Sz-Admin

切换日光/暗黑模式

v2.0.1（20260602） ​

IMPORTANT

v2.0.1 是 v2.0.0 之后的功能增强和修复版本，重点涉及代码生成器、Excel、审计、前端模块注册和 AI 协作资料。

1. 代码生成器重构 ​

本次升级重点优化代码生成器，生成目标和生成前确认流程有较大调整：

  • 支持选择生成到已有后端模块或新建后端模块。
  • 支持联动后端 API 前缀、前端模块和 Liquibase 接入。
  • 编辑页、字段配置页、代码预览页交互重构。
  • 字段智能推断增强，可提示字典、上传、时间、自动填充、逻辑删除和数据权限等常见配置。
  • 生成前磁盘检查增强，会检查模块接入、包扫描范围、路径和数据权限字段等问题。

如果升级前已经导入过表，建议升级后重新打开对应表的生成配置，确认后端模块、API 前缀、前端模块名和生成路径，再执行预览和磁盘检查。

WARNING

新建模块和自动补齐模块接入会修改 POM、application.yml、Liquibase 入口和前端 register.ts 等宿主文件。二开项目使用前请先预览，确认生成计划后再写入。

2. 数据库变更 ​

  • generator_table 增加生成目标相关字段，用于保存后端模块、API 前缀和前端模块等配置。
  • 初始化脚本补充“角色管理-SQL导出”按钮和默认角色授权。
  • 初始化脚本修正菜单标题：“登陆日志”改为“登录日志”。

如果你的系统中超级管理员角色不是 role_id = 1，或已经二开了角色初始化数据，升级后需要在角色管理中手工给目标角色补充“SQL导出”按钮权限。

CAUTION

升级前请备份数据库，并先在测试库或影子库验证 Liquibase 执行结果。代码生成器表如果有大量二开数据，升级后请重点检查生成配置是否符合预期。

3. 前端配置 ​

前端新增动态模块 API 上下文配置：

text
VITE_API_CONTEXT_PATH=/api
VITE_API_PROXY_TARGET=http://127.0.0.1:9991

动态模块请求会基于 VITE_API_CONTEXT_PATH 和模块 API 前缀拼接。升级后请同步检查 .env*、Vite proxy、Nginx location 和后端 server.servlet.context-path 是否一致。

前端还新增了 src/modules/**/register.ts 自动发现能力。如果二开项目手动注册过模块，需要确认模块名唯一，避免重复注册。

4. Excel 与审计 ​

  • Excel 优化 LocalDate、LocalDateTime、LocalTime 的导入导出转换，导出格式分别为 yyyy-MM-dd、yyyy-MM-dd HH:mm:ss、HH:mm:ss。
  • 审计日志优化慢操作和异常诊断记录逻辑。

如果生产环境开启审计诊断，请检查 config/{profile}/audit-log.yml 中的慢操作阈值、诊断开关和日志保留策略。

5. AI 协作资料 ​

本版本在 sz-boot-parent 中新增 AI 协作资料：

text
docs/project-knowledge-conventions.md
docs/codex-skills/README.md
docs/codex-skills/skills/sz-code-generator-workflow/SKILL.md
docs/codex-skills/skills/sz-liquibase-db-compat/SKILL.md

说明：

  • project-knowledge-conventions.md 是 Sz 体系通用知识库。
  • sz-code-generator-workflow 用于代码生成器相关生成、检查、清理和回滚。
  • sz-liquibase-db-compat 用于 Liquibase 与双库兼容迁移。
  • 这些文件不参与 Maven 构建，不影响服务启动，也不会改变运行时行为。

6. 推荐验证 ​

后端：

bash
E:\opt\apache-maven-3.9.6-bin\apache-maven-3.9.6\bin\mvn.cmd -pl sz-service/sz-service-admin -am compile -DskipTests

如果目标库是 PostgreSQL：

bash
E:\opt\apache-maven-3.9.6-bin\apache-maven-3.9.6\bin\mvn.cmd -pl sz-service/sz-service-admin -am compile -DskipTests -Ppostgresql

前端：

bash
pnpm run type-check
pnpm run build

代码生成器重点回归：

  1. 打开旧导入表配置，保存后执行预览和磁盘检查。
  2. 使用已有模块生成一个普通 CRUD，确认前后端、菜单脚本和 Liquibase 预览正常。
  3. 如需新建模块，先预览生成计划，再确认是否写入。
  4. 导出包含 LocalDate、LocalDateTime、LocalTime 字段的 Excel，确认格式正确。

返回升级索引