feat(portal-shell): course-plans + elective 模块 5 页迁移(教师域 §9.1 B2)

§9.1 line 635-636 教师域:
- /shell/teacher/course-plans (列表) + /[id] (详情) — 2 页
- /shell/teacher/elective (列表) + /create (表单) + /[id]/edit (编辑表单) — 3 页
契约:全  schema 无 → MSW 兜底 + @contract-pending

新增文件:
- src/lib/api/{course-plans,elective}.ts (8 hooks 合计)
- src/lib/api/operations/{course-plans,elective}.graphql.ts (8 documents)
- src/features/teacher/{course-plans,elective}/ (clients + transformations + tests)
- src/app/shell/teacher/{course-plans,elective}/ (5 page.tsx + 2 loading + 2 error)

修改文件:
- src/mocks/graphql-data.ts (3 mock 数据 + 8 handler cases)
- src/messages/{zh-CN,en}.json (coursePlans/elective i18n 命名空间)
- src/lib/api/{index,operations/index}.ts (导出 course-plans/elective)
- src/shared/lib/route-permissions.ts (2 EXACT + 2 PREFIX 条目)
- scripts/check-page-count.ts (baseline 48 → 53)

DoD 验收(§11.3 11 项):
- typecheck 0 errors
- lint 0 errors
- vitest 645 tests passed
- lint:tokens 0 errors
- check:pages 53 PASS
- route-permissions 已声明
- 三态齐备
- @contract-pending + MSW 兜底
- i18n zh-CN + en 同步

设计决策:
- COURSE_PLAN_* 权限点不存在于 PERMISSION_BITMAP_ORDER,复用 LESSON_PLAN_READ/CREATE/UPDATE(同备课域语义对齐)
- elective 使用已存在的 ELECTIVE_READ/ELECTIVE_MANAGE
- 编辑表单用 useEffect + initialized state guard 预填数据

关联:ARCHITECTURE.md §5.3 / §5.4 / §9.1 / §10 P2 / §11.3 / §11.4
契约工单:docs/architecture/issues/contracts/core-edu_contract.md
This commit is contained in:
SpecialX
2026-07-22 23:15:45 +08:00
parent 73e09ca29a
commit 80cc1d2461
29 changed files with 3835 additions and 6 deletions

View File

@@ -168,6 +168,23 @@ export const EXACT_ROUTE_PERMISSIONS: Record<string, RoutePermissionConfig> = {
requiredRoles: ["teacher", "admin"],
anyOfPermissions: ["DIAGNOSTIC_READ", "DIAGNOSTIC_MANAGE"],
},
// P2 迁移B2 教师域):课程计划列表页根路由(无尾斜杠)
// 无 COURSE_PLAN_* 权限点,复用 LESSON_PLAN_READ/CREATE/UPDATE
// (课程计划与教案同属备课域,权限语义对齐)
"/shell/teacher/course-plans": {
requiredRoles: ["teacher", "admin"],
anyOfPermissions: [
"LESSON_PLAN_READ",
"LESSON_PLAN_CREATE",
"LESSON_PLAN_UPDATE",
],
},
// P2 迁移B2 教师域):选修课列表页根路由(无尾斜杠)
// ELECTIVE_READ/MANAGE/SELECT 权限点已存在PERMISSION_BITMAP_ORDER 116-118
"/shell/teacher/elective": {
requiredRoles: ["teacher", "admin"],
anyOfPermissions: ["ELECTIVE_READ", "ELECTIVE_MANAGE"],
},
// ── student 专属 ──────────────────────────────────────────
"/shell/student/error-book": {
@@ -312,6 +329,29 @@ export const PREFIX_ROUTE_PERMISSIONS: Array<{
anyOfPermissions: ["DIAGNOSTIC_READ", "DIAGNOSTIC_MANAGE"],
},
},
// P2 迁移B2 教师域):课程计划子路由(含 /shell/teacher/course-plans/[id]
// 复用 LESSON_PLAN_READ/CREATE/UPDATE同备课域
{
prefix: "/shell/teacher/course-plans/",
config: {
requiredRoles: ["teacher", "admin"],
anyOfPermissions: [
"LESSON_PLAN_READ",
"LESSON_PLAN_CREATE",
"LESSON_PLAN_UPDATE",
],
},
},
// P2 迁移B2 教师域):选修课子路由(含 /shell/teacher/elective/create
// 和 /shell/teacher/elective/[id]/edit
// ELECTIVE_READ/MANAGE 权限点已存在
{
prefix: "/shell/teacher/elective/",
config: {
requiredRoles: ["teacher", "admin"],
anyOfPermissions: ["ELECTIVE_READ", "ELECTIVE_MANAGE"],
},
},
// 公告管理
{
prefix: "/shell/admin/announcements/",