签入版本

CHANGELOG.md

@@ -0,0 +1,108 @@
+# 更新日志
+
+本文档记录 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)