签入版本

RXThinkCMF_Laravel13_EleVue/zh/changelog.md

@@ -37,26 +37,27 @@
 
 ### 新增
 
-- **自动参数校验**：Logic 层配置 `$validateClass` 后，`add`/`update` 自动调用验证器校验，覆盖所有 CRUD 入口（含导入），新增 CityValidate、TenantValidate，全模块验证器覆盖率 100%
-- **项目文档体系**：Wiki 文档站点全面改版，覆盖快速入门、模块开发、架构设计、运维部署全场景
-- **生产环境部署指南**：Docker 容器化支持，提供 Dockerfile + docker-compose.yml 一键部署
-- **系统健康检查接口**：运行状态监控，服务可用性实时检测
-- **多数据库 SQL 脚本**：MySQL / PostgreSQL / SQL Server / Oracle / SQLite 五套完整建表脚本
+- **自动参数校验**：Service 层配置验证请求类后，`add`/`update` 自动调用 FormRequest 校验，覆盖所有 CRUD 入口（含导入），全模块验证器覆盖率 100%
+- **项目文档体系**：VitePress 开发者文档站点全面改版，覆盖快速入门、模块开发、架构设计、运维部署全场景
+- **多数据库初始化脚本**：MySQL / PostgreSQL / SQL Server / Oracle / SQLite 五套完整建表脚本（`document/` 按数据库类型分组，已做对应 SQL 语法适配）
+- **生产环境部署指南**：Docker 容器化支持，提供 Dockerfile + docker-compose.yml 一键部署（Nginx + PHP-FPM + MySQL + Redis 四容器编排）
+- **系统健康检查接口**：`/up` 健康路由，运行状态监控，服务可用性实时检测
+- **跨库迁移工具**：`php artisan db:migrate` 数据结构与数据跨数据库迁移
 
 ### 优化
 
-- **IP 归属地查询**：基于 `zoujingli/ip2region`（v3.0.16）composer 包，支持 IPv4/IPv6，自动加载内置数据库
-- **新增 ProxyMiddleware 全局中间件**：部署在 CDN / 负载均衡后面时，自动从 `X-Forwarded-For` / `X-Real-IP` 头提取真实客户端 IP，通过 `.env` → `[API]` `PROXY_IPS` 配置受信代理
-- **角色模块多租户改造**：`think_role` 表新增 `tenant_id` 字段，角色数据按租户隔离，`RoleLogic` 改为继承 `BaseTenantLogic`
+- **IP 归属地查询**：基于 `zoujingli/ip2region`（v3.0+）composer 包，支持 IPv4/IPv6，自动加载内置数据库
+- **新增 ProxyMiddleware 全局中间件**：部署在 CDN / 负载均衡后面时，自动从 `X-Forwarded-For` / `X-Real-IP` 头提取真实客户端 IP，通过 `.env` 的 `TRUSTED_PROXIES` 配置受信代理
+- **角色模块多租户改造**：角色表新增 `tenant_id` 字段，角色数据按租户隔离，RoleService 改为继承 BaseTenantService
 - 全模块稳定性测试与边界条件覆盖
 - 错误提示信息统一规范化，提升用户友好度
 - 日志输出格式标准化，便于日志采集与分析
-- 依赖包版本锁定，确保生产环境一致性
+- 依赖包版本锁定（composer.lock），确保生产环境一致性
 - 接口限流策略优化，防止恶意请求
 
 ### 修复
 
-- JWT 密钥强制从环境变量读取，禁止硬编码
+- JWT 密钥强制从环境变量读取，禁止硬编码，启动时 fail-close 校验（不足 32 字符拒绝启动）
 - 敏感配置项统一迁移至 `.env` 文件
 - CORS 配置支持环境变量动态指定允许域名
 
@@ -67,14 +68,14 @@
 
 ### 新增
 
-- **OAuth2 完整认证流程**：Token 签发 / 刷新 / 吊销 / 检测，兼容标准 OAuth2 协议（`LoginController::token` / `removeToken` / `checkToken`）
-- **Token 黑名单机制**：登出后令牌即时失效，防止令牌被盗用
+- **OAuth2 完整认证流程**：Token 签发 / 刷新 / 吊销 / 检测，兼容标准 OAuth2 协议（`AuthController::token` / `removeToken` / `checkToken`）
+- **令牌 Redis 黑名单机制**：登出后令牌即时失效，防止令牌被盗用
 - **密码强度校验策略**：长度、复杂度、常见密码库校验
 - **登录日志增强**：增加 IP 归属地与浏览器信息记录
 
 ### 优化
 
