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