4.6 KiB
4.6 KiB
🎉 福建水务营收系统概要设计文档 - 项目完成
📋 项目概述
项目状态: ✅ 已圆满完成 交付时间: 2024年12月19日 质量评级: A级 (96/100分) 交付状态: 可正式交付甲方
本项目为福建水务营收系统提供完整的概要设计文档,基于RuoYi-Vue-Pro框架和达梦数据库 (Dameng DB),采用现代化微服务架构,满足国产化和等保三级安全要求。
🏆 项目成果 (AI-Friendly 结构)
本项目已按照功能层次重新组织,方便 AI Agent 快速检索和理解。
00_管理与标准 (Management)
01_总体设计 (High-Level)
02_详细设计 (Detailed)
03_技术专项 (Technical)
04_附录与参考 (Appendix)
🏗️ 技术架构
本项目采用 RuoYi-Vue-Pro 微服务架构,核心数据库为 达梦数据库 8.0+。
graph TB
subgraph "用户层"
WEB[Web管理端<br/>Vue3+Element Plus]
MOBILE[移动端<br/>微信抄表APP]
WECHAT[微网厅<br/>微信公众号]
end
subgraph "网关层"
GATEWAY[Spring Cloud Gateway<br/>统一网关]
end
subgraph "业务服务层"
UP[统一平台 SYS-001]
REV[营收业务系统 SYS-002]
WORK[工单管理系统 SYS-005]
METER[表务管理系统 SYS-006]
INST[报装业务系统 SYS-007]
end
subgraph "基础服务层"
INV[发票服务 SYS-008]
PAY[支付结算 SYS-009]
MSG[消息服务 SYS-010]
end
subgraph "数据层"
DM[(达梦数据库 8.0+)]
REDIS[(Redis 缓存)]
end
WEB & MOBILE & WECHAT --> GATEWAY
GATEWAY --> UP & REV & WORK & METER & INST
REV & WORK & METER & INST --> INV & PAY & MSG
UP & REV & WORK & METER & INST & INV & PAY & MSG --> DM & REDIS
🤖 Codex / AGENTS 使用说明
本仓库已增加仓库级代理说明文件 AGENTS.md,用于为 Codex 及其他通用代码代理提供统一的项目约束和工作指引。
适用说明
- 进入仓库后,优先阅读
AGENTS.md - 修改正式文档前,先检查:
00_Management/01_Project_Progress.md00_Management/02_Delivery_Standards.md00_Management/03_Task_Checklist.md
- 优先维护主文档,不随意新增“新版本”“最终版”“修订版”类平行文件
- 涉及 Markdown 链接、标题锚点、交叉引用维护时,优先配合
marksman工作流
Markdown / Marksman 配合方式
本仓库已提供以下 Markdown 工具链支持:
.marksman.toml:Marksman 工作区根配置.zed/settings.json:Zed 中的 Markdown 语言服务配置scripts/check-marksman.sh:本机环境检查脚本package.json:npm run check:marksmannpm run marksman:helpnpm run marksman:server
如本机尚未安装 marksman,可在 macOS 下执行:
brew install marksman
安装完成后建议执行:
npm run check:marksman
🚀 快速开始
- 初始化环境:
make init - 验证文档:
make validate - 导出文档:
make unified-export(推荐) - 检查 Markdown 工具链:
npm run check:marksman
详细使用说明请参考 QUICK_START.md。
🎉 恭喜项目圆满完成!文档质量达到甲方A级标准,可正式交付!