hfb_sys/docs/order-payment-implementation-plan.md

订单支付确认改造 —— 实施计划

状态：待执行 日期：2026-05-24

目标

将当前"下单即锁定"的流程改造为：

下单 → 待支付(pending_payment) → 支付确认 → 冻结锁定 → 待交接(pending_handoff)

同时清理 price_hourly、price_daily、price_weekly、rent_start_at、rent_end_at、rent_hours 等时租残留字段。

---

改造清单（按依赖顺序）

第1层（无依赖，可并行）
├── A. 合并 3 个 SQL 迁移文件 → 1 个 000001_init.sql
│      修改 rental_listings：price + in_transaction
│      修改 rental_orders：rented_at + estimated_duration_hours
│      修改 notifications：category/link_type/link_id/extra_data
│      新增 sms_logs 表
│      同步改 scripts/dev.sh
│
├── B. Go 模型改造
│      model/listing.go → Price + InTransaction
│      model/order.go → RentedAt + EstimatedDurationHours
│      model/notification.go → Category/LinkType/LinkID/ExtraData
│
第2层（依赖第1层）
├── C. Listing 模块清理
│      listing/dto.go → ListingDTO + CreateRequest 适配
│      listing/repository.go → Create/Update/listQuery/toDTO 全部替换
│      listing/service.go → 校验适配
│
├── D. Order DTO 改造
│      order/dto.go → 删 RentStartAt/RentEndAt/RentHours，加 RentedAt/EstimatedDurationHours
│
第3层（依赖第2层）
├── E. Order 核心改造
│      order/service.go → 删 internalOrderHours，加错误，加 Pay()
│      order/repository.go → Create() → pending_payment + in_transaction
│      order/repository.go → 新增 Pay()：余额→扣款→冻结→锁定→通知
│      order/repository.go → Cancel() 适配 pending_payment
│      order/handler.go → 新增 Pay handler
│      路由注册 → POST /orders/:id/pay
│
├── F. 钱包充值
│      wallet/repository.go → Recharge()
│      wallet/service.go → Recharge()
│      wallet/handler.go → Recharge handler
│      路由注册 → POST /wallet/recharge
│
第4层（依赖第3层 E）
└── G. 超时扫描
      job.go → 新增 handlePendingPaymentTimeout（15min 超时取消）
      system_configs → order.pending_payment_timeout_minutes: 15

---

API 变更

API	类型	说明
POST /api/orders	行为变更	返回 pending_payment，不锁商品，标记 in_transaction
POST /api/orders/{id}/pay	新增	校验余额→扣款→冻结→锁定→通知
POST /api/orders/{id}/cancel	行为变更	允许取消 pending_payment
POST /api/wallet/recharge	新增	开发环境充值

---

涉及文件

修改（17 个）

backend/migrations/000001_init.sql
scripts/dev.sh
backend/internal/model/listing.go
backend/internal/model/order.go
backend/internal/model/notification.go
backend/internal/modules/listing/dto.go
backend/internal/modules/listing/repository.go
backend/internal/modules/listing/service.go
backend/internal/modules/order/dto.go
backend/internal/modules/order/service.go
backend/internal/modules/order/repository.go
backend/internal/modules/order/handler.go
backend/internal/modules/wallet/repository.go
backend/internal/modules/wallet/service.go
backend/internal/modules/wallet/handler.go
backend/internal/router/router.go（或同等路由文件）
backend/internal/jobs/ordertimeout/job.go
backend/internal/modules/systemconfig/defaults.go（或同等文件）

删除（2 个）

backend/migrations/000002_order_checkouts.sql
backend/migrations/000003_add_indexes.sql