开发记录：Nuxt Server Routes与BFF接口边界重构
这篇开发记录用于复盘 M5-13 的背景、目标、执行过程和最终结果。
为什么在 M5-13 补 Nuxt Server Routes与BFF接口边界
前面的案例已经覆盖了页面、基础组件、SSR、Nuxt 页面数据、状态管理、复杂交互、认证权限、路由壳层、错误隔离、异步加载、Nuxt 运行时边界、Nuxt 响应策略、Nuxt 执行时机和 Nuxt 依赖边界，但在真实 Nuxt 项目里，还有一条会不断穿透这些内容的横向主线：页面数据虽然已经走进 Nuxt 链路了，但接口层到底有没有真正形成前端自己的边界。
只要这条链路没有收口，前面任何一类场景都会逐渐出现问题：
- 页面开始理解 token、header、provider 字段和多后端聚合细节
server/api变多了，但仍然只是透传底层接口- 请求上下文、鉴权、聚合和映射逻辑挤在同一层里
- 页面数据获取语义和服务端输出语义没有真正站在同一层
所以 M5-13 选择 Nuxt Server Routes 与 BFF 接口边界，是为了把“页面契约、BFF 聚合、请求上下文、下游适配、服务端接口语义”这一条非常常见的横向架构线补齐。
这轮做了什么
这轮主要完成了这些事情：
- 新增 Nuxt Server Routes 与 BFF 接口案例文档
- 新增
M5-13任务拆解文档 - 新增
M5-13详细设计文档 - 更新里程碑、入口、导航与统一框架
- 将 Nuxt 接口边界型案例正式纳入当前方法库
这轮最重要的决策
决策一：先讲页面契约，再讲接口实现
这轮没有把重点放在“API 文件怎么写”，而是放在：
- 页面真正需要的稳定契约是什么
- 为什么
server/api应该表达页面语义，而不是继续暴露 provider 原始结构 - 为什么请求上下文准备和接口级业务组装必须拆开
- 为什么页面不能继续理解后端细节
决策二：选 Nuxt 数据获取与运行时边界案例共同作为素材来源
这组素材非常适合作为案例来源，因为它刚好覆盖了：
- 页面数据获取链路
- 运行时请求上下文准备
- 生命周期与服务端执行时机
- 服务端接口和页面渲染之间的协同关系
它很适合作为“从数据获取，走向接口边界治理”的过渡案例。
决策三：把服务端接口语义和页面数据语义放到同一层
这轮没有把页面数据获取和服务端接口设计拆成两套完全独立的话题，而是把重点放在：
- 页面应该请求怎样的稳定契约
- 服务端接口应该输出怎样的页面语义
- 下游 provider 差异应该如何被封装在内部层次里
这样新案例就能直接挂到当前已经形成的统一框架里。
本轮自测怎么做
这轮仍然只修改文档，因此自测继续聚焦文档完整性：
- 检查新增 Markdown 文件是否生成成功
- 检查本地链接是否全部可解析
- 检查入口页、导航图和总框架是否已经接入新案例
- 检查 M5-13 的任务拆解、详细设计和开发记录是否齐全
本轮结果
M5-13 完成后，当前方法库已经不只覆盖状态、渲染、交互、认证、路由、容错、异步加载、运行时边界、响应策略、执行时机和依赖组织问题，也开始覆盖 Nuxt 服务端接口本身的一条基础主线：Server Routes、BFF 聚合、接口契约设计与下游适配分层。
这意味着后续如果继续扩展：
- 多后端聚合页面的数据契约设计
- 前端 BFF 与 provider 适配层治理
- 页面级接口收口与服务端映射层设计
- token / tenant / session 上下文与接口边界协同
- Nuxt 项目级服务端接口治理
都已经有了稳定挂载点。