feat: auto committed

docs/architecture/issues/contracts/teacher-portal_contract.md

@@ -60,11 +60,11 @@
 
 ### 2.3 HTTP 调用（如有）
 
-| 被调用方            | Method.Path               | 用途                                          | mock 策略                                                         |
-| ------------------- | ------------------------- | --------------------------------------------- | ----------------------------------------------------------------- |
-| api-gateway (ai01)  | POST /api/teacher/graphql | 教师 GraphQL 查询（经网关代理到 teacher-bff） | api-gateway/teacher-bff 就绪前使用 MSW 拦截返回 mock GraphQL 响应 |
-| api-gateway (ai01)  | POST /api/auth/login      | 教师登录                                      | api-gateway 就绪前使用 MSW 返回固定 JWT                           |
-| push-gateway (ai02) | GET /ws                   | WebSocket 实时通知                            | push-gateway 就绪前使用 mock-socket 模拟 WS 推送                  |
+| 被调用方            | Method.Path                  | 用途                                          | mock 策略                                                         |
+| ------------------- | ---------------------------- | --------------------------------------------- | ----------------------------------------------------------------- |
+| api-gateway (ai01)  | POST /api/v1/teacher/graphql | 教师 GraphQL 查询（经网关代理到 teacher-bff，对齐 matrix.md §5） | api-gateway/teacher-bff 就绪前使用 MSW 拦截返回 mock GraphQL 响应 |
+| api-gateway (ai01)  | POST /api/auth/login         | 教师登录（非 GraphQL，认证前提，F12: JWT 存 localStorage） | api-gateway 就绪前使用 MSW 返回固定 JWT                           |
+| push-gateway (ai02) | GET /ws                      | WebSocket 实时通知                            | push-gateway 就绪前使用 mock-socket 模拟 WS 推送                  |
 
 ### 2.4 GraphQL 查询域（经 api-gateway 代理到 teacher-bff）
 
@@ -97,8 +97,8 @@
 - [ ] teacher-portal dev server :4000 启用
 - [ ] MF Shell 可加载（首页渲染 AppShell + 导航）
 - [ ] 子应用路由可访问（/classes /exams /homework 等子页面渲染）
-- [ ] 登录流程可用（POST /api/auth/login 获取 JWT 存入 cookie）
-- [ ] GraphQL 查询可执行（currentUser / myClasses 返回数据）
+- [ ] 登录流程可用（POST /api/auth/login 获取 JWT 存入 localStorage，F12；P6 迁移 httpOnly cookie）
+- [ ] GraphQL 查询可执行（dashboard / viewports / me / classes / class Query，ARB-001）
 - [ ] WebSocket 通知可接收（push-gateway 推送 → 前端通知中心更新）
 
 ---
@@ -118,9 +118,9 @@ teacher-portal 是最前端，无下游消费方。但对开发体验提供：
 
 - **HTTP/GraphQL mock**：使用 MSW（Mock Service Worker）拦截所有请求
   - POST /api/auth/login → 返回固定 JWT + UserInfo
-  - POST /api/teacher/graphql → 根据 operationName 返回对应 mock 响应（与 teacher-bff mock 数据一致）
+  - POST /api/v1/teacher/graphql → 根据 operationName 返回对应 mock 响应（与 teacher-bff mock 数据一致，对齐 §2.3）
   - 所有 mock 响应定义在 `apps/teacher-portal/src/mocks/fixtures/*.json`
 - **WebSocket mock**：使用 mock-socket 库
   - 连接 ws://localhost:8081/ws 后每 30 秒推送 1 条 mock 通知
-- **JWT mock**：使用固定 mock JWT（与 api-gateway mock 公钥配对），存入 httpOnly cookie
+- **JWT mock**：使用固定 mock JWT（与 api-gateway mock 公钥配对），存入 localStorage（F12；P6 迁移 httpOnly cookie）
 - **环境切换**：通过 `NEXT_PUBLIC_API_MOCKING=enabled` 环境变量控制是否启用 MSW，上游就绪后设为 `disabled`