-- JWT access_token 有效期可配置化（默认 2 小时）
+- JWT access_token 有效期可配置化（`JWT_ACCESS_TTL`，默认 2 小时）
 - refresh_token 续签逻辑优化，支持滑动过期
 - 验证码生成算法升级，增加干扰线与噪点
 - 登录失败次数限制与账户锁定机制
@@ -86,16 +87,15 @@
 
 ### 新增
 
-- **SQL 注入防护增强**：表名拼接统一经 `validateTableName` 校验，防止注入攻击
 - **XSS 防护增强**：富文本内容过滤策略优化，白名单机制
 - **CORS 配置增强**：支持环境变量动态指定允许域名，凭证模式兼容
-- **演示模式增强**：`#[DemoAllow]` 注解精细化控制，指定接口放行
+- **演示模式增强**：`#[DemoAllow]` 注解精细化控制，指定接口放行（DemoMiddleware）
 
 ### 优化
 
 - 敏感配置项统一迁移至 `.env` 文件，禁止硬编码
-- 请求参数统一校验，空参数与类型错误提前拦截
-- 异常信息脱敏，生产环境不暴露文件路径与行号
+- 请求参数统一校验，FormRequest 空参数与类型错误提前拦截
+- 异常信息脱敏，生产环境（`APP_DEBUG=false`）不暴露文件路径与行号
 
 ### 修复
 
@@ -110,17 +110,17 @@
 
 ### 新增
 
-- **岗位管理模块**：岗位信息维护与部门关联（PositionController / PositionLogic）
-- **系统参数管理模块**：系统参数与业务参数分类管理（ParamController / ParamLogic / ParamService）
-- **级别管理模块**：级别信息维护与排序（LevelController / LevelLogic）
-- **城市行政区划模块**：城市树形结构与模糊搜索（CityController / CityLogic）
+- **岗位管理模块**：岗位信息维护与部门关联（PositionController / PositionService）
+- **系统参数管理模块**：系统参数与业务参数分类管理（ParamController / ParamService）
+- **职级管理模块**：职级信息维护与排序，支持 Excel 导入导出（LevelController / LevelService）
+- **城市行政区划模块**：城市树形结构与模糊搜索（CityController / CityService）
 
 ### 优化
 
 - 参数管理支持缓存策略，高频参数请求级缓存
 - 城市数据支持树形结构展示与模糊搜索
 - 岗位与部门关联查询优化
-- 字段校验器统一规范化（新增 PositionValidate / ParamValidate / LevelValidate）
+- 字段校验统一规范化（新增对应 FormRequest）
 
 
 ## [4.6.0] - 2025-11-25
@@ -129,14 +129,14 @@
 
 ### 新增
 
-- **文件模板管理模块**：模板文件上传、版本管理与在线编辑（FileTemplateController / FileTemplateLogic）
+- **文件模板管理模块**：模板文件上传、版本管理与在线编辑（FileTemplateController / FileTemplateService）
 - **富文本占位符机制**：`[IMG_URL]` 占位符，入库替换、出库还原域名，迁移无感知
-- **文件字段自动迁移**：临时文件自动迁移至正式目录，自动去除域名前缀
-- **批量导出分批查询**：`chunkList` 支持逐批处理，避免大数据量内存溢出
+- **文件字段自动迁移**：临时文件自动迁移至正式目录，自动去除域名前缀（HasFileProcessing Trait）
+- **批量导出分批查询**：支持逐批处理，避免大数据量内存溢出
 
 ### 优化
 
-- `save_file` / `save_content` / `get_file_url` 函数链路优化
+- 全局辅助函数文件处理链路优化（`save_file` / `get_file_url` 等）
 - 文件上传 MIME 类型真实检测（`finfo`），不信任客户端声明
 - 上传目录自动按日期分目录，避免单目录文件过多
 - 图片字段与文件字段处理逻辑分离，支持不同校验策略
