DjangoAdmin_FastAPI_EleVue/CHANGELOG.md

更新日志

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

格式基于 Keep a Changelog， 版本号遵循 语义化版本。

[未发布]

新增

• 完善项目 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

---

💡 更早版本的变更记录请参阅 版本更新说明