[epic] deep-module 架构级重构（P1 转发壳重设计 / meeting live chain / Value typed / 接口撒谎 / 端到端测试）

[foxzool]

What to build

汇总 deep-module 全库审查中需要设计决策、不宜直接 AFK 实现的架构级问题。本 epic 不直接实现，作为各架构级子任务的汇总与 design 入口。

Sub-issues

Design-gated：

• [design] P1: 多层 Arc<Config>-only 转发导航壳重设计 ADR（深导航 vs 砍导航） #347 — ✅ P1 ADR 已草案化（PR docs(adr): 0001 导航壳重设计——混合方案（#347 决策） #352，混合方案）：5 项保留判定（feature门控/版本路由/路径参数/扇出≥3/真实helper）+ per-crate 差异化；leaf 100% 冻结。ADR 状态 Accepted（docs(adr): ADR 0001 执行完成——状态 Accepted + 执行记录 + inception 另案 #367 #368）。
• [design] meeting: 5 个零方法 ResourceClient live chain（deepen vs 文档化） #348 — ✅ meeting live chain 决策完成（不 deepen；砍空壳 + 诚实化文档）——ADR 0001 覆盖；执行 [refactor] meeting: 删 chain.rs 8 空 ResourceClient + 修文档谎言 + Config 深拷贝链改 Arc（ADR 0001 阶段1） #353 → PR refactor(meeting): 砍 chain.rs 7 空壳 + 修文档谎言（#353，ADR 0001 阶段1 重灾区） #356；issue CLOSED 2026-07-10

Implementation：

• [refactor] meeting: meeting_room 子树 execute() Value→typed 接线（287 行 typed 模型已就绪） #349 — ✅ P6: meeting meeting_room execute() Value→typed 接线（PR refactor(meeting): meeting_room execute() Value→typed Response (#349) #411）
• [refactor] P9: 接口形状撒谎修正（workflow/platform/analytics/user 4 处） #350 — ✅ P9: 接口形状撒谎修正（workflow/platform/analytics/user；PR refactor!: fix P9 interface-shape lies in workflow and analytics (#350) #410 / refactor(platform)!: 修 PlatformService::new 误导签名（#350 P9 platform 子项） #373 / refactor(user): 砍 PersonalSettingsResource 中间层 + 修 UserService::new 误导签名（ADR 0001 阶段2） #360）
• [refactor] P10: 占位 serde_json roundtrip 测试 → test_runtime 端到端 #351 — ✅ P10: 占位 serde_json roundtrip 测试 → test_runtime 端到端（多 PR 收口至 test: clear remaining 32 model/mod/service placeholder（#351 收尾 fixup） #407）
• [refactor] meeting: 删 chain.rs 8 空 ResourceClient + 修文档谎言 + Config 深拷贝链改 Arc（ADR 0001 阶段1） #353 — ✅ meeting 删 chain.rs 空 ResourceClient + 修文档谎言（ADR 0001 阶段1，PR refactor(meeting): 砍 chain.rs 7 空壳 + 修文档谎言（#353，ADR 0001 阶段1 重灾区） #356）
• [refactor] bot: 删 Bot/V4/BotResource 3 纯转发壳，search_bot() 直达 leaf（ADR 0001 阶段1） #354 — ✅ bot 删 Bot/V4/BotResource 3 壳 + search_bot() 直达（ADR 0001 阶段1，PR refactor(bot): 删 Bot/V4/BotResource 3 纯转发壳，search_bot() 直达 leaf（#354，ADR 0001 阶段1） #355）

ADR 0001 per-crate 迁移计划（PR #352，Accepted）

阶段 1（范式验证）：#353 meeting、#354 bot ✅
阶段 2（死壳清理）：mail/helpdesk/analytics/user/platform ✅（#357–#361 等）
阶段 3（双树合并）：cardkit/docs ✅（#365/#366）
阶段 4（范本微调）：application/workflow ✅（#362/#364）
阶段 5（收口）：CLIENT_NAMING_CONVENTION + openlark-client facade + CHANGELOG + ADR 执行记录 ✅（#368/#372；platform inception #371）

已完成的相关子项

• ✅ [refactor] auth: AuthTokenProvider 手搓 HTTP 改为委托 4 个 Transport-based builder #309 — auth fetch 委托 Transport（PR refactor(auth): AuthTokenProvider 手搓 HTTP 改委托 Transport-based RequestBuilder（#309） #346）
• ✅ [refactor] user: UserService 加 personal_settings() accessor + 删 settings/preferences stub 链 #311 — user accessor + 删 stub（PR refactor(user): 删 settings/preferences stub 链 + 补 personal_settings() accessor（#311） #343）
• ✅ [refactor] application: 删 dead Application wrapper + 补 v5/v6/v7/workplace accessor + 独立 feature 门控 #312 — application accessor + feature 门控（PR refactor(application): 删 dead Application wrapper + 补 v5/v6/v7/workplace accessor + 独立 feature 门控（#312） #344）
• ✅ [refactor] ai: pub mod common 下沉 core::api（serialize_params 返 Value / api_url! macro_export 污染） #330 — HTTP helper 下沉 core::api（PR refactor(core,ai,+8): HTTP 管道 helper 下沉 core::api + ai common 私有化（#330） #345）
• ✅ [design] meeting: 5 个零方法 ResourceClient live chain（deepen vs 文档化） #348 — meeting live chain design 决策 + [refactor] meeting: 删 chain.rs 8 空 ResourceClient + 修文档谎言 + Config 深拷贝链改 Arc（ADR 0001 阶段1） #353 执行
• ✅ [refactor] meeting: 删 chain.rs 8 空 ResourceClient + 修文档谎言 + Config 深拷贝链改 Arc（ADR 0001 阶段1） #353 — meeting 砍 chain 空壳 + 修文档谎言（PR refactor(meeting): 砍 chain.rs 7 空壳 + 修文档谎言（#353，ADR 0001 阶段1 重灾区） #356）
• ✅ [refactor] meeting: meeting_room 子树 execute() Value→typed 接线（287 行 typed 模型已就绪） #349 / [refactor] P9: 接口形状撒谎修正（workflow/platform/analytics/user 4 处） #350 / [refactor] P10: 占位 serde_json roundtrip 测试 → test_runtime 端到端 #351 / [refactor] bot: 删 Bot/V4/BotResource 3 纯转发壳，search_bot() 直达 leaf（ADR 0001 阶段1） #354 — 见上

