91化简

一款开源免费简历制作神器

基于Vue3 + TypeScript + Vite + Element-plus + pinia实现

在线地址：https://91huajian.cn

🚀 项目简介

91化简是一个开源免费的简历设计制作以及提供模板下载的网站，当前项目为前端项目，完全开源免费。

网站内置有两款设计器，可以方便快捷的制作出精美的简历，除此之外，网站还提供有完整的后台管理系统，可以方便管理整个网站。

该项目已发布两个纯前端版本，这两个纯前端版本之后，项目将接入后台系统，所以如果单纯想要学习前端的小伙伴可以直接下载发布的两个版本之一即可。如果小伙伴想要学习设计器，则可以直接拉取最新前端代码即可。

纯前端版本：https://github.com/huajian-pro/resume-design/releases

🤼 功能介绍

......更多功能请到官网体验：91化简

🎇 项目演示截图

网站首页：

管理端：

设计器一：

设计器二：

......更多页面请到官网体验：91化简

🐶 技术栈介绍

前端技术栈：

Vue3.x
Vite3.x
TypeScript4.x
Element-plus
Pinia

后端技术栈：

nest.js

数据库：

MongoDB

文件存储：

minio

🏊 如何使用

拉取项目

git clone https://github.com/huajian-pro/resume-design.git

推荐使用包管理工具pnpm
或使用yarn、npm（node自带无需额外安装）包管理工具
Node版本请确保在v16.0及以上

pnpm全局安装方法npm i -g pnpm

安装项目依赖

cd resume-design

// 使用pnpm安装依赖（推荐）
pnpm install

注意：如果安装失败请切换网络或者清空npm缓存重试。

项目配置

注意：如果你拉取的为纯前端项目，则可以跳过此步骤。

若要运行项目，需要有相对应的后台，如果没有自己搭建的后台，则可以连接91化简官方后台。 修改对应文件：

修改前：

// src/config/index.ts

const serverAddress =
  import.meta.env.MODE === 'development' ? 'http://localhost:3399' : 'https://91huajian.cn';
const CONFIG = {
  // serverAddress: 'http://localhost:3399',
  // serverAddress: 'https://91huajian.cn',
  serverAddress: serverAddress,
  smallpigAddress: 'https://91huajian.cn' // 此地址为资源分享菜单的后台地址，可不管
};
export default CONFIG;

修改后：

// src/config/index.ts

const serverAddress = 'https://91huajian.cn';
const CONFIG = {
  // serverAddress: 'http://localhost:3399',
  // serverAddress: 'https://91huajian.cn',
  serverAddress: serverAddress,
  smallpigAddress: 'https://91huajian.cn' // 此地址为资源分享菜单的后台地址，可不管
};
export default CONFIG;

备注：如想搭建自己的后台，可到化简官网获取后端源码。

运行项目

进入项目目录，执行命令：

pnpm dev

注意：如果运行失败，建议检查依赖是否安装完整、以及检查Node版本是否大于16。

构建项目

进入项目目录，执行命令：

pnpm build

将生成的dist上传至服务器，采用nginx部署即可。

🧱 项目结构说明

resume-design
├── LICENSE                 // 协议文件
├── README.md               // 项目介绍文档
├── build                   // 项目打包相关配置文件
│   ├── utils.ts
│   └── vite
├── commitlint.config.js    // 项目提交代码相关配置，npm run commit会读取 
├── dist                    // 项目构建生成文件
│   ├── favicon.ico
│   ├── index.html
│   ├── json
│   └── static
├── doc                     // 相关文档存放目录
├── index.html
├── package.json
├── pnpm-lock.yaml
├── prettier.config.js
├── public                 // 项目公共文件夹
│   ├── favicon.ico
│   ├── json
│   └── static
├── src
│   ├── App.vue
│   ├── assets             // 相关资源存放目录，如图片等
│   ├── auto-import.d.ts   // 自定引入相关依赖配置文件
│   ├── components         // 全局公共组件存放目录
│   ├── components.d.ts    // 组件自动注册配置，如element-plus
│   ├── config             // 项目全局配置目录，如配置后台接口地址等
│   ├── dictionary         // 项目中使用到的相关字典映射
│   ├── env.d.ts           // Typescript等配置
│   ├── hooks              // 项目公用钩子等
│   ├── http               // 项目请求API存放目录
│   ├── i18n               // 国际化相关
│   ├── interface          // Typescript接口定义
│   ├── main.ts            // 主入口文件
│   ├── material           // 在线制作模块的公共物料组件
│   ├── options            // 在线制作模块的物料属性设置面板组件
│   ├── router             // 项目路由
│   ├── schema             // 在线制作模块相关模型JSON定义
│   ├── store              // 全局状态管理
│   ├── style              // 公共样式存放
│   ├── template           // 在线制作模块模板渲染存放目录
│   ├── utils              // 全局公用工具函数
│   └── views              // 页面
├── tsconfig.json
├── tsconfig.node.json
├── types
│   ├── custom-types.d.ts
│   └── global.d.ts
└── vite.config.ts