@@ -151,14 +151,14 @@
 - **批量生成**：支持多表批量生成代码，一次操作完成多模块搭建
 - **代码预览**：生成前可查看所有文件内容，确认无误后再写入
 - **字典自动生成**：从字段注释中提取枚举值，自动生成字典数据
-- **路由与菜单自动生成**：生成代码时自动注册路由与菜单权限节点
+- **路由与菜单自动生成**：生成代码时自动注册 `routes/api.php` 路由与菜单权限节点
 
 ### 优化
 
-- 模板渲染引擎优化，变量替换更精准
+- 模板渲染引擎优化，变量替换更精准（`resources/templates/` 后端 4 套 + 前端 ui/ui2 模板）
 - 字段属性自动分析（图片字段、富文本字段、筛选字段、模糊搜索字段）
 - 生成文件冲突检测，已存在文件提示跳过或覆盖
-- 多数据库驱动适配优化（PostgreSQL / Oracle / SQL Server / SQLite）
+- 多数据库驱动适配优化（PostgreSQL / SQL Server / SQLite）
 
 
 ## [4.4.0] - 2025-08-07
@@ -167,15 +167,15 @@
 
 ### 新增
 
-- **查询参数自动转换**：驼峰转下划线自动转换（`convertQueryParams`），前后端命名风格无感适配
-- **动态排序**：排序字段支持前端动态指定（`orderField` / `orderType`）
+- **查询参数自动转换**：驼峰转下划线自动转换（`API_CAMEL_SNAKE_CONVERT`），前后端命名风格无感适配
+- **动态排序**：排序字段支持前端动态指定（排序白名单内生效）
 - **返回字段过滤**：前端通过 `fields` 参数指定需要的字段，减少数据传输量
-- **分批查询回调**：`chunkList` 支持逐批回调处理，适合大数据量导出
+- **分批查询回调**：支持逐批回调处理，适合大数据量导出
 
 ### 优化
 
-- 数据权限查询缓存（角色权限 1 小时缓存）
-- 字典数据请求级缓存，同一请求内不重复查询
+- 数据权限查询缓存（角色权限缓存，Menu/RoleMenu Observer 失效）
+- 字典数据请求级缓存 + Cache 两级缓存，同一请求内不重复查询
 - 系统参数请求级缓存，减少数据库查询
 - 表字段列表静态缓存，同一请求内只查一次
 
@@ -188,14 +188,14 @@
 
 - **Excel 导入**：支持原始数组导入与表头映射导入两种模式（`ExcelService::import` / `importWithMap`）
 - **Excel 导出**：一次性导出，适合中小数据量（`ExcelService::export`）
-- **大数据量分批导出**：分批查询 + 流式写入，避免内存溢出（`chunkExport`）
+- **大数据量分批导出**：分批查询 + 流式写入，避免内存溢出
 - **表头映射导入**：自动按表头关联字段名，无需手动映射列号
 
 ### 优化
 
-- 导出文件统一保存至 `upload/temp/日期/` 目录，自动清理过期文件
+- 导出文件统一保存至临时目录，自动清理过期文件
 - 导入数据空行自动过滤
-- PhpSpreadsheet 依赖升级至 ^5.10
+- PhpSpreadsheet 依赖升级至 ^2.0
 - 导入导出异常统一捕获，返回友好错误信息
 
 
@@ -205,16 +205,16 @@
 
 ### 新增
 
-- **40+ 种操作类型常量**：`#[Log]` 注解支持新增/修改/删除/查询/导入/导出/审批/驳回/执行/暂停/恢复等全场景
+- **30 种操作类型常量**：`#[OperationLog]` 注解支持新增/修改/删除/查询/导入/导出/审批/驳回/执行/暂停/恢复等全场景
 - **日志描述占位符**：支持 `{param}` 占位符，自动替换为请求参数值（如 `删除用户ID:{id}` → `删除用户ID:123`）
 - **智能记录策略**：写操作（POST/PUT/DELETE）始终记录，读操作按类型选择性记录
 - **登录日志独立模块**：记录登录/登出/失败，含失败原因与 IP 信息
 
 ### 优化
 
