Skip to content

前端 MS2 初始骨架:目录结构、模块接口与依赖边界 #58

Description

@huyanxius

背景

架构设计(骨架版)见 #45。07-24 导师会议指出该文档主要定的是目录组织与编码规范,本阶段还需交出模块清单与各模块对外接口,并体现在提交的代码里。后端初始骨架已提(#57),前端需要对齐落地。

目标

提交可编译、可运行的前端初始骨架,把模块边界与协作关系落到代码上。空的是实现,不是接口——函数签名、参数与返回类型需明确,后端据此可推出要提供哪些接口。

范围

  • 按架构文档建立 app / pages / features / entities / shared 五层与各 Slice
  • entities/index.ts 列全对外 export:Project 已对接后端;Character、WorkflowRun、ActionTemplate、Wearable 为提案,待前后端走查
  • 四个 feature 的对外 props;六个页面外壳;全局错误边界与 404 兜底
  • shared/apiclient/{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

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions