TLK 云订货 ERP — 架构图

tlk-groups · 2026-10-05 · 只读探索，不改代码 · Go 1.25 + React 19 + PostgreSQL 16

65
internal 包（含 testsim / testutil）
≈195 · 0 环
包间 import 边（非测试；口径不同为 194–196）· SCC 检测无环
63 / 61
PRD.md 数 / 含 sqlc queries 的包数
57 · 192
ADR 文件 · Atlas 迁移文件（schema 21 份）
技术架构进入整页 →

系统怎么搭、请求怎么走、事务怎么保

面向开发与评审：进程与中间件、模块依赖、数据与租户隔离、事务边界、测试与治理。

T1系统全景端 × 进程 × 基础设施T2请求链路11 层：中间件 → handler → module → 数据库T3模块拓扑65 个包的真实 import 深度、被依赖热点T4数据与租户三层模型 · 四道租户防线 · 迁移工具链T5事务与异步一单终审 = 一个事务；NATS 与定时任务T6质量护栏PRD → ADR → 测试 → 审查矩阵
业务架构进入整页 →

业务怎么流转、单据怎么联动

面向产品与业务：销售、采购、仓储成本、财务闭环、商城，以及审批 / 权限 / 期间等横切机制。

B1业务价值链各业务域与 Non-GoalsB2销售链报价 → 订单 → 出库 → 收款 · 退货B3采购链申请 → 订单 → 入库 → 付款 · 直运B4仓储与成本库存唯一写入方、6 种成本方式、关账B5财务闭环往来 → 核销 → 出纳 → 总账B6商城与多端先付后出库、促销与支付B7横切机制审批、权限、期间、编号、红冲
桥 X1

业务 × 技术对照矩阵

13 行：业务域 · 单据号 · 拥有模块与依赖深度 · 主要表 · 终审同事务副作用 · import。技术路线与业务路线在这里接上。

 观察

漂移与待裁决点

核对后的偏离已裁决（2026-10-05）：Append-Only 与缓存纪律改文档；直运成本 #412、盘点原子性 #413、乐观锁 #414、下单幂等键 #415、负毛利守卫 #416 已立 issue；待裁决仅余 item→inventory 上行依赖。
这些图依据什么（2026-10-05）

484 条可证伪论断已由 4 个 Codex worker 逐条对照「页面 ↔ 代码 ↔ 文档」：一致 372 / 部分一致 76 / 不一致 36；controller 抽查并复跑证据。不一致与部分一致均已按代码现实订正页面；代码偏离 PRD / ADR 或 SSOT 的项在页面中以红字标出，并汇总于观察页（待你裁决）。实测内容（模块依赖深度、扇入、计数、终审 tx 分类）来自 import 扫描与 Codex 只读核实；需要真实 PG / 运行时才能确认的点（例如直运在实际租户策略下的最终成本）不在静态核对范围内。

分项：技术页 160 条（119 / 23 / 18）· 销售与商城 64 条（53 / 9 / 2）· 采购与仓储成本 92 条（57 / 29 / 6）· 财务与横切 168 条（143 / 15 / 10）。（对照页的行已计入业务各项。）

怎么读
1 先看技术 T1–T3

知道有哪些进程、模块怎么分带，再进入细节。

2 再看业务 B1–B5

从价值链到销售 / 采购 / 库存成本 / 财务四条主链。

3 用对照矩阵连起来

任何业务概念都能落到模块、表和事务副作用。

4 最后看观察

哪些文档与代码对不上、哪些点待你裁决。

Mermaid 图较宽时，点击图可放大 / 还原。