From 6104e6a685521f42fc3309628b7868fd56eacd15 Mon Sep 17 00:00:00 2001 From: SpecialX <47072643+wangxiner55@users.noreply.github.com> Date: Mon, 6 Jul 2026 22:24:17 +0800 Subject: [PATCH] =?UTF-8?q?docs(architecture):=20=E7=BB=84=E4=BB=B6?= =?UTF-8?q?=E5=8C=96=E9=87=8D=E6=9E=84=E4=B8=93=E9=A1=B9=E9=81=97=E6=BC=8F?= =?UTF-8?q?=E8=A1=A5=E5=85=A8=20-=20=E6=9B=B4=E6=96=B0=20005=20lastUpdate?= =?UTF-8?q?=20+=20known-issues=2025.4=20=E8=8A=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 005 JSON: lastUpdate 追加遗漏补全 9 模块 20 组件迁移记录 - known-issues.md: 新增 25.4 遗漏补全规则章节 - 全量验证：49 个重复组件全部删除，modules/*/components/ 下无残留 --- docs/architecture/005_architecture_data.json | 2 +- docs/troubleshooting/known-issues.md | 10 +++++++++- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/architecture/005_architecture_data.json b/docs/architecture/005_architecture_data.json index 1311d42..2d50ed3 100644 --- a/docs/architecture/005_architecture_data.json +++ b/docs/architecture/005_architecture_data.json @@ -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 行（最大 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" }, "architectureOverview": { diff --git a/docs/troubleshooting/known-issues.md b/docs/troubleshooting/known-issues.md index 13f4f50..538af7b 100644 --- a/docs/troubleshooting/known-issues.md +++ b/docs/troubleshooting/known-issues.md @@ -1338,7 +1338,15 @@ if (announcement.type === "school") { | 单数与复数重复时合并 | attendance 的 `attendance-stats-card.tsx`（单数）删除 | 保留两份 | | StatsGrid 列数支持 2/3/4/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 验证规则 | 规则 | 正确写法 | 错误写法 | |------|---------|---------|