TorbatYar/docs/provider-registry.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

120 lines
3.6 KiB
Markdown

# Provider Registry
Inventory of external providers. Template: [provider-template.md](templates/provider-template.md). Detail sheets: [provider-reference.md](reference/provider-reference.md).
---
## Payamak (پاینامک / Payamak-Panel)
| Field | Value |
| --- | --- |
| Provider Name | Payamak |
| Country | IR |
| Capabilities | SMS OTP send |
| Version | API as configured via env |
| Dependencies | Network egress to Payamak API |
| Supported Modules | Core (OTP), Identity (via Core OTP client) |
| Configuration | `PAYAMAK_USERNAME`, `PAYAMAK_PASSWORD`/`API_KEY`, `PAYAMAK_FROM`, `PAYAMAK_BODY_ID` / pattern |
| API | Provider HTTP SendOtp |
| Status | Active |
| Documentation | [provider-reference.md](reference/provider-reference.md#payamak) |
| Tests | Covered indirectly via OTP auth tests |
---
## Keycloak
| Field | Value |
| --- | --- |
| Provider Name | Keycloak |
| Country | N/A (self-hosted) |
| Capabilities | OIDC IdP, realm users/roles, themed login |
| Version | As deployed in compose/production |
| Dependencies | Postgres (Keycloak DB), HTTPS public URL |
| Supported Modules | Identity & Access, Frontend SSO, all JWT-validating services |
| Configuration | `KEYCLOAK_*`, realm `superapp`, theme `torbatyar` |
| API | OIDC + Admin API |
| Status | Active |
| Documentation | [identity-architecture.md](architecture/identity-architecture.md) |
| Tests | Identity service tests + manual SSO flows |
---
## Let's Encrypt / Certbot
| Field | Value |
| --- | --- |
| Provider Name | Let's Encrypt |
| Country | N/A |
| Capabilities | Public TLS certificates |
| Version | Certbot on edge host |
| Dependencies | Port 80 ACME, DNS pointing to edge |
| Supported Modules | Edge / all public hosts, tenant SSL expansion |
| Configuration | Nginx + `provision_ssl.py` + `SSL_PROVISION_*` |
| API | ACME |
| Status | Active |
| Documentation | [ssl.md](deployment/ssl.md) |
| Tests | Operational verification scripts |
---
## S3-Compatible Object Storage (planned)
| Field | Value |
| --- | --- |
| Provider Name | S3-Compatible |
| Country | N/A |
| Capabilities | Object upload/download, tenant-scoped buckets/prefixes |
| Version | TBD |
| Dependencies | File Storage module |
| Supported Modules | file_storage, website_builder, ecommerce media |
| Configuration | Endpoint, keys, bucket (TBD) |
| API | S3 API |
| Status | Planned |
| Documentation | [phases/Future](phases/Future/README.md) |
| Tests | TBD |
---
## Payment Gateway (planned)
| Field | Value |
| --- | --- |
| Provider Name | TBD (Iranian PSP) |
| Country | IR |
| Capabilities | Checkout, refunds, webhooks |
| Version | TBD |
| Dependencies | Subscription billing, ecommerce/restaurant payments |
| Supported Modules | Core subscriptions, ecommerce, restaurant |
| Configuration | TBD |
| API | TBD |
| Status | Planned |
| Documentation | [roadmap.md](roadmap.md) |
| Tests | TBD |
---
## AI Model Provider (planned)
| Field | Value |
| --- | --- |
| Provider Name | TBD |
| Country | TBD |
| Capabilities | Chat/completion, embeddings |
| Version | TBD |
| Dependencies | ai_assistant module |
| Supported Modules | ai_assistant, live_chat assist |
| Configuration | API keys, model ids |
| API | Provider SDK/HTTP |
| Status | Planned |
| Documentation | [ai-architecture.md](architecture/ai-architecture.md) |
| Tests | TBD |
---
## Related Documents
- [Integration Architecture](architecture/integration-architecture.md)
- [Provider Reference](reference/provider-reference.md)
- [Module Registry](module-registry.md)