-- LogMiddleware 日志写入失败静默处理，不影响主业务
-- 操作日志排除列表可配置化（`middleware.log_except`）
-- `OperationLog` 模型增加操作类型名称自动翻译
+- LogOperation 中间件日志写入失败静默处理，不影响主业务（terminable 阶段落库）
+- 操作日志排除列表可配置化
+- OperationLog 模型增加操作类型名称自动翻译
 - 日志记录增加耗时统计（请求开始到响应完成）
 
 
@@ -224,11 +224,10 @@
 
 ### 新增
 
-- **`#[Permission]` 权限注解**：控制器方法级权限校验，声明即生效
-- **`#[Log]` 操作日志注解**：自动记录操作日志，无需手动埋点
+- **`#[Permission]` 权限注解**：控制器方法级权限校验，auth.jwt 中间件反射统一鉴权，声明即生效
+- **`#[OperationLog]` 操作日志注解**：自动记录操作日志，无需手动埋点
 - **`#[DemoAllow]` 演示模式注解**：演示模式下指定接口放行
-- **`AttributeService`**：统一注解读取服务，基于 PHP 8 反射
-- **`PasswordService`**：密码加密服务（bcrypt 双重加盐）
+- **`PasswordService`**：密码加密服务（bcrypt，成本因子 12）
 - **`RequestInfoService`**：请求信息提取服务（IP / User-Agent / 地理位置）
 
 ### 优化
@@ -244,20 +243,20 @@
 
 ### 新增
 
-- **声明式属性配置**：`BaseLogic` 通过配置 `pageLikeFields` / `pageEqFields` / `pageOrderBy` / `uniqueFields` 等属性，自动完成查询构建、排序、唯一性校验
-- **生命周期钩子体系**：`beforeAdd` / `afterAdd` / `beforeUpdate` / `afterUpdate` / `beforeDelete` / `afterDelete`，业务逻辑按需注入
+- **声明式属性配置**：`BaseService` 通过配置 `pageLikeFields` / `pageEqFields` / `pageOrderBy` / `uniqueFields` 等属性，自动完成查询构建、排序、唯一性校验
+- **生命周期钩子体系**：`beforeAdd` / `afterAdd` / `beforeUpdate` / `afterUpdate` / `beforeDelete` / `afterDelete`，业务逻辑按需注入，DB 事务由基类统一管理
+- **6 个 Service Trait**：HasCrudOperations / HasQueryScopes / HasFileProcessing / HasDataScope / HasSerializeMaps / HasUniqueCheck 组合复用
 - **文件字段自动处理**：配置 `fileFields` 后自动迁移临时文件、补全域名
 - **富文本字段自动处理**：配置 `contentFields` 后自动处理临时文件与占位符
 - **枚举显示名自动翻译**：配置 `serializeMaps` 后自动补 `{字段名}Text` 字段
-- **唯一性校验机制**：配置 `uniqueFields` 后自动校验，支持全局唯一与分组唯一
-- **表字段自动过滤**：前端传入非数据库字段自动忽略，安全接收全量数据
+- **唯一性校验机制**：配置 `uniqueFields` 后自动校验
 
 ### 优化
 
-- `BaseController` 新增 `_index` / `_list` / `_treeList` / `_detail` / `_add` / `_edit` / `_remove` / `_batchRemove` 通用方法
+- `Controller` 基类提供 `_page` / `_list` / `_treeList` / `_detail` / `_add` / `_update` / `_delete` / `_batchDelete` 通用方法
 - 子类控制器代码量减少 70%+，只需配置属性 + 调用父类方法
-- `BaseModel` 审计字段自动写入（`create_user` / `create_time` / `update_user` / `update_time`）
-- 软删除全局查询范围自动过滤已删除数据
+- `HasAuditColumns` 审计字段自动写入（`create_user` / `create_time` / `update_user` / `update_time`）
+- `SoftDeleteFlagScope` 软删除全局查询范围自动过滤已删除数据
 
 ### 修复
 
@@ -272,17 +271,17 @@
 
 ### 新增
 
-- **代码生成器模块**：一键生成 Controller / Logic / Model / Validate / 前端页面（GeneratorController / GeneratorLogic / GeneratorService）
+- **代码生成器模块**：一键生成 Controller / Service / Model / FormRequest / 前端页面（GeneratorController / GeneratorService）
+- **CLI 命令**：`php artisan generate:code` 命令行生成
 - **数据表列表查询**：从数据库读取所有表信息，支持按表名搜索
 - **表结构分析**：字段类型归一化与属性自动识别（图片、富文本、筛选项、唯一、模糊搜索）
