TorbatYar/docs/reference/provider-reference.md
Mortezakoohjani 12c8615615 Ship enterprise Accounting FE/API with CRUD parity and production wiring.
Adds accounting-service PATCH/archive, fiscal helpers, COA templates and setup status, plus SuperApp Accounting UI (DS, scoreboard, masters, vouchers, ledger, ops modules) with session refresh and HTTPS public API URLs.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-24 15:26:43 +03:30

1.3 KiB

Provider Reference

Operational detail for registered providers. Registry index: provider-registry.md.

Payamak

  • Purpose: SMS OTP for Core and Identity (Identity calls Core OTP client).
  • Config: PAYAMAK_*, OTP_EXPIRE_SECONDS, pattern/body id for OTP template.
  • Failure modes: provider downtime, invalid credentials, rate limits — OTP endpoints must fail safely without leaking existence details beyond product policy.
  • Tests: test_otp_auth and related flows.

Keycloak

  • Purpose: Central IdP.
  • Realm: superapp
  • Theme: torbatyar (infrastructure/keycloak/themes/torbatyar)
  • Clients: superapp-frontend, core-service, identity-access-service
  • Public URL: KEYCLOAK_PUBLIC_URL (prod: https://auth.torbatyar.ir)

Let's Encrypt / Certbot

  • Purpose: TLS for platform and tenant hosts.
  • Automation: infrastructure/nginx/provision_ssl.py via Celery SSH.
  • See: ssl.md

Planned Providers

See registry entries for S3, Payment Gateway, AI models. Fill this file when a provider becomes Active.