v1.1.0

v1.1.0（2026-10-14）

共 13 个提交（v1.0.2...v1.1.0）。

✨ 新增功能

• feat(nest): auth 接口接入 @nestjs/throttler 按 IP 限流（契约 v1.14.1）
• feat(website): 首页主视觉改用真实渲染的宣传片，新增回到顶部进度钮
• feat(website): 首页卡片统一 TiltCard 交互并移除 card-premium 悬停效果

🐛 修复

• fix(nest): trust proxy 定值 3 跳——线上取证 XFF 链为 client/CF 边缘/私网三层，1、2 跳时限流桶抖散
• fix(nest): trust proxy 修正为两跳——Render 挂在 Cloudflare for SaaS 后，一跳时 req.ip 落在边缘池导致限流桶抖散

📝 文档

• docs: 机制沉淀 §43 Render 三跳代理链与 trust proxy 取证口径；openapi-design 登记契约 v1.14.1
• docs: Nest auth 限流线上复验通过，记录 trust proxy 三跳取证与纠偏过程
• docs: Next/Nuxt 上线 Vercel 防火墙 auth 限流规则并记录验证
• docs: README 挂产品宣传片封面与外链，登记宣传片进度

🔧 工程

• chore: release v1.1.0
• chore(nest): error 日志取证补全 XFF 原串与 req.ips，核实代理跳数
• chore(nest): error 日志 detail 增加 clientIp（trust proxy 解析后的 req.ip），排查限流分桶取证
• chore(analytics): Next / Nuxt 端接入 @vercel/analytics 站点分析

v1.0.2

v1.0.2（2026-09-26）

共 18 个提交（v1.0.1...v1.0.2）。

✨ 新增功能

• feat(website): 文档站滚动条改为 6px 圆角细滑块并跟随 --muted-foreground

🐛 修复

• fix(nest): refresh token payload 加 jti 根治同秒重复签发，移除 e2e 规避措施
• fix(nest): e2e 补 rbac 用户自建与连接重试，CI 改自托管 TLS postgres 容器

📝 文档

• docs: 登记 okr-tree 1.16.0 升级（锁步新增 virtual，四端零代码改动）
• docs: e2e 落地登记、backlog 销项与共享库隔离机制沉淀
• docs: 遗留 GUI 走查与 website 线上核验收官登记

✅ 测试

• test(nest): login 助手对同用户强制 1s 间隔，规避 refresh token 同秒重复缺陷
• test(nest): 引入 vitest e2e 基建，31 用例覆盖认证/RBAC/超管保护/演示/密码策略

🔧 工程

• chore: release v1.0.2
• chore(nuxt): vue3-okr-tree 升级 1.16.0（锁步 virtual 批，零代码改动）
• chore(next): react-okr-tree 升级 1.16.0（锁步 virtual 批，零代码改动）
• ci: 修复 e2e 容器 TLS key 属主（chown 70:70）
• chore: 根 .gitignore 忽略 .zcode 会话产物目录
• chore: 忽略 .zcode 会话产物目录并移除误提交文件
• ci: nest e2e 独立 job（TEST_DATABASE_URL + 库内自建 e2e schema）
• chore(nuxt): package.json name 与其他端统一为 better-admin-nuxt

v1.0.1

v1.0.1（2026-09-25）

共 20 个提交（v1.0.0...v1.0.1）。

✨ 新增功能

• feat(website): 首页导航精简、对齐卡入口收敛、技术栈卡片内置线上站点按钮
• feat(nuxt): theme-switch-animation 升级 0.4.0，演示场适配反向揭开与 15 种动画类型
• feat: Nuxt 端语言包补文档站快捷链接词条
• feat: 侧栏快捷链接新增文档站入口并排在 GitHub 之上

♻️ 重构

• refactor(website): 数据库设计页表分域总览由 SVG 图改为卡片网格
• refactor(website): 站点 GitHub 链接同走 package.json 派生并回写环境变量口径
• refactor: 四端 GitHub 与博客链接改引 ENV 变量
• refactor: GitHub 仓库与作者地址真源收口到 package.json