-- **多数据库适配**：支持 MySQL / PostgreSQL / SQL Server / Oracle / SQLite 五种驱动
 
 ### 优化
 
 - 生成代码风格与项目现有代码保持一致
-- 生成的 Validate 自动按字段类型生成校验规则
-- 生成的 Controller 自动配置 `#[Permission]` 与 `#[Log]` 注解
-- 生成的菜单自动挂载到指定父菜单下
+- 生成的 FormRequest 自动按字段类型生成校验规则
+- 生成的 Controller 自动配置 `#[Permission]` 与 `#[OperationLog]` 注解
+- 生成的菜单自动挂载到指定父菜单下（`GENERATOR_PARENT_MENU_ID`）
 
 
 ## [3.8.0] - 2024-10-17
@@ -291,18 +290,16 @@
 
 ### 新增
 
-- **租户管理模块**：租户 CRUD、用户数统计、管理员账号创建（TenantController / TenantLogic）
-- **`TenantMiddleware` 租户中间件**：从 JWT 解析用户租户，注入租户上下文
-- **`BaseLogic` 租户隔离**：配置 `tenantScopeField` 后自动按租户过滤数据
-- **租户 ID 自动填充**：新增数据时自动写入 `tenant_id`，超级管理员代入默认租户
+- **租户管理模块**：租户 CRUD、用户数统计、管理员账号创建（TenantController / TenantService）
+- **`ResolveTenant` 租户中间件**：从 JWT 解析用户租户，注入租户上下文
+- **`BaseTenantService` 租户隔离**：自动按租户过滤查询数据，新增数据自动填充 `tenant_id`
 - **租户状态校验**：启用/禁用/过期三种状态，过期租户自动拒绝访问
+- **`config/tenant.php`** 租户配置文件（默认租户 ID）
 
 ### 优化
 
-- 超级管理员（`tenantId=0`）跳过租户隔离
-- 租户隔离字段可配置化，不同表可指定不同隔离字段
+- 超级管理员（`tenantId=0`）跳过租户隔离，创建数据代入默认租户
 - 租户信息缓存，减少重复查询
-- `config/tenant.php` 租户配置文件
 
 
 ## [3.7.0] - 2024-09-03
@@ -311,15 +308,15 @@
 
 ### 新增
 
-- **定时任务管理**：任务 CRUD、Cron 表达式配置、启用/禁用（JobController / JobLogic）
-- **任务执行日志**：完整记录每次执行的开始时间、结束时间、执行状态、耗时、错误详情（JobLogController / JobLogLogic）
-- **Daemon 常驻进程调度器**：后台常驻进程自动调度任务执行
+- **定时任务管理**：任务 CRUD、Cron 表达式配置、启用/禁用（JobController / JobService）
+- **任务执行日志**：完整记录每次执行的开始时间、结束时间、执行状态、耗时、错误详情（JobLogController / JobLogService）
+- **Daemon 常驻进程调度器**：`php artisan job:daemon` 后台常驻进程自动调度任务执行
+- **一次性执行**：`php artisan job:run` 配合系统 Cron 执行到期任务
 - **任务操作**：手动执行一次、暂停、恢复、启用/禁用
-- **调度器状态查询**：`daemonStatus` 接口查询 Daemon 进程运行状态与 PID
 
 ### 优化
 
-- 任务锁文件机制（`runtime/job_daemon.lock`），防止重复调度
+- 任务防重复执行机制（同一任务同一分钟内不重复执行）
 - 跨平台进程检测（Windows `tasklist` / Linux `posix_kill`）
 - 任务执行异常捕获与日志记录
 - Cron 表达式校验与解析
@@ -331,8 +328,8 @@
 
 ### 新增
 
