SpecialX
|
f92fdf8efe
|
feat(portal-shell): wire AppFrame + navigation + permission filter (P1-1)
实现 ARCHITECTURE.md §10 P1-1：
- 新增 src/shared/lib/navigation.ts：27 项静态导航注册表，
按 teacher/student/parent/admin 四角色分区，group 字段用于角色过滤
- 新增 src/app/shell/layout.tsx：RSC AppFrame，从 headers() 读取
middleware 注入的身份头，batchCheckRoutePermission 按位图二次过滤
- 新增 src/shared/components/layout/user-menu.tsx：顶部用户菜单，
显示 userId + role，登出 POST /api/auth/logout
- 新增 src/shared/lib/__tests__/navigation.test.ts：P1-1 验收单测
（7 用例：href 登记一致性 + 4 角色隔离 + 权限检查）
- 修改 src/shared/lib/route-permissions.ts：补全 7 个列表页根路由
的 EXACT 登记（/shell/admin/announcements、/shell/admin/classes、
/shell/teacher/exams 等），与 PREFIX 表互补避免 catch-all 拒绝
验收：
- vitest run navigation → 7/7 passed
- tsc --noEmit 通过；eslint（5 文件）通过
回填 ARCHITECTURE.md §10 P1-1 状态为 ✅，附验收证据。
关联：ARCHITECTURE.md §7.2 AppFrame / §10 P1-1
|
2026-07-22 12:17:16 +08:00 |
|
SpecialX
|
dc13a2afb4
|
docs(portal-shell): backfill ARCHITECTURE.md §10 P0 completion status
- §10 P0 表格新增"状态"列，全部标记 ✅
- 新增"P0 验收证据（2026-07-22）"小节，逐条附命令/文件引用
- 文档头部状态行从"待实施"改为
"P0 已完成 + P1 进行中"
- 验收依据：
P0-1 login API 401 实测
P0-2 middleware + forbidden page 代码
P0-3 localStorage 仅匹配删除注释
P0-4 getDefaultConfig 实现
P0-5 instrumentation register() 实现
P0-6 vitest 27/27 通过
P0-7 eslint 0 errors
P0-8 git status 干净
|
2026-07-22 11:42:02 +08:00 |
|
SpecialX
|
cfb7b005fd
|
feat(portal-shell): v2.1 P0 auth + middleware + login + graphql proxy
- 新增 ARCHITECTURE.md v3.0：portal-shell 架构权威文档
涵盖 §3.4 V3-A2/A3 认证链、§4 GraphQL 联邦、§5 安全、
§6 部署、§10 P0-P3 验收清单
- 新增 middleware.ts：认证 + 路由门禁
httpOnly cookie edu_session（JWT）读取
DEV_MODE 合成 dev-user/teacher 身份（NODE_ENV!=production &&
NEXT_PUBLIC_DEV_MODE=true）
生产模式 jose JWKS RS256 验签（iss/aud 校验）
路由权限位图注入 x-user-id/x-user-role/x-user-permissions 头
/shell/** 强制 checkRoutePermission，拒绝跳 /shell/forbidden
- 新增 instrumentation.ts：生产环境 DEV_MODE 强制 false
防止生产环境误开 DEV_MODE 合成身份
- 新增 app/api/auth/login/route.ts + logout/route.ts
登录走 api-gateway /v1/iam/login
设置 httpOnly + Secure + SameSite=Strict cookie
- 新增 app/api/graphql/route.ts：同域 GraphQL 代理
转发到 apollo-router，注入 router-authorization 头
- 新增 app/login/page.tsx + login-form.tsx
zod 表单校验，next 参数支持
- 新增 app/shell/forbidden/page.tsx：403 页面
- 更新 route-permissions.ts：补全 P0 路由权限映射
- 更新 permission-bitmap.ts（shared-ts）：位图编码/解码
- 更新 apollo-client.ts：DEV_MODE APQ 关闭，错误处理
- 更新 config-fetcher.ts：config-service 直连降级
- 更新 ApolloProvider.tsx：SSR/RSC 兼容
- 更新 eslint.config.js：design-tokens/no-hardcoded-fonts
白名单调整
|
2026-07-22 11:35:36 +08:00 |
|