2.3 KiB
2.3 KiB
0028. Design Lab 边界与设计中间层
Context
Stitch 不再可用,但产品仍需要把客户需求转化为可预览的小程序设计稿,并保留足够结构化的信息供后续 AI 或确定性工具转换。直接把图片转成 HTML 的保真度不足;直接生成自由 React 代码会破坏现有模板系统和管理端边界。
Decision
- Design Lab 在当前 monorepo 内实现,暂不新开仓库。
packages/design-spec是唯一设计源头,定义DesignSpec、校验器和 HTML renderer。apps/design-lab是独立内部工具,只负责编辑 DesignSpec、展示校验结果和渲染预览。- DesignSpec 只允许使用受控 section 类型与设计 token,不允许描述数据库访问或小程序实现细节。
- 渲染出的 HTML 是设计稿和机器可读中间层,必须携带
data-template-section、data-field、data-action标注。 - Design Lab 第一阶段不直接修改生产模板包,也不直接连接 API 数据库。
Alternatives
- 新建独立仓库:共享 schema 与工程门槛成本更高,等出现独立产品化边界后再拆。
- 放入 Admin:会让后台管理职责和设计生产工具耦合,增加后台 bundle 与权限复杂度。
- 直接生成 React / Taro:容易形成第二套 UI 架构,也无法稳定保证字段契约。
- 图片直接转 HTML:缺少语义结构,保真度和可回溯性不足。
Consequences
Positive
- 设计可以版本化、校验和回滚。
- HTML 对 AI 转换友好,同时保留人可预览的视觉结果。
- 设计工具与线上管理系统、模板包保持隔离。
- 后续可以扩展截图、视觉回归和 manifest 生成,而不改变源头模型。
Negative
- 第一版只能覆盖受限 section 和设计 token,无法表达任意视觉稿。
- 需要 DesignSpec schema 与模板 manifest 的映射文档持续维护。
- 多一个内部应用,需要纳入全局检查流程。
Migration Plan
- 先提供 DesignSpec schema、校验器、HTML renderer 和基础工作台。
- 加入 Playwright 截图与视觉检查,形成可归档的设计稿。
- 补充 DesignSpec 到 template manifest / Taro 模板的半自动转换流程。
- 用至少两个真实行业需求验证完整链路后,再考虑持久化和多人协作。