Acceptance（epic 级）

• epic 拆分 sub-issues（[design] P1: 多层 Arc<Config>-only 转发导航壳重设计 ADR（深导航 vs 砍导航） #347-[refactor] P10: 占位 serde_json roundtrip 测试 → test_runtime 端到端 #351 + [refactor] meeting: 删 chain.rs 8 空 ResourceClient + 修文档谎言 + Config 深拷贝链改 Arc（ADR 0001 阶段1） #353/[refactor] bot: 删 Bot/V4/BotResource 3 纯转发壳，search_bot() 直达 leaf（ADR 0001 阶段1） #354）
• P1 ADR 草案化（[design] P1: 多层 Arc<Config>-only 转发导航壳重设计 ADR（深导航 vs 砍导航） #347，PR docs(adr): 0001 导航壳重设计——混合方案（#347 决策） #352 混合方案）—— Accepted
• meeting live chain（[design] meeting: 5 个零方法 ResourceClient live chain（deepen vs 文档化） #348 决策：不 deepen；[refactor] meeting: 删 chain.rs 8 空 ResourceClient + 修文档谎言 + Config 深拷贝链改 Arc（ADR 0001 阶段1） #353/PR refactor(meeting): 砍 chain.rs 7 空壳 + 修文档谎言（#353，ADR 0001 阶段1 重灾区） #356 执行）
• P6 meeting_room typed 化（[refactor] meeting: meeting_room 子树 execute() Value→typed 接线（287 行 typed 模型已就绪） #349，PR refactor(meeting): meeting_room execute() Value→typed Response (#349) #411）
• P9 撒谎修正（[refactor] P9: 接口形状撒谎修正（workflow/platform/analytics/user 4 处） #350，PR refactor!: fix P9 interface-shape lies in workflow and analytics (#350) #410）
• P10 测试策略 + 首批及收尾（[refactor] P10: 占位 serde_json roundtrip 测试 → test_runtime 端到端 #351，收口至 PR test: clear remaining 32 model/mod/service placeholder（#351 收尾 fixup） #407）
• ADR 0001 阶段 1–5 落地 + 执行记录（docs(adr): ADR 0001 执行完成——状态 Accepted + 执行记录 + inception 另案 #367 #368/docs(adr): ADR 0001 platform inception 收口——「未做」改「决策痕迹」+ 执行记录加 #371 #372）

Blocked by

None

Status

COMPLETED — 全部 design + implementation 子 issue 已 CLOSED；最后一块 #350 于 2026-07-10 经 PR #410 合入 main。

[foxzool]

#348 收口

meeting live chain design（deepen vs 文档化）已正式关闭：

• 决策：不 deepen；砍零方法 ResourceClient + 诚实化 facade（ADR 0001）
• 执行：[refactor] meeting: 删 chain.rs 8 空 ResourceClient + 修文档谎言 + Config 深拷贝链改 Arc（ADR 0001 阶段1） #353 → PR refactor(meeting): 砍 chain.rs 7 空壳 + 修文档谎言（#353，ADR 0001 阶段1 重灾区） #356（已合并）
• 状态：[design] meeting: 5 个零方法 ResourceClient live chain（deepen vs 文档化） #348 CLOSED（completed）

epic Acceptance 中「meeting live chain」可标完成（此前为 partial via ADR）。

[foxzool]

Epic #314 收口

全部 design / implementation 子 issue 已完成并合入 main，epic Acceptance 全勾。

项	状态	关键交付
#347 ADR / P1	CLOSED	PR #352 → Accepted（#368/#372）
#348 meeting live chain design	CLOSED	不 deepen；#353 → PR #356
#349 P6 meeting_room typed	CLOSED	PR #411
#350 P9 接口形状撒谎	CLOSED	PR #410（workflow/analytics）；platform/user 更早 #373/#360
#351 P10 e2e / 占位清除	CLOSED	多批 PR，收口 #407
#353 / #354 ADR 阶段1	CLOSED	PR #356 / #355
ADR 0001 阶段 2–5	已执行	#357–#366、#362/#364、#371 等

结论：本 epic 明确「不直接实现」；实现面已由子 issue 全覆盖。无剩余 ready-for-agent 子项，关闭 epic。

Refs: docs/adr/0001-navigation-shell-redesign.md、docs/API_E2E_TEST_STRATEGY.md