From 3a2c4dff64b10c729ac0818458875a06818e72c7 Mon Sep 17 00:00:00 2001
From: Rogee <rogee@ipao.vip>
Date: Tue, 3 Feb 2026 13:27:48 +0800
Subject: [PATCH] chore: add payment flow verification plan

---
 docs/plan.md | 71 ++++++++++++++++++++++++----------------------------
 1 file changed, 33 insertions(+), 38 deletions(-)

diff --git a/docs/plan.md b/docs/plan.md
index dab81c1..25a74e3 100644
--- a/docs/plan.md
+++ b/docs/plan.md
@@ -1,65 +1,61 @@
-# Implementation Plan: Execute UI Testing Checklist
+# Implementation Plan: Payment Flow Rules & Verification
 
 **Branch**: `main` | **Date**: 2026-02-03 | **Spec**: `docs/seed_verification.md`
-**Input**: 按 `docs/seed_verification.md` 的页面→操作→数据验证清单执行与核对。
-
-**Note**: 本计划遵循 `docs/templates/plan-template.md`。
+**Input**: 统一支付流程规则，完善前后端联调与验证路径。
 
 ## Summary
 
-依据 `docs/seed_verification.md` 的页面级检查表，系统性执行 Portal 与 Superadmin 的功能/数据验证，记录结果及缺口（支付流半成品、通知广播未落库等），并确认数据库与页面数据一致性。
+明确支付流程的接口契约与前端交互（创建订单→支付→状态查询），补齐规则并制定验证步骤，确保页面交互与数据库状态一致。
 
 ## Technical Context
 
-**Language/Version**: Vue 3 (Vite), Go 1.22, Chrome DevTools MCP
-**Primary Dependencies**: Vite dev servers, seeded PostgreSQL data
+**Language/Version**: Go 1.22, Vue 3 (Vite)
+**Primary Dependencies**: Fiber, Vite, existing `/orders`/`/pay`/`/status` APIs
 **Storage**: PostgreSQL
-**Testing**: 页面自动化（MCP）+ 目测数据校验
+**Testing**: 页面自动化（MCP）+ 手动校验
 **Target Platform**: local/staging
 **Project Type**: Web application
 **Performance Goals**: N/A
-**Constraints**: 不改生成文件；遵循 `AGENTS.md` 规划要求
-**Scale/Scope**: UI 功能验证与数据一致性检查
+**Constraints**: 不改生成文件；遵循 `backend/llm.txt`
+**Scale/Scope**: 支付流程规范与验证
 
 ## Constitution Check
 
-- 遵循 `backend/llm.txt`（无代码改动）。
-- 仅执行/记录测试，不修改生成文件。
+- 仅文档/规则梳理，若后续改代码需遵守生成文件不可直改规则。
 
 ## Project Structure
 
 ```text
 docs/
-├── plan.md              # 当前计划
-├── seed_verification.md # 测试清单（页面→操作→数据验证）
-└── plans/               # 归档目录
+├── 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: Portal 测试执行
-- 登录、首页/详情、订单/订单详情、已购、收藏/点赞、优惠券、钱包、通知、创作者入口。
+### Phase 1: 规则梳理
+- 明确 `/orders` 创建所需字段与返回字段（价格、content_title、status、id）。
+- 明确 `/orders/:id/pay` 入参与预期状态变更；`/orders/:id/status` 响应格式。
 
-### Phase 2: Superadmin 测试执行
-- 登录、Dashboard/Users/Tenants/Orders/Finance/Reports/Health/Contents/Assets/System Configs/Audit Logs、通知模板。
+### Phase 2: 前后端对齐点
+- 若后端缺字段/逻辑，提出对齐要求；前端 Checkout/Payment 显示金额、商品名、状态并可发起 pay/模拟成功。
 
-### Phase 3: 结果汇总与缺口记录
-- 汇总通过/失败项，更新缺口（支付流、通知广播、上传链路）。
+### Phase 3: 验证与记录
+- 执行创建→支付→状态流；校验页面与 DB (`orders`, `order_items`, `content_access`) 一致；记录缺口（若 pay 未实现则记为待补）。
 
 ## Tasks
 
-**Format**: `[ID] [P?] [Story] Description`
-
-### Phase 1 (Portal)
-- [x] T001 [US0] 执行 Portal 测试清单（登录、主页、详情）
-- [x] T002 [US0] 执行 Portal 订单/库/收藏/点赞/优惠券/钱包/通知/创作者检查
-
-### Phase 2 (Superadmin)
-- [x] T010 [US1] 执行 Superadmin 清单（Users/Tenants/Orders/Finance/Reports/Health/Contents/Assets 等）
-- [x] T011 [US1] 验证通知模板编辑、系统配置、审计日志
-
-### Phase 3 (Summary)
-- [x] T020 [US2] 汇总结果与缺口（支付流半成品、通知广播未落库、上传未测）
+- [ ] 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
 
@@ -67,14 +63,13 @@ docs/
 
 ## Acceptance Criteria
 
-- `docs/seed_verification.md` 中的页面/操作/数据验证项均执行并记录结果。
-- 已知缺口明确列出（支付流、广播通知、上传链路）。
-- 计划归档到 `docs/plans/<date>.md` 并清空 `docs/plan.md`。
+- 支付接口契约（字段/状态）明确并记录。
+- 前端 Checkout/Payment 能显示金额/商品名并调用 pay+轮询；若后端未实现，缺口已记录。
+- 手动/自动化验证创建→支付→状态→订单详情链路，DB 状态与页面一致。
 
 ## Risks
 
-- 部分功能未实现（支付流、通知广播），导致验证失败。
-- 环境/端口变更需调整脚本。
+- 后端 pay/status 未实现或字段缺失导致无法完成闭环（需记录缺口）。
 
 ## Complexity Tracking