figma-ios-playbook

Figma → iOS 代码生成（入口）

📌 本 playbook 的产物定位（重要）

本 playbook 产出的是 阶段 2 基础 UI 代码（不是最终商用代码）：

• ✅ UI 视觉 / 布局 / 样式 / 交互骨架 100% 还原
• ✅ 数据走 mock（URL 用 manifest.json.mock.default_image_url，模型用临时 struct + 从 Figma 文字提取的数据）
• ✅ 业务逻辑留 // TODO(阶段3): ... 锚点
• ❌ 不负责：接口对接、ViewModel / Service、路由、埋点、错误处理、权限、持久化

这些由 阶段 3（结合 PRD + 接口文档二次加工，人工或另一个 AI 会话完成）接手。阶段 2 的目标是「UI 能跑能看，阶段 3 接手时只动数据层不动视图层」。

🏷 类名前缀（强制）

所有新建顶层类型（class / struct / enum / protocol / actor）必须以业务类前缀 <P> 开头，见 host.json / PROJECT_BINDING §0。

可选外部 driver 若注入 CLASS_PREFIX = <P> 则优先于 host.json（本开源仓不附带 driver）。本文档示例中的 XxxVC / XxxView / XxxCell 占位应理解为 <P>XxxVC 等（真实生成时展开，如 AppFillOrderVC）。

---

⛔ 强制流程：先输出「节点 → view 映射表」再写一行代码

阶段 2 开始第一件事就是产出一份对账表（直接放生成代码文件顶部的注释里），覆盖 design.json 中所有非跳过节点。在没有这份表前，禁止直接写 class <P>XxxVC: ... / private lazy var ... = ...。

表格模板（必须按此格式输出）

// ============== 节点 → View 映射表（共 N 个节点，跳过 K 个）==============
// node_id              type           name                       impl
// 341:265              GROUP          填写派单要求_增加外露品类       根 view（self.view）
// 341:266              GROUP          bg                         backgroundImageView（整组导出，无语义子节点 → 切图）
// 341:273              GROUP          编组 3                     stepStripContainer（含 6 个语义子节点 → 拆解）
//   ↳ 341:274          RECTANGLE      矩形                       stepStripBgView（蓝色圆角底）
//   ↳ 341:275          FRAME          编组 4                     step1Container
//     ↳ 341:276        TEXT           填写要求                   step1TitleLabel
//     ↳ 341:277        TEXT           STEP.1                    step1IndexLabel
//   ↳ 341:284          RECTANGLE      位图                       stepArrow1ImageView (img_af078_asset)
//   ...
// 341:311              INSTANCE       系统控件/home indicator   <skip> (figma-ios-to-code-conventions)
// ...
// === 跳过节点统计 ===
// - Home Indicator: 341:311 (系统控件)
// - Status Bar: <none>（设计稿无该节点）
//
// === 切图节点统计（assets/ios/manifest.json）===
// 341:266 → img_51be1_bg            (背景图，纯位图)
// 341:284 → img_af078_asset         (步骤箭头 1)
// ...
//
// === 列表节点 ===
// 341:332 (Property 1=水平): scroll=horizontal, cell=341:333, count=5
// ...