更新日志

• 用户菜单树落地 Redis 单层缓存（手写轨），发布点同点失效。
• 注解式缓存样板落地（公告详情）并沉淀启用规约。
• 显式 AsyncConfigurer 夺回 @Async 绑定，修复异步日志 traceId 丢失（Spring Boot 4 下 Bean 名约定失效的对策）。

• 注解式缓存补齐异常降级与事务感知基建。
• 免登过滤器热路径零 Redis：token 本地缓存 + 30 秒重校验，移除 active-timeout 冻结机制。

• 落地第三方 HTTP 声明式客户端对接契约（@HttpExchange 声明式客户端，含可执行样例）。
• 数据权限范围查询下沉 XML mapper，修复 PostgreSQL 15+ SYSTEM_USER 保留字冲突。
• AI 协作文档瘦身：入口链去重，通用最佳实践蒸馏为项目级约束。

• 字典编码按 {namespace}_{concept} 规则做命名空间治理。
• 超级管理员全权限旁路（*:*:* 通配，免逐项授权）。
• 生产环境关闭 API 文档暴露（Swagger / springdoc）。
• DataTracer 查询端点补齐权限校验，收口越权访问面。
• 表单长度校验规约落地：后端 @Size 与前端 maxlength 以 DDL 列长为唯一事实来源。
• 系统参数新增值类型维度、参数组分组管理与结构化编辑。

• 模块架构收敛：实体与持久层下沉 start-admin，start-common 收敛为纯技术设施；定时任务引擎、业务错误码、Swagger 分组随之迁移；新增纯净性守卫。
• 数据权限上下文由 ThreadLocal 迁移至 ScopedValue 作用域绑定。
• 认证切换为 JWT 有状态模式，使强制下线原生生效。
• 语义状态码写入真实 HTTP 状态行，兑现 RFC 9457 自述。
• 关键写接口启用 @Idempotent 防重复提交。
• 抽取 TwoLevelCache 统一二级缓存模式，参数支持配置文件覆盖。
• 新增统一数据选择器通道，改造用户、岗位、公告等页面的下拉承接。

• 首轮系统审计整改批：接口风格统一（分页 GET /page、删除 DELETE /{id}）、破坏性 changeset 补 rollback、表命名收敛「模块名_业务实体」口径、超管角色保护等数十项。
• 前端组件测试基建落地，补齐用户、字典、菜单、通知等十个页面组件测试。
• 系统监控新增 Redis 缓存管理（概览五项指标 + 双栏管理页）。
• 封装 FaUpload 通用上传组件，内置认证头与同源地址。
• Excel 导入支持跳过汇总模板，唯一约束冲突转译为友好提示。
• WebSocket 握手 token 迁移至 Sec-WebSocket-Protocol 子协议。

项目奠基版：start-common 十一个能力域与 start-admin 业务模块的 Maven 多模块架构成型。

• 认证授权（Sa-Token JWT）、系统管理（用户/角色/菜单/部门/岗位/字典/参数/通知）、系统监控（在线用户/操作日志/登录日志/错误日志/数据追踪）完整闭环。
• Controller → Service → Manager → Mapper 分层契约与统一错误码（IErrorCode + RFC 9457 对齐）。
• Liquibase 数据库版本管理与 PostgreSQL 持久层。
• AI 协作工程体系：AGENTS.md 入口、规则集、任务 Skill 与 ai-check 质量门禁。