里程碑规划

这份里程碑规划文档，用来定义本轮 11Vue学习/组件化思维 文档化重构项目的执行顺序、交付物和当前状态。

项目目标

把零散的 Vue 练习项目重构经验，整理成一套具备下面特征的方法库：

• 有统一入口
• 有方法总纲
• 有案例拆解
• 有过程文档
• 有后续扩展位

里程碑总览

M1：案例沉淀

目标：把典型练习项目拆成可复用案例。

交付物：

• 页面型案例 3 篇
• 基础组件型案例 3 篇

当前状态：已完成。

M2：方法统一

目标：把案例抽象成一套统一的 Vue 重构框架。

交付物：

• Vue练习项目重构统一框架

当前状态：已完成。

M3：导航体系

目标：让文档可以按问题、场景和能力快速检索。

交付物：

• Vue重构案例导航图

当前状态：已完成。

M4：项目化流程文档

目标：把执行顺序、详细设计和开发记录补齐，形成完整交付链路。

交付物：

• docs/01-详细设计-文档体系结构.md
• docs/02-详细设计-执行顺序与交付流.md
• docs/03-开发记录-Vue文档化重构实践.md
• README.md

当前状态：已完成。

M5：持续扩展阶段

目标：继续新增案例，并按统一框架挂载到当前方法库中。

候选方向：

• 更多 Nuxt / Vue 3 场景
• 状态管理场景
• SSR / hydration 场景
• 动画与复杂交互场景
• 认证与权限场景
• 路由缓存与布局场景
• 错误边界与降级场景
• 异步组件与懒加载场景
• Nuxt中间件与插件场景
• Nuxt路由规则与混合渲染场景
• Nuxt生命周期与副作用场景
• Nuxt自动导入与隐式依赖场景
• Nuxt Server Routes与BFF接口场景
• Nuxt组合式能力分层场景
• Nuxt业务模块组织场景
• Nuxt应用公共层治理场景

当前阶段：M5-1（SSR / hydration）+ M5-2（Nuxt 数据获取与渲染模式）+ M5-3（状态管理与 Pinia 迁移）+ M5-4（动画与复杂交互链路）+ M5-5（认证与路由权限链路）+ M5-6（路由缓存与布局编排）+ M5-7（错误边界与客户端降级）+ M5-8（异步组件与懒加载降级）+ M5-9（Nuxt中间件与插件注入边界）+ M5-10（Nuxt路由规则与混合渲染策略）+ M5-11（Nuxt生命周期与副作用时机）+ M5-12（Nuxt自动导入与隐式依赖边界）+ M5-13（Nuxt Server Routes与BFF接口边界）+ M5-14（Nuxt组合式能力分层与页面编排边界）+ M5-15（Nuxt业务模块与feature目录边界）+ M5-16（Nuxt应用公共层与共享能力治理）

本轮交付物：

