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:
@@ -5,7 +5,7 @@
|
|||||||
"generatedAt": "2026-06-17",
|
"generatedAt": "2026-06-17",
|
||||||
"formatVersion": "1.1",
|
"formatVersion": "1.1",
|
||||||
"rule": "每次文件修改后须同步更新本文件",
|
"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 行(最大 375),49 个重复组件全部删除无残留,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 行(最大 375),49 个重复组件全部删除无残留,modules/*/components/ 下无 *-filters/*-stats-card*/*-skeleton/*-error-boundary 文件,tsc 零错误,lint 无新增错误。",
|
||||||
"lastUpdated": "2026-07-06"
|
"lastUpdated": "2026-07-06"
|
||||||
},
|
},
|
||||||
"architectureOverview": {
|
"architectureOverview": {
|
||||||
|
|||||||
@@ -1338,7 +1338,15 @@ if (announcement.type === "school") {
|
|||||||
| 单数与复数重复时合并 | attendance 的 `attendance-stats-card.tsx`(单数)删除 | 保留两份 |
|
| 单数与复数重复时合并 | attendance 的 `attendance-stats-card.tsx`(单数)删除 | 保留两份 |
|
||||||
| StatsGrid 列数支持 2/3/4/5 | `<StatsGrid columns={5}>` 按需指定 | 固定 4 列 |
|
| 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 验证规则
|
||||||
|
|
||||||
| 规则 | 正确写法 | 错误写法 |
|
| 规则 | 正确写法 | 错误写法 |
|
||||||
|------|---------|---------|
|
|------|---------|---------|
|
||||||
|
|||||||
Reference in New Issue
Block a user