Implementation Plan: Payment Flow Rules & Verification

Branch: main | Date: 2026-02-03 | Spec: docs/seed_verification.md Input: 统一支付流程规则，完善前后端联调与验证路径。

Summary

明确支付流程的接口契约与前端交互（创建订单→支付→状态查询），补齐规则并制定验证步骤，确保页面交互与数据库状态一致。

Technical Context

Language/Version: Go 1.22, Vue 3 (Vite) Primary Dependencies: Fiber, Vite, existing /orders//pay//status APIs Storage: PostgreSQL Testing: 页面自动化（MCP）+ 手动校验 Target Platform: local/staging Project Type: Web application Performance Goals: N/A Constraints: 不改生成文件；遵循 backend/llm.txt Scale/Scope: 支付流程规范与验证

Constitution Check

仅文档/规则梳理，若后续改代码需遵守生成文件不可直改规则。

Project Structure

docs/
├── plan.md                  # 本计划
├── seed_verification.md     # 页面→操作→数据验证清单
└── plans/                   # 归档目录
frontend/portal/src/views/order/   # Checkout/Payment
backend/app/http/v1/transaction.go # orders/pay/status/webhook

Structure Decision: 在现有前后端目录内完善支付契约说明与测试步骤，不新增结构。

Plan Phases

Phase 1: 规则梳理

明确 /orders 创建所需字段与返回字段（价格、content_title、status、id）。
明确 /orders/:id/pay 入参与预期状态变更；/orders/:id/status 响应格式。

Phase 2: 前后端对齐点

若后端缺字段/逻辑，提出对齐要求；前端 Checkout/Payment 显示金额、商品名、状态并可发起 pay/模拟成功。

Phase 3: 验证与记录

执行创建→支付→状态流；校验页面与 DB (orders, order_items, content_access) 一致；记录缺口（若 pay 未实现则记为待补）。

Tasks

T001 梳理 /orders 创建与返回字段（content_id, price_amount, id/status）
T002 梳理 /orders/:id/pay 入参与成功/失败状态定义
T003 梳理 /orders/:id/status 响应字段（status, amount_paid/original, content_title）
T010 前端显示与调用对齐（Checkout 显示金额/标题，Payment 调用 pay+轮询）
T020 验证创建→支付→状态→订单详情链路；记录 DB 状态变化
T030 汇总缺口（如 pay 未实现、字段缺失），更新 docs/seed_verification.md

Dependencies

Phase 1 → Phase 2 → Phase 3

Acceptance Criteria

支付接口契约（字段/状态）明确并记录。
前端 Checkout/Payment 能显示金额/商品名并调用 pay+轮询；若后端未实现，缺口已记录。
手动/自动化验证创建→支付→状态→订单详情链路，DB 状态与页面一致。

Risks

后端 pay/status 未实现或字段缺失导致无法完成闭环（需记录缺口）。

Complexity Tracking

无。

3.0 KiB Raw Blame History Unescape Escape