# oa-api **Repository Path**: caiheping/oa-api ## Basic Information - **Project Name**: oa-api - **Description**: 员工管理系统api - **Primary Language**: NodeJS - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 18 - **Forks**: 8 - **Created**: 2021-06-17 - **Last Updated**: 2025-05-26 ## Categories & Tags **Categories**: Uncategorized **Tags**: egg, MySQL ## README # oa-api ## 描述 oa-api 为前后端分离的企业员工管理系统。 ## 技术栈 后端技术栈：egg.js + mysql + sequelize + jwt 等 前端技术栈：vue3 + vite + ant-design-vue + pinia + windicss等 前端项目地址： 码云：https://gitee.com/caiheping/oa-sys GitHub：https://github.com/caiheping/oa-sys ### 环境 node版本8以上 MySQL数据库 ### 项目运行 **项目有两个分支，master分支包含一个后台管理系统的基础功能，feature-oa分支除了系统管理外还包含基础数据，财务数据，审核管理等模块** ```bash git clone https://gitee.com/caiheping/oa-api.git cd oa-api npm install ``` 然后修改config/config.default.js和database/config.json（如果你不是sequelize的命令生成数据的话，这个改不改都行）下自己的数据库用户名和密码 创建数据库egg-oa-sys master分支运行：在egg-oa-sys数据库下导入项目根目录下 egg-oa-sys.sql 文件 feature-oa分支运行：在egg-oa-sys数据库下导入项目根目录下 egg-oa-sys-2021-09-17-基础功能完成.sql 文件 **备注：切换分支时要把数据库清空，重新导入对应分支的sql文件** 运行项目 > npm run dev 浏览器打开 http://127.0.0.1:7002/index.html admin登录账号：admin，密码： 123456 普通用户账号密码自己用admin去用户管理创建 ### 目录结构 ```bash oa-api ├─ apidoc // 接口文档 ├─ app | ├─ controller // 用于解析用户的输入，处理后返回相应的结果 | ├─ extend // 用于框架的扩展 | ├─ middleware // 用于编写中间件 | ├─ model // 用于放置领域模型 | ├─ public // 用于放置静态资源 | ├─ rules // 参数校验文件 | ├─ schedule // 用于定时任务，可选，具体参见定时任务 | ├─ service // 用于编写业务逻辑层，可选，建议使用 | ├─ utils // 工具文件 | ├─ router.js // 用于配置 URL 路由规则 ├─ config | ├─ config.default.js // 用于编写配置文件 | ├─ plugin.js // 用于配置需要加载的插件 ├─ database | ├─ migrations // 数据库迁移文件 | ├─ seeders // 种子文件 | ├─ config.json // sequelize 配置文件 ├─ logs // 日志文件 ├─ run ├─ test ├─ typings ├─ www // 前端打包文件 ... ``` 演示地址：http://oa.caihp.top （自己服务器只开放部分功能，想要查看全部功能，请copy代码在自己的电脑上看） 用户名： test123 密码：123456 **后台接口文档在apidoc目录下** ## 界面截图 登录页 ![](http://cdn.caihp.top/oa-sys/other/login.png) ![](http://cdn.caihp.top/oa-sys/other/dept.png) ![](http://cdn.caihp.top/oa-sys/other/dit.png) ![](http://cdn.caihp.top/oa-sys/other/lockIn.png) ![](http://cdn.caihp.top/oa-sys/other/log.png) ![](http://cdn.caihp.top/oa-sys/other/makeUpCard.png) ![](http://cdn.caihp.top/oa-sys/other/menu.png) ![](http://cdn.caihp.top/oa-sys/other/notice.png) ![](http://cdn.caihp.top/oa-sys/other/role.png) ![](http://cdn.caihp.top/oa-sys/other/salary.png) ![](http://cdn.caihp.top/oa-sys/other/sysSetting.png) ![](http://cdn.caihp.top/oa-sys/other/setting.png) ![](http://cdn.caihp.top/oa-sys/other/userInfo.png) ![](http://cdn.caihp.top/oa-sys/other/user.png) ![](http://cdn.caihp.top/oa-sys/other/workOverTime.png) ![](http://cdn.caihp.top/oa-sys/other/workingDaySetting.png) ## 功能模块 **master分支** - [x] 登录 -- 完成 - [ ] 首页 -- 待定 - [x] 系统布局配置 -- 完成 - [x] 系统管理 =》用户中心 -- 完成 - [x] 系统管理 =》角色管理 -- 完成 - [x] 系统管理 =》菜单管理 -- 完成 - [x] 系统管理 =》部门管理 -- 完成 - [x] 系统管理 =》字典管理 -- 完成 - [x] 系统管理 =》消息公告 -- 完成 - [x] 个人中心 =》头像上传 -- 完成 **feature-oa** - [x] 登录 -- 完成 - [ ] 首页 -- 待定 - [x] 系统布局配置 -- 完成 - [x] 国际化（中英文切换）-- 完成 - [x] 系统管理 =》用户中心 -- 完成 - [x] 系统管理 =》角色管理 -- 完成 - [x] 系统管理 =》菜单管理 -- 完成 - [x] 系统管理 =》部门管理 -- 完成 - [x] 系统管理 =》字典管理 -- 完成 - [x] 系统管理 =》消息公告 -- 完成 - [x] 个人中心 =》头像上传 -- 完成 - [x] 系统管理 =》系统配置 -- 完成 - [x] 系统管理 =》系统日志 -- 完成 - [x] 基础数据 =》打卡详情 -- 完成 - [x] 基础数据 =》工作日设置 -- 完成 - [x] 基础数据 =》员工假期详情 -- 完成 - [x] 财务数据 =》工资详情 -- 完成 - [x] 审批管理 =》出差申请 -- 完成 - [x] 审批管理 =》补卡申请 -- 完成 - [x] 审批管理 =》请假申请 -- 完成 - [x] 审批管理 =》 加班申请 -- 完成 如果对您有帮助，您可以点右上角 "Star" 支持一下 谢谢！ ^_^