docs: move frontend structure into task one

This commit is contained in:
liyy 2026-08-28 09:34:22 +08:00
parent a865c15aed
commit 4acad681e1

View File

@ -17,19 +17,19 @@
## 2. 任务顺序 ## 2. 任务顺序
### 任务 01项目初始化与目录确定 ### 任务 01项目初始化与目录整理
工作创建前后端目录、TypeScript 配置、包管理脚本、环境变量模板、基础 Git 忽略规则。 工作创建前后端目录、TypeScript 配置、包管理脚本、环境变量模板、基础 Git 忽略规则;按照需求文档拆分前端 `api``stores``layouts``views``components``composables``styles``types``utils` 目录;将已有散落代码移动到明确归属的位置,建立统一入口
产出:前后端分别可以启动;开发、构建、类型检查命令可执行。 产出:前后端分别可以启动;前端目录结构与需求文档一致;开发、构建、类型检查命令可执行。
完成标准:新环境按 README 操作可以启动前端和后端,启动失败时有明确错误。 完成标准:新环境按 README 操作可以启动前后端;页面、样式、请求和状态没有继续堆在 `App.vue` 或单一目录;新增页面和功能都有明确放置位置;启动失败时有明确错误。
### 任务 02JSON Store 与演示数据 ### 任务 02JSON Store 与演示数据
工作:实现 `readData``writeData``updateData`,建立数据文件路径常量和缺失文件初始化;录入演示题、用户档案、计划、模考和要闻数据。 工作:实现 `readData``writeData``updateData`,建立数据文件路径常量和缺失文件初始化;录入演示题、用户档案、计划、模考和要闻数据。
产出:`server/data/` 可独立运行;写入使用临时文件后原子替换。需要兼容开发/生产两套环境。 产出:`data/` 可独立运行;写入使用临时文件后原子替换。需要兼容开发/生产两套环境。
完成标准:服务重启后数据仍然存在;任一 JSON 文件缺失不会导致服务崩溃;非法 JSON 有可定位错误。 完成标准:服务重启后数据仍然存在;任一 JSON 文件缺失不会导致服务崩溃;非法 JSON 有可定位错误。
@ -41,9 +41,9 @@
完成标准:所有已登记接口都出现在文档中;请求参数错误能返回统一错误;`openapi:export` 可重复执行。 完成标准:所有已登记接口都出现在文档中;请求参数错误能返回统一错误;`openapi:export` 可重复执行。
### 任务 04前端 API 自动生成与基础壳层 ### 任务 04前端 API 自动生成与基础视觉壳层
工作:接入 OpenAPI 代码生成;建立请求客户端、路由、Pinia 基础 store、设计 Token、全局布局、PC 侧栏和 Mobile TabBar。 工作:接入 OpenAPI 代码生成;完善请求客户端、路由、Pinia 基础 store落地设计 Token、全局布局、PC 侧栏和 Mobile TabBar。
产出:`client/src/api/generated/`;页面可在桌面和移动断点切换;统一加载、空数据、错误提示组件。 产出:`client/src/api/generated/`;页面可在桌面和移动断点切换;统一加载、空数据、错误提示组件。