Files
persionalBrand/docs/adr/0028-design-lab-boundaries.md
T

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

  1. 新建独立仓库:共享 schema 与工程门槛成本更高,等出现独立产品化边界后再拆。
  2. 放入 Admin:会让后台管理职责和设计生产工具耦合,增加后台 bundle 与权限复杂度。
  3. 直接生成 React / Taro:容易形成第二套 UI 架构,也无法稳定保证字段契约。
  4. 图片直接转 HTML:缺少语义结构,保真度和可回溯性不足。

Consequences

Positive

  • 设计可以版本化、校验和回滚。
  • HTML 对 AI 转换友好,同时保留人可预览的视觉结果。
  • 设计工具与线上管理系统、模板包保持隔离。
  • 后续可以扩展截图、视觉回归和 manifest 生成,而不改变源头模型。

Negative

  • 第一版只能覆盖受限 section 和设计 token,无法表达任意视觉稿。
  • 需要 DesignSpec schema 与模板 manifest 的映射文档持续维护。
  • 多一个内部应用,需要纳入全局检查流程。

Migration Plan

  1. 先提供 DesignSpec schema、校验器、HTML renderer 和基础工作台。
  2. 加入 Playwright 截图与视觉检查,形成可归档的设计稿。
  3. 补充 DesignSpec 到 template manifest / Taro 模板的半自动转换流程。
  4. 用至少两个真实行业需求验证完整链路后,再考虑持久化和多人协作。