4451b32a33
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>
47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
# 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.0–14.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
|
||
|
||
```bash
|
||
cd frontend
|
||
npm run validate:payment
|
||
npm run typecheck
|
||
```
|
||
|
||
## References
|
||
|
||
- [payment-frontend-architecture.md](../../frontend/docs/payment-frontend-architecture.md)
|
||
- [payment-frontend-validation-report.md](../../frontend/docs/payment-frontend-validation-report.md)
|
||
- [service-snapshots/payment-frontend.yaml](../service-snapshots/payment-frontend.yaml)
|
||
- [service-snapshots/payment.yaml](../service-snapshots/payment.yaml)
|