wjbl/fundplatform
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
61 Commits 1 Branch 0 Tags
Commit Graph

21 Commits

Author SHA1 Message Date
zhangjf
32863c5ce3 docs: 补充 Controller 职责与参数校验规范\n\n- 在开发规范中新增 8.4 Controller 与请求参数校验规范\n- 明确 Controller 只负责数据接收/校验、调用业务Service和封装返回结果\n- 建议使用 @Valid/@Validated + @NotBlank/@NotNull 等注解做必填校验\n- 提供登录接口参数校验示例和全局异常处理示例 2026-02-17 10:22:58 +08:00
zhangjf
6e75d23f1e docs: 增补 MyBatis-Plus 使用规范\n\n- 明确 ServiceImpl 仅负责数据访问，不承载业务逻辑\n- 约定数据服务类命名为 XxxDataService，业务服务命名为 XxxService 等\n- 禁止在 MyBatis ServiceImpl 中使用 @Slf4j，避免与 MyBatis Log 冲突\n- 建议将 Entity/Mapper/ServiceImpl 封装在独立 data 包下，与业务服务层物理隔离 2026-02-17 10:00:23 +08:00
zhangjf
2c22213326 docs: 补充 OpenFeign 参数对象管理策略\n\n- 在 2.3 章节新增 2.3.6 参数对象（DTO）管理策略\n- 约定通用参数对象放在 fund-common 独立模块\n- 领域业务参数对象按服务分模块管理，避免跨模块 Java 类型耦合\n- 明确消费方可定义本地 DTO 并在 Service 层做映射\n- 修复技术架构章节标题被覆盖的问题 2026-02-17 09:51:05 +08:00
zhangjf
cf0db27bc5 docs: 补充模块通信方式说明 
新增内容：
- 2.3 模块通信方式章节
  - 2.3.1 基础服务 - Maven 依赖方式
  - 2.3.2 业务服务 - OpenFeign 通信方式
  - 2.3.3 通信链路追踪
  - 2.3.4 通信架构图
  - 2.3.5 通信方式选择标准

关键说明：
✓ fund-common 等基础服务采用 Maven 依赖方式
✓ 业务服务间采用 OpenFeign 进行 HTTP 通信
✓ 自动传递租户ID、用户信息、链路追踪ID
✓ 提供完整的代码示例和架构图
✓ 明确反模式，避免错误使用
 2026-02-17 09:28:37 +08:00
zhangjf
c7904a9f8b docs: 同步文件上传管理模块文档 
更新内容：

1. API接口文档.md
   - 新增「十六、文件管理接口」章节（194行）
   - 7个核心接口文档：
     * 16.1 上传文件（multipart/form-data）
     * 16.2 分页查询文件列表
     * 16.3 根据业务类型和ID查询文件列表
     * 16.4 获取文件详情
     * 16.5 删除文件
     * 16.6 获取文件访问URL
     * 16.7 文件类型说明（支持的MIME类型）
   - 完整的请求参数、响应示例、字段说明
   - 文件类型白名单、大小限制说明
   - 调整附录章节编号为「十七」

2. 资金服务平台 FundPlatform 功能清单.md
   - 新增「4.1.3 文件管理」章节
   - 标记文件管理功能为已完成 ✅
   - 添加实现状态说明：
     * 后端：FileRecord + FileRecordMapper + FileService + FileController
     * 前端：file.js + file.vue
     * 功能清单：12大功能点
     * 支持文件类型、存储方式、业务关联

文档与代码同步完成！
 2026-02-16 09:59:21 +08:00
zhangjf
c184e649ee docs: 同步人员分配模块文档 
更新内容：

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大功能点
     * 批量分配、未分配筛选、职位管理

文档与代码同步完成！
 2026-02-16 09:51:56 +08:00
zhangjf
25776cc9a4 docs: 同步岗位管理模块文档 
更新内容：

1. API接口文档.md
   - 新增「三、岗位管理接口」章节（256行）
   - 8个核心接口文档：
     * 3.1 分页查询岗位列表（支持多条件过滤）
     * 3.2 按部门ID查询岗位列表
     * 3.3 获取所有启用的岗位列表
     * 3.4 获取岗位详情
     * 3.5 创建岗位
     * 3.6 更新岗位
     * 3.7 删除岗位
     * 3.8 更新岗位状态
   - 完整的请求参数、响应示例、字段说明
   - 调整后续所有章节编号（四~十五）

2. 资金服务平台 FundPlatform 功能清单.md
   - 标记「岗位管理（岗位定义、职责描述）」为已完成 ✅
   - 添加实现状态说明：
     * 后端：PostMapper + PostService + PostController
     * 前端：post.js + post.vue
     * 功能清单：8大功能点
     * 部门树选择器、状态管理、职责描述

文档与代码同步完成！
 2026-02-16 09:43:22 +08:00
zhangjf
2b7c43366b docs: 同步数据统计分析模块文档 
更新内容：

1. API接口文档.md
   - 新增「十三、数据统计分析接口」章节（129行）
   - 13.1 获取仪表盘统计数据
     * 完整的请求参数、响应示例
     * 包含概览、收支、趋势、分布等多维度数据
   - 13.2 响应字段说明
     * 概览数据：项目数、客户数、合同数、需求工单数
     * 收支统计：总收入、总支出、净利润、应收款、逾期金额
     * 本月数据：本月收入/支出、新增项目/客户
     * 趋势数据：月度收入/支出趋势（List结构）
     * 分布数据：项目状态、支出类型、应收款状态分布
   - 调整附录章节编号为「十四」

