# 变更记录 - @go/db

## [1.0.11] - 2026-05-13
- **基础设施对齐**:
    - 移除 `encoding/json` 原生依赖，全面切换至 `apigo.cc/go/cast.UnmarshalJSON` 以增强类型兼容性。
    - 移除测试代码中对 `os.Remove` 的直接调用，统一切换至 `apigo.cc/go/file.Remove` 以支持隔离文件系统。
- **稳定性增强**:
    - 验证并更新了测试用例，确保在 Go 1.25.0 环境下的执行稳定性。
    - 更新 `TEST.md` 性能基准，反映基础设施对齐后的最新指标。

## [1.0.10] - 2026-05-10
- **功能增强**:
    - 全面支持“复杂标识符”：改进了 `LIKE` 拦截逻辑中的正则表达式，支持带引号（`` ` ``, `"`, `'`, `[]`）和特殊字符（如 `-`）的表名与字段名。
    - 优化 `cleanIdentifier`：能够更精准地剥离多段式标识符（如 `table.column`）中的包装引号。
    - 增强 `getFTSMatchSQLParts` 和 `extractTableName`：确保在各种引用风格下均能正确定位影子列和源表。
- **基础设施对齐**:
    - 升级 `apigo.cc/go/log` 至 `v1.3.2`。
- **测试增强**:
    - 新增 `TestComplexIdentifierFTS` 验证复杂标识符下的全文检索重定向。
    - 修复并增强 `TestAutonomousFTS` 以支持多种引用风格的兼容性测试。

## [1.3.0] - 2026-05-12
- **基础设施对齐**: 
    - 官方发布 v1.3.0 对齐版本。

## [1.0.11] - 2026-05-11
- **基础设施对齐**: 
    - 最终基础设施对齐。

## [1.0.10] - 2026-05-10
- **基础设施对齐**: 
    - 升级 `apigo.cc/go/redis` 至 `v1.0.8`。
    - 验证了 `redis.NewIDMaker` API 变更后的集成稳定性。
    - 增强了 ID 生成器的集成测试，覆盖了 Redis 路径。

## [1.0.9] - 2026-05-09
- **基础设施对齐**: 
    - 升级 `apigo.cc/go/log` 至 `v1.1.13`。
    - 为 `DBInfoLog` 和 `DBErrorLog` 实现 `Reset()` 方法，以遵循 `log` 的强制 Reset 契约。
    - 调整 `DBLog` 内的字段 `pos` 索引，从 `6` 开始紧凑排列，消除索引空洞。
- **测试增强**: 
    - 修复多个测试用例 (`TestSmartDelete`, `TestGenericQuery`, `TestTableProbing`, `TestVersionControl`) 中因使用 `sqlite://:memory:` DSN 导致的初始化失败问题。
    - 引入 `test_util.go` 和 `ResetAllForTest()`，确保测试间的全局状态隔离。

## [1.0.6] - 2026-05-05
### 优化
- **日志体系重构**: 
  - 引入 `DBInfoLog` 和 `DBErrorLog` 类型化日志，分别继承 `log.InfoLog` 和 `log.ErrorLog`。
  - 利用 `log` 包的新特性实现“零手动”调用栈捕获，业务端仅需关注错误信息和 SQL 现场。
  - 进一步解耦业务字段与日志元数据。
### 优化
- **日志自主化**: 
  - 将数据库日志逻辑从 `log` 包迁移至 `db` 包，实现日志格式与业务逻辑的深度绑定。
  - 自定义 `DBLog` 结构，利用 `log.GetEntry[DBLog]()` 对象池加速，并支持完整的错误堆栈捕获。
  - 接入 `log.Log` 的自动填充能力，精简元数据维护逻辑。

## [1.0.4] - 2026-05-04
### 优化
- **日志增强**：升级 `apigo.cc/go/log` 至 v1.0.1，并重构数据库日志逻辑，利用新版 `log.DB` API 直接支持错误字段和调用栈捕获，提升排障效率。

## [1.0.3] - 2026-05-04
### 新增
- **自动随机 ID (Auto Random ID)**：当表主键或唯一索引字段类型为 `char(8/10/12/14)` 且值为空时，自动填充分布式唯一 ID。
- **智能 ID 生成器**：自动适配数据库类型（MySQL 右旋散列、PostgreSQL 时间单调、SQLite 纯随机），优先使用 Redis 分布式生成器。

## [1.0.2] - 2026-05-04
### 修复
- **PostgreSQL 增强**：补全了 `getTable` 中的元数据探测逻辑，使 `autoVersion` 和影子删除在 PostgreSQL 下可自动启用。
- **错误处理一致性**：统一了 `QueryResult` 与 `ExecResult` 的错误传播逻辑，确保 `r.Error` 在数据处理阶段也能正确记录。
- **单元测试修复**：修正了 `DB_test.go` 中因 SQLite 时区差异导致的 `TestInsertReplaceUpdateDelete` 偶发失败。

### 优化
- **性能提升**：在 `Base.go` 中引入了 `sync.Map` 缓存结构体反射解析结果，减少 SQL 生成过程中的反射开销。

## [1.0.1] - 2026-05-03
### 新增
- **架构 DSL (Schema-as-Code)**：支持通过文本 DSL 定义并自动同步数据库结构。
- **影子删除 (Shadow Deletion)**：支持 `SD` 标记，使用 `db.Remove` 自动将删除数据移动到 `_deleted` 后缀的备份表中。
- **乐观锁与版本控制**：支持 `db.Update` 自动处理版本递增与冲突检测。
- **泛型支持**：新增 `db.ToSlice[T]` 和 `db.To[T]`，提供类型安全的查询结果映射。
- **PostgreSQL 支持**：初步支持 PostgreSQL 的架构同步逻辑。
- **AI 友好文档**：新增 `db.SchemaMarkdown()` 自动生成 Markdown 格式的数据库模型文档。

### 优化
- 重构了 `makeResults` 逻辑，预计算 Struct 字段映射，显著提升大数据集下的查询性能。
- 完善了 SQLite 的 `DATETIME` 与 Go `time.Time` 的自动转换逻辑。
- 所有的文档和注释已本地化为中文。

### 修复
- 修复了 `Tx` 结构体中的拼写错误 `isCommitedOrRollbacked` 为 `isCommittedOrRollbacked`。
- 统一了全模块的参数命名规范：`requestSql` -> `query`，`wheres` -> `conditions`。