general-admin-server

轻量级 OA 系统服务端，基于 Node.js + Koa2 + MongoDB 构建，提供用户管理、菜单管理、角色管理和部门管理等 RESTful API。

---

技术栈

技术	说明
Node.js	JavaScript 运行时
Koa2	轻量级 Web 框架
MongoDB + Mongoose	数据库与 ODM
jsonwebtoken	JWT 身份认证
log4js	日志记录
nodemon	开发热重载

---

安装与运行

1. 克隆项目

git clone https://github.com/gonwe/general-admin-server.git
cd general-admin-server

2. 安装依赖

npm install

3. 配置 MongoDB 连接

编辑 config/index.js，修改数据库连接地址：

module.exports = {
  URL: "mongodb://127.0.0.1:27017/oasystem",
};

将 mongodb://127.0.0.1:27017/oasystem 替换为你本地的 MongoDB 连接字符串。

4. 启动开发服务

npm run dev

默认服务运行在 http://localhost:3000。

5. 生产环境

npm run prd

使用 PM2 守护进程运行。

---

API 接口概览

所有接口统一前缀 /api，除登录接口外均需携带 JWT Token（Header: Authorization: Bearer <token>）。

用户管理 /api/users

方法	路径	说明
POST	/login	用户登录（无需 Token）
GET	/list	用户列表（分页，支持按 userId / userName / state 筛选）
GET	/all/list	全部用户（简化字段）
POST	/delete	批量删除用户（软删除）
POST	/operate	新增 (action: "add") / 编辑 (action: "edit") 用户
GET	/getPermissions	获取当前用户的菜单权限列表

菜单管理 /api/menu

方法	路径	说明
GET	/list	菜单列表（树形结构）
POST	/operate	新增 (action: "create") / 编辑 (action: "edit") / 删除 (action: "delete") 菜单

角色管理 /api/roles

方法	路径	说明
GET	/list	角色列表（分页）
GET	/alllist	全部角色（简化字段）
POST	/operate	新增 / 编辑 / 删除角色
POST	/update/permission	更新角色权限

部门管理 /api/dept

方法	路径	说明
GET	/list	部门列表（树形结构）
GET	/alllist	全部部门（简化字段）
POST	/operate	新增 / 编辑 / 删除部门
POST	/update/permission	更新部门权限

---

前端项目

配套前端管理界面：gonwe/general-admin

---

License

MIT License. 详见 LICENSE 文件。