注意：由于项目在不断更新迭代，项目目录结构可能会改变。

🐨 在线制作设计器

设计器简介

在线制作设计器主要是项目初期建设时的第一代设计器，功能没有那么复杂，项目目录可能没有那么规范，但是代码还是很清晰明了的。

使用这款设计器只能制作简历，并且让使用者专注于简历数据，不用花费更多精力在配色、字体等方面，以下为在线制作设计器相关截图：

特点描述

该款设计器目前是提供模板最多的，主要用于简历设计制作，用户可以自行添加和删除相对应简历模块，通过简单的拖动实现模块之间顺序交换，主要特点如下：

专注于简历制作
提供有丰富简历模板
已提前配置了简历模块
让用户专注于数据
可以在模板中添加物料中心组件

模板开发

如果想要给在线制作功能添加更多的模板，那么可以到【贡献模板】页面拖拉拽组成一个完整模板，然后提交审核，管理员在后台审核通过后将会展示在模板列表中。

页面如下：

上图中左侧是物料区，该款设计器其实和在线制作设计器是同一款，只不过这儿是用来生成模板使用的。

组件开发相关目录

物料组件和属性设置面板分别存放在src下的两个目录，如下所示：

具体实现步骤可以参考文章：# 简历开源项目——教你如何新增模板和物料组件

🐔 积木制作设计器

设计器简介

该款设计器为后来新开发的设计器，相较于第一款设计器而言，该款设计器将组件粒度划分为更小，更为灵活，理论而言，不仅可以制作简历，还可以制作海报、logo等等。

但是相对于在线制作设计器而言，积木制作设计器使用户没有那么专注于数据，因为太为灵活，所以需要看用户需求，如果只需要简单制作一份简历，在线制作设计器可能是更好的选择。

积木设计器截图如下：

特点描述

积木制作设计器主要为满足灵活多变的设计场景，理论上它可以渲染任何组件，比如数据可视化组件等，它主要集中于如下特点：

物料组件粒度更小
画布区域可设计性更强
不仅可制作简历，还可制作海报等
理论可以渲染任何组件
良好的代码结构

模板开发

积木制作的模板开发也很简单，任何用户都可以申请提交模板，在设计器内制作出想要的模板，然后提交申请，管理员审核通过即可发布为模板。

如下所示：

物料组件开发

为了积木制作设计器与项目更好的解耦，比如让其他项目快速接入积木制作设计器，所以积木制作设计器基本是单独一个目录，如下所示：

新增物料组件主要关注一下几个目录：

schema
setters
widgets

大体步骤如下：

第一步：定义物料组件JSON

在schema/widgetConfig.ts文件中新增一段JSON，JSON例如：

{
  id: '', // 组件唯一性id
  componentName: 'hj-text-2', // 组件名
  commentType: '', // 组件类型
  icon: '', // 组件icon
  title: '', // 组件中文名称
  description: '渐变文本-1', // 组件描述信息
  screenShot: {
    src: 'text-2.png',
    width: '116px',
    height: '37px',
    borderRadius: '4px'
  }, // 组件快照
  keywords: '文本-2', // 组件关键词，用于搜索
  category: 'text', // 组件分类
  props: {}, // 组件属性
  css: {
    left: 0,
    top: 0,
    zIndex: 1,
    width: 60,
    height: 20,
    rotate: 0, // 旋转角度
    fontSize: 14,
    letterSpace: 1,
    lineHeight: 1.5,
    fontFamily: '方正黑体简体',
    fontWeight: 500,
    textAlign: 'justify',
    padding: {
      top: 0,
      right: 0,
      bottom: 0,
      left: 0
    },
    borderWidth: 0,
    borderRadius: 10,
    borderColor: '#eee',
    borderStyle: 'solid'
  }, // 组件样式
  dataSource: {} // 组件单独数据
}

将上段JSON添加到List字段中去，左侧物料区对应的分类下就会有对应的组件选择了，主要注意JSON中相关字段含义。其中props和css、dataSource对象中的每一个字段都有对应属性设置组件，比如你在css中添加了fontSize字段，那么右侧属性面板将会出现如下选项：