# 更新日志

本项目的所有重要变更都会记录在此文件中。
格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)。

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

### 🏗️ 企业级重构（P1-P9 全部完成）

基于《重构方案-v2.md》，后端完成整体重构：

- **目录重构**：源码迁入 `src/`（core/common/modules/routes），删除 `application/`、`extensions/`、`utils/`
- **服务层范式**：21 个服务模块改为「入参数据/出参数据 + `raise BizError`」，新增 repository 层
- **依赖注入**：权限校验与操作日志通过 `current_app.extensions` 注入（解决 core→modules 依赖倒置）
- **API 版本化**：全部 148 条路由挂载 `/api/v1` 前缀，登录白名单同步更新
- **工程化**：pyproject.toml / flake8 / black / pre-commit / Makefile / pytest / CI-CD
- **运维**：`/health` 健康端点、Docker 加固、运维脚本（scripts/）

**质量指标**：全项目 flake8 从 154 条基线降至 0；pytest 12 项通过。

### 修复的问题

- 合并模块重名函数互相覆盖（get_info/_apply_filters/_build_page_data）
- `log/` gitignore 规则误忽略 `src/modules/log/`（模块未入库）
- `DictItemItem` typo、`utils.load2dict` 不存在等潜在 bug
- 应用工厂循环导入（factory 独立为模块）

### 破坏性变更

- **API 前缀**：所有接口由 `/xxx` 变更为 `/api/v1/xxx`，前端需同步（见 USAGE.md）
- **服务层签名**：服务函数不再直接读取 `request`，由 router 层取参包 R

---

## [v2.8.0] - 2026-07

原版本（重构前）。见 `document/版本更新说明.txt`。