Files
wecom_it_smart_desk/docs/02-技术文档/技术架构/dependency-graph.mermaid
T
Simon facc04aa65 chore: docs 结构整改 + compose 双目录对齐(合并重建提交)
本提交为 .git 对象库损坏后的重建提交,内容等价于原先三个本地提交
(5e2fd4c2 / 57a53c98 / 5d7e1873)的累积结果,未做任何额外改动。

一、docs 结构整改(整改 #14)
根因:重构时新结构为 untracked 文件,执行 git stash(未带 -u)未纳入,
随后 git reset 拉回 HEAD 旧 tracked 树,导致旧树复活、新旧两棵目录
树并存于 docs/,共 791 文件、双分类体系冲突。

修复动作:
- b2 同名异主题文件改名迁移保全 9 个
- C 类 39 个孤立文件按主题正确归类
- A/B1 类 222 个重复文件删除(新结构已有内容副本)
- 9 个旧独有空目录删除
- 270 处内部引用按 verified 映射改写
- 整改记录 #14 登记于 04-运维文档/部署运维

结果:docs 791 → 569 文件,顶层仅规范 8 类 + 治理文件,单树恢复。
残留:约 20 处指向从未存在文件的陈旧死链,归入独立文档卫生任务。

二、compose 双目录对齐(消除踩坑 A)
- docker-compose.yml:nginx 前端挂载全部由根目录 frontend-*/dist
  改为 src/frontend-*/dist(h5 / agent / admin / terminal)
- docker-compose.dev.yml:dev 服务 build context 与卷同步改 src/
- 效果:本地 docker compose up 不再把根目录 stale dist 挂回,
  与线上一致,分叉隐患消除(已 docker compose config 校验通过)

防复发铁律:
- 重构须提交;仓库修复须 git stash -u 或先 commit
- 新结构须 git add 并提交,避免再次 untracked 复活
- H5 改动只动 src/frontend-h5/,禁改根目录遗留 frontend-*/
2026-08-07 22:31:32 +08:00

68 lines
2.0 KiB
Plaintext

%% 模块依赖关系图
%% 来源:增量设计-知识库迭代-开发任务分解-20260712.md §9
graph TB
subgraph "T01: 项目基础设施"
DB[数据库迁移<br/>3张新表]
CFG[config.py<br/>新增配置项]
MODEL[ORM 模型<br/>3个]
SCHEMA[Pydantic Schema<br/>2个文件]
ROUTER[router.py<br/>路由注册]
end
subgraph "T02: 分诊交互模块"
TRI_API[分诊 API<br/>12个端点]
TRI_SVC[TriageService<br/>+ DifyTriageService]
H5_FE[H5 前端<br/>TriageCard + useTriage]
AG_FE[坐席端前端<br/>TriageDashboard + 3组件]
DIFY_APP[Dify 分诊应用<br/>Prompt + 配置]
end
subgraph "T03: 拓扑预览模块"
TOPO_FE[管理后台前端<br/>TopologyPreview + 3组件]
TOPO_API[复用已有<br/>GET /graph]
end
subgraph "T04: 代答排除模块"
EXC_API[排除管理 API<br/>8个端点]
EXC_SVC[ExclusionService<br/>+ 4个Matcher]
EXC_FE[管理后台前端<br/>ExclusionRules + 2组件]
MSG_INT[消息流集成<br/>ai_handler.py]
end
%% 依赖关系
DB --> TRI_API
DB --> EXC_API
CFG --> TRI_SVC
MODEL --> TRI_API
MODEL --> EXC_API
SCHEMA --> TRI_API
SCHEMA --> EXC_API
ROUTER --> TRI_API
ROUTER --> EXC_API
TRI_API --> TRI_SVC
TRI_SVC --> H5_FE
TRI_SVC --> AG_FE
TRI_SVC --> DIFY_APP
EXC_API --> EXC_SVC
EXC_SVC --> EXC_FE
EXC_SVC --> MSG_INT
%% 软依赖
TRI_SVC -.->|"CategoryMatcher<br/>软依赖分诊结果"| EXC_SVC
%% 拓扑预览独立
TOPO_FE --> TOPO_API
%% 并行标注
style TOPO_FE fill:#e8f5e9,stroke:#4caf50,stroke-dasharray: 5 5
style TOPO_API fill:#e8f5e9,stroke:#4caf50,stroke-dasharray: 5 5
style DB fill:#e3f2fd,stroke:#2196f3
style CFG fill:#e3f2fd,stroke:#2196f3
style MODEL fill:#e3f2fd,stroke:#2196f3
style SCHEMA fill:#e3f2fd,stroke:#2196f3
style ROUTER fill:#e3f2fd,stroke:#2196f3