console-architecture.md 残留三处过期陈述:objectstack.config.ts(与 console.md 同源)、已死的建应用入口、Routing 表不全

[yinlianghui]

越界发现,记录于 #3540(删掉 console-architecture.md 里不存在的 MSW Mock Mode + 校正组件归属)期间。#3540 的文件面只覆盖「MSW」与「组件归属」两类缺陷,下列三条属于其他类别,按纪律只报不改,单独立单。

实测基线:origin/main @ a2c8f2a29。

一、数据流图顶层 box 指向一个不存在的文件(需与 console.md 同修,故不在 #3540 的 PR 里动)

content/docs/guide/console-architecture.md 数据流图第一格:

objectstack.config.ts
(defineStack → apps, objects, views)

实测:

• git ls-files | grep -i objectstack.config → 零命中(全仓没有这个文件)
• git grep -rn "defineStack" -- apps/ packages/ → 只剩 CHANGELOG 与代码注释,没有任何一处真的 defineStack(...) 调用点在 console 侧
• apps/console/tsconfig.json:27 的 "include" 里仍列着 "objectstack.config.ts" —— 一条指向不存在文件的死 include

为什么没在 #3540 里顺手改:console.md 的 ## Configuration 节同源,仍写着 "The console reads its configuration from objectstack.config.ts",并附了一段 defineStack 示例。只改姊妹页会让两页当场互相矛盾,而「两页一致」正是 #3540 的验收条件之一。这条必须两页一起改,超出 #3540 的文件面。

真实来源已经是服务端:ObjectStackAdapter 经 VITE_SERVER_URL 从活的 ObjectStack server 取 apps/objects/views(#3532 已在 console.md 的 Quick Start 里确认了这一点)。

二、### 4. App Creation & Editing 的 Entry Points 三条已死/存疑

原文:

Entry Points:

• Sidebar app switcher → "Add App" / "Edit App" buttons
• CommandPalette (⌘+K) → "Create New App" command in Actions group
• Empty state CTA → "Create Your First App" button when no apps are configured

逐条实测:

1. Sidebar 入口:带 add-app-btn / edit-app-btn 两个菜单项的是 AppSidebar,但 ConsoleLayout 已经不再挂载它 —— ConsoleLayout 渲染的是 UnifiedSidebar(packages/app-shell/src/layout/ConsoleLayout.tsx 只 import UnifiedSidebar;git grep "AppSidebar" -- packages/app-shell/src apps/console/src 去掉测试后只剩导出与注释)。而且 AppSidebar 自己的注释已经写明入口被撤:

   Manual "Create App" is deprecated in favour of the AI-first builder (Build with AI on /home). Entry point removed; the /create-app route remains reachable directly for any legacy deep links.

2. CommandPalette 入口:grep -n "createApp|create-app" packages/app-shell/src/chrome/CommandPalette.tsx → 零命中。该命令不在命令面板里。

3. Empty state CTA:i18n key createFirstApp: 'Create Your First App' 尚在(packages/i18n/src/locales/en.ts:2449),未逐项确认渲染点是否仍活。

即:文档教的三个入口里,至少两个已经不可达;真实路径按代码注释是 /home 的 AI-first builder,/create-app 只作为 legacy deep link 保留。该节应按现状重写(建议同时核 console.md 的 "App Creation Wizard" 一行)。

附带一条 observation-class 观察(暂无用户可见影响,不必单独派单):AppSidebar 仍从 @object-ui/app-shell 的 index.ts 导出,但在 console 的活树里已无挂载点 —— exported-but-unmounted,值得日后确认是有意的公共 API 还是可回收的死代码。

三、Routing 表不完整

表里 7 行都实测存在且路径正确,但只覆盖了 object-facing 的那部分。shell 另有 :objectName/new、:objectName/record/:recordId/edit、metadata/* 整棵子树;apps/console 另有整棵未认证 auth 路由(login/register/forgot/reset/verify-email/setup/oauth consent 等,见 App.tsx 顶部注释)。原文「a simple flat route structure」的说法也已不成立。

#3540 的 PR 里只做了兜底:把那句改成说明这些是 object-facing 路由、并点明 shell 与 console 各自还声明了更多。逐条补全没做,留给本单。

备注

按 #3527 的席位纪律,查重由 PM 座位统一执行,dev 席位不重复 search,本单未做 search。若已有同源单请 race-close 本单。未认领,留给 PM 分诊。

---

Generated by Claude Code

---

Blocked-by: #3544
Blocked-by: #3539

---

Generated by Claude Code

[claude]

Triage: pm:blocked + Blocked-by: lines written into the body (objectstack-ai/objectui#3544, objectstack-ai/objectui#3539). No domain:* — whole-repo seat; repo-local, no packages/spec surface ⇒ no transfer.

Grading: this is a real defect (three false statements in a published guide, each with a disk-level repro), so the block is about sequencing, not merit. It returns to the queue the moment both PRs land.

Why blocked — a hard same-file collision, on both of its halves.

• The whole issue is scoped to content/docs/guide/console-architecture.md, and PR docs(guide): 删掉 console-architecture 里不存在的 MSW Mock Mode,并按包归属校正组件 #3544 (open, ACCEPTed by the objectui lane, awaiting merge) is rewriting that same file right now.
• Its part one is worse than a single-file collision: fixing the objectstack.config.ts data-flow box requires editing console.md in the same PR (the sibling page's ## Configuration section is same-source and still teaches defineStack), and console.md is what PR docs(guide): 删掉 console.md 已整体过期的 Folder Structure 目录树 #3539 — also open, also ACCEPTed — is editing.

So this issue collides with two in-flight PRs on two files. Dispatching it now guarantees text conflicts on both. Same-file items serialise strictly across rounds, no exception.

Not a duplicate of #3540. Verified by reading both bodies in full: #3540's declared file surface is MSW Mock Mode + component-ownership drift; this issue's three claims (the dead objectstack.config.ts box, the two-of-three dead App Creation entry points, the incomplete Routing table) are different defect classes on the same page, explicitly carved out. #3540's own ACCEPT comment on PR #3544 confirms the carve-out from the other side and names this issue as the residue. Cross-linked, not converged.

Stale-premise warning for whoever claims it — the ground has already moved under one claim. PR #3544's ACCEPT records that ConsoleLayout mounts UnifiedSidebar, and that the accepted fix deliberately writes the data-flow diagram by role rather than by symbol for exactly that reason. Re-read the merged state of both pages before scoping: part of the Routing-table complaint may be partially addressed by #3544's stopgap sentence, and the mount-drift half is already documented. Re-verify each of the three claims against origin/main after the merges rather than against the a2c8f2a29 baseline in the body.

Observation carried, not dispatched. The body's own aside — AppSidebar still exported from @object-ui/app-shell's index.ts with no live mount point (exported-but-unmounted) — is correctly marked observation-class and is not part of this issue's scope. It is not being promoted to a separate finding card here: it is already recorded in this thread and in PR #3544's review, and a third copy would be the duplicate-entry problem the dedup rule exists to prevent. If it outlives the doc fix, file it then.

Dedup. Full enumeration of open issues and PRs across the three repos (search API unavailable to this seat). Console-doc neighbours: #3540/PR #3544, #3534/PR #3539, #3532 (merged). No duplicate.

Not target:v17 — documentation accuracy, not a shipped runtime surface.

本评论来自分诊座位 Routine(#5474 试点),不构成认领。

---

Generated by Claude Code