digital-psychology/docs/ECR/ECR-001-structural-realignment.md

ECR-001

Title: 愈心谷结构对齐重构（Evidence-first · 非全仓重写）
Status: Closed
Date: 2026-08-05
Closed: 2026-08-05
Change Level: L3（治理双轨 + 结构边界）/ 实现分阶段按 L2 拆单

Change

在 不更换技术栈、不破坏 P1/P2 已发布 API 行为 的前提下，用 ESS 流程把仓库从「可运行的 P1 Complete」对齐到可长期演进的结构：双轨治理固化、超标大文件拆分、Go 域包边界澄清、词表/包名卫生、共享 packages 补强。

Motivation

见历史版本；勘察结论：现有架构冻结正确，全仓换栈/微服务重写 = 拒绝。

Scope

见 docs/ENGINEERING_SPEC/ECR-001-structural-realignment.md Phase A–F。

Acceptance Criteria

• ADR-0007（.ai/ ↔ ESS 双轨）Accepted 并写入 Profile Pointers
• ENGINEERING_SPEC + IMPLEMENTATION_PLAN 分 Phase A–F 可执行
• 每个实现 Phase 有独立 Task Contract；单 PR 单 Phase（过程中有合并提交，工件齐全）
• Phase 完成后：相关 go test / build:h5 / 既有 e2e 主路径不回归
• 超标页/引擎有明确拆分目标与「完成后行数」门槛（见 ENGINEERING_SPEC）— 目标页均 ≤400
• TRACEABILITY / CHANGELOG / STATE 已更新
• TEST_REPORT greened per Phase（Engineer）
• Docs + CHANGELOG

Residual（移出本 ECR）

• JSON 旧键 fortune / 字段 lucky 删除 → ECR-003
• SynastryLanding / useSynastryPage 贴 400 行上限 → 后续 L1
• OpenAPI schemas 补全 → 后续切片

Rollback

• 治理文档：revert docs/ + ADR commit
• 代码 Phase：git revert 该 Phase；本 ECR 无 schema 变更

Linked

• PRODUCT_SPEC / ENGINEERING_SPEC / HANDOFF / ADR-0007
• ECR-002（包名）Closed-compat → ECR-003
• TRACEABILITY: Closed