---
name: design-frontend-data
description: 设计前端请求边界、视图模型、状态所有权、缓存、并发和请求响应转换。适用于前端数据层与状态流设计；页面结构、HTTP API 设计、接口字段映射或直接编码不应触发。
---

# 前端数据设计

让传输模型、领域数据、视图状态和组件局部状态边界清晰，并适配项目真实框架与请求封装。

## 工作流

1. 确认框架版本、渲染模式、请求客户端、状态管理和现有数据边界。
2. 区分服务端状态、共享客户端状态、页面状态、局部状态和可派生状态。
3. 设计加载、成功、空、错误、取消、重试、竞态、缓存失效和乐观更新行为。
4. 按 [官方来源](references/sources.md) 核实浏览器请求和框架状态语义。
5. 输出数据流、所有权、转换边界、并发策略、错误策略和测试点，不预设字段或请求封装。
6. 用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`。

落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。`r`n`r`n写入后在 `workRoot/<task>/task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。

具体 API 字段映射交由 `prepare-api`，页面组合交由 `design-frontend`。