tangweijie
3eccab2cf9
1. AGENTS.md 更新 - water-docs: 新增 specs/ 与 docs/design/ 生命周期规则章节 - water-backend: 更新协作引用（建设期/建成后、evidence 模块化） 2. specs/ 重复合并 - 006-reminder-event-design 合并入 003-rev006-reminder-event-design - 001-rev004-accounting 删除冗余 data-model.md + contracts/ - 002-rev005-invoice-flow 删除冗余 data-model.md + contracts/ 3. evidence 按模块归档 - 35 个 REV-004 文件归入 evidence/rev004-accounting/ - 7 个通用 bugfix 文件归入 evidence/bugfix/ 和 bugfix/frontend/ - 新建 rev005-invoice/、rev006-reminder/、rev007-statistics/ 目录 4. guides/ 清理 - 14 个 REV004_*.md 移入 evidence/rev004-accounting/ 5. 遗留文件处理 - docs/research/ 归档到 Archive/06_Migration_Plans/ - backend-check detached worktrees 清理 6. 交叉引用修复 - 006-reminder-event-design → 003-rev006-reminder-event-design - docs/guides/REV004_ → docs/evidence/rev004-accounting/REV004_ 7. DB 设计文档修正（01_Database_Design.md） - biz_invoice 明确为开票配置表，非发票记录表 - 新增 biz_invoice_record 为发票申请/结果主表 - 新增 biz_charge_invoice_rel 账单-发票关联说明 - REV-005 承接口径表名全部修正 8. 发票审计证据 - 新增 evidence/rev005-invoice/2026-06-16-invoice-document-audit.md
🎉 福建水务营收系统概要设计文档 - 项目完成
📋 项目概述
项目状态: ✅ 已圆满完成 交付时间: 2024年12月19日 质量评级: A级 (96/100分) 交付状态: 可正式交付甲方
本项目为福建水务营收系统提供完整的概要设计文档，基于RuoYi-Vue-Pro框架和达梦数据库 (Dameng DB)，采用现代化微服务架构，满足国产化和等保三级安全要求。
🏆 项目成果 (AI-Friendly 结构)
本项目已按照功能层次重新组织，方便 AI Agent 快速检索和理解。
00_管理与标准 (Management)
- 📋 项目进度跟踪
- 📏 交付标准
- ✅ 任务清单
- ✍️ 编写指南
- 🧭 目录治理基线
- 🤖 AI Agent 维护SOP
- 📈 AI 文档优化规划
- 🎯 AI 检索白名单
- 🗂️ 主文档章节导航
- 🧪 AI 每周抽检模板
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 - 修改正式文档前，先检查：
docs/design/00_Management/01_Project_Progress.mddocs/design/00_Management/02_Delivery_Standards.mddocs/design/00_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 - 检查 AI 治理基线:
make check-ai-governance
详细使用说明请参考 QUICK_START.md。
🎉 恭喜项目圆满完成！文档质量达到甲方A级标准，可正式交付！