Initial commit

jy_pay/README.md

@@ -0,0 +1,74 @@
+# jy_pay 支付模块
+
+基于 **微信支付 APIv3** 的 Native 支付能力与支付日志记录。
+
+## 功能
+
+- **微信 Native 预下单**：生成 `code_url`，供前台生成二维码，用户扫码支付。
+- **支付结果回调**：验签、解密并更新支付日志；可在此扩展订单状态等业务逻辑。
+- **支付日志表** `jy_pay_log`：记录每笔预下单与支付结果，便于对账与排查。
+
+## 依赖与接入
+
+- 根工程 `pom.xml` 已加入模块：`<module>jy_pay</module>`，并在 `dependencyManagement` 中声明 `jy_pay`。
+- 主应用（如 `back`）在 `pom.xml` 中增加对 `jy_pay` 的依赖后，会通过 `@MapperScan("com.ruoyi.**.mapper")` 与 `classpath*:mapper/**/*Mapper.xml` 自动扫描本模块的 Mapper 与 XML。
+
+## 数据库
+
+执行项目根目录下 `sql/jy_pay.sql`，创建表 `jy_pay_log`（与主库同库即可）。
+
+## 配置
+
+在 `application-xxx.yml` 中增加微信支付配置（可参考 `jy_pay/src/main/resources/application-jypay.yml`）：
+
+```yaml
+wechat:
+  pay:
+    enabled: true
+    merchant-id: "你的商户号"
+    private-key-path: "/绝对路径/apiclient_key.pem"
+    merchant-serial-number: "商户API证书序列号"
+    api-v3-key: "32字节APIv3密钥"
+    app-id: "公众号/开放平台appid"
+    notify-url: "https://你的域名/pay/api/wechat/native/notify"
+```
+
+`notify-url` 需在微信商户平台配置，且公网可访问。未配置或 `enabled: false` 时，仅不创建微信 Config，不影响启动。
+
+## 接口说明
+
+| 说明       | 方法 | 路径                               |
+|------------|------|------------------------------------|
+| Native 预下单 | POST | `/pay/api/wechat/native/prepay`    |
+| 微信支付回调 | POST | `/pay/api/wechat/native/notify`    |
+
+### 预下单请求参数
+
+- `outTradeNo`（必填）：商户订单号，唯一。
+- `description`（必填）：商品描述。
+- `totalFen`（必填）：金额，单位：分。
+- `bizType`（可选）：业务类型，默认 `ORDER`。
+- `bizId`（可选）：业务主键，如订单 ID，默认与 `outTradeNo` 一致。
+
+### 预下单响应
+
+- 成功：`{"codeUrl":"weixin://wxpay/...", "payLogId": 1}`，前台用 `codeUrl` 生成二维码。
+- 失败：`{"errorCode":"xxx", "errorMsg":"xxx"}`。
+
+## 支付日志状态
+
+- `0`：待支付（预下单成功）
+- `1`：已支付
+- `2`：已关闭
+- `3`：已退款
+- `4`：失败
+
+## 与订单联动
+
+- 支付日志：回调中会调用 `payLogService.updateToPaid(...)` 更新 `jy_pay_log`。
+- 订单表 `shop_order`：当预下单时 `bizType=ORDER` 且 `outTradeNo` 为订单的 `order_number` 时，回调中会调用 jy-shop 的 `IOrderService`，将对应订单更新为已支付：
+  - `status = 1`（待发货）
+  - `is_payed = 1`
+  - `pay_time`、`update_time` 为当前时间  
+  仅当订单当前为待付款（`status=0`）时才会更新，避免重复回调导致错误。
+- jy_pay 已依赖 jy-shop，主应用需同时引入 jy-shop 与 jy_pay，订单回写才会生效。