Files
persionalBrand/docs/adr/0018-template-visual-slots.md
T

32 lines
2.7 KiB
Markdown

# 0018 模板视觉槽位与内容发布校验
## Context
餐饮原型的固定日程、配送双列和流程列表被错误地转换为任意 TrustContent 记录循环。旧正文、摘要和 config 并存,后台与小程序选择的记录不同。隔离数据库 seed 测试通过,开发数据库和发布快照仍缺字段。
## Decision
- 先确认原型区块、子卡、行和按钮,再声明浅层字段。布局只使用结构化字段,不拆分正文推断布局。
- 餐饮三个固定区域声明 `maxPublishedItems: 1`,每个区域只能有一条公开记录;草稿和旧记录可以保留。其他模板的列表内容可以声明自己的数量限制,未声明时允许多条。发布检查阻止重复公开记录或缺少实际展示字段。
- `hideStandardFields` 明确当前模板不使用的标准列。Admin、共享内容完整性判定和发布校验消费同一声明;隐藏正文不再作为完整性门槛。
- 公开记录投影保留稳定 `id`,视觉步骤列表生成明确索引 key,避免编辑和重排时出现节点复用错误。
- 可编辑状态、标签、步骤说明和页脚文案均由 manifest 声明,业务承诺不得硬编码在 renderer。
- 咨询问题来自已发布 InquiryForm,模板样例只在显式导入或限定开发 fixture 时复制。历史提交快照不改变。
- 完成必须覆盖当前数据库、发布 API、最终生成文件和页面数据。静态源码检查和独立 seed 测试不能代替实际数据迁移。
## Alternatives
保留正文拆分兼容会继续产生双数据源。为餐饮新建专用表会把示例行业侵入平台模型。采用浅层 TrustContent.config 与模板声明即可保持可替换模板边界。
## Consequences
旧记录可以作为草稿查看和恢复,但不能同时公开到同一必填视觉区域。后台列表展示实际 config 内容预览。发布失败明确引导用户完善对应区块。
## Migration Plan
`apps/api/scripts/migrate-food-template-content.ts` 只处理开发餐饮品牌,执行前备份,事务内迁移,保留旧记录为草稿,并创建新发布版本。命令默认 dry run,`--apply` 执行;成功标记后再次执行不写数据。生产客户必须另行制定品牌内容迁移映射,不能批量导入演示承诺。
## 主理人视觉约束
整理主理人页内容不得改为通用正文卡。以 OwnerView 原型为基准保留 208 px 写真封面、渐变身份区、三列资质图标小卡、案例简称/说明/结果标签及回复承诺圆点/强调色。新增槽位使用浅层 config 列表;不拆旧正文来猜测条目。缺少结构化数据时可显示原有正文,但不能用样例遮挡用户编辑。原型中的证书、经营年限和统计只在品牌管理员确认后填写。