# CHANGELOG.md

所有重要的变更都会记录在此文件中。

## [v2.0.2] - 2026-02-12

### 🐛 Bug 修复
- ✅ 修复容器启动时找不到模板文件导致崩溃的问题
- ✅ 修复 Dockerfile 缺少 `templates/` 和 `static/` 目录复制

### 📦 Docker 改进
- ✅ 完善多阶段构建，正确复制运行时所需文件
- ✅ 新增 `docker-compose.production.yml` 生产环境配置
- ✅ 预编译镜像推送到 Docker Hub (ouaone/sms-receiver-go:v2.0.2)
- ✅ 验证容器可正常启动并通过健康检查

### 📂 目录结构重构
- ✅ 新增 `docs/legacy/` 目录，归档废弃文档
- ✅ 新增 `scripts/` 目录，存放管理脚本和测试脚本
- ✅ 新增 `build/` 目录，用于构建输出
- ✅ 移动 `sms-receiver-go-ctl.sh` 到 `scripts/`
- ✅ 移动 `test_api.sh` 到 `scripts/`
- ✅ 移动 `GO_REFACTOR_PROGRESS.md` 到 `docs/legacy/`
- ✅ 移动 `OPTIMIZATION_REPORT.md` 到 `docs/legacy/`

### 🔧 Git 仓库清理
- ✅ 从仓库中移除二进制文件（sms-receiver*, sms_*.db, *.log）
- ✅ 从仓库中移除配置文件 `config.yaml`
- ✅ 更新 `.gitignore` 忽略运行时生成文件
- ✅ 从仓库中移除 Python 版本目录 `sms-receiver/`

### 📚 文档
- ✅ 更新 `README.md` 版本标签从 v2.0.0 到 v2.0.2
- ✅ 更新 `README.md` 镜像拉取说明
- ✅ 新增 `CHANGELOG.md` 独立变更日志文件
- ✅ 添加 Docker Hub 镜像标签说明

### 🔧 兼容性
- ✅ 与 v2.0.1 功能完全兼容
- ✅ 数据库无需迁移
- ✅ 配置文件格式无变更
- ✅ 更新管理脚本路径（`scripts/sms-receiver-go-ctl.sh`）

---

## [v2.0.1] - 2026-02-08

### 🐛 Bug 修复
- ✅ 修复登录会话创建失败问题（`securecookie: the value is not valid`）
- ✅ 回退密钥处理逻辑确保向后兼容性
- ✅ 改进会话初始化错误处理

### 🔧 兼容性
- ✅ 与 v2.0.0 Cookie 完全兼容，无需清除
- ✅ 支持 `/api/v1/*` 和 `/api/*` 路由
- ✅ 密钥长度不足时仅记录警告

---

## [v2.0.0] - 2026-02-08

### 🔴 高优先级 (6项)
- ✅ 数据库事务支持 (确保消息和日志一致性)
- ✅ SQL 注入修复 (参数化查询)
- ✅ 配置验证启动时自动检查
- ✅ 会话密钥强化 (长度验证)
- ✅ 签名验证增强 (详细记录验证过程)
- ✅ 密码哈希支持 (bcrypt)

### 🟡 中优先级 (15项)
- ✅ 连接池配置 (MaxOpenConns, MaxIdleConns)
- ✅ 查询优化 (范围查询, 索引)
- ✅ 健康检查增强 (/health 端点)
- ✅ API 版本控制 (/api/v1/*)
- ✅ 认证中间件 (RequireAuth, RequireAPIAuth)
- ✅ 定时任务优化 (robfig/cron)
- ✅ 配置文件示例 (config.example.yaml)
- ✅ 常量定义 (config/constants.go)
- ✅ 开发文档 (DEVELOPMENT.md)

### 🟢 低优先级 (9项)
- ✅ Docker 支持 (Dockerfile, docker-compose.yml)
- ✅ Makefile 构建脚本
- ✅ 优化报告 (OPTIMIZATION_REPORT.md)
- ✅ 密码哈希工具 (tools/password_hash.go)
- ✅ 单元测试架构准备

### 📦 文件变更
- 新增文件: 14 个
- 代码行数: +1523 / -101

---

## [v1.0.0] - 2026-02-08

### 🎉 初始版本发布
- ✅ 完整功能实现
- ✅ 对齐 Python 版本所有核心特性
- ✅ 独立数据库 (sms_receiver_go.db)
- ✅ 完整的 API 接口 (POST /api/receive, GET /api/messages, GET /api/statistics)
- ✅ Web 管理界面 (短信列表、详情、统计、日志)
- ✅ 签名验证 (HMAC-SHA256)
- ✅ 时区转换 (Asia/Shanghai)