签入版本

DjangoAdmin_Django_EleVue/zh/changelog.md

@@ -0,0 +1,292 @@
+# 更新日志
+
+:::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 认证 → 权限校验 → 操作日志
+- 动态路由与菜单驱动，后端配置前端自动渲染