# 更新日志

:::tip 说明
更新日志是项目演进的完整记录，帮助开发者和企业了解每个版本的能力变化与技术演进方向。对于开发者，可快速掌握新功能与 API 变更，降低升级成本；对于企业，可评估版本稳定性与功能成熟度，为技术选型和升级决策提供依据。建议在升级前阅读目标版本的变更内容，确保业务代码平滑适配。
:::

## 版本总览

| 版本 | 日期 | 主要内容 |
|:-----|:-----|:---------|
| 2.0.0 | 2024-03-14 | 用户、角色、菜单、部门、岗位、职级管理 |
| 2.1.0 | 2024-06-23 | RBAC 权限体系 + JWT 认证 + 验证码 |
| 2.2.0 | 2024-09-06 | 字典管理 + 系统配置 + 参数管理 |
| 2.3.0 | 2024-12-19 | 文章管理 + 分类管理 + 文件上传 + XSS 防护 |
| 2.4.0 | 2025-03-11 | Vue3 + ElementPlus + TypeScript + Vite |
| 2.5.0 | 2025-06-25 | 代码生成器 CLI + Web UI + Excel 导入导出 |
| 2.6.0 | 2025-09-17 | 定时任务 + 操作日志 + 登录日志 |
| 2.7.0 | 2025-12-08 | 接口限流 + IP 地理位置 + 安全防护 |
| 2.8.0 | 2026-03-22 | Docker 容器化 + Nginx + Supervisor |
| 2.9.0 | 2026-06-15 | 文档体系 + 缓存优化 + 性能提升 |
| **3.0.0** | **2026-09-01** | **Django 6.0 + Python 3.12 + 架构优化** |

## [3.0.0] - 2026-09-01

**Django 6.0 升级，技术栈全面焕新。**

### 新增

- **Django 6.0.3**：升级至 Django 6.0 长期支持版本，安全性与性能全面提升
- **Python 3.12**：推荐使用 Python 3.12，运行性能提升 5-10%
- **pnpm 12**：前端包管理器升级至 pnpm 12，安装速度提升 30%
- **VitePress 文档站**：全新文档站上线，127 篇技术文档，支持全文搜索
- **BaseModel 字段重排**：通过 `class_prepared` 信号自动将公共字段移至业务字段之后
- **Token 黑名单机制**：退出登录后令牌立即失效，基于 Redis 存储，自动过期清理
- **操作日志装饰器**：`@operation_log` 自动记录请求参数、响应结果、执行耗时

### 优化

- Django ORM 查询性能优化，减少 N+1 查询
- 前端构建速度优化，Vite 开发服务器启动时间 < 500ms
- 代码生成器模板优化，生成代码与手写代码风格一致
- 环境变量配置统一通过 `config/env.py` 加载 `.env` 文件

### 修复

- 修复 Python 3.12 兼容性问题
- 修复并发请求下数据库连接泄露
- 修复 JWT Token 过期后未正确返回 401 状态码

## [2.9.0] - 2026-06-15

**文档体系与缓存优化。**

### 新增

- **企业级文档体系**：覆盖快速入门、模块开发、架构设计、运维部署、规范标准
- **Redis 缓存优化**：权限缓存、字典缓存、IP 地理位置缓存，减少数据库查询
- **数据库连接池**：Django ORM 连接池参数可调（`CONN_MAX_AGE`、`CONN_HEALTH_CHECKS`）
- **日志系统优化**：Python logging 模块配置化，支持按模块分级日志

### 优化

- 分页查询性能优化，大表查询速度提升 50%
- 前端首屏加载优化，路由懒加载 + 组件按需导入
- 代码生成器模板优化，生成代码风格统一

### 修复

- 修复 Redis 连接异常时权限校验失败
- 修复大表分页查询内存溢出
- 修复前端路由懒加载偶发白屏

## [2.8.0] - 2026-03-22

**Docker 容器化与生产部署能力。**

### 新增

- **Docker 容器化**：提供 Dockerfile + docker-compose.yml，支持一键启动完整环境
- **Nginx 反向代理**：生产环境 Nginx 配置模板，支持 SSL 终止与负载均衡
- **Supervisor 进程管理**：Gunicorn + Supervisor 进程管理方案
- **健康检查端点**：`/health` 接口，支持 Docker 和 Kubernetes 健康检查
- **多环境配置**：开发、测试、UAT、生产四套环境配置模板

