# 更新日志

本文档记录 DjangoAdmin FastAPI + EleVue 版本的所有重要变更。

格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。


## [未发布]

### 新增
- 完善项目 README 文档，新增英文版本
- 新增 CONTRIBUTING.md 贡献指南
- 新增 CHANGELOG.md 更新日志
- 新增 docs/ARCHITECTURE.md 架构说明文档
- 新增 docs/DEPLOYMENT.md 部署指南

### 优化
- 丰富项目说明文案，突出技术栈特点与项目优势
- 完善技术栈表格，补充组件链接与说明


## [2.8.0] - 2026-08

### 新增
- 完善项目视觉与 UI 操作体验
- 优化软件全局配置文件
- 撰写新版软件文案说明

### 修复
- 修复用户反馈的若干问题


## [2.7.0] - 2026-07

### 新增
- 跨库数据迁移工具 `scripts/migrate_db.py`，支持 MySQL → PostgreSQL / SQL Server / SQLite
- Alembic 数据库迁移集成，支持版本化 Schema 管理
- 数据库初始化脚本 `scripts/init_db.py`，支持多驱动自动建库
- 字典数据种子脚本 `scripts/seed_dict.py`
- 定时任务闭环演示脚本 `scripts/demo_job_loop.py`
- Docker Compose 容器化部署方案
- 契约快照测试，守护路由路径、权限标识与表名

### 优化
- BaseRepository 统一软删过滤，等值查询自动跳过 None 值
- BaseService 批量删除统一走 `batch_delete_with_r` 静态方法
- 中间件链重构：CORS → Redis → 限流 → DB 会话 → 操作日志
- 响应格式统一：`R.ok()` / `R.failed()` 标准化

### 修复
- 上传接口缺 request 参数致 500 错误
- Excel 导入 JSONResponse 解析崩溃
- 文字广告 cover 列 NOT NULL 冲突


## [2.6.0] - 2026-06

### 新增
- 定时任务模块，基于 APScheduler 实现可视化调度
- 任务日志模块，记录每次任务执行详情
- 操作日志自动记录，支持按模块/动作筛选
- 登录日志模块，记录登录/退出行为
- 限流中间件，基于 Redis 滑动窗口的 per-IP 限流

### 优化
- JWT 认证机制，支持 Token 刷新与黑名单
- 权限控制装饰器，用户 ID 1（管理员）自动跳过权限检查
- 数据库会话中间件，请求级会话自动提交/回滚


## [2.5.0] - 2026-05

### 新增
- 前端升级至 Vue 3 + TypeScript + Element Plus
- 状态管理迁移至 Pinia
- 构建工具迁移至 Vite
- 组合式 API（Composition API）全面适配
- ESM 模块化改造

### 优化
- 前端代码 TypeScript 类型安全
- ESLint + Prettier 代码规范统一
- 前端组件可插拔体系重构


## [2.0.0] - 2026-01

### 新增
- 后端框架迁移至 FastAPI
- SQLAlchemy 2.0 声明式映射
- Pydantic 2.0 数据校验
- 原生异步支持（async/await）
- 多数据库驱动支持（MySQL / PostgreSQL / SQL Server / Oracle / SQLite）
- Redis 异步客户端集成
- 统一异常处理与响应封装
- RBAC 细粒度权限控制（按钮级）
- 代码生成器，一键生成 CRUD 模块

### 变更
- 项目架构重构为前后端分离模式
- API 路由统一前缀 `/api/v1`
- 配置管理迁移至 `.env` + `python-dotenv`


---

> 💡 更早版本的变更记录请参阅 [版本更新说明](document/版本更新说明.txt)