📝 文档

• docs: feature-matrix 登记组织架构树 1.14.2 升级（四端零代码改动）
• docs: feature-matrix 与 progress 登记主题切换动画 0.4.0 升级（四端 + website）
• docs: 删除上线前夜一次性测试报告并精简 AGENTS §19 历史细节

🔧 工程

• chore: release v1.0.1
• chore(nuxt): vue3-okr-tree 升级 1.14.2（锁步修复批，零代码改动）
• chore(next): react-okr-tree 升级 1.14.2（锁步修复批，零代码改动）
• chore(website): theme-switch-animation 升级 0.4.0（顶栏 CIRCLE_BLUR 零代码改动）

chore: release v1.0.0

v1.0.0（2026-09-23）

共 562 个提交（v0.1.0...v1.0.0）。

✨ 新增功能

• feat(website): 首页按钮与徽章改用 beUI registry 组件，/docs 侧栏挂四端演示入口
• feat(website): 文档站 UI 去 fumadocs-ui，迁移为 beUI 风格自绘组件
• feat(website): 改造静态导出上 CF Workers——搜索索引/og/robots/sitemap 全部 force-static 构建期预渲染，新增 wrangler.jsonc
• feat: React / Vue 改按 Workers Static Assets 部署并补 SPA 回退（审计 #3）
• feat: 补齐 Vue / Nuxt 端品牌图标资产与 head 声明（审计 #5）
• feat(nest): 新增无鉴权健康探针 /api/health 并补录契约 v1.14.0
• feat(playground): Nuxt 端主题切换动画对齐 0.2.0（自 Vue 平移，四端收尾）
• feat(playground): Vue 端主题切换动画对齐 0.2.0（Nuxt UI 控件同口径）
• feat(playground): Next.js 端主题切换动画对齐 0.2.0（自 React 平移）
• feat(playground): React 端主题切换动画升级 0.2.0（新增 BLINDS/SCAN/QR_GRID，四向擦除并入 direction 选项）
• feat(playground): Nuxt 端新增组织架构树演示页（自 Vue 平移，画布四端收尾）
• feat(playground): Vue 端新增组织架构树演示页（Nuxt UI 重写 + 画布对齐）
• feat(playground): Next.js 端新增组织架构树演示页（画布版自 React 平移）
• feat(playground): React 端新增组织架构树演示页（react-okr-tree 画布自适应基准）
• feat(playground): 新增组织架构树演示页菜单录入脚本（nest 共用库）
• feat(playground): Nuxt 端新增 loaders 演示页（自 Vue 端平移，加载动画四端收尾）
• feat(playground): Vue 端新增 loaders 演示页（对齐 React 端，motion 关键帧改 CSS 等效）
• feat(playground): Next.js 端新增 loaders 演示页（对齐 React 端）
• feat(playground): React 端新增 loaders 演示页（菜单 + 17 种加载动效变体）
• feat: Nuxt 端对齐角色关联用户列与穿透、公告已读人员 AvatarGroup 及成员抽屉分页
• feat: Vue 端对齐角色关联用户列与穿透、公告已读人员 AvatarGroup 及成员抽屉分页
• feat: Next 端同步角色关联用户列与穿透、AvatarGroup 两列及成员抽屉分页
• feat: React 端 HeroUI 3.2.6 升级，角色/公告列改 AvatarGroup，成员穿透抽屉加分页
• feat: 角色管理新增关联用户列与名单穿透（契约 v1.13.0，React + Nest）
• feat: Vue 端新增 Unovis 图表主题层与 Area/Donut 封装
• feat: Nuxt 端 Dashboard 落地（nuxt-charts 3.0.0），四端功能对齐 27/27
• feat: Vue 端 Dashboard 概览对齐 React 基准（契约 v1.12.0）
• feat: Next 端 Dashboard 同步契约 v1.12.0 与 React 新基准
• feat: Dashboard 概览二轮打磨 + 契约 v1.12.0 取数口径修正
• feat: Next 端 Dashboard 对齐 React 基准（欢迎横幅/概览统计/图表）
• feat: Dashboard 页头升级欢迎横幅（问候/日期/天气/快捷入口）
• feat: stats 概览公告与最近日志补发布人/操作人摘要字段
• feat: stats 概览最近日志补操作人头像字段（契约 avatar）
• feat: React Dashboard 概览页（设计基准版，Phase C 实施顺序第 3 步）
• feat: Nest stats 模块实现概览聚合接口（契约 v1.11.0）
• feat: 架构图谱去虚拟根「Better Admin」+ 默认仅展开前两级（四端统一）
• feat: 组织管理「负责人」列四端统一改为 UserInfo 头像形式（Vue / Nuxt UserInfo 副行去重对齐 React）
• feat: Next / Nuxt 独立全栈演示模式（server demo-login + 只读拦截 + 登录页，Phase 0 T4）
• feat: React / Vue 登录页演示快捷登录 + DEMO_READONLY 统一提示（Phase 0 T3）
• feat: demo-reset 用户数据中国化（拼音用户名 / better-admin.com 邮箱 / 分性别名字池，引入 pinyin-pro）
• feat: faker 演示数据重置脚本 demo-reset（Phase 0 T2）
• feat: 演示只读守卫 / 快捷登录端点 / 日志降噪 / refresh_tokens 过期清理（契约 v1.10.0）
• feat(playground): Nuxt 端新增 theme-switch-animation 演示页（基于 Vue 端对齐）
• feat: 官网文档站内容精修与视觉升级
• feat(playground): Vue 端新增 theme-switch-animation 演示页（对齐 React 端）
• feat(playground): Next.js 端新增 theme-switch-animation 演示页（对齐 React 端）
• feat(playground): React 端新增 theme-switch-animation 演示页（菜单 + 13 种蒙版揭示动画）
• feat(playground): Nuxt 端 Playground 演示页对齐 React 基准
• feat(playground): Vue 端 Playground 演示页对齐 React 基准
• feat(nest): /docs 接口文档 UI 由 Swagger 换为 Scalar API Reference
• feat(playground): GitHub Activity 仓库榜换为实际项目并展示各自 logo
• feat(next): Playground Phase B 对齐 React 基准——7 演示页 + rare-ui 六组件 vendor 落地
• feat(react,next): 侧边栏菜单区改用 ScrollShadow 滚动渐隐
• feat(playground): Phase B React 基准——PlaygroundIntro 元数据机制 + rare-ui 六组件 vendor + Number Flow 共 7 页
• feat(playground): Phase A——菜单树录入共用库 + 四端占位页
• feat(users): 调整用户表单对话框中选择器的UI样式
• feat(nuxt): 顶栏全屏按钮替换主题切换，对齐 Vue 端布局
• feat(auth): 替换主题切换组件为配置抽屉
• feat(brand): 品牌标识定稿方案 03「Monogram B」——全套资源落地五端
• feat(nest,next): 契约 v1.9.0 super_admin 绑定不变量守卫 SUPER_ADMIN_LAST_PROTECTED，三端错误映射对齐
• feat(react,next,vue): 键盘可达性批次——标签关闭热区/组织树键盘拖拽/Shift+F10 标签菜单（backlog #1/#2/#4）
• feat(vue): DataTable 首屏骨架行对齐 React + 新增 i18n locales 一致性测试
• feat: 初始化 Nuxt 启动模板项目
• feat: 多标签页拖拽排序（Vue 端对齐）
• feat(next): 路由标题服务端化，generateMetadata 按语言渲染进初始 HTML
• feat: 多标签页拖拽排序（React / Next 双端同步）
• feat(vue): 五项体验对齐（个人链接子菜单 / 列设置重置动画 / 标签栏载体 / 标签输入 / 菜单失败回退）
• feat: 非菜单路由标签页图标兜底（react/next/vue 三端同步）
• feat: 契约 v1.8.1 账户电话收紧为 11 位大陆手机号 + 基本信息显示名称实时字数
• feat(next): 路由过渡动画落地——React ViewTransition 编排，偏好 9 预设真实生效
• feat(auth): 密码策略收紧至契约 v1.8.0，Nest / React / Next / Vue 四端对齐
• feat(users): 用户表单角色/组织/岗位加载态改用 Indicator Spinner，性别支持清空
• feat(users): 更新表单字段帮助文本样式
• feat(components): 将USelect替换为USelectMenu并添加清除功能
• feat(users): 表单对齐契约 v1.7.3，入职日期改用 UInputDate
• feat: 用户/密码输入长度约束补齐并同步 React/Next（契约 v1.7.3）
• feat(errors): 错误页对齐 React Result 风格并补齐异常页菜单
• feat: 表格筛选下拉改为 placeholder 占位并支持内嵌清空
• feat(notice): 更新我的通知页面加载指示器样式
• feat: 菜单管理表单增加字数限制与实时计数显示
• feat(vue): 首屏/刷新全屏 Loading 占位（纯 HTML/CSS Spinner，对齐 React 端）
• feat(react): 命令面板新增快捷链接组，layout.command.* key 补齐真源
• feat(vue): 路由切换与接口请求进度条（@bprogress/vue，对齐 React 端机制）
• feat: 异常页菜单上线（/exception/403|404|500），React / Next 双端
• feat(next): 错误页同步 Result 风格（对齐 react 516e8b9）
• feat(react): 错误页重设计为 Result 风格（插画+标题+副标题+操作区，整页居中）
• feat(react): 403/404/500 恢复主体区直显，推翻独立错误页跳转方案
• feat: 菜单表单字段长度/格式校验补齐，react + next + nest 三端对齐
• feat: 菜单表单 i18nKey 与图标输入框 placeholder 接入 i18n
• feat: 角色表单 code 输入框 placeholder 改为 i18n 文案
• feat: 角色管理表单添加字段长度限制与实时字数统计
• feat(vue): 搜索按钮条件未变时不再禁用，同值提交转为刷新列表
• feat: 菜单管理页重构（树形表格/表单组件/父级选择器/i18n）
• feat(permissions): 更新导出权限的显示标签为中文
• feat(permissions): 调整权限页面布局样式
• feat: 字典管理表单同步 React 端 i18n key 并添加实时字数统计
• feat: 字典管理表单三端统一字段长度限制与实时字数统计
• feat(org): 部门表单添加字数限制和实时统计
• feat(notice): 公告表单标题实时字数，必填校验改字段内 FieldError
• feat: 更新图标库并优化用户界面组件
• feat: 将网站链接图标从 Globe 替换为 House
• feat(dicts): 字典表单 UForm/zod 化，删除确认补 loading
• feat(menus): 菜单表单 UForm/zod 化，保存改 toast.promise
• feat(roles): 角色表单 UForm/zod 化，启停改 toast.promise
• feat(users): 用户表单 UForm/zod 化，保存与删除操作补全反馈
• feat(org): 表单保存/拖拽排序改 toast.promise 三段反馈
• feat(ui): 新增 LoadingContent 加载遮罩组件，统一页面 loading 覆盖
• feat(org): 组织管理页交互细化——负责人头像、表单 UForm 化、删除反馈
• feat: 组织树改用 UTree + useSortable（官方参考示例形态）
• feat: DataTable 改用 Nuxt UI UTable；@tanstack/vue-table 降级至 v8
• feat: UModal 统一使用 title prop + #footer slot；ConfirmDialog 补 loading 状态
• feat(org): 部门树选择组件增加表单验证和标签显示功能
• feat: React/Next 组织树拖拽排序保存期间显示遮罩并禁用树操作
• feat: React/Next 组织名称/编码输入框增加实时字数显示并优化编码提示语
• feat: React/Next 组织树下拉选项展示负责人小头像（无图回退首字）
• feat: UApp 接入 uiLocale，Nuxt UI 内置文案跟随语言切换
• feat: Vue M2 组织管理落地——左树右表 + 同级拖拽排序
• feat: Admin 布局对齐 React——品牌下拉/顶栏面包屑/全屏/快捷链接/用户双行
• feat: 登录页对齐 React 认证外壳并改用 UAuthForm，全局字体切换 Maple Mono CN
• feat: website 官方文档站落地——Next 16 + Fumadocs + ogimg 黑白风格
• feat(react,next): 列设置面板可见性 Checkbox variant 默认改为 secondary
• feat(next): 配置图片优化选项以支持远程图片加载
• feat: Next 端同步公告模块功能（与 React/Nest 对齐）
• feat: 公告模块功能增强（我的公告页/通知抽屉/已读人员列）
• feat: 组织中心阶段 4——架构图谱与通讯录 Excel 导出（React/Next 两端）
• feat: 通知详情登录可达路由与详情页重构（两端对齐）
• feat: Next.js 全局进度条 — 路由导航与接口请求自动显示进度条
• feat: 全局进度条 — 接口请求与路由导航自动显示进度条
• feat: next 端补齐用户管理组织关联与组织中心模块
• feat(notice): 公告管理 + 站内信铃铛上线（契约 v1.7.x）及验收修复
• feat(next): N7 收尾——契约快照升级至 HEAD、proxy 403/404 语义修正、env/README 项目化、依赖清理
• feat(next): N6 组织管理——depts 树/CRUD/拖拽排序、三级删除占用校验、负责人选择与 DeptTreeSelect
• feat(next): N5 我的账户——资料/邮箱/改密（全端下线）/Supabase Storage 头像上传与删除
• feat(next): N4 字典与日志——字典类型/项 CRUD、日志列表/删除、清理脚本与两个设置页
• feat(next): N3c 菜单管理——树表格 CRUD/add-child、to 格式与唯一校验、权限位说明页
• feat(next): N3b 角色管理——角色 CRUD、菜单授权抽屉（GRANT 位）、menus/tree 接口与 super_admin 保护
• feat(next): N3a 用户管理——DataTable 基建移植、8 个用户接口、列表/表单/重置密码页与位掩码按钮权限
• feat(next): N2 布局横切——AdminLayout 移植、服务端过滤动态菜单、菜单 403 门卫、多标签页与命令面板
• feat(react): 组织中心阶段2——岗位管理页、人员通讯录页与用户组织/岗位编辑
• feat(nest): 组织中心阶段2——岗位管理、人员通讯录与用户组织/岗位关联
• feat(next): N1 认证——登录页、/api/auth 四接口、JWT 双令牌 Cookie、proxy 守卫与静默轮换
• feat(next): N0 地基——App Router 重置、主题/i18n/请求层移植、契约冻结与 Drizzle 接入
• feat(react): 组织中心组织管理页上线（左树右表 / 拖拽排序 / 异步负责人选择）
• feat(nest): 组织中心阶段1——契约 v1.6.0、迁移 0007 与组织管理接口
• feat(next): 初始化Next.js应用模板
• feat(react): 列设置重置顺序增加 FLIP 平滑动画
• feat(react): 用户管理列改版与侧边栏个人链接菜单
• feat(nest): AuthUser 视图补个人链接三字段（契约 v1.5.3）
• feat(auth): 更新版权年份为动态获取当前年份
• feat(react): 我的账户验收调整——Tabs 分区 / 骨架屏 / 密码强度 / 个人链接卡
• feat(nest): 删除头像接口与个人链接字段（契约 v1.5.1 / v1.5.2）
• feat(react): 我的账户页面（头像裁剪上传 / 资料 / 邮箱 / 密码）
• feat(nest): 我的账户自助接口与头像上传（契约 v1.5.0）
• feat(layout): 添加全屏按钮尺寸配置
• feat(data-table): 添加分页组件中选择器的最小宽度类
• feat: 日志定时清理——每日清理 30 天前日志（@nestjs/schedule）
• feat: 日志管理上线——操作人摘要联表、详情抽屉、单条/批量删除（契约 v1.4.8）
• feat: 403/404/500 统一改为跳转独立错误页，推翻主体区直显 403 的旧设计
• feat: 前端权限快照同步——AdminLayout 挂载时 /auth/me，权限变更刷新页面生效
• feat: 登录鉴权加固——停用用户拦截 USER_DISABLED、软删除过滤与幽灵权限修复（契约 v1.4.7）
• feat: 用户写操作保护（本人/admin/super_admin 三层，契约 v1.4.6）
• feat: 列表查询引入条件代际号 epoch，消除重置/搜索时的缓存闪回
• feat: React 用户管理验收调整（编辑保存修复/批量操作条改版/角色数上限/菜单失败态重设计）
• feat: 契约 v1.4.5 用户关联角色数量上限（roleIds maxItems=5，超限 400）
• feat: 错误页重设计：毛玻璃卡片 + 巨字光晕 + tone 线稿插画 + 按钮流光
• feat: React 搜索/重置按钮补齐位掩码门控并抽共享组件，角色授权入口改 GRANT 位
• feat: 新增 GRANT 菜单授权权限位，PUT /roles/:id/menus 权限要求由 EDIT 收敛（契约 v1.4.4）
• feat(react): 角色管理页上线（服务端分页 CRUD + 菜单授权抽屉）
• feat(react): 通用组件——分页条三列布局、空/错误状态组件拆分
• feat(nest): 角色列表 enabled 筛选与 super_admin 角色保护（契约 v1.4.3）
• feat(react): 字典管理页上线（字典类型/字典项双栏 CRUD）
• feat(react): 偏好设置新增圆角档位（直角/小/中/大）
• feat(react): 偏好设置重置后弹出成功 toast
• feat(nest,react): 契约 v1.4——菜单 target 字段整体移除
• feat(nest,react): 菜单管理页——树形表格 + CRUD + 列设置 + 后端搜索
• feat(nest,react): 契约 v1.3——管理菜单树端点、Settings 移除、权限点调整
• feat(react): 列设置至少保留一列可见 + 面板组件 HeroUI 化
• feat(react): 列设置支持拖拽排序——dnd-kit 面板 + columnOrdering 持久化
• feat(react): 权限位改由 /permissions 接口下发 + 权限管理只读页
• feat(react): 业务页面通用基础设施——DataTable 组件族、表单/弹窗/页头封装、列表状态工厂与字典缓存

