feat(config): 初始化项目配置文件
- 添加 application.yml 主配置文件，配置 Spring、Druid、MyBatis-Plus 等基础设置 - 添加 application-dev.yml 开发环境配置，配置数据源及 PingPong 沙箱参数 - 添加数据库建表及配置说明文档（README.md、README_DATABASE.md、README_PRODUCT.md） - 添加商品表结构定义及示例数据说明 - 添加支付相关枚举类 RecordType 和充值信息 DTO RechargeDTO - 添加日志文件 mt-pay.2025-12-19.log 用于记录系统启动异常信息
This commit is contained in:
122
mt-pay/database/README.md
Normal file
122
mt-pay/database/README.md
Normal file
@@ -0,0 +1,122 @@
|
||||
# 数据库建表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. 记录版本变更日志
|
||||
|
||||
67
mt-pay/database/README_DATABASE.md
Normal file
67
mt-pay/database/README_DATABASE.md
Normal file
@@ -0,0 +1,67 @@
|
||||
# 数据库配置说明
|
||||
|
||||
## 数据库信息
|
||||
|
||||
- **数据库名称**：`mtpay`
|
||||
- **字符集**：`utf8mb4`
|
||||
- **排序规则**：`utf8mb4_general_ci`
|
||||
|
||||
## 数据库表
|
||||
|
||||
### 支付相关表
|
||||
|
||||
1. **payment_order** - 支付订单表
|
||||
2. **payment_record** - 支付记录表
|
||||
|
||||
### 商品相关表
|
||||
|
||||
1. **mt_product** - 商品表
|
||||
2. **mt_product_sku** - 商品SKU表
|
||||
|
||||
## 执行建表SQL
|
||||
|
||||
### 方式1：执行所有SQL文件
|
||||
|
||||
```bash
|
||||
# 在MySQL中执行
|
||||
mysql -u用户名 -p密码 mtpay < mt_product_schema.sql
|
||||
```
|
||||
|
||||
### 方式2：在MySQL客户端中执行
|
||||
|
||||
```sql
|
||||
-- 1. 连接到MySQL
|
||||
mysql -u用户名 -p密码
|
||||
|
||||
-- 2. 选择数据库
|
||||
USE mtpay;
|
||||
|
||||
-- 3. 执行SQL文件
|
||||
SOURCE /path/to/mt_product_schema.sql;
|
||||
```
|
||||
|
||||
### 方式3：使用IDE工具
|
||||
|
||||
1. 打开数据库管理工具（如Navicat、DBeaver、DataGrip等）
|
||||
2. 连接到数据库服务器
|
||||
3. 选择 `mtpay` 数据库
|
||||
4. 打开 `mt_product_schema.sql` 文件
|
||||
5. 执行SQL脚本
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **执行顺序**：先执行 `mt_product_schema.sql` 创建商品表
|
||||
2. **外键约束**：`mt_product_sku` 表有外键关联 `mt_product` 表，删除商品时会级联删除SKU
|
||||
3. **字符集**：所有表使用 `utf8mb4` 字符集，支持emoji和特殊字符
|
||||
4. **索引**：已创建必要的索引，提高查询性能
|
||||
|
||||
## 表结构概览
|
||||
|
||||
```
|
||||
mtpay
|
||||
├── payment_order (支付订单表)
|
||||
├── payment_record (支付记录表)
|
||||
├── mt_product (商品表)
|
||||
└── mt_product_sku (商品SKU表)
|
||||
```
|
||||
|
||||
139
mt-pay/database/README_PRODUCT.md
Normal file
139
mt-pay/database/README_PRODUCT.md
Normal file
@@ -0,0 +1,139 @@
|
||||
# 商品表结构说明
|
||||
|
||||
## 表名规范
|
||||
|
||||
所有表名使用 `mt_` 前缀，如：
|
||||
- `mt_product` - 商品表
|
||||
- `mt_product_sku` - 商品SKU表
|
||||
|
||||
## 表结构
|
||||
|
||||
### 1. mt_product（商品表）
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段名 | 类型 | 说明 | 备注 |
|
||||
|--------|------|------|------|
|
||||
| id | BIGINT | 商品ID | 主键，自增 |
|
||||
| name | VARCHAR(255) | 商品名称 | 必填 |
|
||||
| price | DECIMAL(12,2) | 商品价格 | 基础价格，默认0.00 |
|
||||
| main_image | VARCHAR(4000) | 主图URL | 可选 |
|
||||
| status | VARCHAR(20) | 商品状态 | ACTIVE-上架，INACTIVE-下架，DELETED-已删除 |
|
||||
| shop_id | BIGINT | 店铺ID | 必填，关联店铺 |
|
||||
| create_time | DATETIME | 创建时间 | 自动填充 |
|
||||
| update_time | DATETIME | 更新时间 | 自动更新 |
|
||||
|
||||
**索引：**
|
||||
- 主键：`id`
|
||||
- 普通索引：`shop_id`、`status`、`create_time`
|
||||
|
||||
**排序规则：**
|
||||
- 使用 `utf8mb4_general_ci` 排序规则
|
||||
|
||||
### 2. mt_product_sku（商品SKU表）
|
||||
|
||||
**字段说明：**
|
||||
|
||||
| 字段名 | 类型 | 说明 | 备注 |
|
||||
|--------|------|------|------|
|
||||
| id | BIGINT | SKU ID | 主键，自增 |
|
||||
| product_id | BIGINT | 商品ID | 外键，关联mt_product |
|
||||
| sku | VARCHAR(2000) | SKU编码 | 必填 |
|
||||
| price | DECIMAL(12,2) | 价格 | 必填 |
|
||||
| currency | VARCHAR(3) | 货币 | ISO 4217代码，默认USD |
|
||||
| stock | INT | 库存数量 | 默认0 |
|
||||
| sales_attrs | LONGTEXT | 销售属性 | JSON格式，如：[{"name":"颜色","value":"红色"}] |
|
||||
| sku_image | VARCHAR(4000) | SKU图片URL | 可选 |
|
||||
| weight | DECIMAL(10,2) | 重量 | 单位：克 |
|
||||
| size | VARCHAR(200) | 大小/尺寸 | JSON格式，如：{"length":10,"width":5,"height":3} |
|
||||
| specification | VARCHAR(2000) | 规格 | 文本描述 |
|
||||
| status | VARCHAR(20) | SKU状态 | ACTIVE-启用，INACTIVE-禁用 |
|
||||
| create_time | DATETIME | 创建时间 | 自动填充 |
|
||||
| update_time | DATETIME | 更新时间 | 自动更新 |
|
||||
|
||||
**索引：**
|
||||
- 主键：`id`
|
||||
- 普通索引：`product_id`、`status`
|
||||
- 外键：`product_id` → `mt_product.id`（级联删除）
|
||||
|
||||
## 数据示例
|
||||
|
||||
### 商品示例
|
||||
|
||||
```sql
|
||||
INSERT INTO `mt_product` (`name`, `price`, `main_image`, `status`, `shop_id`)
|
||||
VALUES ('Macaron 马卡龙礼盒装', 20.00, 'https://example.com/image.jpg', 'ACTIVE', 1);
|
||||
```
|
||||
|
||||
### SKU示例
|
||||
|
||||
```sql
|
||||
-- SKU 1：粉色6枚装
|
||||
INSERT INTO `mt_product_sku` (
|
||||
`product_id`, `sku`, `price`, `currency`, `stock`,
|
||||
`sales_attrs`, `sku_image`, `weight`, `size`, `specification`, `status`
|
||||
) VALUES (
|
||||
1, 'SKU001', 18.00, 'USD', 50,
|
||||
'[{"name":"颜色","value":"粉色"},{"name":"规格","value":"6枚装"}]',
|
||||
'https://example.com/pink-6pcs.jpg', 500.00,
|
||||
'{"length":20,"width":15,"height":5}',
|
||||
'6枚装马卡龙礼盒', 'ACTIVE'
|
||||
);
|
||||
|
||||
-- SKU 2：蓝色12枚装
|
||||
INSERT INTO `mt_product_sku` (
|
||||
`product_id`, `sku`, `price`, `currency`, `stock`,
|
||||
`sales_attrs`, `sku_image`, `weight`, `size`, `specification`, `status`
|
||||
) VALUES (
|
||||
1, 'SKU002', 20.00, 'USD', 100,
|
||||
'[{"name":"颜色","value":"蓝色"},{"name":"规格","value":"12枚装"}]',
|
||||
'https://example.com/blue-12pcs.jpg', 800.00,
|
||||
'{"length":25,"width":20,"height":8}',
|
||||
'12枚装马卡龙礼盒', 'ACTIVE'
|
||||
);
|
||||
```
|
||||
|
||||
## JSON字段格式说明
|
||||
|
||||
### sales_attrs（销售属性）
|
||||
|
||||
```json
|
||||
[
|
||||
{"name": "颜色", "value": "粉色"},
|
||||
{"name": "规格", "value": "6枚装"}
|
||||
]
|
||||
```
|
||||
|
||||
### size（尺寸）
|
||||
|
||||
```json
|
||||
{
|
||||
"length": 20,
|
||||
"width": 15,
|
||||
"height": 5,
|
||||
"unit": "cm"
|
||||
}
|
||||
```
|
||||
|
||||
## 执行SQL
|
||||
|
||||
```bash
|
||||
# 在MySQL中执行
|
||||
mysql -u用户名 -p密码 数据库名 < mt_product_schema.sql
|
||||
```
|
||||
|
||||
或在MySQL客户端中：
|
||||
|
||||
```sql
|
||||
SOURCE /path/to/mt_product_schema.sql;
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **字符集**：使用 `utf8mb4` 字符集，支持emoji和特殊字符
|
||||
2. **排序规则**：使用 `utf8mb4_unicode_ci`
|
||||
3. **存储引擎**：使用 `InnoDB`，支持事务和外键
|
||||
4. **外键约束**：删除商品时会级联删除所有SKU
|
||||
5. **SKU字段**：`sku` 字段最大2000字符，不再设置唯一索引（可根据业务需求决定是否唯一）
|
||||
6. **JSON字段**：`sales_attrs` 和 `size` 字段存储JSON格式数据，需要应用层进行解析
|
||||
|
||||
Reference in New Issue
Block a user