weichenandCursor
a3d382c6d9
Record that go vet passed and the two short-test failures are docker registry EOF, not this documentation change. Co-authored-by: Cursor <cursoragent@cursor.com>
3.4 KiB
3.4 KiB
title, status, created, updated, owner, branch, worktree, mutex
| title | status | created | updated | owner | branch | worktree | mutex |
|---|---|---|---|---|---|---|---|
| 模块解耦规范与耦合审计 | done | 2026-09-20 | 2026-09-20 | Cursor-Auto | docs/module-decoupling-spec-2026-09-20 | - | module-decoupling-spec |
模块解耦规范与耦合审计
目标
在不改业务代码、不推翻模块化单体 ADR 的前提下，交付三份可执行文档：当前耦合审计、模块开发规范（通信契约 / 输入输出接口 / 故障隔离）、分批整改计划。
范围
- 盘点 2026-09-14 / 2026-09-15 解耦基线之上的剩余耦合热点。
- 把既有契约（窄端口、领域事件、wire DTO、表唯一写者）收成开发者入口规范。
- 把整改拆成独立批次 A–G，各自带 mutex、分支示例、验收门与回滚点。
- 同步 CURRENT 认领与 FEATURE-MATRIX 规范行。
非目标
- 不改
internal/、web/、module-boundaries.yaml或迁移。 - 不把单体内端口改成 RPC，不拆微服务。
- 不修改 Cline 占用的
partial-deferred-completion-plan.md（只引用）。 - 不占用
architecture-docsmutex。 - 不把 planned 批次标成进行中或完成。
步骤
- 登记 short-term 与 CURRENT 认领。
- 写耦合审计。
- 写模块开发规范。
- 写分批整改计划。
- 同步 FEATURE-MATRIX 与 CURRENT 焦点。
- 分批
docs(...)提交，占集成槽位后--no-ff合回dev，文档-only 冒烟。
验收标准
- 审计覆盖 7 个热点，并给出文件路径证据与严重度。
- 规范明确三种通信契约、端口 checklist、故障隔离红线、新增模块/表/事件流程。
- 整改计划 A–G 各自可独立认领，互不把对方写成已完成。
- 文档落入 taxonomy，不在
.doc/根新建文件。
相关链接
- 架构: ../../system-design/2026-09-14-module-decoupling-architecture.md
- 本轮审计: ../../audit/2026-09-20-module-coupling-audit.md
- 本轮规范: ../../system-design/2026-09-20-module-development-standards.md
- 本轮批次: ../../remediation/2026-09-20-module-decoupling-batch-plan.md
- ADR: ../../adr/2026-09-14-modular-monolith-decoupling.md
- Phase 2: ../../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md
- 影响面守则: ../../remediation/2026-09-16-partial-deferred-completion-plan.md §2
- 边界清单: ../../system-design/module-boundaries.yaml
证据 / 备注
只读盘点（2026-09-20）：生产 Go 约 7.8 万行；archtest import/event 已 block 且 baseline import=0、event=0；剩余例外为 sql_write 5 + path 16。
合入 dev：133ceb45（merge: docs/module-decoupling-spec-2026-09-20）。冒烟：go vet ./... 通过。go test -short ./... 除 TestPiAgentDockerBuildContext_RunnerModulesPresent 与 TestDockerBuildContext_TemplatesDocsReadable 外均为 ok；这两例失败原因是拉取 debian:bookworm-slim 时镜像源 EOF，不是本批文档改动。槽位在记录该结果后释放。