109 lines
3.2 KiB
Markdown
109 lines
3.2 KiB
Markdown
# 更新日志
|
||
|
||
本文档记录 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)
|