🐛 修复

• fix(website): wrangler name 对齐 CF Worker 名 better-admin
• fix(website): 钉 packageManager pnpm@11.24.0（CF Workers Builds 默认 pnpm 10 误判纯配置 pnpm-workspace.yaml）
• fix(react): wrangler name 对齐 CF Worker 名 better-admin-react
• fix(vue,ci): 显式标注两处回调参数类型（CI TS7006）+ CI 构建期占位 DATABASE_URL（next build page data 收集）
• fix(next): 补提交 pnpm-lock.yaml（next/.gitignore 曾忽略之，CI 缓存与 frozen install 依赖；其余五端同口径）
• fix(react): CF Git 构建钉 pnpm@11.24.0 并对齐 Worker 名 better-admin（vue 同批钉版本）
• fix(nuxt): 会话失效硬跳改裸跳，四端统一为方案 C（审计 #28）
• fix(next,nuxt): phone 不再 trim，服务端语义对齐 Nest（审计 #27）
• fix(nuxt,vue): 图标 link 与 React 基准对齐并修 Nuxt head 类型错误
• fix(nest): 幂等回填 super_admin 缺失的 4 条菜单授权（审计 #9）
• fix(build): 版本同步脚本改为枚举 apps/ 实际目录，纳入 website
• fix(nest): 写库脚本补 --confirm 安全阀，避免误污染共用线上库
  ...

