77 lines
3.0 KiB
Markdown
77 lines
3.0 KiB
Markdown
# 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
|
||
|
||
```text
|
||
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
|
||
|
||
无。
|