wjbl/fundplatform
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
fundplatform/doc/资金服务平台 FundPlatform 功能清单.md
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

9.1 KiB
Raw Blame History

四、功能模块分解

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 移动端模块 (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

文档结束