22 lines
1.4 KiB
Markdown
22 lines
1.4 KiB
Markdown
---
|
|
name: design-frontend-data
|
|
description: 设计前端请求边界、视图模型、状态所有权、缓存、并发和请求响应转换。适用于前端数据层与状态流设计；页面结构、HTTP API 设计、接口字段映射或直接编码不应触发。
|
|
---
|
|
|
|
# 前端数据设计
|
|
|
|
让传输模型、领域数据、视图状态和组件局部状态边界清晰，并适配项目真实框架与请求封装。
|
|
|
|
## 工作流
|
|
|
|
1. 确认框架版本、渲染模式、请求客户端、状态管理和现有数据边界。
|
|
2. 区分服务端状态、共享客户端状态、页面状态、局部状态和可派生状态。
|
|
3. 设计加载、成功、空、错误、取消、重试、竞态、缓存失效和乐观更新行为。
|
|
4. 按 [官方来源](references/sources.md) 核实浏览器请求和框架状态语义。
|
|
5. 输出数据流、所有权、转换边界、并发策略、错误策略和测试点，不预设字段或请求封装。
|
|
6. 用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`。
|
|
|
|
写入后在 `workRoot/<task>/task.json` 登记本次过程或共享文档；已有记录时保守合并，只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则，不修改项目级默认配置。
|
|
|
|
具体 API 字段映射交由 `prepare-api`，页面组合交由 `design-frontend`。
|