v0.1.0

🎉 首个版本化发布

本版本完成 React（Hero UI）+ NestJS + PostgreSQL 的第一套完整全栈系统（Phase 1–3），
并沉淀多标签页保活、路由过渡动画、全站国际化、会话安全与版本统一管理等基础设施。

✨ Features

React 前端（Hero UI 为主 + Shadcn UI 补充，UI 基准版本）

• AdminLayout 双栏布局：侧边栏多级递归菜单、DynamicIcon 动态图标、HeroUI 面包屑、折叠交互、菜单展示模式可配置
• 顶栏：全局搜索命令面板（菜单导航 + 主题切换）、全屏切换、语言切换入口
• 多标签页栏：与 keepAlive 实例池联动、右键菜单（刷新 / 关闭左侧 / 右侧 / 其他 / 全部）
• 偏好设置抽屉：主题色、主题模式、色彩模式（正常 / 灰色 / 色弱）、路由过渡动画 9 预设 + 速度档位、语言切换；主题切换接入 ViewTransition 方向揭示动画
• keepAlive 路由缓存：基于 React <Activity> 的实例池保活，菜单数据驱动、新增页面零登记成本；导航方向感知的 9 种路由过渡动画预设
• 标签右键刷新：激活页复用 VT 过渡编排，重播切换动画
• 登录：记住我（refreshToken 按需持久化）、回跳地址站内校验
• 全站国际化：i18next 双语言（简体中文 / English），菜单 i18nKey 实时翻译，语言切换不改 URL、刷新保持
• 页面标题随路由动态更新（含登录页与错误页）

