docs(进度总账): A 类首切片市场推荐位接入(后端就绪前端0消费,全量 e2e 45/0)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs/mvp/进度总账.md

@@ -174,6 +174,7 @@
 - 收口口径:每切片"关 MSW→真连活体单体→playwright e2e 绿"才算完成(反假绿)。
 - 📊 **2026-06-22:admin + studio 全功能域缺口系统盘点(6 并行 agent 对照 02B-02G 规格 SSOT,反假绿)**。完整度:**admin ~40%**(views/muse 千行实质页、调真 admin-api、后端 P1r IT 背书;缺 MetaSchema 废弃/回退接线[deprecate/rollback API 已存在未接]、function-orch 仅"查看+激活"、field editor 裸 JSON textarea);**studio:02C 作品台 ~40%(✅6🟡5🟠6❌10/27)、02E 知识库 ~30%(✅7🟡6🟠2❌9/24,双轨确认链 8 活体 e2e 质量最高)、02G 个人中心 ~25%(✅1🟠9❌12/22)、02F 市场 生产~64%消费~7%(✅8🟡1🟠7❌9/25)、02D 智能体 ~10-18%(✅0🟠3🟡1❌11/15)**。**四条横切共性缺口**:① **handoff 跨空间安全交接=架构级缺失**——02C 智能体关联/02D 槽位/02E 作品绑定/02F 市场交接/02G 记录跳转**五域全部**仅来源侧只读预检、前端从不消费一次性 token→server session(后端已有 `AppMuseMarketHandoffController`),规格"不信任客户端 URL 参数"红线零落地,修一次受益全域;② **核心写路径真验证空白(假绿)**——studio 正文自动保存(02C 写作台心脏)**零 e2e**、AI 生成链 e2e **一律 stub `/ai/tasks`**,"全量 e2e 43/0 全绿"最关键两条创作命脉绿在 mock/stub 上;③ 资产深度管理(版本史/详情页/导出/导入/使用记录/作品设置)整批缺,各域是"创建+主操作"有、"管理+可观测+生命周期"无;④ **后端已就绪、前端 0 消费**成片(02G New-API绑定/配额请求/余额快照/导出、02F recommendations/governance-impact、02E 处理任务重试、admin MetaSchema 废弃回退),后端已 P1r 验收、前端接线即得。**修复分层**:**D 真验证补强**(最优先、反假绿成本最低:正文保存/AI 任务创建/market install/agent 试用槽位补 e2e)→ **A 接已就绪后端**(快见效)→ **B 前端整页整链**(handoff 统一/详情版本/导入导出/分型可信面板)→ **C 前后端共建**(改密/MFA/会话/偏好通知、02D 版本生命周期)。**本轮按用户决策启动 D 类**(正文保存 + AI 真后端 e2e),结果见下条。
 - ✅/⚠️ **2026-06-22:D 类正文保存补真后端 e2e 闭环 + AI 生成四重阻塞定位(反假绿,commit a581fec)**。**正文保存 ✅ 完成**:写作台心脏却零 e2e、仅 MSW 掩盖、"43/0 全绿"绿在 mock 上。补 `block-autosave.spec.ts` 真打 PUT blocks 暴露并修真 bug——① **block revision 字段漂移**:WorkspacePage 裸读 `activeBlock.version`(真后端返 revision、无 version,curl 证)→ expectedRevision 恒为 1 → 乐观锁必冲突 `1041000002`,提 `blockRevision()` 到 useBlockStructure 共享、WorkspacePage 复用;② **work revision 漂移**(tsc -b 增量重检暴露):WorkVO 类型无 revision、真后端 detail 返 revision=5,加 `workRevision()` helper(chapter create/work delete 共用);③ MuseEditor saveBlock 返 `{revision}`(非 openapi 标的 newVersion),L110 改 revision 优先兜底;④ market 申诉 deadline fixture 老化(纯时间推进非代码:reviewRejection 的 eventAt=reviewedAt+7天 过期→`1044000027 申诉期限已过`),globalSetup §5a 刷新被驳回 request.reviewed_at 到近期。验证:block-autosave + block-structure/chapter/work 回归 4/4、**全量 e2e 43→44/0**、tsc/eslint/vitest 79/79。**AI 生成 ⚠️ 真后端 happy-path 不可行(四重阻塞,不做假 e2e,归 02D+外部依赖后置)**:① **AIPanel 不传 agentSlotKey/agentOverrideRef**(CreateAiTaskRequest 经"作品内智能体槽位"解析 agent),后端无 agent 来源 → POST /ai/tasks 真打 `1040100005 AI Agent 不存在`;② 作品-智能体**槽位绑定 UI 本就不完整**(02D 核心 gap:SlotBindingPanel workId 硬编码、无真正绑定流);③ 我重启 48080 时禁用了 AI dispatcher(initial-delay 24h);④ 真实生成依赖 New-API 外部模型(本机不可用——accept-suggestion e2e 历来 stub /ai/tasks 即此因)。即使修 ①②③,④ 仍硬阻塞 → 不做假 e2e。AI 生成正向验证需 02D 智能体槽位接入 + New-API provision(C 类 + 外部依赖),非 D 类可解。**D 类小结**:两条创作命脉,正文保存已真验证闭环(并连带修 3 处 revision 漂移 + 1 处 fixture 老化);AI 生成阻塞根因已定位归档。
+- ✅ **2026-06-22:A 类首切片——市场推荐位接入真后端 recommendations(commit cac3b88)**。A 类(后端已 P1r 验收、前端 0 消费):02F `GET /marketplace/recommendations` 后端就绪(curl code:0 + 真实推荐资产 + recommendationReason),但 studio 从不调用、推荐理由仅 mock 造、UI 未渲染(盘点 C3)。接入:`useMarketRecommendations` hook(返 MarketAssetCard[]、推荐失败不阻断主列表)+ MarketBrowse「为你推荐」区(渲染推荐资产 + recommendationReason、点击进详情)+ mock handler + vitest 推荐契约 + `market-recommendations.spec.ts` 真后端 e2e(进 /market 验推荐区渲染真实数据)。连带修 `live-read` market 断言加 `.first()`(推荐位与列表可同时渲染同名资产→strict mode)。验证:**全量 e2e 44→45/0**、vitest 79→80、tsc/eslint 绿。**A 类样板成型**(读端接线即得 + 自然 UI 落点 + 真后端 e2e),可复用到 02G New-API 摘要/余额快照(curl 均 code:0 就绪)、02F governance 等其余"后端就绪、前端 0 消费"缺口。
 
 ### D. gateway 接线(B4,**配置层已收口;运行态后置**)
 - ✅ **配置层收口(2026-06-19)**:`muse-gateway` 已新增 `/admin-api/muse/**`、`/app-api/muse/** → grayLb://muse-server`,删除当前聚合入口未启用的 bpm/pay/report/mp 死路由,Knife4j 聚合入口改为 `muse-server`。新增 `GatewayRouteConfigurationTest` 机械门禁,断言 Muse 路由存在、停用模块路由不回潮、Knife4j 不展示停用服务;本轮 `mvn -pl muse-gateway test -Dtest=GatewayRouteConfigurationTest` **3/3 绿**。