-- **通知公告模块**：通知 CRUD、类型管理、发布状态、排序（NoticeController / NoticeLogic）
-- **友情链接模块**：链接 CRUD、图标管理、启用/禁用（LinkController / LinkLogic）
+- **通知公告模块**：通知 CRUD、类型管理、发布状态、排序（NoticeController / NoticeService）
+- **友情链接模块**：链接 CRUD、图标管理、启用/禁用（LinkController / LinkService）
 - **通知类型字典**：通知/公告/提醒三种类型，字典驱动
 - **链接状态管理**：启用/禁用状态控制
 
@@ -350,8 +347,8 @@
 
 ### 新增
 
-- **文章管理模块**：文章 CRUD、封面图、图集、状态管理、点击率统计（ArticleController / ArticleLogic）
-- **文章分类模块**：分类 CRUD、树形结构、多级嵌套（CategoryController / CategoryLogic）
+- **文章管理模块**：文章 CRUD、封面图、图集、状态管理、点击率统计（ArticleController / ArticleService）
+- **文章分类模块**：分类 CRUD、树形结构、多级嵌套（CategoryController / CategoryService）
 - **分类树形结构**：支持无限级分类嵌套（`parent_id` 自关联）
 - **文章状态管理**：正常/下架两种状态
 
@@ -369,16 +366,17 @@
 
 ### 新增
 
-- **字典管理模块**：字典 CRUD、字典项管理（DictController / DictLogic / DictItemController / DictItemLogic）
-- **配置管理模块**：配置 CRUD、配置项管理（ConfigController / ConfigLogic / ConfigItemController / ConfigItemLogic）
-- **`DictService` 字典服务**：按编码查询字典值，请求级缓存
+- **字典管理模块**：字典 CRUD、字典项管理（DictController / DictItemController / DictService）
+- **配置管理模块**：配置 CRUD、配置项管理（ConfigController / ConfigItemController / ConfigService）
+- **`DictCacheService` 字典服务**：按编码查询字典值，两级缓存（请求级 + Cache）
 - **`ParamService` 参数服务**：按编码查询系统参数，请求级缓存
+- **字典缓存命令**：`php artisan dict:clear-cache`
 
 ### 优化
 
 - 字典数据按编码缓存，同一请求内不重复查询
 - 配置项支持分组管理
-- 字典值与显示名自动映射
+- 字典值与显示名自动映射（Observer 变更自动失效缓存）
 - 配置项支持启用/禁用状态
 
 
@@ -388,10 +386,10 @@
 
 ### 新增
 
-- **部门管理模块**：部门 CRUD、树形结构（DeptController / DeptLogic）
-- **菜单管理模块**：菜单 CRUD、目录/菜单/按钮三种类型（MenuController / MenuLogic）
+- **部门管理模块**：部门 CRUD、树形结构（DeptController / DeptService）
+- **菜单管理模块**：菜单 CRUD、目录/菜单/按钮三种类型（MenuController / MenuService）
 - **数据权限控制**：全部 / 本部门 / 仅本人三级数据权限
-- **`BaseLogic` 数据权限过滤**：配置 `dataScopeUserField` / `dataScopeDeptField` 后自动过滤
+- **`HasDataScope` 数据权限 Trait**：配置数据权限字段后自动过滤
 - **角色数据权限范围**：`data_scope` 字段控制角色可见数据范围
 
 ### 优化
@@ -399,7 +397,7 @@
 - 菜单支持目录 / 菜单 / 按钮三种类型（`type` 字段）
 - 权限节点与菜单分离，按钮级权限控制
 - 部门树形结构展示
-- 数据权限缓存机制（角色权限 1 小时缓存）
+- 数据权限缓存机制（角色权限缓存 + Observer 失效）
 
 
 ## [3.2.0] - 2024-01-23
@@ -408,15 +406,15 @@
 
 ### 新增
 
-- **用户管理模块**：用户 CRUD、密码重置、启用/禁用（UserController / UserLogic）
-- **角色管理模块**：角色 CRUD、权限节点配置（RoleController / RoleLogic）
-- **RBAC 权限模型**：用户 → 角色 → 菜单 → 权限，四层权限体系
+- **用户管理模块**：用户 CRUD、密码重置、启用/禁用（UserController / UserService）
+- **角色管理模块**：角色 CRUD、权限节点配置（RoleController / RoleService）
+- **RBAC 权限模型**：用户 → 角色 → 菜单 → 权限，菜单即权限体系
 - **用户角色关联表**：`UserRole` 支持一个用户多角色
 - **角色菜单关联表**：`RoleMenu` 支持一个角色多权限
 
 ### 优化
 
