NextEdu/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Added

• arch:scan @public JSDoc 标记豁免机制，支持登录前/公开/内部工具 Server Action 豁免权限校验
• arch:scan 递归 CTE 违规检测，识别通过辅助函数间接调用 requirePermission 的调用链
• 大仓工程基建：LICENSE、CONTRIBUTING、SECURITY、.env.example 文档
• husky + lint-staged + commitlint 本地提交规范工具链
• /api/health 健康检查端点 + Dockerfile HEALTHCHECK
• @next/bundle-analyzer 构建体积分析工具
• CI 流水线新增 Unit test + coverage 阶段
• tsconfig 开启 noUncheckedIndexedAccess 严格模式

Changed

• 重构 004 架构文档为完整架构设计文档（912 行，14 章节，13 个 mermaid 图）
• 重写 35 个模块 README，统一 8 章节模板（架构图/流程图/技术栈）
• 拆分 5 个超长文件：schema.ts (2245→29+27子文件)、invalidation-map.ts (1195→50+6子文件)、messaging/actions.ts (973→47+5子文件)、textbooks/data-access.ts (907→15+6子文件)、questions/data-access.ts (828→48+4子文件)
• 精简 known-issues.md 为索引式速查手册（场景→技术/规则映射）

Fixed

• 修复 20 个 Server Action 权限违规（12 个 @public 豁免 + 8 个真违规修复）
• 修复 ai 模块 6 个 Action 权限误报（requireAiPermission 间接调用链识别）
• 修复 parent 模块 6 个 Action 权限缺失（requireAuth → requirePermission）
• 修复 settings 模块 updateProfileAction 权限校验（显式 requirePermission）

[0.1.0] - 2026-06-01

Added

• 初始版本发布
• K12 智慧教学平台核心功能：备课、作业、考试、成绩、考勤、消息、家校互动
• 严格三层架构：app → modules → shared
• 5 层状态管理模型：URL(nuqs) · Server(TanStack Query) · Client(Zustand) · Global UI · Form
• 权限 3 道防线：proxy.ts → requirePermission → usePermission
• 设计令牌双层架构：Primitive + Semantic
• arch.db 架构元数据库（12 张表 + 7 个索引）
• cacheFn 请求级缓存层
• Gitea Actions CI/CD 流水线