# 数据库建表SQL说明

## 文件说明

- `schema.sql` - 完整的数据库建表SQL脚本

## 表结构说明

### 1. payment_order（支付订单表）

**表说明**：存储支付订单的完整信息

**主要字段**：
- `id` - 主键ID（自增）
- `merchant_transaction_id` - 商户订单号（唯一索引）
- `transaction_id` - PingPong交易流水号
- `amount` - 交易金额（DECIMAL(12,2)）
- `currency` - 交易币种（3位ISO 4217代码）
- `payment_type` - 交易类型（SALE/AUTH）
- `status` - 订单状态（PENDING/SUCCESS/FAILED/REVIEW/CANCELLED）
- `token` - PingPong返回的token
- `payment_url` - 支付收银台地址
- `create_time` - 创建时间（自动填充）
- `update_time` - 更新时间（自动更新）

**索引**：
- 主键：`id`
- 唯一索引：`merchant_transaction_id`
- 普通索引：`transaction_id`、`status`、`create_time`

### 2. payment_record（支付记录表）

**表说明**：记录所有支付相关操作（回调、查询等）

**主要字段**：
- `id` - 主键ID（自增）
- `transaction_id` - PingPong交易流水号
- `merchant_transaction_id` - 商户订单号
- `record_type` - 记录类型（CHECKOUT/CALLBACK/QUERY/REFUND/CAPTURE/VOID）
- `status` - 交易状态
- `code` - 响应码
- `description` - 响应描述
- `request_data` - 原始请求数据（JSON，TEXT类型）
- `response_data` - 原始响应数据（JSON，TEXT类型）
- `create_time` - 创建时间（自动填充）

**索引**：
- 主键：`id`
- 普通索引：`transaction_id`、`merchant_transaction_id`、`record_type`、`create_time`

## 执行方式

### 方式1：直接执行SQL文件

```bash
mysql -u用户名 -p密码 数据库名 < schema.sql
```

### 方式2：在MySQL客户端中执行

```sql
-- 1. 连接到MySQL
mysql -u用户名 -p密码

-- 2. 选择数据库
USE mtpay;

-- 3. 执行SQL文件
SOURCE /path/to/schema.sql;
```

### 方式3：使用IDE工具

1. 打开数据库管理工具（如Navicat、DBeaver、DataGrip等）
2. 连接到数据库
3. 打开 `schema.sql` 文件
4. 执行SQL脚本

## 注意事项

1. **字符集**：使用 `utf8mb4` 字符集，支持emoji和特殊字符
2. **排序规则**：使用 `utf8mb4_unicode_ci` 排序规则
3. **存储引擎**：使用 `InnoDB` 存储引擎，支持事务和外键
4. **时间字段**：使用 `DATETIME` 类型，支持自动填充和更新
5. **金额字段**：使用 `DECIMAL(12,2)` 类型，精确到分
6. **唯一约束**：`merchant_transaction_id` 必须全局唯一

## 字段长度说明

- `merchant_transaction_id`：64字符（根据PingPong文档）
- `transaction_id`：64字符（根据PingPong文档）
- `token`：255字符（根据PingPong文档）
- `payment_url`：500字符（URL可能较长）
- `remark`：500字符（备注信息）
- `description`：500字符（响应描述）
- `request_data`/`response_data`：TEXT类型（JSON数据可能很长）

## 索引优化建议

1. **查询优化**：根据实际查询场景添加复合索引
2. **时间范围查询**：`create_time` 索引有助于时间范围查询
3. **状态查询**：`status` 索引有助于按状态筛选订单
4. **关联查询**：`transaction_id` 和 `merchant_transaction_id` 索引有助于关联查询

## 数据备份建议

1. 定期备份数据库
2. 重要操作前先备份
3. 使用 `mysqldump` 命令备份：

```bash
mysqldump -u用户名 -p密码 数据库名 > backup_$(date +%Y%m%d).sql
```

## 版本更新

如果后续需要修改表结构，建议：

1. 创建迁移SQL文件（如：`migration_v1.1.sql`）
2. 使用 `ALTER TABLE` 语句修改
3. 记录版本变更日志