### 优化

- Docker 镜像体积优化，多阶段构建减小 60%
- Gunicorn Worker 配置优化，支持 Gevent 异步 Worker
- 数据库迁移命令优化，支持跳过确认直接执行

### 修复

- 修复 Docker 环境下时区设置不生效
- 修复 Nginx 代理后获取客户端 IP 异常
- 修复 Supervisor 重启后进程未正确清理

## [2.7.0] - 2025-12-08

**安全防护与可观测性增强。**

### 新增

- **IP 地理位置查询**：基于离线 IP 数据库，服务启动时加载内存，查询零延迟
- **User-Agent 解析**：自动识别客户端操作系统与浏览器信息
- **接口限流**：基于 Django 缓存框架的按 IP 限流策略，支持按接口独立配置阈值
- **验证码防刷**：按 IP 频率控制，单 IP 每分钟最多获取 5 次验证码

### 优化

- JWT 认证增强：Token 支持主动刷新与过期续签
- 权限校验增强：超级管理员（ID=1）自动放行所有权限校验
- 文件上传安全：扩展名白名单 + 文件类型校验双重防护

### 修复

- 修复 Token 刷新后旧令牌未失效
- 修复大文件上传超时问题
- 修复并发请求下会话泄露

## [2.6.0] - 2025-09-17

**定时任务与日志审计能力。**

### 新增

- **定时任务调度**：支持 Cron 表达式、固定间隔、指定时间三种触发方式
- **任务执行日志**：完整记录每次执行的开始时间、结束时间、执行状态、耗时
- **登录日志**：记录所有登录与退出行为，含 IP 地址、设备信息、登录结果
- **数据字典缓存**：Redis 缓存加速字典查询，支持手动刷新与变更自动失效
- **权限缓存主动失效**：权限变更实时生效，支持版本号兜底机制

### 优化

- 定时任务分布式锁：多实例部署时避免任务重复执行
- 字典查询：支持按编码直接获取字典项列表
- 系统配置：运行时动态修改，无需重启服务生效

### 修复

- 修复定时任务夏令时偏移问题
- 修复字典项排序不生效
- 修复配置值包含特殊字符时序列化异常

## [2.5.0] - 2025-06-25

**代码生成能力上线，开发效率大幅提升。**

### 新增

- **代码生成器（CLI）**：`python generator.py django_<表名>` 一键生成 Model、Form、Service、View、URL 及前端页面
- **代码生成器（Web UI）**：`/generator` 可视化操作界面，支持单表生成与批量生成
- **自定义模板引擎**：基于 Jinja2，支持自定义生成代码风格与目录结构
- **Excel 导入导出**：支持模板下载、数据校验、错误行跳过与错误详情导出
- **文件模板管理**：支持模板文件上传、版本管理

### 优化

- 代码生成器自动注册路由与权限节点，生成即用
- 生成代码自动适配分层架构（Model/Form/Service/View/URL）
- 代码生成器自动追加路由到 `application/urls.py`，自动注册 App 到 `INSTALLED_APPS`

### 修复

- 修复生成代码唯一性校验遗漏字段
- 修复 Excel 导出日期格式不一致
- 修复模板渲染中文乱码

## [2.4.0] - 2025-03-11

**前端技术栈全面升级至 Vue3 生态。**

### 新增

- **Vue3 升级**：前端框架从 Vue 2 升级至 Vue3.4+，全面拥抱 Composition API
- **ElementPlus**：采用 ElementPlus 组件库，适配 Vue3 生态
- **Pinia 状态管理**：替代 Vuex，更轻量、更灵活、TypeScript 支持更完善
- **TypeScript 类型安全**：全量类型定义，IDE 智能提示与编译时类型检查
- **Vite 构建工具**：替代 Webpack，开发服务器毫秒级启动，HMR 即时生效

### 优化

- 构建速度：Vite 开发服务器启动时间 < 500ms，热更新 < 100ms
- 代码规范：ESLint + Prettier + Stylelint 统一代码风格
- 组件体系：可插拔架构重构，按需加载，首屏加载体积减少 40%

