# GORM Logging

## Purpose

定义 GORM 日志适配器规范，将 GORM 日志桥接到 zap，实现数据库操作日志统一格式和请求追踪。

## Requirements

### Requirement: GORM 日志适配器

系统 SHALL 提供 GORM 日志适配器，桥接到 zap。

#### Scenario: 适配器实现

- **WHEN** 初始化数据库连接
- **THEN** SHALL 使用 `logger.NewGormLogger(zapLogger)` 作为 GORM logger
- **THEN** 适配器 SHALL 实现 `gorm.logger.Interface` 接口

#### Scenario: 日志级别映射

- **WHEN** GORM 记录日志
- **THEN** GORM Silent SHALL 映射到不输出
- **THEN** GORM Error SHALL 映射到 `zap.ErrorLevel`
- **THEN** GORM Warn SHALL 映射到 `zap.WarnLevel`
- **THEN** GORM Info SHALL 映射到 `zap.DebugLevel`

#### Scenario: SQL 查询日志

- **WHEN** GORM 执行 SQL 查询
- **THEN** SHALL 使用 zap Debug 级别记录
- **THEN** SHALL 包含 SQL 语句
- **THEN** SHALL 包含执行耗时
- **THEN** SHALL 包含影响行数（如有）

### Requirement: Request ID 关联

GORM 日志 SHALL 支持 request_id 关联。

#### Scenario: 从 Context 提取 request_id

- **WHEN** GORM 记录日志
- **THEN** SHALL 从 `context.Context` 提取 request_id
- **THEN** 日志 SHALL 包含 request_id 字段

#### Scenario: Context 传播

- **WHEN** 使用 GORM 进行数据库操作
- **THEN** SHALL 使用 `db.WithContext(ctx)` 传递 context
- **THEN** GORM 日志 SHALL 自动包含 request_id

### Requirement: 模块标识

GORM 日志 SHALL 包含模块标识。

#### Scenario: 数据库模块标识

- **WHEN** GORM 记录日志
- **THEN** SHALL 包含 `logger: database` 标识
- **THEN** Console 格式 SHALL 输出为 `[database]`

### Requirement: 单行输出

GORM 日志 SHALL 单行输出。

#### Scenario: SQL 单行输出

- **WHEN** 记录 SQL 查询日志
- **THEN** SHALL 单行输出
- **THEN** SQL 语句中的换行 SHALL 替换为空格（除非保留原始格式）

#### Scenario: 错误日志单行

- **WHEN** 记录数据库错误日志
- **THEN** SHALL 单行输出
- **THEN** 错误详情 SHALL 作为字段值

### Requirement: 日志字段标准化

GORM 日志 SHALL 使用标准化字段。

#### Scenario: SQL 日志字段

- **WHEN** 记录 SQL 查询
- **THEN** SHALL 使用 `sql` 字段记录 SQL 语句
- **THEN** SHALL 使用 `rows_affected` 字段记录影响行数
- **THEN** SHALL 使用 `latency` 字段记录执行耗时

#### Scenario: 错误日志字段

- **WHEN** 记录数据库错误
- **THEN** SHALL 使用 `zap.Error(err)` 记录错误
- **THEN** SHALL NOT 使用 `zap.String("error", err.Error())`