tangweijie
1b6fda9c4d
The evidence captures the new regression scripts, formal-first query narrowing, and the fresh verification trail used to support the next round of fallback removal. Constraint: Evidence must match commands and outcomes actually executed in backend worktree Rejected: Fold this into an older summary doc | would hide the stepwise proof for fallback reduction Confidence: high Scope-risk: narrow Reversibility: clean Directive: Keep appending fresh verification evidence here until the remaining legacy fallback is either removed or explicitly retained Tested: Evidence cross-checked against backend worktree commands, regression logs, and targeted test outputs Not-tested: No doc export/render pipeline executed
🎉 福建水务营收系统概要设计文档 - 项目完成
📋 项目概述
项目状态: ✅ 已圆满完成 交付时间: 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级标准，可正式交付！