• ../SSR数据预取与水合重构.md
• 04-M5任务拆解-SSR与水合场景.md
• 05-M5详细设计-SSR数据流与水合边界.md
• 06-开发记录-SSR与水合文档化重构.md
• ../Nuxt数据获取与渲染模式重构.md
• 07-M5-2任务拆解-Nuxt数据获取与渲染模式.md
• 08-M5-2详细设计-Nuxt数据流与渲染边界.md
• 09-开发记录-Nuxt数据获取与渲染模式重构.md
• ../Vuex状态中心与Pinia迁移重构.md
• 10-M5-3任务拆解-状态管理场景.md
• 11-M5-3详细设计-状态边界与Pinia迁移.md
• 12-开发记录-状态管理与Pinia迁移重构.md
• ../动画与复杂交互链路重构.md
• 13-M5-4任务拆解-动画与复杂交互场景.md
• 14-M5-4详细设计-动画状态与交互协调层.md
• 15-开发记录-动画与复杂交互链路重构.md
• ../认证请求与路由权限链路重构.md
• 16-M5-5任务拆解-认证与权限场景.md
• 17-M5-5详细设计-认证链路与权限边界.md
• 18-开发记录-认证与路由权限链路重构.md
• ../路由视图缓存与布局编排重构.md
• 19-M5-6任务拆解-路由缓存与布局场景.md
• 20-M5-6详细设计-路由视图与缓存边界.md
• 21-开发记录-路由缓存与布局编排重构.md
• ../错误边界与客户端降级渲染重构.md
• 22-M5-7任务拆解-错误边界与降级场景.md
• 23-M5-7详细设计-错误隔离与客户端降级边界.md
• 24-开发记录-错误边界与客户端降级重构.md
• ../异步组件与懒加载降级重构.md
• 25-M5-8任务拆解-异步组件与懒加载场景.md
• 26-M5-8详细设计-异步加载与占位边界.md
• 27-开发记录-异步组件与懒加载降级重构.md
• ../Nuxt中间件与插件注入边界重构.md
• 29-M5-9任务拆解-Nuxt中间件与插件场景.md
• 30-M5-9详细设计-Nuxt运行时注入与中间件边界.md
• 31-开发记录-Nuxt中间件与插件注入边界重构.md
• ../Nuxt路由规则与混合渲染策略重构.md
• 32-M5-10任务拆解-Nuxt路由规则与混合渲染场景.md
• 33-M5-10详细设计-Nuxt路由规则与混合渲染边界.md
• 34-开发记录-Nuxt路由规则与混合渲染策略重构.md
• ../Nuxt生命周期与副作用时机重构.md
• 35-M5-11任务拆解-Nuxt生命周期与副作用场景.md
• 36-M5-11详细设计-Nuxt生命周期与副作用时机边界.md
• 37-开发记录-Nuxt生命周期与副作用时机重构.md
• ../Nuxt自动导入与隐式依赖边界重构.md
• 38-M5-12任务拆解-Nuxt自动导入与隐式依赖场景.md
• 39-M5-12详细设计-Nuxt自动导入与隐式依赖边界.md
• 40-开发记录-Nuxt自动导入与隐式依赖边界重构.md
• ../NuxtServerRoutes与BFF接口边界重构.md
• 41-M5-13任务拆解-NuxtServerRoutes与BFF接口场景.md
• 42-M5-13详细设计-NuxtServerRoutes与BFF接口边界.md
• 43-开发记录-NuxtServerRoutes与BFF接口边界重构.md
• ../Nuxt组合式能力分层与页面编排边界重构.md
• 44-M5-14任务拆解-Nuxt组合式能力分层场景.md
• 45-M5-14详细设计-Nuxt组合式能力与页面编排边界.md
• 46-开发记录-Nuxt组合式能力分层与页面编排重构.md
• ../Nuxt业务模块与feature目录边界重构.md
• 47-M5-15任务拆解-Nuxt业务模块组织场景.md
• 48-M5-15详细设计-Nuxt业务模块与feature目录边界.md
• 49-开发记录-Nuxt业务模块与feature目录重构.md
• ../Nuxt应用公共层与共享能力治理重构.md
• 50-M5-16任务拆解-Nuxt应用公共层治理场景.md
• 51-M5-16详细设计-Nuxt应用公共层与共享能力边界.md
• 52-开发记录-Nuxt应用公共层与共享能力治理重构.md

当前状态：M5-16 文档已完成，待进入下一子阶段。

当前推荐执行顺序

建议按下面顺序持续推进：

• 先阅读并遵循 执行清单：里程碑任务开发与交付规范
• 先维护导航层和统一框架
• 再增加新的案例文档
• 每次增加案例时同步补充开发记录
• 每个阶段结束后回看导航分类是否需要扩容

里程碑完成标准

判断一个里程碑是否真正完成，可以用下面的标准：

• 是否产出了明确文档文件
• 是否已经链接进入口页
• 是否可以被后续案例继续复用
• 是否降低了后续新增内容的组织成本