### 修复

- 修复热更新偶尔失效问题
- 修复 TypeScript 类型定义不完整
- 修复部分组件样式在 Vue3 下兼容性问题

## [2.3.0] - 2024-12-19

**内容管理与文件上传能力。**

### 新增

- **文章管理**：文章发布、编辑、删除、状态流转（草稿 → 审核 → 发布 → 下架）
- **分类管理**：树形分类结构，支持拖拽排序与层级校验
- **公告管理**：通知公告发布，支持置顶排序与有效期范围控制
- **友情链接**：友情链接管理，支持启用/停用状态控制
- **行政区划**：全国省市区三级联动数据管理
- **文件上传**：统一文件上传接口，支持图片、文档、压缩包等全类型文件
- **XSS 防护**：富文本内容自动过滤恶意脚本

### 优化

- 文件上传流式大小校验，超限立即中断，避免内存溢出
- 富文本编辑器集成，支持图片上传与预览
- 文件 URL 自动补全，相对路径自动转换为绝对路径

### 修复

- 修复富文本编辑器中图片路径为相对路径导致无法访问
- 修复编辑时临时文件未清理
- 修复批量删除时关联数据未同步处理

## [2.2.0] - 2024-09-06

**系统配置与基础数据管理增强。**

### 新增

- **系统配置模块**：动态配置参数，运行时可调，修改即时生效，无需重启
- **参数管理模块**：系统参数与业务参数分类管理，支持参数分组
- **字典模块增强**：字典项排序、启用/停用状态控制、批量导入导出
- **部门树形结构**：无限级部门树，支持拖拽排序与层级校验
- **职级管理**：职级信息维护，支持 Excel 导入导出
- **岗位管理**：岗位信息维护，支持状态管理

### 优化

- 配置查询：支持按配置编码直接获取值，支持默认值兜底
- 字典导入导出：支持 Excel 批量导入字典项，含数据校验
- 部门排序：拖拽交互优化，实时保存排序结果

### 修复

- 修复字典编码重复校验遗漏
- 修复部门删除时子部门未同步处理
- 修复空配置值序列化异常

## [2.1.0] - 2024-06-23

**RBAC 权限体系与认证安全。**

### 新增

- **RBAC 权限体系**：用户-角色-菜单三层权限模型，支持按钮级权限控制
- **JWT 认证**：无状态令牌认证，支持令牌刷新与黑名单机制
- **登录安全**：图形验证码、失败次数锁定、密码加密存储
- **菜单管理**：动态路由生成，权限节点可视化配置
- **PermissionRequired 权限混入**：后端接口级权限拦截
- **v-perm 权限指令**：前端按钮级权限控制

### 优化

- 管理员账号（ID=1）自动放行所有权限校验
- 权限数据 Redis 缓存加速，减少数据库查询
- Token 过期自动跳转登录页，携带 redirect URL

### 修复

- 修复 Token 过期响应码统一为 401
- 修复权限缓存刷新延迟
- 修复登录锁定时间计算错误

## [2.0.0] - 2024-03-14

**核心模块与基础架构。**

### 新增

- **Django Web 框架**：基于 Django 5.x，成熟的 MTV 架构，丰富的生态系统
- **Django ORM**：声明式模型定义，自动迁移，多数据库方言支持
- **Django ModelForm**：声明式表单验证，自动错误信息生成
- **Vue3 前端**：基于 Vue3 + ElementPlus，前后端分离架构
- **用户管理**：用户账号管理、密码重置、启用/停用状态控制
- **角色管理**：角色 CRUD、权限节点配置
- **菜单管理**：菜单 CRUD、图标设置、动态路由生成
- **部门管理**：部门树形结构管理
- **登录模块**：JWT 登录认证、图形验证码
- **统一响应**：`R.ok()` / `R.failed()` 统一 JSON 响应格式
- **软删除**：所有数据逻辑删除，避免误删

### 架构特性

- 前后端完全分离架构，前端 Vue3 + 后端 Django
- Django MTV 设计模式，Model-Form-Service-View 分层
- 统一响应格式与异常处理
- 中间件链式处理：CORS → JWT 认证 → 权限校验 → 操作日志
- 动态路由与菜单驱动，后端配置前端自动渲染