ad4176ae8a
- 架构设计文档：更新前端架构说明和接入层架构图 - 需求文档：更新移动端技术栈描述 - 功能清单：更新移动端模块技术栈 - 移除 UniApp 跨端架构，改为独立的 H5 移动端应用
9.0 KiB
9.0 KiB
四、功能模块分解
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 文件管理 ✅
- 文件上传（合同附件、收款凭证、支出凭证） ✅
- 文件列表管理 ✅
- 文件预览（图片、PDF） ✅
- 文件下载 ✅
- 文件删除 ✅
- 实现状态：✅ 已完成
- 后端：FileRecord + FileRecordMapper + FileService + FileController
- 前端：file.js + file.vue
- 功能：
- 文件上传（支持多类型：图片、PDF、Office、文本）
- 文件验证（类型白名单、大小限制50MB）
- 本地存储（支持扩展至COS/OSS）
- 按日期分目录存储
- UUID重命名防冲突
- 业务关联（合同/收款/支出/其他）
- 分页查询、按业务查询
- 图片/PDF预览
- 文件下载
- 物理+逻辑双删除
4.1.4 系统配置
- 基础参数设置（公司信息、币种、日期格式等）
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 移动端模块 (H5)
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 | 响应式设计，组件丰富 |
| 移动端 | Vue 3 + Vite 5 + Vant 4 | 移动端H5响应式应用 |
| 图表库 | ECharts 5.x | 数据可视化、报表展示 |
| 构建工具 | Vite 4.x | 快速构建、热更新 |
5.3
文档结束