v1.0.0 · 合同回款管理系统首发
首个可交付版本,覆盖 SRS V1.1 全部 152 个任务、2 万+ 行代码、150+ 个文件、12 篇文档,70/70 自动化验收 PASS。
✨ 核心能力
- IAM:5 角色 / 30+ 权限点 / Sa-Token JWT / 三档数据范围(ALL / DEPT / SELF)
- 客户档案:CRUD / 合并去重 / 多联系人 / 变更日志
- 合同管理:状态机(DRAFT → EFFECTIVE → COMPLETED / TERMINATED / EXPIRED)+ 附件上传(最多 20 个 / 50MB)+ 到期提醒
- 回款全流程:计划生成 → 实际登记 → FIFO 自动核销 → 红冲 → 批量导入 → 账龄分析(0–30 / 31–60 / 61–90 / 90+)
- 看板与报表:KPI / 月度趋势 / TOP 客户 / 我的待办 / Excel 导出
- 通知中心:合同到期 / 回款临期 / 回款逾期
- 系统管理:参数 / 操作审计 / 硬删除二次密码 / 回收站
🛠️ 工程基础设施
- 后端 Spring Boot 3.2 + MyBatis-Plus + Sa-Token + Flyway + Redis + MinIO
- 前端 Vue 3 + TypeScript + Vite + Element Plus + ECharts + Pinia
- 公共能力:统一响应、全局异常、AES-256-GCM 字段加密、Snowflake ID、操作日志 AOP、Trace ID 透传
- 文件存储:本地磁盘 / MinIO 双实现,
crms.storage.type一键切换
🚀 5 分钟单机部署
git clone https://github.com/liudi2991/crms.git
cd crms/deploy && cp .env.example .env # 填密钥
./scripts/build-images.sh 1.0.0 # 本机打镜像
docker compose -f docker-compose.single.yml --env-file .env up -d
# 浏览器打开 http://localhost/ admin / Admin@123456完整指引见 docs/deploy-quickstart.md。
🧪 70+ 项自动化验收
scripts/acceptance.sh 7 段:A 烟测 / B E2E / C 回归 / D 权限 / E 算法 / F 安全 / G 可观测。本版本本机 5 容器闭环 70 PASS / 0 FAIL(5.6 秒)。
📚 文档(12 篇)
- 业务用户:用户操作手册 · FAQ
- 系统管理员:管理员手册 · 安全自查
- 测试 / UAT:验收指南 · 人工验收清单
- 研发:SRS V1.1 · DSS V1.1 · 任务拆分
- 运维:部署快速指南 · 运维手册
🔮 已知问题与下一步
- UC-03-04 封档合同越权可编辑(已记录,待 v1.0.1 修复)
- UC-04-08 P3 改进(计划纳入 v1.1)
- 计划接入 GitHub Actions CI 与 Sentry / Prometheus 监控
完整变更见 CHANGELOG.md。
License:Apache 2.0