12c8615615
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>
34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
# Provider Reference
|
|
|
|
Operational detail for registered providers. Registry index: [provider-registry.md](../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](../deployment/ssl.md)
|
|
|
|
## Planned Providers
|
|
|
|
See registry entries for S3, Payment Gateway, AI models. Fill this file when a provider becomes Active.
|
|
|
|
## Related Documents
|
|
|
|
- [Integration Architecture](../architecture/integration-architecture.md)
|
|
- [Provider Template](../templates/provider-template.md)
|