# Changelog

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

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [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 流水线