M5-5详细设计：认证链路与权限边界

这份设计文档说明 M5-5 为什么选择认证与权限场景，以及它将如何接入现有方法库。

设计目标

把认证问题从“登录页怎么写”还原成“认证状态如何穿过请求层、路由层与页面层”的边界设计问题，并用一篇案例把现代 Vue / Nuxt 项目里更稳的组织方式说清楚。

为什么在 M5-5 选认证与权限

在当前方法库里，已经补齐了：

• 页面型案例
• 基础组件型案例
• SSR / hydration 运行时边界
• Nuxt 页面数据获取与渲染边界
• 状态管理型案例
• 动画与复杂交互型案例

下一步最自然补的，就是登录态、请求层和路由准入这条横向主线。因为它会同时影响：

• 页面型案例中的入口与跳转逻辑
• 状态管理案例中的 session store 设计
• Nuxt / SSR 场景中的客户端恢复与权限控制
• 后台系统里的角色准入和页面装配

所以认证与权限是一个非常适合作为 M5-5 的横向扩展线。

本轮案例的复杂度中心

本轮复杂度中心主要有四个：

• 会话状态的唯一来源
• 请求层与 UI / store 的解耦
• 路由准入协议的显式化
• 登录成功回跳与失效退出的统一处理

与现有框架的映射关系

本轮将重点强化统一框架中的这些步骤：

• 第二步：找到真正的复杂度中心
• 第四步：判断状态应该放在页面、组件还是 composable
• 第六步：把通信链路改成显式契约
• 第七步：把副作用和派生状态分开

本轮交付物

本轮预期交付物包括：

• 新案例：../认证请求与路由权限链路重构.md
• 新任务拆解：16-M5-5任务拆解-认证与权限场景.md
• 新详细设计：17-M5-5详细设计-认证链路与权限边界.md
• 新开发记录：18-开发记录-认证与路由权限链路重构.md

设计约束

本轮继续遵循当前项目约束：

• 不直接修改独立 demo 源码
• 只提炼核心逻辑与方法进入文档
• 每轮新增案例都要同步更新入口、导航和总框架

完成后的预期效果

完成后，当前方法库将会同时覆盖：

• 页面型重构
• 基础组件型重构
• 运行时边界型重构
• 框架场景型重构
• 状态管理型重构
• 复杂交互型重构
• 认证与权限型重构

这会让整套方法库从“案例集合”，继续长成一张更完整的 Vue / Nuxt 架构重构地图。