# 版本变更日志

本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/) 规范。

## [v3.0.0] - 2026-08-14

### 架构重构
- 采用 `src/` 布局，引入 Poetry 依赖管理与项目打包
- 引入 DDD 分层：`domain/`（实体、值对象、领域事件、仓储接口）
- 配置迁移至 Pydantic Settings（`.env` 驱动）
- 表单校验由 WTForms 迁移至 Pydantic schemas
- 密码加密由 MD5 升级为 bcrypt（兼容旧 MD5 密码自动升级）
- 数据访问引入 Repository 模式与读写分离支持
- API 统一挂载 `/api/v1` 前缀
- 新增核心基础设施：异常体系、事件总线、缓存管理器、结构化日志、统一响应

### 增强
- 新增健康检查端点 `/api/v1/health`
- 新增优雅关闭、链路追踪 ID、操作日志、限流中间件
- 新增 pytest 测试骨架与 CI/CD 流水线
- 新增部署配置（nginx/supervisor/prometheus/grafana/kubernetes）

## [v2.7.0] - 历史版本

- 见 `document/版本更新说明.txt`