Files
TypeWords/docs/更新后的详细执行计划.md
Zyronon 0a8cd8182a wip
2025-12-05 18:56:17 +08:00

2.2 KiB
Raw Blame History

遵照您的指示,我将在迁移代码之前,先梳理并输出详细的需求文档和架构文档。

更新后的详细执行计划:

第一阶段:文档编写 (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。
    • 目录结构: 详细对比 TypeWordsnuxt-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. 类型与工具: 迁移 typesutils/libs
  2. 状态管理: 迁移 stores 到 Nuxt Pinia 模块。
  3. Composables: 重构 hooksapis 为 Nuxt Composables。

第四阶段:资源与组件 (Assets & Components)

  1. 静态资源: 迁移 assetspublic
  2. 组件迁移: 迁移并适配所有 Vue 组件。

第五阶段:页面与路由 (Pages & Routing)

  1. 页面重构: 将 Vue Router 配置转换为 pages/ 目录结构。
  2. 元数据适配: 使用 definePageMetauseHead

第六阶段:验证 (Verification)

  1. 功能测试: 验证核心业务流程(登录、练习、词典加载)。
  2. 样式检查: 确保 UnoCSS 样式正确应用。

确认执行? 如果同意,我将首先生成两份文档,供您查阅和存档。