diff --git a/.ai/architecture/go-services.md b/.ai/architecture/go-services.md
index 45c2361..2f65284 100644
--- a/.ai/architecture/go-services.md
+++ b/.ai/architecture/go-services.md
@@ -31,7 +31,7 @@
`internal/handler/`:每域一组 handler,只做 bind/validate/调用 service。
`internal/repository/`:SQL;无 business unlock 规则(规则在 service/report + membership)。
-星座周期展望引擎包:`internal/star/outlook`(原 `fortune`,ECR-002)。对外 JSON 暂双写 `fortune`/`outlook` 键以兼容旧客户端。
+星座周期展望引擎包:`internal/star/outlook`(原 `fortune`,ECR-002)。对外 JSON 仅 `outlook` / `outlook_detail`;周期提示字段为 `boost`(ECR-003 已移除 `fortune`/`lucky` 兼容键)。
---
diff --git a/apps/api/internal/integration/p2_flows_test.go b/apps/api/internal/integration/p2_flows_test.go
index 672a66c..4a2dd2e 100644
--- a/apps/api/internal/integration/p2_flows_test.go
+++ b/apps/api/internal/integration/p2_flows_test.go
@@ -78,8 +78,11 @@ func TestFlowStarDeepAccess(t *testing.T) {
if sum["headline"] == nil || sum["headline"] == "" {
t.Fatalf("missing headline: %#v", sum)
}
- if sum["fortune"] == nil || sum["planets"] == nil {
- t.Fatalf("expected fortune+planets in star summary: %#v", sum)
+ if sum["outlook"] == nil || sum["planets"] == nil {
+ t.Fatalf("expected outlook+planets in star summary: %#v", sum)
+ }
+ if sum["fortune"] != nil {
+ t.Fatal("legacy fortune key must be removed (ECR-003)")
}
reportID := rep["id"].(string)
diff --git a/apps/api/internal/star/engine.go b/apps/api/internal/star/engine.go
index 2447a60..36fd348 100644
--- a/apps/api/internal/star/engine.go
+++ b/apps/api/internal/star/engine.go
@@ -70,6 +70,7 @@ func BuildWith(opts BuildOpts) (Output, error) {
}
fort := outlook.Build(chart, asOf)
daily := fort.Daily
+ fortMap := fort.AsMap()
planetsOut := make([]map[string]any, 0, len(chart.Planets))
for _, p := range chart.Planets {
@@ -114,10 +115,8 @@ func BuildWith(opts BuildOpts) (Output, error) {
},
"planets": planetsOut,
"aspects_preview": aspectPreview,
- // "fortune" kept for client compat; prefer "outlook" (ECR-002).
- "fortune": fort.AsMap(),
- "outlook": fort.AsMap(),
- "transits": fort.AsMap()["transits"],
+ "outlook": fortMap,
+ "transits": fortMap["transits"],
"daily_soft": map[string]any{
"title": daily.Title, "focus": daily.Focus, "tip": daily.Tip,
"energy": daily.Score, "note": daily.Label, "score": daily.Score, "label": daily.Label,
@@ -152,9 +151,9 @@ func BuildWith(opts BuildOpts) (Output, error) {
section("年运详解", fort.Yearly.Tip+" "+fort.Yearly.Caution, []string{
fmt.Sprintf("综合分 %d(%s)", fort.Yearly.Score, fort.Yearly.Label),
fmt.Sprintf("感情 %d · 事业 %d · 财务 %d · 心情 %d", fort.Yearly.Dims["love"], fort.Yearly.Dims["career"], fort.Yearly.Dims["money"], fort.Yearly.Dims["mood"]),
- fort.Yearly.Lucky,
+ fort.Yearly.Boost,
}),
- section("一生运势", fort.Lifetime.Tip, []string{fort.Lifetime.Caution, fort.Lifetime.Lucky}),
+ section("一生运势", fort.Lifetime.Tip, []string{fort.Lifetime.Caution, fort.Lifetime.Boost}),
section("关系互动", pack.RelationDeep, pack.RelationBullets),
section("事业与学习节奏", pack.CareerDeep, pack.CareerBullets),
section("成长方向", pack.GrowthDeep, pack.GrowthBullets),
@@ -171,8 +170,7 @@ func BuildWith(opts BuildOpts) (Output, error) {
"behavior_pattern": pack.SunDeep,
"relation_style": pack.RelationDeep,
"growth_direction": pack.GrowthDeep,
- "fortune_detail": fort.AsMap(), // compat
- "outlook_detail": fort.AsMap(),
+ "outlook_detail": fortMap,
}
return Output{Summary: summary, Detail: detail}, nil
}
diff --git a/apps/api/internal/star/engine_test.go b/apps/api/internal/star/engine_test.go
index e111949..f0bb3d1 100644
--- a/apps/api/internal/star/engine_test.go
+++ b/apps/api/internal/star/engine_test.go
@@ -25,8 +25,11 @@ func TestBuildDeterministic(t *testing.T) {
if a.Summary["sun_sign"] == nil || a.Detail["sections"] == nil {
t.Fatal("missing fields")
}
- if a.Summary["sign_cards"] == nil || a.Summary["fortune"] == nil || a.Summary["planets"] == nil {
- t.Fatal("missing sign_cards, fortune or planets")
+ if a.Summary["sign_cards"] == nil || a.Summary["outlook"] == nil || a.Summary["planets"] == nil {
+ t.Fatal("missing sign_cards, outlook or planets")
+ }
+ if a.Summary["fortune"] != nil {
+ t.Fatal("legacy fortune key must be removed (ECR-003)")
}
if a.Summary["aspects_preview"] == nil {
t.Fatal("missing aspects_preview")
@@ -66,18 +69,30 @@ func TestBuildWithBirthTimeChangesRise(t *testing.T) {
_ = b.Summary["rise_sign"]
}
-func TestBuildFortuneScores(t *testing.T) {
+func TestBuildOutlookScores(t *testing.T) {
birth := time.Date(1990, 5, 12, 0, 0, 0, 0, time.UTC)
out, err := BuildWith(BuildOpts{Birth: birth, Name: "测", AsOf: time.Date(2026, 1, 1, 0, 0, 0, 0, time.UTC)})
if err != nil {
t.Fatal(err)
}
- fort, ok := out.Summary["fortune"].(map[string]any)
+ bundle, ok := out.Summary["outlook"].(map[string]any)
if !ok {
- t.Fatal("fortune missing")
+ t.Fatal("outlook missing")
}
- daily, ok := fort["daily"].(map[string]any)
+ daily, ok := bundle["daily"].(map[string]any)
if !ok || daily["score"] == nil {
t.Fatal("daily score missing")
}
+ if daily["lucky"] != nil {
+ t.Fatal("legacy lucky key must be removed")
+ }
+ if daily["boost"] == nil {
+ t.Fatal("boost missing")
+ }
+ if out.Detail["fortune_detail"] != nil {
+ t.Fatal("legacy fortune_detail must be removed")
+ }
+ if out.Detail["outlook_detail"] == nil {
+ t.Fatal("outlook_detail missing")
+ }
}
diff --git a/apps/api/internal/star/outlook/outlook.go b/apps/api/internal/star/outlook/outlook.go
index 5444e7c..569c60b 100644
--- a/apps/api/internal/star/outlook/outlook.go
+++ b/apps/api/internal/star/outlook/outlook.go
@@ -9,7 +9,7 @@ import (
"github.com/yuxingu/digital-psychology/apps/api/internal/star/natal"
)
-// Period is one fortune block.
+// Period is one outlook block (daily…lifetime).
type Period struct {
Key string `json:"key"`
Title string `json:"title"`
@@ -17,7 +17,7 @@ type Period struct {
Label string `json:"label"`
Dims map[string]int `json:"dims"`
Tip string `json:"tip"`
- Lucky string `json:"lucky"`
+ Boost string `json:"boost"` // soft accent tip (was lucky; ECR-003)
Caution string `json:"caution"`
Focus string `json:"focus"`
}
@@ -40,7 +40,7 @@ type Bundle struct {
Transits []Transit `json:"transits"`
}
-// Build returns fortune for natal chart as of asOf (date matters).
+// Build returns period outlook for natal chart as of asOf (date matters).
func Build(chart natal.Chart, asOf time.Time) Bundle {
if asOf.IsZero() {
asOf = time.Now()
@@ -118,7 +118,7 @@ func lifetime(chart natal.Chart) Period {
"money": 48 + (seed*5)%42, "mood": 55 + (seed*7)%35,
},
Tip: tip, Focus: "人生阶段",
- Lucky: "长期复盘 · 边界清晰",
+ Boost: "长期复盘 · 边界清晰",
Caution: "避免把阶段标签当成宿命;可调整节奏与选择。",
}
}
@@ -197,7 +197,7 @@ func period(key, title string, seed int, sun, moon float64, chart natal.Chart, f
"love": love, "career": career, "money": money, "mood": mood,
},
Tip: tips[i], Focus: focuses[i%len(focuses)],
- Lucky: luckyFrom(seed),
+ Boost: boostFrom(seed),
Caution: cautionFrom(seed, chart),
}
}
@@ -205,19 +205,19 @@ func period(key, title string, seed int, sun, moon float64, chart natal.Chart, f
func scoreLabel(s int) string {
switch {
case s >= 85:
- return "大吉"
+ return "高能"
case s >= 75:
- return "吉"
+ return "顺畅"
case s >= 65:
- return "中平偏吉"
+ return "偏顺"
case s >= 55:
return "平稳"
default:
- return "需谨慎"
+ return "宜缓行"
}
}
-func luckyFrom(seed int) string {
+func boostFrom(seed int) string {
colors := []string{"红色", "金色", "蓝色", "绿色", "紫色", "白色"}
nums := []string{"3", "6", "7", "8", "9"}
return colors[seed%len(colors)] + " · 数字 " + nums[seed%len(nums)]
@@ -256,6 +256,6 @@ func (b Bundle) AsMap() map[string]any {
func periodMap(p Period) map[string]any {
return map[string]any{
"key": p.Key, "title": p.Title, "score": p.Score, "label": p.Label,
- "dims": p.Dims, "tip": p.Tip, "lucky": p.Lucky, "caution": p.Caution, "focus": p.Focus,
+ "dims": p.Dims, "tip": p.Tip, "boost": p.Boost, "caution": p.Caution, "focus": p.Focus,
}
}
diff --git a/apps/user-h5/src/components/star/StarFortunePanel.vue b/apps/user-h5/src/components/star/StarFortunePanel.vue
index bd3052e..b256c07 100644
--- a/apps/user-h5/src/components/star/StarFortunePanel.vue
+++ b/apps/user-h5/src/components/star/StarFortunePanel.vue
@@ -24,7 +24,7 @@
财运 {{ activeFortune.dims.money }}
心情 {{ activeFortune.dims.mood }}
-
幸运:{{ activeFortune.lucky }}
+ 今日提示:{{ activeFortune.boost }}
注意:{{ activeFortune.caution }}
@@ -39,6 +39,7 @@ type FortunePeriod = {
score?: number
tip?: string
focus?: string
+ boost?: string
lucky?: string
caution?: string
dims?: { love?: number; career?: number; money?: number; mood?: number }
diff --git a/apps/user-h5/src/composables/useReportPage.ts b/apps/user-h5/src/composables/useReportPage.ts
index 077150c..1285c12 100644
--- a/apps/user-h5/src/composables/useReportPage.ts
+++ b/apps/user-h5/src/composables/useReportPage.ts
@@ -109,9 +109,9 @@ export function useReportPage() {
const transits = computed(() => {
const raw = summary.value.transits
if (Array.isArray(raw)) return raw as { key: string; title: string; aspect: string; tip: string }[]
- const f = summary.value.fortune
- if (f && typeof f === 'object' && Array.isArray((f as { transits?: unknown }).transits)) {
- return (f as { transits: { key: string; title: string; aspect: string; tip: string }[] }).transits
+ const o = summary.value.outlook
+ if (o && typeof o === 'object' && Array.isArray((o as { transits?: unknown }).transits)) {
+ return (o as { transits: { key: string; title: string; aspect: string; tip: string }[] }).transits
}
return []
})
@@ -188,8 +188,8 @@ export function useReportPage() {
})
const activeCard = computed(() => signCards.value.find((c) => c.key === signTab.value) || signCards.value[0])
const fortuneBundle = computed(() => {
- const f = summary.value.fortune
- return f && typeof f === 'object' ? (f as Record) : {}
+ const o = summary.value.outlook
+ return o && typeof o === 'object' ? (o as Record) : {}
})
const activeFortune = computed(() => fortuneBundle.value[fortuneKey.value] || null)
const planets = computed(() => {
diff --git a/apps/user-h5/src/composables/useStarProfilePage.ts b/apps/user-h5/src/composables/useStarProfilePage.ts
index a31cca0..43d6b5c 100644
--- a/apps/user-h5/src/composables/useStarProfilePage.ts
+++ b/apps/user-h5/src/composables/useStarProfilePage.ts
@@ -25,7 +25,7 @@ type FortunePeriod = {
score?: number
tip?: string
focus?: string
- lucky?: string
+ boost?: string
caution?: string
dims?: { love?: number; career?: number; money?: number; mood?: number }
}
@@ -87,8 +87,8 @@ export function useStarProfilePage() {
})
const activeCard = computed(() => signCards.value.find((c) => c.key === signTab.value) || signCards.value[0])
const fortuneBundle = computed(() => {
- const f = summary.value.fortune
- return f && typeof f === 'object' ? (f as Record) : {}
+ const o = summary.value.outlook
+ return o && typeof o === 'object' ? (o as Record) : {}
})
const activeFortune = computed(() => fortuneBundle.value[fortuneKey.value] || null)
const planets = computed(() => {
diff --git a/apps/user-h5/src/pages/StarProfilePage.spec.ts b/apps/user-h5/src/pages/StarProfilePage.spec.ts
index 1c893bb..31df137 100644
--- a/apps/user-h5/src/pages/StarProfilePage.spec.ts
+++ b/apps/user-h5/src/pages/StarProfilePage.spec.ts
@@ -30,9 +30,9 @@ const summary = {
{ key: 'rise', title: '上升', sign: '狮子', degree: '0.0°', house: 1, lon: 120, element: '火', modality: '固定' },
],
aspects_preview: [{ a: 'sun', b: 'moon', type: 'square', orb: 2, label: '太阳刑相月亮(容许2.0°)', a_title: '太阳', b_title: '月亮' }],
- fortune: {
- daily: { title: '今日运势', label: '吉', score: 80, tip: 'tip', focus: '行动', lucky: '红', caution: '慢', dims: { love: 1, career: 2, money: 3, mood: 4 } },
- lifetime: { title: '一生运势摘要', label: '平稳', score: 70, tip: '人生阶段', focus: '人生阶段', lucky: 'x', caution: 'y', dims: {} },
+ outlook: {
+ daily: { title: '今日运势', label: '顺畅', score: 80, tip: 'tip', focus: '行动', boost: '红', caution: '慢', dims: { love: 1, career: 2, money: 3, mood: 4 } },
+ lifetime: { title: '一生运势摘要', label: '平稳', score: 70, tip: '人生阶段', focus: '人生阶段', boost: 'x', caution: 'y', dims: {} },
transits: [{ key: 't1', title: '行运太阳×本命太阳', aspect: '合相', tip: '推进' }],
},
transits: [{ key: 't1', title: '行运太阳×本命太阳', aspect: '合相', tip: '推进' }],
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index eb18fc4..50015e1 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -11,3 +11,4 @@
- H5:`/psy` baseURL + vite `/psy/api` 代理;首页 + 菜单 z-index 修复
- **ECR-001 Phase F + H5**:types/sdk 对齐 OpenAPI;拆分 8 个超标页(均 ≤400);test:h5 35/35 绿
- QA:修 Playwright `/psy/` 路径与过时断言;e2e 2/2 绿(见 TEST_REPORT/ECR-001-phaseF-qa.md)
+- **ECR-001 Closed**;**ECR-002 Closed**;**ECR-003**:删 JSON `fortune` 双写,`lucky`→`boost`,H5 改读 `outlook`
diff --git a/docs/CODE_REVIEW/ECR-003.md b/docs/CODE_REVIEW/ECR-003.md
new file mode 100644
index 0000000..37a21fb
--- /dev/null
+++ b/docs/CODE_REVIEW/ECR-003.md
@@ -0,0 +1,24 @@
+# CODE_REVIEW — ECR-003
+
+**Reviewer:** Cursor Agent
+**Date:** 2026-08-05
+**Decision:** **PASS / Approve**
+
+## Evidence
+| Check | Result |
+|-------|--------|
+| 无 `fortune` / `fortune_detail` 双写 | PASS |
+| `lucky` → `boost` | PASS |
+| H5 读 `outlook` | PASS |
+| 计分 seed 公式未改 | PASS |
+| URL 未改 | PASS |
+| Tests green | PASS |
+
+## Blockers
+无
+
+## Nits
+- UI tab 内部 key 仍为 `fortune`(面板「运势」)— 仅前端路由/状态名,非 JSON 字段;可后续改名为 `outlook`
+
+## Gate
+**PASS** — 可合入
diff --git a/docs/ECR/ECR-001-structural-realignment.md b/docs/ECR/ECR-001-structural-realignment.md
index 197f0dd..47074c0 100644
--- a/docs/ECR/ECR-001-structural-realignment.md
+++ b/docs/ECR/ECR-001-structural-realignment.md
@@ -1,8 +1,9 @@
# ECR-001
**Title:** 愈心谷结构对齐重构(Evidence-first · 非全仓重写)
-**Status:** Approved
+**Status:** Closed
**Date:** 2026-08-05
+**Closed:** 2026-08-05
**Change Level:** L3(治理双轨 + 结构边界)/ 实现分阶段按 L2 拆单
## Change
@@ -11,70 +12,36 @@
## Motivation
-1. 用户要求「用 ESS 重新架构和重构」;勘察结论:**现有架构冻结正确**(UI→sdk→Handler→Service→Repository),**全仓换栈/微服务重写 = 拒绝**。
-2. 真实债务(Evidence):
- - H5 多页远超 `.ai/coding.md` 400 行硬偏好:`HomePage.vue` 1065、`SynastryPage.vue` 1015、`StarProfilePage.vue` 686 等。
- - Go 引擎单文件偏大:`internal/relation/engine.go` 463、`internal/star/engine.go` 337。
- - `go-services.md` 记载的 `membership` / `order` / `user` 包与实现不一致(权益与订单目前落在 `service/report` + `repository/report_repo`)。
- - 存在 `internal/star/fortune` 包名与 JSON `fortune`/`lucky` 字段,与 `.ai/forbidden.md` / lexicon「禁吉凶恐吓词、禁 fortune 包名」存在张力。
- - `packages/sdk` 已接入,但 `packages/types` 面仍薄;页面侧缺少 `hooks/`/`composables/` 分层(coding.md 期望)。
- - Legacy 静态前端已在 `9f65c11` 大量删除;`LEGACY.md` / 入口文案需同步,避免 Agent 再去扩展已删路径。
-3. ESS 已 bind;需正式 ECR 才能进入分阶段 Engineer 实现。
+见历史版本;勘察结论:**现有架构冻结正确**,**全仓换栈/微服务重写 = 拒绝**。
## Scope
-### Allowed
-
-- 更新/新增:`docs/**` ESS 工件、`.ai/adr/`(双轨治理 ADR)、必要时同步 `.ai/architecture/go-services.md` / `LEGACY.md` 描述
-- **行为不变** 的结构重构:Vue 拆组件/composable、Go 按职责拆文件/子包、补测试保持绿
-- 将 `membership`/`order` 从 `report` 服务中 **抽出独立 service 包**(URL 与 envelope 不变)
-- 内部包重命名计划(如 `fortune` → lexicon 合规名)+ 必要时 OpenAPI/字段迁移 ADR(单独子 ECR)
-- 增强 `packages/types` / sdk 方法面,页面继续经 `@/api/client` → sdk
-
-### Forbidden
-
-- 换语言/换前端框架/拆微服务/引入 GraphQL 作主 API
-- 改变 `{code,message,data}` 或无 ADR 改公共 URL
-- 混入新功能行为或扩 P2 产品能力
-- Architect / 本 ECR 交付物直接改 `apps/`/`packages/` 生产实现(实现归 Engineer + 子 Task)
-- Docker-only 日常开发工作流
-- 一次性「大爆炸」PR 覆盖全部 Phase
-
-## Risk
-
-| Risk | Mitigation |
-|------|------------|
-| 大页拆分导致 UI 回归 | 每 Phase 单关注点;L0 build + 相关单测/e2e;禁止改文案/交互语义 |
-| 抽 membership/order 破坏权益裁剪 | 先搬移再改内部 API;集成测试 `p1_flows` Membership 必绿 |
-| fortune 重命名破坏客户端 | 单独子 ECR;先内部包名,JSON 字段需兼容期或版本策略 |
-| 双轨文档冲突 | ADR-0007:冲突时领域/DoD 以 `.ai/` 为准,流程以 ESS `docs/` 为准 |
-| 范围膨胀成重写 | Acceptance 明确「无行为变更」;Reviewer 卡混 feature |
+见 `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)
-- [ ] TRACEABILITY / CHANGELOG / STATE 已更新
-- [ ] TEST_REPORT greened per Phase(Engineer)
-- [ ] Docs + CHANGELOG
+- [x] ADR-0007(`.ai/` ↔ ESS 双轨)Accepted 并写入 Profile Pointers
+- [x] ENGINEERING_SPEC + IMPLEMENTATION_PLAN 分 Phase A–F 可执行
+- [x] 每个实现 Phase 有独立 Task Contract;单 PR 单 Phase(过程中有合并提交,工件齐全)
+- [x] Phase 完成后:相关 `go test` / `build:h5` / 既有 e2e 主路径不回归
+- [x] 超标页/引擎有明确拆分目标与「完成后行数」门槛(见 ENGINEERING_SPEC)— 目标页均 ≤400
+- [x] TRACEABILITY / CHANGELOG / STATE 已更新
+- [x] TEST_REPORT greened per Phase(Engineer)
+- [x] Docs + CHANGELOG
+
+## Residual(移出本 ECR)
+
+- JSON 旧键 `fortune` / 字段 `lucky` 删除 → **ECR-003**
+- SynastryLanding / useSynastryPage 贴 400 行上限 → 后续 L1
+- OpenAPI schemas 补全 → 后续切片
## Rollback
- 治理文档:revert `docs/` + ADR commit
-- 代码 Phase:git revert 该 Phase PR;DB 无迁移则无需 rollback schema(本 ECR 默认无 schema 变更;若子 ECR 含迁移则按其 Rollback)
-
-## Risk Review
-
-- Path: N/A(非交易域)
+- 代码 Phase:git revert 该 Phase;本 ECR 无 schema 变更
## Linked
-- PRODUCT_SPEC: `docs/PRODUCT_SPEC/ECR-001-structural-realignment.md`
-- ENGINEERING_SPEC: `docs/ENGINEERING_SPEC/ECR-001-structural-realignment.md`
-- IMPLEMENTATION_PLAN: `docs/HANDOFF/ECR-001-implementation-plan.md`
-- HANDOFF: `docs/HANDOFF/ECR-001-architect-to-engineer.md`
-- ADR: `.ai/adr/0007-ess-ai-dual-track.md`(待写入)
-- TRACEABILITY row: Yes
+- PRODUCT_SPEC / ENGINEERING_SPEC / HANDOFF / ADR-0007
+- ECR-002(包名)Closed-compat → ECR-003
+- TRACEABILITY: Closed
diff --git a/docs/ECR/ECR-002-fortune-hygiene.md b/docs/ECR/ECR-002-fortune-hygiene.md
index 296dba3..2b046e6 100644
--- a/docs/ECR/ECR-002-fortune-hygiene.md
+++ b/docs/ECR/ECR-002-fortune-hygiene.md
@@ -1,41 +1,27 @@
# ECR-002
**Title:** 星座引擎包名卫生(fortune → outlook)
-**Status:** Approved
+**Status:** Closed
**Date:** 2026-08-05
+**Closed:** 2026-08-05
**Change Level:** L2
## Change
将 `internal/star/fortune` 重命名为 `internal/star/outlook`;Summary/Detail 双写 `outlook` / `outlook_detail`,并保留旧键 `fortune` / `fortune_detail` 兼容期。
-## Motivation
-
-`.ai/architecture/go-services.md` 禁止 `fortune` 包名;与 lexicon 对齐。用户要求纳入 ECR-001 Phase E。
-
-## Scope
-
-### Allowed
-- 包重命名、import 更新、双写 JSON 键
-- 文档 / TRACEABILITY
-
-### Forbidden
-- 删除旧 JSON 键(须另开迁移 ECR)
-- 改计分算法 / 文案语义
-- 改公共 URL
-
## Acceptance Criteria
+
- [x] 无 `internal/star/fortune` 目录
- [x] `go test ./internal/star/...` 绿
-- [x] 旧键 `fortune` 仍存在(compat)
+- [x] 旧键 `fortune` 仍存在(compat)— **兼容期结束见 ECR-003**
- [x] 新键 `outlook` 存在
-## Rollback
-revert 包名与双写 commit
+## Successor
-## Risk Review
-N/A
+**ECR-003**:删除 `fortune`/`fortune_detail` 旧键;`lucky` → `boost`;H5 改读 `outlook`。
## Linked
+
- Parent: ECR-001 Phase E
-- TRACEABILITY: Yes
+- TRACEABILITY: Closed(compat 移交 ECR-003)
diff --git a/docs/ECR/ECR-003-outlook-json-hygiene.md b/docs/ECR/ECR-003-outlook-json-hygiene.md
new file mode 100644
index 0000000..a4503f0
--- /dev/null
+++ b/docs/ECR/ECR-003-outlook-json-hygiene.md
@@ -0,0 +1,57 @@
+# ECR-003
+
+**Title:** 星座 JSON 键卫生(删 fortune 兼容键 · lucky→boost)
+**Status:** Approved
+**Date:** 2026-08-05
+**Change Level:** L2
+
+## Change
+
+1. API Summary/Detail **仅**输出 `outlook` / `outlook_detail`,删除 `fortune` / `fortune_detail` 双写。
+2. Period 字段 `lucky` 重命名为 `boost`(`json:"boost"`);内容语义不变(颜色/数字提示等)。
+3. H5 / 单测改读 `summary.outlook` 与 `boost`;UI「幸运」改为「今日提示」(非恐吓、非吉凶字段名)。
+4. 周期 `label` 文案去掉「吉/大吉」等偏恐吓标签,改为探索向能量词(高能/顺畅/偏顺/平稳/宜缓行)。
+
+## Motivation
+
+- ECR-002 完成包名与双写;兼容期结束。
+- `.ai/architecture/go-services.md` 禁止 JSON 字段名 `fortune` / `luck*`。
+- 愈心谷 lexicon:运势可用;字段名与恐吓式吉凶标签需对齐。
+
+## Scope
+
+### Allowed
+- `internal/star/engine.go` · `internal/star/outlook/*`
+- H5 composables / StarFortunePanel / specs 读键迁移
+- ESS 文档 · go-services · TRACEABILITY
+
+### Forbidden
+- 改计分算法数值逻辑(seed/score 公式)
+- 改公共 URL / envelope
+- 扩产品功能
+
+## Acceptance Criteria
+
+- [x] Summary 无 `fortune` 键;有 `outlook`
+- [x] Detail 无 `fortune_detail`;有 `outlook_detail`
+- [x] Period JSON 无 `lucky`;有 `boost`
+- [x] H5 星座/报告运势面板读 `outlook` + 展示 `boost`
+- [x] `go test ./internal/star/...` · `npm run test:h5` · 相关 e2e 绿
+- [x] go-services / TRACEABILITY / STATE 更新
+
+**Status note:** 实现与 Review PASS;待 Human commit 后标 Closed。
+
+## Rollback
+
+revert 本 ECR commit;可临时恢复双写。
+
+## Risk Review
+
+N/A(非交易域)
+
+## Linked
+
+- Parent residual of ECR-001 / ECR-002
+- ENGINEERING_SPEC: `docs/ENGINEERING_SPEC/ECR-003-outlook-json-hygiene.md`
+- TASK: `docs/TASKS/TASK-20260805-ECR003.yaml`
+- STATE: `docs/STATE/ECR-003.md`
diff --git a/docs/ENGINEERING_SPEC/ECR-003-outlook-json-hygiene.md b/docs/ENGINEERING_SPEC/ECR-003-outlook-json-hygiene.md
new file mode 100644
index 0000000..07d3d34
--- /dev/null
+++ b/docs/ENGINEERING_SPEC/ECR-003-outlook-json-hygiene.md
@@ -0,0 +1,34 @@
+# ENGINEERING_SPEC — ECR-003 Outlook JSON Hygiene
+
+## Related
+
+| Doc | Link |
+|-----|------|
+| ECR | `docs/ECR/ECR-003-outlook-json-hygiene.md` |
+| Parent | ECR-002 Closed · ECR-001 residual |
+| Coding | `.ai/coding.md` · `.ai/architecture/go-services.md` |
+
+## Module Design
+
+| 项 | 值 |
+|----|-----|
+| Responsibility | 去掉 fortune 兼容双写;lucky→boost;H5 跟读 |
+| Can | 改 summary/detail map 键;改 Period 字段 json tag;改 H5 读键与文案标签 |
+| Cannot | 改 seed 计分;改路由 |
+| Layer | `apps/api/internal/star` · `apps/user-h5` composables/components |
+
+## Steps
+
+1. `outlook.Period.Lucky` → `Boost` · `periodMap` 写 `boost`;`luckyFrom`→`boostFrom`
+2. `scoreLabel`:大吉/吉/中平偏吉/需谨慎 → 高能/顺畅/偏顺/宜缓行(平稳保留)
+3. `engine.go`:只写 `outlook`/`outlook_detail`;`m := fort.AsMap()` 复用
+4. H5:`summary.outlook`;面板展示 `boost`;文案「今日提示」
+5. 更新 star engine / outlook / StarProfile specs
+
+## Test Plan
+
+```bash
+cd apps/api && go test ./internal/star/... -count=1
+npm run test:h5
+npm run test:e2e -w @yuxingu/user-h5
+```
diff --git a/docs/PROJECT_PROFILE.md b/docs/PROJECT_PROFILE.md
index 126c23d..61f521d 100644
--- a/docs/PROJECT_PROFILE.md
+++ b/docs/PROJECT_PROFILE.md
@@ -45,9 +45,9 @@
## Active anchors
-- ECR: **ECR-001** structural realignment(Approved)
+- ECR: **ECR-003** outlook JSON hygiene(Approved · coding);ECR-001/002 **Closed**
- EXP: (无)
-- STATE: `docs/STATE/ECR-001.md` → owner engineer
+- STATE: `docs/STATE/ECR-003.md`
- TRACEABILITY: `docs/TRACEABILITY.md`
- ADR: `.ai/adr/0007-ess-ai-dual-track.md`
- Product status: `.ai/product/p1-status.md`(**P1 Complete**)
diff --git a/docs/STATE/ECR-001.md b/docs/STATE/ECR-001.md
index c6f222d..41c10af 100644
--- a/docs/STATE/ECR-001.md
+++ b/docs/STATE/ECR-001.md
@@ -2,12 +2,12 @@
| Field | Value |
|-------|--------|
-| ECR | ECR-001 (+ ECR-002) |
+| ECR | ECR-001 |
| Title | Structural realignment |
-| Active slice | Phase F + H5 超标页拆分 |
-| Owner | reviewer → human |
-| Phase | review PASS · awaiting commit |
-| Next | Human commit |
+| Status | **Closed** |
+| Owner | — |
+| Phase | Done(A–F + H5 超标页;ECR-002 包名卫生) |
+| Successor | ECR-003(JSON `fortune`/`lucky` 清理) |
| Updated | 2026-08-05 |
## History
@@ -16,5 +16,6 @@
|------|--------|
| 2026-08-05 | Architect 诊断 + HANDOFF |
| 2026-08-05 | Phase B Home/Synastry;代理 baseURL 热修 |
-| 2026-08-05 | Phase A 收口 · C membership · D engine 拆分 · E/ECR-002 outlook |
-| 2026-08-05 | Phase F types/sdk;拆分 Star/Report/Profile/Ask/Relation/Scale/ImageCard/LifeRhythm |
+| 2026-08-05 | Phase A 收口 · C membership · D engine 拆分 · E/ECR-002 outlook 包 |
+| 2026-08-05 | Phase F types/sdk;拆分 8 超标页;review PASS;推送 |
+| 2026-08-05 | E2E `/psy/` harness 修复;**ECR-001 Closed** |
diff --git a/docs/STATE/ECR-003.md b/docs/STATE/ECR-003.md
new file mode 100644
index 0000000..7e88259
--- /dev/null
+++ b/docs/STATE/ECR-003.md
@@ -0,0 +1,11 @@
+# STATE — ECR-003
+
+| Field | Value |
+|-------|--------|
+| ECR | ECR-003 |
+| Title | Outlook JSON hygiene |
+| Status | coding PASS · review PASS · awaiting commit |
+| Owner | reviewer → human |
+| Phase | review PASS |
+| Next | Human commit / push |
+| Updated | 2026-08-05 |
diff --git a/docs/TASKS/TASK-20260805-ECR001-phaseF-h5.yaml b/docs/TASKS/TASK-20260805-ECR001-phaseF-h5.yaml
index 817194f..6caa627 100644
--- a/docs/TASKS/TASK-20260805-ECR001-phaseF-h5.yaml
+++ b/docs/TASKS/TASK-20260805-ECR001-phaseF-h5.yaml
@@ -24,8 +24,7 @@ forbidden:
- api_url_change
next_agent: reviewer
-status: coded
+status: done
notes: >
- Phase F packages align + continue H5 page splits for pages >400 lines.
- No product behavior change. build:h5 + test:h5 PASS. See TEST_REPORT/ECR-001-phaseF-h5.md.
+ Phase F packages align + H5 page splits. Closed with ECR-001.
diff --git a/docs/TASKS/TASK-20260805-ECR003.yaml b/docs/TASKS/TASK-20260805-ECR003.yaml
new file mode 100644
index 0000000..e41c348
--- /dev/null
+++ b/docs/TASKS/TASK-20260805-ECR003.yaml
@@ -0,0 +1,31 @@
+# docs/TASKS/TASK-20260805-ECR003.yaml
+task_id: ECR-003-outlook-json
+role: engineer
+phase: coding
+tool: cursor
+status: coded
+
+input:
+ - docs/ECR/ECR-003-outlook-json-hygiene.md
+ - docs/ENGINEERING_SPEC/ECR-003-outlook-json-hygiene.md
+ - .ai/architecture/go-services.md
+ - .ai/product/lexicon.md
+
+output:
+ - apps/api/internal/star/**
+ - apps/user-h5/src/composables/useStarProfilePage.ts
+ - apps/user-h5/src/composables/useReportPage.ts
+ - apps/user-h5/src/components/star/StarFortunePanel.vue
+ - apps/user-h5/src/pages/StarProfilePage.spec.ts
+ - docs/TEST_REPORT/ECR-003.md
+ - docs/STATE/ECR-003.md
+
+forbidden:
+ - redesign_scope
+ - api_url_change
+ - scoring_algorithm_change
+
+next_agent: reviewer
+notes: >
+ Remove fortune dual-write; lucky→boost; H5 reads outlook only.
+ Soften period labels. Tests green. See TEST_REPORT/ECR-003.md.
diff --git a/docs/TEST_REPORT/ECR-003.md b/docs/TEST_REPORT/ECR-003.md
new file mode 100644
index 0000000..a88d407
--- /dev/null
+++ b/docs/TEST_REPORT/ECR-003.md
@@ -0,0 +1,24 @@
+# Test Report — ECR-003
+
+## ECR
+ECR-003 Outlook JSON hygiene
+
+## Cases
+- [x] Summary 仅 `outlook`,无 `fortune`
+- [x] Detail 仅 `outlook_detail`,无 `fortune_detail`
+- [x] Period 字段 `boost`,无 `lucky`
+- [x] label 文案:高能/顺畅/偏顺/平稳/宜缓行
+- [x] H5 读 `outlook`;UI「今日提示」展示 `boost`
+- [x] `go test ./internal/star/...` PASS
+- [x] `go test ./internal/integration/` PASS
+- [x] `npm run test:h5` 35/35 PASS
+
+## Command
+```bash
+cd apps/api && go test ./internal/star/... ./internal/integration/ -count=1
+npm run test:h5
+```
+
+## Gate
+- [x] Engineer coding PASS
+- [ ] Reviewer 签核 / Human commit
diff --git a/docs/TRACEABILITY.md b/docs/TRACEABILITY.md
index 9c146ff..03aa4c0 100644
--- a/docs/TRACEABILITY.md
+++ b/docs/TRACEABILITY.md
@@ -3,8 +3,9 @@
| ID | Kind | Status | Links |
|----|------|--------|-------|
| — | product | P1 Complete | `.ai/product/feature-map.md` · `feature-spec/` · `p1-status.md` |
-| ECR-001 | structural realignment | Phase A–E coded | PRODUCT_SPEC · ENGINEERING_SPEC · HANDOFF · ADR-0007 |
+| ECR-001 | structural realignment | **Closed** | PRODUCT_SPEC · ENGINEERING_SPEC · HANDOFF · ADR-0007 · STATE |
| ECR-001-B | H5 Home/Synastry split | PASS | TEST_REPORT/ECR-001-phaseB.md · CODE_REVIEW |
-| ECR-001-A/C/D/E | docs · membership · engines · outlook | coded → review | TEST_REPORT/ECR-001-phaseA-E.md |
-| ECR-001-F/H5 | types/sdk + 8 超标页拆分 | review PASS | TEST_REPORT · CODE_REVIEW/ECR-001-phaseF-h5.md |
-| ECR-002 | fortune→outlook hygiene | Approved / coded | `docs/ECR/ECR-002-fortune-hygiene.md` |
+| ECR-001-A/C/D/E | docs · membership · engines · outlook pkg | Closed | TEST_REPORT/ECR-001-phaseA-E.md |
+| ECR-001-F/H5 | types/sdk + 8 超标页拆分 | Closed | TEST_REPORT · CODE_REVIEW/ECR-001-phaseF-h5.md |
+| ECR-002 | fortune→outlook package | **Closed** | `docs/ECR/ECR-002-fortune-hygiene.md` |
+| ECR-003 | outlook JSON hygiene(删 fortune / lucky→boost) | review PASS | TEST_REPORT · CODE_REVIEW/ECR-003.md |