NestJS 后端（Drizzle ORM + PostgreSQL / Supabase）

• 数据库：9 张表 Drizzle Schema、迁移与种子数据（位掩码权限、软删部分唯一索引、jsonb）
• 认证：JWT 双 Token；refreshToken SHA-256 哈希托管、轮换（事务删旧插新）、重放直接 401；tokenVersion 机制支持改密 / 封禁全端强制下线；记住我分档有效期（契约 v1.2）
• RBAC：位掩码权限 PermissionsGuard、菜单按角色关联过滤、O(1) 内存映射填充 userPermissions（禁 N+1）
• 业务模块：Auth / Users / Roles / Menus / Permissions / Dict / Settings / Logs
• Swagger（/docs）、全局异常过滤器、统一响应结构与 API 日志拦截器

全栈联调

• React 接入 NestJS 真实 API：真实登录 / 退出、菜单联调、双 Token 无感刷新、路由权限门卫、业务页面真实数据

🐛 Bug Fixes

• 无 VT 路径 flushSync 生命周期警告（状态提交与帧捕获职责分离）
• 保活刷新直入丢状态与标签栏滚动体验
• 登录回跳地址站内校验，防开放重定向
• 主题切换 ViewTransition 揭示不全与结束后二次跳变
• 菜单图标统一为裸 lucide 名，修复 DynamicIcon 找不到名称
• 接口对齐契约：login / refresh 返回 200、权限位统一正数全量掩码
• 系统设置编辑保留字段元数据，修复修改后标签丢失

⚡️ Performance

• 布局可达路径集合 useMemo 缓存与异常覆盖层静态提升

♻️ Refactor

• keepAlive 路由缓存与过渡动画架构重构：RouteTransition 双缓冲 → KeepAliveOutlet + <Activity>
• 菜单 - 路由交叉核对，新增字典管理菜单并对齐种子数据
• HeroUI Typography 平替布局排版标签、组件分层结构调整

📝 Documentation

• AGENTS.md 记录各阶段架构约定与状态（React 迁移策略、keepAlive、会话安全、i18n、版本管理）
• nest：OpenAPI Contract v1.1.0 与数据库设计基线 v0.3

🔧 Chore

• 版本统一管理：根 package.json 作产品级版本真源 + sync-versions 同步脚本，基线对齐 0.1.0
• react 包更名 better-admin-react 并补全仓库元信息；侧边栏 GitHub 指向仓库地址
• 接入 Hero UI、全局字体 Maple Mono CN、vercel-react-best-practices 与 heroui-react Skill
• /react-shadcn 调整为只读参考源

Full Changelog: 7440f63...v0.1.0