乐橙智康文档矩阵

状态定义：

• 可交付：内容、截图、验证方式和关键来源已完成。
• 维护中：内容可用于交接，但会随源码、截图、API、数据库或部署事实继续同步。
• 内部：包含工程交接细节，需要访问控制。
• 公开：可以脱敏后放在公开文档中心。

板块	文档	路径	状态	建议可见性	主要来源
开始	文档中心首页	/	可交付	公开	文档站结构、产品与工程索引
开始	文档生产规范	/WRITING_GUIDE	维护中	内部	文档生产规则
开始	来源映射	/SOURCE_MAP	可交付	内部	代码映射、生产只读事实
产品总览	产品与能力总览	/product/	可交付	公开	官网、README、架构总览
产品总览	当前覆盖范围与参考层边界	/product/status	可交付	内部	文档矩阵、站点现状、运行事实
App 页面	页面总览与截图索引	/app-pages/	可交付	内部	Flutter screens、截图
App 页面	主流程与跳转关系	/app-pages/main-flow	可交付	内部	Flutter MaterialApp/routes/onGenerateRoute/Navigator
App 页面	核心页面详解	/app-pages/core-pages	可交付	内部	Flutter screens、截图
App 页面	页面状态与交互规范	/app-pages/interaction-states	可交付	内部	Flutter BLoC、screens
App 页面	视觉风格与组件规范	/app-pages/visual-style	可交付	内部	home.html、Flutter theme、截图
系统架构	架构总览	/architecture/	可交付	内部	.docs/architecture/fitdoc-system-architecture-overview.md
系统架构	边界与主链	/architecture/boundaries	可交付	内部	main/bootstrap/runtime/use_cases、Flutter main/BLoC
系统架构	测试护栏与演进落点	/architecture/test-and-evolution	可交付	内部	backend tests、Flutter tests、架构总览
前端工程	前端总览	/frontend/	可交付	内部	apps/flutter_app/
前端工程	Flutter 架构	/frontend/app-architecture	可交付	内部	lib 目录
前端工程	路由与页面实现	/frontend/route-map	可交付	内部	MaterialApp/routes/onGenerateRoute/Navigator
前端工程	BLoC 状态管理	/frontend/state-management	可交付	内部	lib/bloc/
前端工程	API Client 与数据流	/frontend/api-client-data-flow	可交付	内部	lib/api/、lib/bloc/
前端工程	测试与替换点	/frontend/tests-replacement-points	可交付	内部	Flutter tests、架构总览
后端	后端总览	/backend/	可交付	内部	apps/backend_service/
后端	服务架构	/backend/architecture	可交付	内部	FastAPI app、架构总览
后端	入口与运行时装配	/backend/runtime-boundary	可交付	内部	app/main.py、app/bootstrap.py、app/runtime.py
后端	Use Case 边界	/backend/use-cases	可交付	内部	app/use_cases/
后端	模块边界	/backend/modules	可交付	内部	routers/services/repos
后端	核心链路	/backend/core-flows	可交付	内部	auth/chat/sport 等
数据库	数据库总览	/database/	可交付	内部	生产 RDS catalog、ORM、Alembic、运维手册
数据库	核心业务表	/database/core-business-tables	可交付	内部	生产 RDS catalog、ORM、repositories、use cases
数据库	知识库与 RAG 表	/database/knowledge-rag-tables	可交付	内部	RAG topology、knowledge files、production catalog
数据库	ER 模型与表关系	/database/er-model	可交付	内部	生产 RDS constraints/indexes、SQLAlchemy/Alembic
数据库	核心数据流	/database/data-flow	可交付	内部	API、use cases、services、repositories
AI/RAG	AI 链路总览	/ai-rag/	可交付	内部	runtime gateway、RAG package、LLM clients、生产运行开关
AI/RAG	RAG 专项边界	/ai-rag/rag-boundary	可交付	内部	runtime/bootstrap/gateway、Chat/Prescription use case、RAG topology tests
AI/RAG	LLM 调用链路	/ai-rag/llm-chain	可交付	内部	llm_config、llm_manager、OpenAI-compatible client、Spark client
AI/RAG	RAG 检索链路	/ai-rag/rag-engine	可交付	内部	RAG package、knowledge_chunks、reranker、hybrid contract tests
AI/RAG	Prompt 契约	/ai-rag/prompt-contract	可交付	内部	response_generation、prescription_generation、Chat/Prescription use case
AI/RAG	安全过滤	/ai-rag/safety-filter	可交付	内部	safety_filter、safety_engine、safety_rules、Chat use case tests
API	API 总览	/api/	可交付	内部	routers/schemas/tests、Flutter clients、DB touchpoints
API	认证 API	/api/auth	可交付	内部	auth router、AuthService、Flutter auth client
API	用户 API	/api/user	可交付	内部	user router、UserService、avatar storage
API	聊天 API	/api/chat	可交付	内部	chat router、SendChatMessageUseCase、DialogueRepository
API	处方 API	/api/prescription	可交付	内部	prescription router/use cases、PrescriptionService
API	评估 API	/api/assessment	可交付	内部	assessment router/use cases、assessment schemas
API	安全 API	/api/safety	可交付	内部	safety router/core、risk assessment
API	陪伴 API	/api/companion	可交付	内部	companion router/use case、CompanionService
API	运动 API	/api/sport	可交付	内部	sport router、SportService、Flutter sport/history clients
API	错误码与鉴权	/api/errors	可交付	内部	auth dependency、routers、Flutter error handling
部署运行	部署与运行总览	/operations/	可交付	内部	运维手册、ECS 只读运行事实、架构总览
部署运行	部署拓扑	/operations/deployment	可交付	内部	ECS/Nginx/systemd、端口与路由核验
部署运行	本地运行	/operations/local-run	可交付	内部	AGENTS、项目命令、package/config
部署运行	线上部署流程	/operations/production-deploy	可交付	内部	运维手册、部署事实、构建命令
部署运行	环境变量说明	/operations/env-vars	可交付	内部	.env.example、Settings、生产非敏感 key 列表
部署运行	安装包打包流程	/operations/app-package-build	可交付	内部	Flutter project、Gradle、AGENTS
部署运行	常见问题与排查	/operations/faq-troubleshooting	可交付	内部	运维手册、ECS 只读运行事实、脚本入口