2. 资金服务平台 FundPlatform 功能清单.md
   - 标记「4.6.5 支出统计分析」为已完成 ✅
   - 添加实现状态说明：
     * 后端：DashboardVO + DashboardService + DashboardController
     * 前端：dashboard.js + dashboard/index.vue
     * 功能清单：概览、收支、本月、趋势、分布
     * 图表：ECharts折线图、环形饼图
     * 响应式设计

文档与代码同步完成！
 2026-02-16 09:36:39 +08:00
zhangjf
39577a9b11 docs: 同步部门管理模块文档 
更新内容：

1. API接口文档.md
   - 新增「二、部门管理接口」章节（229行）
   - 6个核心接口文档：
     * 2.1 获取部门树（树形结构）
     * 2.2 获取部门列表（扁平结构）
     * 2.3 获取部门详情
     * 2.4 新增部门
     * 2.5 更新部门
     * 2.6 删除部门
   - 完整的请求参数、响应示例、字段说明
   - 部门层级结构展示（children嵌套）
   - 调整后续所有章节编号（三~十三）

2. 资金服务平台 FundPlatform 功能清单.md
   - 标记「4.1.2 组织架构管理」为已完成 ✅
   - 标记「部门管理（增删改查、层级关系）」为已完成 ✅
   - 添加实现状态说明：
     * 后端：DeptMapper + DeptService + DeptController
     * 前端：dept.js + dept.vue
     * 功能清单：10大功能点
     * 树形结构展示
     * 层级管理、负责人管理、状态管理

文档与代码同步完成！

注意：部门管理的前后端代码早期已完成，本次仅补充文档同步。
 2026-02-16 09:12:39 +08:00
zhangjf
c115a0b58c docs: 同步操作日志管理模块文档 
更新内容：

1. API接口文档.md
   - 新增「十一、操作日志管理接口」章节（165行）
   - 4个核心接口文档：
     * 11.1 获取操作日志列表（分页+多条件过滤）
     * 11.2 获取操作日志详情
     * 11.3 删除操作日志
     * 11.4 批量删除操作日志
   - 11.5 操作类型说明表（8种操作类型+标签颜色）
   - 完整的请求参数、响应示例、字段说明
   - 时间格式说明（yyyy-MM-dd HH:mm:ss）
   - 调整附录章节编号为「十二」

2. 资金服务平台 FundPlatform 功能清单.md
   - 标记「操作日志记录与查询」为已完成 ✅
   - 添加实现状态说明：
     * 后端：OperationLogMapper + OperationLogService + OperationLogController
     * 前端：operationLog.js + operationLog.vue
     * 功能清单：7大功能点
     * 操作类型：8种类型（查询/新增/更新/删除/导入/导出/登录/登出）
     * 性能监控：执行时长超时标红

文档与代码同步完成！
 2026-02-16 09:08:36 +08:00
zhangjf
3dd1b88749 docs: 同步项目成员管理模块文档 
更新内容：

1. API接口文档.md
   - 在「六、项目管理接口」章节新增7个项目成员管理接口：
     * 6.6 获取项目成员列表（按项目ID）
     * 6.7 获取用户的项目列表（按用户ID）
     * 6.8 获取项目成员详情
     * 6.9 添加项目成员
     * 6.10 更新项目成员
     * 6.11 移除项目成员
     * 6.12 更新成员状态
   - 完整的请求参数、响应示例、字段说明
   - 角色类型说明（pm/dev/test/finance/member）

2. 资金服务平台 FundPlatform 功能清单.md
   - 标记「4.3.2 项目关联管理」为已完成 ✅
   - 添加实现状态说明：
     * 后端：ProjectMemberMapper + ProjectMemberService + ProjectMemberController
     * 前端：projectMember.js + projectMember.vue
     * 功能清单：7大功能点

文档与代码同步完成！
 2026-02-16 09:04:06 +08:00
zhangjf
6702b92a95 docs: 同步收款记录模块文档 
更新内容：

1. API接口文档.md
   - 新增「十、收款记录管理接口」章节
   - 包含5个接口文档
   - 完整的请求参数、响应示例、字段说明

2. 资金服务平台 FundPlatform 功能清单.md
   - 标记「4.7.2 收款管理」为已完成 ✅
   - 添加实现状态说明

文档与代码同步完成！
 2026-02-16 09:00:35 +08:00
zhangjf
61475dd320 docs: 添加API接口文档、数据库设计文档、部署运维文档 2026-02-15 12:09:18 +08:00
zhangjf
fccadf63c2 docs: 架构文档补充统一全局上下文GlobalContext，统筹tid/uid/uname获取和异步传递 2026-02-15 11:42:20 +08:00
zhangjf
43e6e41a4a docs: 架构文档补充HikariCP连接池和支持异步场景的UserContext封装 2026-02-15 11:35:39 +08:00
zhangjf
2a45ac0279 docs: 架构文档补充Shiro认证框架和服务调用链uid/uname传递设计 2026-02-15 10:45:16 +08:00
zhangjf
2088742543 docs: 架构文档补充Feign动态路由方案详细设计，对比DynamicDataSource方案优劣 2026-02-14 00:41:49 +08:00
zhangjf
8029ac31da docs: 架构设计文档补充多租户架构和Head日志追踪设计 2026-02-14 00:34:29 +08:00
zhangjf
15d1cb698a docs: 添加架构设计文档，包含系统架构、技术选型、数据架构、安全架构、部署方案 2026-02-14 00:19:30 +08:00
zhangjf
2033bd64dd docs: 根据功能清单生成完整需求文档，包含功能模块、数据模型、技术架构 2026-02-14 00:09:06 +08:00
zhangjf
b213592e55 Initial commit: 初始化资金服务平台项目 2026-02-13 23:54:47 +08:00