docs(architecture): 组件化重构专项遗漏补全 - 更新 005 lastUpdate + known-issues 25.4 节

- 005 JSON: lastUpdate 追加遗漏补全 9 模块 20 组件迁移记录
- known-issues.md: 新增 25.4 遗漏补全规则章节
- 全量验证:49 个重复组件全部删除,modules/*/components/ 下无残留
This commit is contained in:
SpecialX
2026-07-06 22:24:17 +08:00
parent e76c626779
commit 6104e6a685
2 changed files with 10 additions and 2 deletions

View File

@@ -5,7 +5,7 @@
"generatedAt": "2026-06-17",
"formatVersion": "1.1",
"rule": "每次文件修改后须同步更新本文件",
"lastUpdate": "组件化重构专项全量完成2026-07-06三批 10 个模块闭环 + Phase 1 底座补全。Phase 1新增 ErrorBoundary 基础类组件、StatsGrid 容器、SkeletonCard variant收敛 SectionErrorBoundary/RouteErrorBoundary/WidgetBoundary 为 preset。第 1 批grades/attendance/error-book/elective拆分 batch-grade-entry (457→375) + grade-record-list (523→231),迁移 12 个重复组件到 StatsGrid/FilterBar 底座。第 2 批homework/exams/textbooks拆分 homework-take-view (428→330) + homework-grading-view (507→170) + exam-assembly (467→268) + textbook-reader (458→318) + knowledge-graph-inner (411→295),删除 textbooks 同名 section-error-boundary.tsx迁移 3 个 filter 组件。第 3 批lesson-preparation/ai/dashboard拆分 lesson-plan-editor (594→273) + ai-chat-panel (417→218),新增 DashboardShell 布局壳统一 4 角色 dashboard迁移 filters/skeletons/error-boundaries 到底座。总计9 个巨型文件全部 ≤500 行(最大 37549 个重复组件全部删除无残留tsc 零错误lint 无新增错误。前次更新Phase 4.6 grades 模块组件化重构闭环完成2026-07-06。",
"lastUpdate": "组件化重构专项全量完成2026-07-06含遗漏补全Phase 1 底座补全 + 三批 10 个模块闭环 + 遗漏补全 9 个模块。Phase 1新增 ErrorBoundary 基础类组件、StatsGrid 容器、SkeletonCard variant收敛 SectionErrorBoundary/RouteErrorBoundary/WidgetBoundary 为 preset。第 1 批grades/attendance/error-book/elective拆分 2 个巨型文件,迁移 12 个重复组件。第 2 批homework/exams/textbooks拆分 5 个巨型文件,迁移 3 个 filter + 1 个同名 error-boundary。第 3 批lesson-preparation/ai/dashboard拆分 2 个巨型文件,新增 DashboardShell迁移 6 个重复组件。遗漏补全classes/audit/school/settings/adaptive-practice/announcements/messaging/questions/student迁移剩余 20 个重复组件9 filters + 2 stats-cards + 5 skeletons + 4 error-boundaries),补充 school/settings/classes 模块 i18n error.boundary* 键。总计9 个巨型文件全部 ≤500 行(最大 37549 个重复组件全部删除无残留modules/*/components/ 下无 *-filters/*-stats-card*/*-skeleton/*-error-boundary 文件tsc 零错误lint 无新增错误。",
"lastUpdated": "2026-07-06"
},
"architectureOverview": {

View File

@@ -1338,7 +1338,15 @@ if (announcement.type === "school") {
| 单数与复数重复时合并 | attendance 的 `attendance-stats-card.tsx`(单数)删除 | 保留两份 |
| StatsGrid 列数支持 2/3/4/5 | `<StatsGrid columns={5}>` 按需指定 | 固定 4 列 |
### 25.4 验证规则
### 25.4 遗漏补全规则
| 规则 | 正确写法 | 错误写法 |
|------|---------|---------|
| 批次划分需覆盖全部重复组件 | 审查 spec 附录清单与批次覆盖范围的一致性 | 仅覆盖有巨型文件的模块,遗漏无巨型文件模块 |
| i18n 键跨命名空间补齐 | school/settings/classes 等模块补 `error.boundaryTitle` 等 | 仅补部分模块,导致 next-intl SSR IntlError |
| adaptive-practice stats-cards 同样需迁移 | `practice-stats-cards` / `practice-overview-stats-cards` → StatsGrid | 仅迁移 grades/attendance 等批次内模块 |
### 25.5 验证规则
| 规则 | 正确写法 | 错误写法 |
|------|---------|---------|