主题
支付(预留模块)
PAY-00 | Maven
pmforge-module-pay| 状态 ⏸ 预留(已纳入构建,未接入运行时)
支付渠道与应用、支付订单、退款、钱包与余额流水。代码在库、已通过编译验证(未接入运行时);channel 客户端按支付宝 / 微信 / 银联等实现分派。
1. 模块概览
| 项 | 值 |
|---|---|
| Maven 模块 | pmforge-module-pay |
| 控制器 | 19 |
| 接口 | 60 |
| 唯一权限点 | 22 |
| 数据对象(DO) | 14 |
| 已拆功能点 | 10 项 |
| 需求原件 | 04-01-应用管理 |
2. 能力清单
| 能力 | 优先级 | 状态 |
|---|---|---|
| 应用信息管理 | P0 | ⏸ 预留 |
| 支付渠道配置 | P0 | ⏸ 预留 |
| 支付订单 | P0 | ⏸ 预留 |
| 退款订单 | P0 | ⏸ 预留 |
| 钱包开通 | P1 | ⏸ 预留 |
| 钱包余额 | P1 | ⏸ 预留 |
| 钱包流水 | P1 | ⏸ 预留 |
| 支付示例 | P2 | ⏸ 预留 |
| 退款示例 | P2 | ⏸ 预留 |
| 钱包示例 | P2 | ⏸ 预留 |
共 10 项,与能力地图的统计口径一致;状态为「预留」:代码在库、已通过编译验证,尚未接入 server 运行时。
3. 控制器与接口
| Controller | 路径前缀 | 接口 | 权限点 | 代码位置 |
|---|---|---|---|---|
| PayAppController | /pay/app | 7 | 5 | modules/pay/src/main/java/com/pmforge/module/pay/controller/admin/app/PayAppController.java#L40 |
| PayChannelController | /pay/channel | 6 | 4 | modules/pay/src/main/java/com/pmforge/module/pay/controller/admin/channel/PayChannelController.java#L34 |
| PayDemoOrderController | /pay/demo-order | 5 | 0 | modules/pay/src/main/java/com/pmforge/module/pay/controller/admin/demo/PayDemoOrderController.java#L36 |
| PayNotifyController | /pay/notify | 5 | 1 | modules/pay/src/main/java/com/pmforge/module/pay/controller/admin/notify/PayNotifyController.java#L63 |
| PayOrderController | /pay/order | 5 | 2 | modules/pay/src/main/java/com/pmforge/module/pay/controller/admin/order/PayOrderController.java#L59 |
| PayWalletRechargePackageController | /pay/wallet-recharge-package | 5 | 4 | modules/pay/src/main/java/com/pmforge/module/pay/controller/admin/wallet/PayWalletRechargePackageController.java#L34 |
| PayDemoWithdrawController | /pay/demo-withdraw | 4 | 0 | modules/pay/src/main/java/com/pmforge/module/pay/controller/admin/demo/PayDemoWithdrawController.java#L34 |
| PayRefundController | /pay/refund | 3 | 2 | modules/pay/src/main/java/com/pmforge/module/pay/controller/admin/refund/PayRefundController.java#L46 |
| PayTransferController | /pay/transfer | 3 | 2 | modules/pay/src/main/java/com/pmforge/module/pay/controller/admin/transfer/PayTransferController.java#L45 |
| PayWalletController | /pay/wallet | 3 | 2 | modules/pay/src/main/java/com/pmforge/module/pay/controller/admin/wallet/PayWalletController.java#L38 |
| PayWalletRechargeController | /pay/wallet-recharge | 3 | 0 | modules/pay/src/main/java/com/pmforge/module/pay/controller/admin/wallet/PayWalletRechargeController.java#L31 |
| AppPayOrderController | /pay/order | 2 | 0 | modules/pay/src/main/java/com/pmforge/module/pay/controller/app/order/AppPayOrderController.java#L47 |
| … | 其余 7 个 | 见接口索引 |
4. 数据对象
| 表 | DO | 字段数 |
|---|---|---|
pay_app | PayAppDO | 0 |
pay_channel | PayClientConfigTypeHandler | 0 |
pay_demo_order | PayDemoOrderDO | 0 |
pay_demo_withdraw | PayDemoWithdrawDO | 0 |
pay_notify_log | PayNotifyLogDO | 0 |
pay_notify_task | PayNotifyTaskDO | 0 |
pay_order | PayOrderDO | 0 |
pay_order_extension | PayOrderExtensionDO | 0 |
pay_refund | PayRefundDO | 0 |
pay_transfer | PayTransferDO | 0 |
pay_wallet | PayWalletDO | 0 |
pay_wallet_recharge | PayWalletRechargeDO | 0 |
pay_wallet_recharge_package | PayWalletRechargePackageDO | 0 |
pay_wallet_transaction | PayWalletTransactionDO | 0 |
主库脚本
sql/mysql/pmforge.sql只覆盖 system 与 infra,本模块的表结构以 DO 为准;启用前需自备 DDL(部分模块有测试脚本src/test/resources/sql/create_tables.sql)。
5. 启用前提
依赖:mall 的 trade 子模块依赖它;member 与之无编译期依赖,可并行启用。
- 根 pom 取消
pmforge-module-pay注释 - server 加依赖
- 导入
modules/pay/src/test/resources/sql/create_tables.sql - 配置支付渠道密钥(
pmforge.pay.*),示例值不可直接用于生产 - 补菜单与权限点(
pay:*)
6. 风险与注意
- 支付回调需要公网可达地址,本地联调要配内网穿透(
application-dev.yaml里原有示例已清理) - 渠道证书、密钥属敏感配置,不要提交进仓库
7. 关联
- 相关页面:MOD-RSV-00
- 相关页面:PAT-03
- 模块手册:/modules/reserved/
- 接口索引:/code/api/pay