12 Commits

Author	SHA1	Message	Date
SpecialX	5d9981fd7d	docs(architecture): update impact map, data, audit reports, superpowers docs ... - Update 004_architecture_impact_map.md and 005_architecture_data.json - Add audit reports: data-access-audit-framework-v1, data-access-audit-v1-data.json, data-access-audit-v1, g1-g5 audit outputs - Add superpowers plans and specs (logging-refactor, documentation-system-redesign) - Update troubleshooting/known-issues.md	2026-07-07 16:23:35 +08:00
SpecialX	4e6d397d8e	docs(architecture): sync logging refactor to 004/005 and known-issues ... Task 15: 004 架构影响地图新增 1.1.7 日志系统重构章节(架构图、核心组件表、Request ID 贯穿链路、Edge Runtime 限制、替换范围、环境变量),shared/lib 清单新增 logger.ts/request-context.ts/with-request-context.ts/track-event.ts 更新,hooks 清单新增 use-error-report.ts。 Task 16: 005 架构数据 JSON 新增 3 个 shared/lib 文件节点、1 个 hooks 节点、1 个 apiRoute(/api/client-error)、5 个 dependencyMatrix 依赖关系,JSON 有效性验证通过。 Task 17: known-issues.md 新增二十八、日志系统规则章节,含 5 个规则表(pino 使用、Edge Runtime 限制、Request ID 贯穿、ESLint no-console、客户端错误上报)。	2026-07-07 13:00:00 +08:00
SpecialX	94f098b0f2	perf(phase1-4): 补漏性能预算重构专项遗漏项 ... Phase 1 配置基线：next.config.ts 新增 experimental.optimizePackageImports（lucide-react/recharts/@xyflow/react/@tiptap/* /@radix-ui/*/date-fns）+ serverExternalPackages 追加 tencentcloud-sdk-nodejs + exceljs；providers.tsx 注入 WebVitalsReporter 闭环 RUM 上报链路（之前组件存在但未注入导致生产环境零性能数据）。 Phase 2 Bundle 预算优化补漏：TipTap 三实例（shared/ui/rich-text-editor + exams/editor/exam-rich-editor + lesson-preparation/blocks/rich-text-block）之前仅文件拆分未真正 next/dynamic ssr:false,本次补齐 lazy wrapper + xxx-inner.tsx 拆分模式；ReactFlow knowledge-graph.tsx 改用 next/dynamic 加载 inner；chart.tsx 改 recharts 具名导入替代 import * as RechartsPrimitive barrel。 Phase 4 组件渲染优化补漏：12 个 recharts 图表组件（parent/grades/dashboard/homework 模块下）margin props 提取到模块级 CHART_MARGIN 常量避免 inline 重建；layout.tsx metadata 增强（metadataBase/openGraph/twitter/robots/authors/creator）+ getLocale/getMessages/auth 串行 await 改 Promise.all 并行。 同步架构文档 004/005 + known-issues.md：新增 Phase 1 配置基线规则章节 + Phase 2 文件清单修正（之前引用不存在的 question-rich-editor.tsx 和 paper-rich-editor.tsx,实际是 rich-text-editor.tsx 和 rich-text-block.tsx）+ Phase 4.9 metadata + Promise.all 规则补充。架构图 1.1.5 章节新增未完成项（React Compiler/force-dynamic 评估/Playwright 性能断言）。 验证：npx tsc --noEmit 零错误；npm run lint 零新增错误（3 errors + 12 warnings 均位于未修改的 pre-existing 文件）。	2026-07-07 00:30:47 +08:00
SpecialX	6104e6a685	docs(architecture): 组件化重构专项遗漏补全 - 更新 005 lastUpdate + known-issues 25.4 节 ... - 005 JSON: lastUpdate 追加遗漏补全 9 模块 20 组件迁移记录 - known-issues.md: 新增 25.4 遗漏补全规则章节 - 全量验证：49 个重复组件全部删除，modules/*/components/ 下无残留	2026-07-06 22:24:17 +08:00
SpecialX	ee10380462	docs(architecture): 组件化重构专项完成 - 同步 005 lastUpdate + known-issues 第 25 章 ... - 005 JSON: lastUpdate 更新为组件化重构专项全量完成摘要 - known-issues.md: 新增第 25 章（4 个小节：底座使用规则/拆分模式/迁移规则/验证规则） - 9 个巨型文件全部 ≤500 行，49 个重复组件全部删除	2026-07-06 20:57:14 +08:00
SpecialX	9ce8d6d3fd	refactor(data-access): 补全剩余 37 个 data-access 文件迁移至 cacheFn ... 迁移范围：lesson-preparation 11 文件、attendance 3 文件、settings 4 文件、classes-invitations、跨模块接口 4 文件、adaptive-practice/ai/onboarding/invitation-codes/search/standards/scheduling/leave-requests/audit。修复 3 个 cacheFn 块位置错误。同步架构文档迁移范围至 83 文件 250+ 函数。	2026-07-06 15:12:30 +08:00
SpecialX	99f15ee37a	docs(architecture): 同步缓存基础设施 + classes 标杆迁移 + 缓存策略规则 ... - 004: 补全 shared/lib/cache 9 文件说明（types/memory-store/redis-store/store-factory/cache-fn/invalidation-map/client-invalidation-map/invalidate/index）+ shared/lib/redis-client + shared/lib/query-keys - 005: shared.lib.exports.functions 补 5 个节点（MemoryCacheStore / RedisCacheStore / CLIENT_INVALIDATION_MAP / getRedisClient / queryKeys） - known-issues.md 新增「二十四、缓存策略规则」章节，含 14 条规则表与涉及文件清单	2026-07-05 19:04:03 +08:00
SpecialX	0f9d8825e7	docs(cache): 同步 cacheFn 架构图与已知问题速查	2026-07-05 18:07:18 +08:00
SpecialX	214ebec976	refactor(design-tokens): 全量体系化重建设计令牌 ... Primitive + Semantic 双层令牌架构,HEX->HSL,明暗双份,@theme inline 暴露为 Tailwind 类。 - 新建 src/app/styles/tokens/ 6 个令牌文件(primitive/semantic-light/semantic-dark/lesson-preparation/tailwind-theme/index) - globals.css 改为 @import 引入,477->258 行 - 清理 91 处 #hex 硬编码颜色 -> hsl(var(--*)) - 清理 10 处硬编码字体 -> var(--font-family-*) - 清理 100 文件 Tailwind 任意值(Tier 1 映射/Tier 3 注释豁免) - 清理 M3 Surface 死代码,升级 --lp-* 令牌(HEX->HSL + 暗色补全) - 新建 ESLint 自定义规则 no-hardcoded-design-tokens(单词边界正则) - eslint.config.mjs 新增 no-restricted-syntax 禁止 #hex + 自定义规则加载(pathToFileURL) - 项目规则新增设计令牌规范强制章节 - 架构图 004/005 同步设计令牌体系节点 - known-issues.md 追加设计令牌问题分类(7 个规则表) 验证: tsc --noEmit 0 errors, npm run lint 0 errors/12 warnings(均为既有问题)	2026-07-05 01:03:19 +08:00
SpecialX	d1ad7a1f75	docs(architecture): update impact map, data, troubleshooting, add mockups ... - Update 004_architecture_impact_map.md and 005_architecture_data.json - Remove obsolete _update_004.cjs helper script - Update troubleshooting/known-issues.md - Add docs/mockups/ directory	2026-07-04 23:02:14 +08:00
SpecialX	0780524c08	docs(troubleshooting): V4 备课编辑器规则 ... 新增 V4 备课编辑器（纸感重构）规则表，8 条规则：正文节点必须是 Tiptap 编辑器、锚点用 Tiptap Mark 内嵌、节点展开位置由 order 决定、节点类型色点用 --lp-dot-*、文档版本必须是 4、师生交互节点用 QaEditor、右键菜单触发对象区分、v3 锚点迁移失效提示。	2026-07-04 12:01:06 +08:00
SpecialX	872d5fb085	docs(architecture): update impact map, data, audit report, troubleshooting ... - Update 004_architecture_impact_map.md - Update 005_architecture_data.json - Add lesson-preparation-audit-report-v5.md - Add troubleshooting docs	2026-07-04 10:24:08 +08:00