外观
乐橙智康文档来源映射
本文件用于让后续维护者快速找到事实来源。正式文档中的结构、接口、表字段和运行事实应优先回到源码、配置、迁移、测试、截图或生产只读元数据。
产品与页面来源
| 来源 | 对应文档 | 待提取内容 |
|---|---|---|
home.html | /product/、/app-pages/visual-style | 官网表达、主色、字体栈、导航与卡片风格 |
README.md | /product/ | 项目总览、模块说明 |
apps/flutter_app/lib/screens/ | /app-pages/、/app-pages/core-pages | 页面清单、截图、用户路径 |
apps/flutter_app/lib/main.dart | /app-pages/main-flow、/frontend/route-map、/architecture/boundaries | 应用入口、全局 provider、MaterialApp/routes/onGenerateRoute/Navigator |
docs_site/public/images/screenshots/ | /app-pages/、/app-pages/core-pages、/app-pages/visual-style | App 页面截图、组件状态截图 |
前端工程来源
| 来源 | 对应文档 | 待提取内容 |
|---|---|---|
apps/flutter_app/lib/bloc/ | /frontend/state-management、/app-pages/interaction-states | BLoC 列表、事件、状态、页面依赖 |
apps/flutter_app/lib/api/ | /frontend/api-client-data-flow、/api/ | API client、鉴权、错误处理、数据流 |
apps/flutter_app/lib/config/theme/ | /app-pages/visual-style | Flutter theme、颜色、排版、组件风格 |
docs/UI_DEV_STANDARD.md | /app-pages/visual-style | UI token、组件约束、设计系统落地规则 |
docs/UX_INTERACTION_AUDIT.md | /app-pages/visual-style、/app-pages/interaction-states | UX 审计口径、动效与情绪设计现状、模块级交互观察 |
apps/flutter_app/test/ | /frontend/tests-replacement-points、/architecture/test-and-evolution | Flutter 架构护栏和验收测试 |
后端来源
| 来源 | 对应文档 | 待提取内容 |
|---|---|---|
apps/backend_service/app/main.py | /backend/architecture、/backend/runtime-boundary | FastAPI thin entrypoint |
apps/backend_service/app/bootstrap.py | /backend/runtime-boundary、/architecture/boundaries | create_app、route registration、CORS、static |
apps/backend_service/app/runtime.py | /backend/runtime-boundary、/architecture/boundaries | settings/session/db/rag/storage resolver |
apps/backend_service/app/use_cases/ | /backend/use-cases、/architecture/test-and-evolution | 主链业务编排和扩展落点 |
apps/backend_service/app/api/ | /backend/modules、/api/ | API 模块、接口路径、请求响应 |
apps/backend_service/app/services/ | /backend/core-flows | 业务服务边界 |
apps/backend_service/app/repositories/ | /database/data-flow | 数据访问路径 |
apps/backend_service/app/core/ | /ai-rag/、/operations/ | RAG、LLM、安全过滤、配置 |
apps/backend_service/app/core/rag_runtime_gateway.py | /ai-rag/、/ai-rag/rag-boundary | RAG 生产 runtime gateway、兼容委托入口、业务层入口收敛 |
apps/backend_service/app/core/rag/ | /ai-rag/rag-engine、/ai-rag/rag-boundary | query understanding、retrieval orchestration、rerank、evidence policy、context formatting、response/prescription generation |
apps/backend_service/app/external/ | /ai-rag/llm-chain | LLM manager、OpenAI-compatible client、Spark WebSocket client |
apps/backend_service/tests/ | /architecture/test-and-evolution | 后端架构护栏和验收测试 |
API 来源
| 来源 | 对应文档 | 待提取内容 |
|---|---|---|
apps/backend_service/app/bootstrap.py | /api/、/api/errors | router include prefix、debug route 注册条件、非 /api/v1 路径事实 |
apps/backend_service/app/api/auth.py、auth_dependencies.py | /api/auth、/api/errors | 认证接口、JWT 解析、401 语义、短信与登录错误 |
apps/backend_service/app/api/user.py、app/services/user_service.py | /api/user | 用户档案、健康指标、疾病史、手术史、头像接口与归属校验 |
apps/backend_service/app/api/chat.py、app/use_cases/chat/send_message.py | /api/chat | 会话、历史、消息发送、幂等、RAG/LLM/safety 主链 |
apps/backend_service/app/api/prescription.py、app/use_cases/prescription/ | /api/prescription | 处方生成、当前处方、替换、Demo 处方、处方卡写回 |
apps/backend_service/app/api/sport.py、app/services/sport_service.py | /api/sport | 运动日志、MET、日历、周报、历史、自定义运动、方案校验 |
apps/backend_service/app/api/assessment.py、app/schemas/assessment.py | /api/assessment | G1-M3 安全检查、R1-R11 完整评估、最近评估读取 |
apps/backend_service/app/api/safety.py、app/core/safety_filter.py、app/services/risk_assessment.py | /api/safety | 内容安全、风险评估、安全指南、事件报告持久化边界 |
apps/backend_service/app/api/companion.py、app/use_cases/companion/get_health_overview.py | /api/companion | 陪伴状态、外观、健康总览、debug route 生产边界 |
apps/flutter_app/lib/api/ | /api/、/api/errors | Flutter 实际请求路径、token 注入、错误处理、前后端契约差异 |
apps/backend_service/tests/api/、apps/backend_service/tests/use_cases/、apps/flutter_app/test/api/ | /api/ | endpoint contract、use case contract、Flutter client contract |
数据库与 RAG 来源
| 来源 | 对应文档 | 待提取内容 |
|---|---|---|
生产 RDS core_base 只读 catalog | /database/、/database/core-business-tables、/database/knowledge-rag-tables、/database/er-model | alembic_version、extensions、public tables、columns、constraints、indexes、row estimates |
apps/backend_service/app/models/ | /database/core-business-tables、/database/knowledge-rag-tables、/database/er-model | ORM 模型、表名、字段、关系、RAG canonical/legacy 模型 |
apps/backend_service/alembic/versions/ | /database/core-business-tables、/database/knowledge-rag-tables、/database/er-model、/operations/deployment | schema 迁移来源、索引、timestamp/date 语义收口、RAG 表迁移 |
apps/backend_service/app/repositories/ | /database/data-flow、/api/ | 数据读写路径、查询条件、索引使用意图 |
apps/backend_service/app/use_cases/、apps/backend_service/app/services/ | /database/data-flow、/api/、/ai-rag/ | Chat、处方、评估、用户档案、运动执行的数据编排 |
apps/backend_service/app/core/rag/persistence_topology.py | /database/knowledge-rag-tables、/ai-rag/rag-boundary | knowledge_chunks canonical 主表与 legacy RAG 表边界 |
apps/backend_service/app/core/rag/knowledge_chunk_search.py | /database/knowledge-rag-tables、/ai-rag/rag-engine | knowledge_chunks DB-native 检索、pipeline scope、embedding 查询 |
apps/backend_service/app/core/rag/retrieval_orchestration.py | /ai-rag/rag-engine | hybrid 主链：query understanding、retrieval、rerank、evidence、context、LLM |
apps/backend_service/app/core/rag/reranker.py | /ai-rag/rag-engine | DashScope rerank、timeout fallback、circuit breaker |
apps/backend_service/app/core/rag/evidence_policy.py、context_formatter.py | /ai-rag/rag-engine | evidence selection、compact context |
apps/backend_service/app/core/rag/response_generation.py、prescription_generation.py | /ai-rag/llm-chain、/ai-rag/rag-boundary | Chat 回复生成、处方生成、LLM fallback 与处方安全检查 |
apps/backend_service/app/core/rag/response_generation.py | /ai-rag/prompt-contract | Chat system prompt、患者画像摘要、RAG user message、知识不足 fallback |
apps/backend_service/app/core/rag/prescription_generation.py | /ai-rag/prompt-contract | 处方 system prompt、用户档案约束注入、JSON 输出约束、处方解析和默认兜底 |
apps/backend_service/app/core/safety_filter.py、safety_engine.py、safety_rules.py、safety_policy.py | /ai-rag/safety-filter、/api/safety、/api/assessment | Chat 内容安全、红黄绿规则、处方安全检查 |
apps/backend_service/app/core/llm_config.py、apps/backend_service/app/external/llm_manager.py | /ai-rag/llm-chain | provider/model 配置、运行时凭据注入、client 动态加载 |
生产 ECS /opt/fitdoc/backend/.env 非敏感白名单开关 | /ai-rag/、/ai-rag/rag-engine、/ai-rag/llm-chain | RAG_PIPELINE_VERSION、RAG_ENABLE_RERANK、LLM_PROVIDER 等运行开关；不登记密钥或连接串 |
apps/backend_service/tests/rag/、tests/core/test_rag_entrypoint_contract.py、tests/test_rag_hybrid_contract.py | /ai-rag/、/ai-rag/rag-boundary、/ai-rag/rag-engine | RAG runtime gateway、hybrid contract、rerank、evidence、context formatter 测试 |
docs/数据库架构.md | /database/、/database/core-business-tables、/database/knowledge-rag-tables | 2026-04-29 生产 schema 快照与 postflight 记录 |
knowledge/*.xlsx | /database/knowledge-rag-tables、/ai-rag/rag-engine | RAG 原始知识库文件、知识导入来源 |
架构治理来源
| 来源 | 对应文档 | 待提取内容 |
|---|---|---|
.docs/architecture/fitdoc-system-architecture-overview.md | /architecture/、/backend/、/frontend/、/database/、/operations/ | 主业务闭环、架构边界、测试护栏、开发落点 |
.docs RAG 专项治理记录 | /ai-rag/rag-boundary、/ai-rag/rag-engine | RAG 专项边界和当前口径 |
部署运行来源
| 来源 | 对应文档 | 待提取内容 |
|---|---|---|
docs/新服务器运维手册.md | /operations/、/operations/deployment、/operations/production-deploy | 生产拓扑、服务管理、排障命令 |
AGENTS.md | /operations/local-run、/operations/app-package-build | 项目级命令和运行约束 |
apps/backend_service/.env.example | /operations/env-vars | 环境变量清单，必须脱敏 |
生产 ECS systemctl show fitdoc-core 只读输出 | /operations/、/operations/deployment、/operations/production-deploy | fitdoc-core.service 工作目录、环境文件、运行用户、127.0.0.1:8001 启动命令 |
生产 ECS /etc/nginx/sites-enabled/fitdoc 只读配置 | /operations/deployment、/operations/production-deploy、/operations/faq-troubleshooting | /、/uploads/、/static/videos/、/api、/health、/docs、/openapi.json 路由归属 |
生产 ECS ss -tlnp 与 systemctl is-active/is-enabled 只读检查 | /operations/、/operations/deployment、/operations/faq-troubleshooting | 当前 active/enabled 服务、监听端口、8000/8002 非活动事实 |
生产 ECS /opt/fitdoc/backend/.env 非敏感 key 列表 | /operations/env-vars、/ai-rag/ | 运行环境变量名称清单；不登记真实值 |
docs_site/package.json、docs_site/.vitepress/config.ts | /operations/local-run、/operations/production-deploy、/operations/faq-troubleshooting | VitePress 命令、构建产物、base: '/doc-center/' 与生产 /docs FastAPI 文档边界 |
apps/backend_service/app/core/config.py | /operations/env-vars、/operations/faq-troubleshooting | Settings 字段、默认值、CORS、RAG、LLM、OSS、视频资源配置 |
apps/backend_service/scripts/README.md | /operations/production-deploy、/operations/faq-troubleshooting | RAG guardrails、知识导入、维护脚本、生产检查脚本入口 |
apps/flutter_app/lib/config/environment_config.dart | /operations/local-run、/operations/env-vars、/operations/app-package-build、/operations/faq-troubleshooting | Flutter --dart-define、API base URL、视频资源 base URL、环境选择 |
apps/flutter_app/pubspec.yaml | /operations/app-package-build | App 版本、依赖、资源声明 |
apps/flutter_app/android/app/build.gradle.kts | /operations/app-package-build、/operations/faq-troubleshooting | Android applicationId、NDK、release signing 当前边界 |