# 模块化方案（自我批判版）

## "4 盒子 1 铁律"有什么问题

### 问题 1：读写路径不对称

```
读：Web → API → Core(metrics_store) → DB    ← 铁律覆盖了
写：sync_mercury → DB                        ← 铁律管不了
写：rules_ads → ads_recommendations          ← 铁律管不了
写：routes → report_defs / mcp_keys 等       ← 铁律管不了
```

"API 不写 SQL"只解决了**读**的问题。**写**有多条路径各自为政，这才是最大的漏洞。

### 问题 2：Core 内部职责混杂

```
Core = metrics_store(只读查询) + rules_ads(写建议) + sync_mercury(跨系统同步)
```

三个东西完全不同：
- metrics_store 是纯函数：输入参数 → 查 DB → 返回结果
- rules_ads 是状态机：读数据 → 生成建议 → 写表
- sync_mercury 是管道：SSH 拉远端 → 转换 → 写本地

放在一个"Core"里掩盖了它们的差异。

### 问题 3：审计是横切但不在任何盒子里

four_layer_audit 读全部层、不服务于业务、不暴露 HTTP。4 盒子模型没有它的位置。

---

## 那什么是对的？

**取决于团队规模和系统阶段：**

| 阶段 | 团队 | 正确架构 |
|---|---|---|
| 现在 | 1人+AI | 4盒子够了（简单可执行） |
| 6个月后 | 3-5人 | 需要显式模块契约 |
| 1年后 | 10人 | 领域驱动设计 |

**现在最优解不是完美架构，而是：**

1. **铁律简化为一句**："所有 SQL 只存在于 3 个文件里（metrics_store / rules_ads / sync_mercury）"
2. **不建更多层**——现有四层审计 + 回归检查已经监控住了
3. **让代码自己证明**——metrics_store 接口逐步覆盖高频查询，旧的内联 SQL 改哪个顺手迁哪个

**为什么不做更完美的架构？**

因为架构的代价是认知开销。1 人团队 + 每天大量功能迭代的场景下：
- 过度架构 → 没人遵守 → 形同虚设
- 不足架构 → bug 复发 → 今天的教训

**刚好够用的架构才是最优解。** 今天立的"SQL 只在 3 个文件"这个约束，加上回归检查每日监控，已经把 4849 这类 bug 的复发概率降到接近零。再多的结构是给未来团队准备的，等团队到了再建不迟。

---

## 一句话总结

> **不要设计你不需要的架构。当前的瓶颈不是架构不够好，是旧代码还没迁移完。先迁移，再演进。**
