TorbatYar/docs/phase-handover/phase-payment-frontend.md
Mortezakoohjani 4451b32a33 feat(payment-frontend): ship Torbat Pay admin portal for MVP 14.0-14.5
Add payment module, BFF proxy, hub/dashboard/ops/PSP/merchant screens wired to real APIs, and mark payment-frontend complete in project status.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-27 18:35:07 +03:30

1.7 KiB
Raw Blame History

Phase Handover — Payment Frontend (payment-frontend)

Completed: 2026-07-27
Service: Torbat Pay — Enterprise Payment Platform
Backend version at handover: 0.14.5.0 (phases 14.014.5)

Summary

Full MVP admin portal for Torbat Pay delivered under frontend/modules/payment/ and frontend/app/payment/**. Persian labels, real API wiring via BFF to port 8012, recharts on dashboard/KPIs.

Deliverables

  • 26 feature modules under modules/payment/features/
  • Thin Next.js app routes with loading/error boundaries
  • BFF app/api/payment/[...path]/route.ts (Idempotency-Key forwarded)
  • scripts/validate-payment-routes.mjs + npm run validate:payment
  • Apps catalog entry: Torbat Pay → /payment/hub
  • Docker env: NEXT_PUBLIC_PAYMENT_API_URL, PAYMENT_SERVICE_URL
  • Snapshots/docs: payment-frontend.yaml, architecture + validation reports

Checkout session mapping

PaymentRequest detail page (/payment/requests/[id]) is the checkout session view — cancel, verify, redirect URL display.

Stop boundary

Do not implement 14.6+ UI (refunds, splits, subscriptions) until backend phases complete.

Next backend phase

payment-14.6 Refunds & Reversals — frontend remains list/read for MVP until explicitly scoped.

Verification

cd frontend
npm run validate:payment
npm run typecheck

References