c184e649ee
更新内容：
1. API接口文档.md
- 新增「四、人员分配管理接口」章节（159行）
- 5个核心接口文档：
* 4.1 分页查询用户分配列表（支持多条件过滤）
* 4.2 根据部门ID查询用户列表
* 4.3 分配用户到部门和岗位
* 4.4 批量分配用户
* 4.5 移除用户分配
- 完整的请求参数、响应示例、字段说明
- 包含部门名称、岗位名称的VO结构
- 调整后续所有章节编号（五~十六）
2. 资金服务平台 FundPlatform 功能清单.md
- 标记「人员分配（部门人员配置）」为已完成 ✅
- 添加实现状态说明：
* 后端：UserAssignmentVO + UserAssignmentService + UserAssignmentController
* 前端：userAssignment.js + userAssignment.vue
* 功能清单：8大功能点
* 批量分配、未分配筛选、职位管理
文档与代码同步完成！
243 lines
8.3 KiB
Markdown
243 lines
8.3 KiB
Markdown
## 四、功能模块分解
|
||
|
||
### 4.1 系统管理模块
|
||
|
||
#### 4.1.1 用户管理
|
||
- 用户注册/登录/注销
|
||
- 用户信息维护（姓名、手机号、邮箱、部门等）
|
||
- 角色权限管理（管理员、财务、项目经理、普通员工）
|
||
- 操作日志记录与查询 ✅
|
||
- **实现状态**：✅ 已完成
|
||
- 后端：OperationLogMapper + OperationLogService + OperationLogController
|
||
- 前端：operationLog.js + operationLog.vue
|
||
- 功能：
|
||
* 分页查询（支持模块、操作类型、操作人、时间范围过滤）
|
||
* 查询详情（完整展示请求参数、响应结果、错误信息）
|
||
* 删除单条日志
|
||
* 批量删除（删除N天前的所有日志，支持7-365天）
|
||
* 操作类型：查询/新增/更新/删除/导入/导出/登录/登出
|
||
* 执行时长监控（超时标红>1000ms）
|
||
* 状态展示（成功/失败）
|
||
|
||
#### 4.1.2 组织架构管理 ✅
|
||
- 部门管理（增删改查、层级关系） ✅
|
||
- **实现状态**：✅ 已完成
|
||
- 后端：DeptMapper + DeptService + DeptController
|
||
- 前端：dept.js + dept.vue
|
||
- 功能：
|
||
* 获取部门树（树形结构展示）
|
||
* 获取部门列表（扁平结构）
|
||
* 查询部门详情
|
||
* 新增部门（支持顶级部门和子部门）
|
||
* 更新部门信息
|
||
* 删除部门（含子部门校验）
|
||
* 部门层级管理（自动计算层级）
|
||
* 负责人管理（姓名+电话）
|
||
* 状态管理（启用/禁用）
|
||
* 排序功能
|
||
- 岗位管理（岗位定义、职责描述） ✅
|
||
- **实现状态**：✅ 已完成
|
||
- 后端：PostMapper + PostService + PostController
|
||
- 前端：post.js + post.vue
|
||
- 功能：
|
||
* 分页查询（支持编码、名称、部门、状态过滤）
|
||
* 按部门查询岗位列表
|
||
* 获取所有启用的岗位
|
||
* 新增/编辑/删除岗位
|
||
* 状态管理（启用/禁用）
|
||
* 岗位职责、岗位要求管理
|
||
* 部门树选择器
|
||
- 人员分配（部门人员配置） ✅
|
||
- **实现状态**：✅ 已完成
|
||
- 后端：UserAssignmentVO + UserAssignmentService + UserAssignmentController
|
||
- 前端：userAssignment.js + userAssignment.vue
|
||
- 功能：
|
||
* 分页查询用户分配列表（支持用户名、姓名、部门、岗位、状态过滤）
|
||
* 按部门查询用户列表
|
||
* 分配用户到部门和岗位（支持单独分配）
|
||
* 批量分配用户
|
||
* 移除用户分配
|
||
* 仅显示未分配用户筛选
|
||
* 部门树选择器、岗位下拉选择
|
||
* 职位管理
|
||
|
||
#### 4.1.3 系统配置
|
||
- 基础参数设置（公司信息、币种、日期格式等）
|
||
|
||
---
|
||
|
||
### 4.2 客户管理模块
|
||
|
||
#### 4.2.1 客户信息管理
|
||
- 客户档案创建/编辑/删除/禁用
|
||
- 客户分类管理（按行业、规模、等级等）
|
||
- 客户联系人管理（联系人信息、联系方式）
|
||
|
||
|
||
---
|
||
|
||
### 4.3 项目管理模块
|
||
|
||
#### 4.3.1 项目信息管理
|
||
- 项目创建/编辑/归档/删除
|
||
- 项目基本信息维护（项目名称、编号、负责人、开始/结束日期）
|
||
- 项目状态管理（筹备中、进行中、已完成、已归档）
|
||
|
||
#### 4.3.2 项目关联管理 ✅
|
||
- 客户关联（项目所属客户）
|
||
- 团队成员分配（项目经理、开发人员、财务等）
|
||
- **实现状态**：✅ 已完成
|
||
- 后端：ProjectMemberMapper + ProjectMemberService + ProjectMemberController
|
||
- 前端：projectMember.js + projectMember.vue
|
||
- 功能：
|
||
* 按项目查询成员列表
|
||
* 按用户查询项目列表
|
||
* 添加/编辑/移除成员
|
||
* 角色管理（项目经理/开发/测试/财务/普通成员）
|
||
* 状态管理（在职/已离开）
|
||
* 工作量占比管理
|
||
|
||
|
||
---
|
||
|
||
### 4.4 需求清单管理模块
|
||
|
||
#### 4.4.1 需求工单信息管理
|
||
- 需求工单创建/编辑/删除
|
||
- 需求工单详情维护：
|
||
- 需求工单名称
|
||
- 需求描述
|
||
- 所属客户
|
||
- 所属项目
|
||
- 开发工时
|
||
- 交付日期
|
||
- 应收款金额
|
||
- 应收款日期
|
||
- 需求状态管理（待开发、开发中、待交付、已完成）
|
||
|
||
#### 4.4.2 应收款管理
|
||
- 应收款金额设置
|
||
- 应收款日期管理
|
||
- 交付日期跟踪与提醒
|
||
|
||
|
||
### 4.5 支出类型管理模块
|
||
|
||
#### 4.5.1 支出分类管理
|
||
- 支出类型创建/编辑/删除
|
||
- 支出类型层级管理（一级分类、二级分类）
|
||
- 常见支出类型示例：
|
||
- 人力成本（工资、奖金、社保）
|
||
- 办公费用（房租、水电、办公用品）
|
||
- 差旅费用（交通、住宿、餐饮）
|
||
- 采购费用（设备、软件、服务）
|
||
- 其他费用
|
||
|
||
---
|
||
|
||
### 4.6 支出管理模块
|
||
|
||
#### 4.6.1 支出申请
|
||
- 支出录入字段：
|
||
- 支出金额
|
||
- 支出类型
|
||
- 支出事由
|
||
- 支出日期
|
||
- 所属项目
|
||
- 申请人
|
||
- 附件上传（发票、合同等）
|
||
|
||
#### 4.6.3 支出执行
|
||
- 付款操作（确认付款、付款日期）
|
||
- 付款凭证管理（付款截图、银行回单）
|
||
- 付款状态更新（待付款、已付款、已核销）
|
||
|
||
#### 4.6.4 支出状态管理
|
||
- 标记完成（确认支出已完成）
|
||
- 作废处理（支出作废、原因记录）
|
||
- 退款管理（退款申请、退款记录）
|
||
|
||
#### 4.6.5 支出统计分析 ✅
|
||
- 支出明细查询（多条件筛选） ✅
|
||
- 支出趋势分析（月度、季度、年度） ✅
|
||
- **实现状态**：✅ 已完成
|
||
- 后端：DashboardVO + DashboardService + DashboardController
|
||
- 前端：dashboard.js + dashboard/index.vue
|
||
- 功能：
|
||
* 概览数据：项目数、客户数、合同数、需求工单数
|
||
* 收支统计：总收入、总支出、净利润、应收款、逾期金额
|
||
* 本月数据：本月收入/支出、新增项目/客户
|
||
* 趋势图表：收支趋势折线图（最近12个月）
|
||
* 分布图表：项目状态分布饼图
|
||
* 分布图表：支出类型分布饼图
|
||
* 分布图表：应收款状态分布饼图
|
||
* ECharts可视化：折线图、环形饼图
|
||
* 响应式设计：窗口大小变化自动重绘
|
||
|
||
---
|
||
|
||
### 4.7 应收款管理模块
|
||
|
||
#### 4.7.1 应收款确认
|
||
- 应收款生成（从需求清单自动生成）
|
||
- 应收款金额确认（确认应收金额）
|
||
- 应收款日期确认（确认应收日期）
|
||
|
||
#### 4.7.2 收款管理 ✅
|
||
- 收款记录录入：
|
||
- 实际收款金额
|
||
- 收款日期
|
||
- 收款方式（银行转账、现金、支票等）
|
||
- 收款凭证（上传凭证照片）
|
||
- 收款方式管理（维护常用收款方式）
|
||
- 收款凭证管理（凭证归档、查询）
|
||
- **实现状态**：✅ 已完成
|
||
- 后端：ReceiptMapper + ReceiptService + ReceiptController
|
||
- 前端：receipt.js + receipt.vue
|
||
- 功能：分页查询、新增、编辑、删除、应收款关联
|
||
|
||
---
|
||
|
||
### 4.10 移动端模块 (UniApp)
|
||
|
||
#### 4.10.1 移动端首页
|
||
- 数据概览（今日收支、待收款）
|
||
- 快捷入口（快速录入）
|
||
|
||
#### 4.10.3 移动查询
|
||
- 收支查询（个人收支、项目收支）
|
||
- 项目查询（项目进度、项目收支）
|
||
- 客户查询（客户信息、客户往来）
|
||
|
||
#### 4.10.4 移动录入
|
||
- 支出录入（快速录入支出申请）
|
||
- 收款录入（现场收款记录）
|
||
|
||
---
|
||
|
||
## 五、技术架构建议
|
||
|
||
### 5.1 后端架构
|
||
|
||
| 组件 | 技术选型 | 说明 |
|
||
| ------------ | ------------------------- | ---------------------------------- |
|
||
| **应用框架** | Spring Cloud Alibaba + nacos | Java生态，成熟稳定，适合企业级应用 |
|
||
| **数据库** | MySQL 8.0 | 支持事务、ACID，数据持久化 |
|
||
| **缓存** | Redis 7.x | 会话管理、热点数据缓存 |
|
||
| **文件存储** | 腾讯COS | 文件上传、附件存储 |
|
||
| **定时任务** | XXL-JOB | 定时提醒、数据统计 |
|
||
| **API文档** | Swagger / Knife4j | 接口文档自动生成 |
|
||
|
||
### 5.2 前端架构
|
||
|
||
| 端 | 技术栈 | 说明 |
|
||
| ------------ | --------------------------------- | ----------------------------------- |
|
||
| **管理后台** | Vue 3 + TypeScript + Element Plus | 响应式设计，组件丰富 |
|
||
| **移动端** | UniApp + Vue 3 + uView UI | 一套代码多端发布（H5、小程序、App） |
|
||
| **图表库** | ECharts 5.x | 数据可视化、报表展示 |
|
||
| **构建工具** | Vite 4.x | 快速构建、热更新 |
|
||
|
||
### 5.3
|
||
|
||
**文档结束**
|