跳转正文

Authoring 反模式 ​

适用范围:Legacy Admin Kit / Schema 与旧 admin-vue。新 admin-nuxtui 的开发入口见管理端 Nuxt UI 指南。

裸 URL 与 DTO copy ​

Page Schema 直接写 endpoint、HTTP method、query key 或复制 generated DTO,会让 transport 事实与页面意图双维护。使用 generated client/catalog 和 feature-local typed adapter。

Feature-local query/form/mutation runtime ​

在 Vue 页面重新维护 filter、sort、pagination、selection、dirty/busy 或通用 mutation 状态,会与 Data Workbench/Form owner 竞争。把业务差异接入现有 ports,不复制状态机。

任意 component path ​

Schema 中写组件文件路径、动态 import、函数脚本或 eval 会绕过 registry/linking。只能引用已登记的 field、renderer、action 与 extension key。

猜 permission、field intent 或 presentation ​

字段名不能证明 label、renderer、identity/headline、查询必要性或 mobile placement。Permission 也不能从 prefix 想当然拼接;先读 generated catalog,再由产品作者决定展示语义。

把 fixture 当 production binding ​

Product Catalog 等 fixture 有明确 provenance,只用于可重复 runtime evidence。不要复制 fixture datasource、延迟或假 bulk job 到正式 feature,也不要把它描述为真实后端闭环。

AI / CLI 自创语义 ​

AI 和 CLI 都是受约束作者。不得通过 prompt-only convention 或 generator heuristic 发明 Schema keyword、renderer、permission、endpoint、ActionContract 或业务 workflow。

CLI 未覆盖就建立第四套 runtime ​

CLI recipe 缺失只说明需要手写 canonical Page Schema/Data Workbench adapter,或需要单独评估 capability gap;不能因此新增 feature-local CRUD framework、legacy JSON 或平行 DSL。

复制 reference 页面 ​

Measuring Unit、Identity Users/Roles、Product Catalog 与 Tenant Management 是可定位 reference,不是复制模板。复用其 public pattern 和 owner 分工,而不是复制整页再改名。

YoyoBoot · 从真实项目走向可复用能力