-- 用户密码 bcrypt 双重加盐加密
+- 用户密码 bcrypt 加密（成本因子 12）
 - 用户状态管理（启用/禁用）
 - 角色支持权限节点批量分配
 - 用户列表支持按角色、部门筛选
@@ -428,17 +426,17 @@
 
 ### 新增
 
-- **用户登录接口**：用户名 + 密码 + 验证码登录（`LoginController::login`）
-- **JWT 双令牌机制**：`access_token`（2小时） + `refresh_token`（7天）
-- **`JwtService` 令牌服务**：令牌签发 / 刷新 / 解析 / 吊销
+- **用户登录接口**：用户名 + 密码 + 验证码登录（`AuthController::login`）
+- **JWT 双令牌机制**：`access_token`（默认 2 小时） + `refresh_token`（默认 7 天）
+- **`JwtService` 令牌服务**：令牌签发 / 刷新 / 解析 / 吊销（Redis 有状态存储）
 - **图形验证码**：`CaptchaService` 生成验证码，按 IP 频率控制
-- **`AuthMiddleware` 认证中间件**：JWT 校验 + 用户信息注入
-- **`CorsMiddleware` 跨域中间件**：支持配置化跨域策略
+- **`Authenticate` 认证中间件（auth.jwt）**：JWT 校验 + `#[Permission]` 鉴权 + 用户信息注入
+- **`Cors` 跨域中间件**：支持配置化跨域策略
 
 ### 优化
 
 - Token 从请求头 `Authorization: Bearer {token}` 提取
-- 登录参数校验器（`LoginValidate`）
+- 登录参数 FormRequest 校验
 - 登录日志记录（成功/失败/原因）
 
 
@@ -448,20 +446,20 @@
 
 ### 新增
 
-- **ThinkPHP 6.1.x 框架初始化**：基于 ThinkPHP 6.1.x 搭建前后端分离 API 项目
-- **`BaseModel` 模型基类**：软删除（`is_delete` 字段）+ 审计字段自动写入（`create_user` / `create_time` / `update_user` / `update_time`）
-- **`BaseController` 控制器基类**：统一响应格式（`success` / `fail` / `page`）+ 参数获取
-- **`BaseLogic` 逻辑基类**：基础 CRUD + 软删除 + 分页查询
-- **`Common` 公共函数库**：密码加密 / 文件上传 / 驼峰下划线转换 / 随机字符串
-- **`Result` 统一响应类**：`success` / `fail` / `page` 三种响应格式
-- **`ExceptionHandle` 全局异常处理**：统一异常捕获与错误响应
-- **多数据库配置支持**：MySQL / PostgreSQL / SQL Server / Oracle / SQLite
+- **Laravel 13 框架初始化**：基于 Laravel 13 + PHP 8.3 搭建前后端分离 API 项目
+- **模型层基础**：Eloquent 模型 + `SoftDeletesByFlag`（`is_delete` 软删除） + `HasAuditColumns`（审计字段自动写入）
+- **控制器基类**：统一响应格式（`success` / `fail` / `paginate`）+ 参数获取 + 通用 CRUD 快捷方法
+- **服务层基类**：`BaseService` 基础 CRUD + 软删除 + 分页查询
+- **全局辅助函数库**：`Helpers/helpers.php`（密码加密 / 文件处理 / 驼峰下划线转换 / 随机字符串）
+- **`Result` 统一响应类**：`success` / `page` / `fail` / 语义化方法，统一 `{code, ok, msg, data}` 结构
+- **`Handler` 全局异常处理**：异常统一捕获与 JSON 响应渲染
+- **多数据库配置支持**：MySQL / PostgreSQL / SQL Server / SQLite（`DB_CONNECTION` 切换）
 - **`.env` 环境变量配置**：敏感配置与环境解耦
 
 ### 架构特性
 
 - 前后端完全分离架构
 - RESTful API 设计规范
-- 统一响应格式（`code` / `msg` / `data`）
+- 统一响应格式（`code` / `ok` / `msg` / `data`）
 - 软删除全局查询范围自动过滤
 - 审计字段模型事件自动写入