背景
架构设计(骨架版)见 #45。07-24 导师会议指出该文档主要定的是目录组织与编码规范,本阶段还需交出模块清单与各模块对外接口,并体现在提交的代码里。后端初始骨架已提(#57),前端需要对齐落地。
目标
提交可编译、可运行的前端初始骨架,把模块边界与协作关系落到代码上。空的是实现,不是接口——函数签名、参数与返回类型需明确,后端据此可推出要提供哪些接口。
范围
- 按架构文档建立
app / pages / features / entities / shared 五层与各 Slice
entities/index.ts 列全对外 export:Project 已对接后端;Character、WorkflowRun、ActionTemplate、Wearable 为提案,待前后端走查
- 四个 feature 的对外 props;六个页面外壳;全局错误边界与 404 兜底
shared/api 下 client/{real,mock,mappers},mock 与真实现对外一致
- 工作流状态暂存本地(后端确认当前不存 workflow,以后会存),对外签名按将来走网络的形状设计,后端接管时只需替换
entities/workflow-run/api/ 下的实现
- 依赖边界自动检查 + 单元测试与集成测试
不在本次范围
画布实现、PixiJS 试玩、真实生成链路、后端尚未提供的接口实现、生产监控与全局通知。
验收
npm run typecheck / lint / build / test 全部通过
- 依赖边界检查通过:分层方向、同层 Slice 不互相 import、跨 Slice 只走
index.ts
- Quick Start 创建 WorkflowRun 后能进入 Workflow Editor,两边使用同一个 runId
已知保留项
六条待与后端确认,已记在 frontend/README.md:精灵尺寸口径(接口文档写 32~2048 任意整数,表注释列的是七个档位)、user_id 何时改由 token 推出、WorkflowRun.id 类型(前端按架构文档用 string,windup_project.workflow_id 是 BIGINT)、生成异步链路的具体形状(任务 id、SSE 端点与事件字段)、角色/动作/资产接口的路径与字段、一个动作几帧的来源字段。
在前后端共同走查完成前,entities 的接口按提案对待,不作为已定契约。
Refs #45 #51
背景
架构设计(骨架版)见 #45。07-24 导师会议指出该文档主要定的是目录组织与编码规范,本阶段还需交出模块清单与各模块对外接口,并体现在提交的代码里。后端初始骨架已提(#57),前端需要对齐落地。
目标
提交可编译、可运行的前端初始骨架,把模块边界与协作关系落到代码上。空的是实现,不是接口——函数签名、参数与返回类型需明确,后端据此可推出要提供哪些接口。
范围
app / pages / features / entities / shared五层与各 Sliceentities/index.ts列全对外 export:Project 已对接后端;Character、WorkflowRun、ActionTemplate、Wearable 为提案,待前后端走查shared/api下client/{real,mock,mappers},mock 与真实现对外一致entities/workflow-run/api/下的实现不在本次范围
画布实现、PixiJS 试玩、真实生成链路、后端尚未提供的接口实现、生产监控与全局通知。
验收
npm run typecheck / lint / build / test全部通过index.ts已知保留项
六条待与后端确认,已记在
frontend/README.md:精灵尺寸口径(接口文档写 32~2048 任意整数,表注释列的是七个档位)、user_id何时改由 token 推出、WorkflowRun.id类型(前端按架构文档用 string,windup_project.workflow_id是 BIGINT)、生成异步链路的具体形状(任务 id、SSE 端点与事件字段)、角色/动作/资产接口的路径与字段、一个动作几帧的来源字段。在前后端共同走查完成前,entities 的接口按提案对待,不作为已定契约。
Refs #45 #51