soroush.asadi
ec51e87d2d
A generic multi-client payment gateway so FlatRender, meezi.ir and bargevasat.ir can all pay through ZarinPal's single verified callback domain (pay.flatrender.ir). New Go service services/payment (clones the notification skeleton + vendored deps): - migration 31_payment_broker.sql — `payment` schema: client_apps, transactions, webhook_deliveries. - ZarinPal v4 client ported from the proven identity PaymentService (request.json -> StartPay -> verify.json; codes 100/101). - client API: POST /v1/pay/request + /v1/pay/inquiry, authed by X-Api-Key + HMAC body signature; GET /callback/zarinpal (the single verified endpoint) verifies, then 302s the user back to the site's return_url (signed) and fires a signed, retried webhook. - per-client ZarinPal merchant override (default = shared merchant); amount stored canonically in Rial, unit to ZarinPal env-configurable. - admin API /v1/admin/* (FlatRender admin JWT): client-app CRUD + key issue/rotate + transactions list. Deploy wiring: payment-svc in docker-compose.v2.yml (host port 1607), pay.flatrender.ir server block in mirror-nginx conf, ENV_FILE + README updates (cert SAN + manual migration note). Admin UI: src/components/admin/PaymentsAdmin.tsx (client apps with one-time key reveal + rotate, transactions table) + /admin/payments page + nav link + fa/en strings; pay-admin proxy route to payment-svc. Docs/SDK: deploy/PAYMENTS.md (integration contract) + deploy/sdk/flatpay.js (zero-dep Node client + webhook verifier) for meezi/any site. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
FlatRender
AI-powered video and image creation platform. Create professional videos and images with templates, a drag-and-drop studio, and one-click export.
Products
- Video Maker — timeline editor, Konva canvas, scene browser, transitions, audio, nexrender export
- Image Editor — Konva canvas, filters, crop, background removal, layer system
- Video Trimmer — ffmpeg.wasm in-browser trim + crop + export
- Templates — browsable marketplace with category sidebar
Quick Start
npm install
cp .env.example .env.local # fill in your credentials
npm run dev # http://localhost:3000
Related Repos
| Repo | Path | Purpose |
|---|---|---|
| flatrender | D:\Projects\flatrender |
This repo — Next.js app |
| flatrender-admin | D:\Projects\flatrender-admin\admin-api |
.NET 10 Admin API |
| flatrender-admin | D:\Projects\flatrender-admin\admin-ui |
React Admin SPA |
Stack
- Next.js 15 App Router · TypeScript · Tailwind CSS · shadcn/ui
- Supabase — auth, database, storage
- Stripe — subscription payments
- React-Konva — canvas editor (video + image)
- next-intl — Persian (default) + English i18n
- ffmpeg.wasm — browser-side video trimming
- nexrender — server-side After Effects rendering
Environment Variables
See .env.example for the full list. Minimum required to run:
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
Without Supabase the app runs in mock mode (studio uses localStorage).
Database Migrations
Run in order in Supabase SQL Editor:
supabase/migrations/001_profiles.sqlsupabase/migrations/002_render_jobs.sqlsupabase/migrations/003_projects.sql
Admin Panel
The admin panel at D:\Projects\flatrender-admin manages templates, categories, and media. When ADMIN_API_URL=http://localhost:5000 is set, the Next.js app fetches live data from it. Without it, hardcoded fallback data is used.
See CLAUDE.md for full development guide.