MTKJPAY/mt-pay/README.md

# MT Pay - 支付系统

面向东南亚地区的电商支付系统，支持PayPal支付、商品管理、订单管理、货币转换等功能。

## 快速开始

### 1. 数据库配置

执行数据库脚本（按顺序）：
```sql
source database/customer_order_schema.sql;
source database/customer_order_currency_update.sql;
source database/customer_order_address_optimized.sql;
```

### 2. 配置文件

编辑 `src/main/resources/application-dev.yml`：
- 数据库连接信息
- PayPal API凭证（Client ID、Client Secret）
- 百度翻译配置（App ID、Security Key）
- 阿里云OSS配置

### 3. 启动项目

```bash
mvn spring-boot:run
```

### 4. 访问地址

- 后端API: http://localhost:8082/api
- Druid监控: http://localhost:8082/druid
- 前端地址: http://localhost:3000

## 核心API

### 商品管理
- `POST /api/product` - 创建商品
- `GET /api/product/{id}` - 获取商品详情
- `GET /api/product/link/{linkCode}` - 通过链接码获取商品
- `POST /api/product/query` - 查询商品列表（分页）
- `PUT /api/product/{id}/off-shelf` - 下架商品

### 订单管理
- `POST /api/order` - 创建客户订单
- `GET /api/order/{orderNo}` - 获取订单详情
- `POST /api/order/query` - 查询订单列表（分页）

### PayPal支付
- `POST /api/paypal/orders` - 创建PayPal订单
- `POST /api/paypal/orders/{orderId}/capture` - 捕获支付
- `POST /api/paypal/webhook` - Webhook回调

### ERP用户
- `POST /api/erp/user/register` - 用户注册
- `POST /api/erp/user/login` - 用户登录
- `GET /api/erp/user/info` - 获取用户信息

## 技术栈

- Spring Boot 4.0.0
- MyBatis-Plus
- MySQL 5.7+
- Vue 3 + Element Plus

## 相关文档

- `PAYPAL_WEBHOOK_SETUP.md` - PayPal Webhook配置
- `ERP_USER_API.md` - ERP用户API文档