Platform documentation

Access level: your own organization only. Sign in at /auth; every new organization starts on a 3-day Pro trial.

1. Create your organization on first sign-in — name, sport focus and logo. This becomes your tenant; all teams, players and tournaments live inside it.
2. Go to Dashboard → New tournament. Pick a sport, format (league, knockout or hybrid), dates and venue. Templates pre-fill sensible defaults.
3. Open the tournament → Teams tab. Add teams manually, or open registrations so captains submit themselves for your approval.
4. Players tab: add squads one by one, or bulk import from CSV (columns: full_name, jersey_number, position).
5. Fixtures tab: click Generate fixtures. Edit venue and kick-off times inline; drag matches to reschedule.
6. On match day open the live console: update the score, and standings plus public pages refresh in real time for fans.
7. Media tab: upload gallery photos, add sponsors with tiers, and issue certificates in bulk — each carries a QR code that verifies at /c/<code>.
8. Websites: generate a public tournament microsite with live team, match, venue and prize-pool counts, then share the link.
9. Posters: generate branded match and result posters. Trial accounts get 2 free; more are available as an add-on.
10. Billing: upgrade before the trial ends to keep tournaments published. Invoices with GST are downloadable from the Billing page.

Screens to bookmark: /dashboard, /tournaments, /websites, /posters, /billing.

Access level: cross-tenant read plus support actions. Roles: support_exec and finance_manager, assigned by a platform administrator.

1. Support inbox: /support lists every ticket across tenants with status and priority. Reply in-thread; internal notes stay hidden from the customer.
2. Contact messages and demo requests arrive in Admin → Settings; move each through new → in progress → closed so nothing is dropped.
3. Finance: /admin/revenue shows MRR, plan mix and invoice history. Use /admin/usage to confirm AI add-on consumption before issuing credits.
4. Never edit subscription status by hand — billing state is written only by the verified Razorpay webhook. Raise a platform-admin request instead.
5. For account recovery, verify identity against the registered phone number before any change.

Access level: full platform. Roles: super_admin and platform_admin. Landing screen is /admin.

1. Organizations: /admin/organizations — create tenants on behalf of a customer, inspect usage and suspend abusive tenants.
2. Users: /admin/users — invite staff, assign platform roles, and reset access.
3. Plans & add-ons: /admin/plans and /admin/addons — edit pricing, quotas and feature limits; changes apply to new checkouts immediately.
4. Payments: Admin → Settings → Payment gateway. Store the Razorpay Key ID, Key Secret and Webhook Secret (encrypted at rest), pick test or live mode, and set the GST percentage.
5. AI providers: Admin → Settings — set the preferred provider and store fallback Gemini / OpenAI keys. Use Rotate to clear a compromised key instantly.
6. Content: /admin/blogs — review and approve tenant blog posts before they go public.
7. Quotas: /admin/quotas — per-feature monthly limits and rate limits per organization.
8. Security: sign-in throttling, honeypot bot traps and audit logs are always on; review audit trails before any destructive action.

A seeded demo tenant is available for rehearsing the full organizer flow without touching live data. Use it only in Test payment mode.

• Organizer login: demo.organizer@kheloonline.in / DemoOrg@2026
• Tenant: Yunite Demo Sports Club (slug yunite-demo-sports-club)
• Tournament: KheloOnline Demo Cup 2026 — cricket, 4 teams, 12 players, a full round-robin fixture list with some results already entered.

Suggested test pass: sign in → open the demo tournament → add a team → regenerate fixtures → score a live match → check the public microsite and standings update → generate a poster → issue a certificate and verify its QR code at /c/<code> → run a test-mode checkout.

Credentials are never published on this page. Platform administrators receive their sign-in details privately, and every account is expected to use a unique password plus a verified phone number. Staff accounts are created by a platform administrator from /admin/users — self-signup never grants platform access.

For end-to-end testing, use a dedicated test organization on a test-mode payment configuration so no real money moves. Switch Admin → Settings → Payment gateway to Test mode before running a checkout rehearsal.

Raise a ticket from /support inside the app, or email support@kheloonline.in. Include your organization name and the tournament link so we can reproduce quickly.