This commit is contained in:
Zyronon
2025-12-05 18:56:17 +08:00
committed by GitHub
parent 7f05ec95d9
commit 0a8cd8182a
4 changed files with 360 additions and 0 deletions

View File

@@ -0,0 +1,42 @@
遵照您的指示,我将在迁移代码之前,先梳理并输出详细的需求文档和架构文档。
**更新后的详细执行计划:**
### 第一阶段:文档编写 (Documentation)
1. **需求文档 (`documents/Requirement_Analysis.md`)**:
* 基于源码(`router.ts`, `types.ts` 等)深度解析现有功能。
* 详细列出功能模块:单词练习(多种模式)、文章练习(音频同步)、词典管理(本地/在线、用户系统VIP/同步)、快捷键系统等。
* 明确数据结构Word, Article, Dict, User 等核心实体的定义。
2. **架构文档 (`documents/System_Architecture.md`)**:
* **技术栈**: Vue 3 -> Nuxt 4, Pinia, UnoCSS, IndexedDB。
* **目录结构**: 详细对比 `TypeWords``nuxt-tw` 的目录映射关系。
* **数据流**: 描述前端与后端 (API)、本地存储 (IndexedDB) 的交互流程。
* **路由设计**: 规划 Nuxt 的文件路由结构。
### 第二阶段:基础设施与依赖 (Infrastructure & Dependencies)
1. **清理与配置**:
* 移除 `nuxt-tw` 中的临时文件和 `@nuxt/ui` 及其 Tailwind 依赖。
* 配置 `nuxt.config.ts`:移除 UI 模块,添加 `@unocss/nuxt`
* 创建 `uno.config.ts`
2. **依赖安装**:
* 安装核心依赖:`unocss`, `pinia`, `sass`, `idb-keyval`, `dayjs`, `lodash` 等。
### 第三阶段:核心逻辑迁移 (Core Logic)
1. **类型与工具**: 迁移 `types``utils/libs`
2. **状态管理**: 迁移 `stores` 到 Nuxt Pinia 模块。
3. **Composables**: 重构 `hooks``apis` 为 Nuxt Composables。
### 第四阶段:资源与组件 (Assets & Components)
1. **静态资源**: 迁移 `assets``public`
2. **组件迁移**: 迁移并适配所有 Vue 组件。
### 第五阶段:页面与路由 (Pages & Routing)
1. **页面重构**: 将 Vue Router 配置转换为 `pages/` 目录结构。
2. **元数据适配**: 使用 `definePageMeta``useHead`
### 第六阶段:验证 (Verification)
1. **功能测试**: 验证核心业务流程(登录、练习、词典加载)。
2. **样式检查**: 确保 UnoCSS 样式正确应用。
**确认执行?**
如果同意,我将首先生成两份文档,供您查阅和存档。