Skip to main content

Developer Portal Service — Application Logic

Version: 1.0 Status: Draft Owner: Product + Developer Relations (DevRel) Last Updated: 2026-04-20

1. Intent​

Describe the use cases, commands, queries, ports, and orchestration flows that compose the Developer Portal Service. Each use case is one application-layer entry point; orchestration crosses ports to auth-service, sms-orchestrator, channel-router-service, analytics-service, and billing-service.

2. Use Cases​

  • CreateApiKey — TBD
  • RevokeApiKey — TBD
  • RequestProductionApiKey (with owner-approval workflow) — TBD
  • RenderDocsPage — TBD
  • GenerateCodeSnippet — TBD
  • StartVerification — TBD
  • CheckVerification — TBD
  • AdvanceChannelFallback — TBD
  • PublishSdkRelease — TBD
  • QueryConsumption — TBD

3. Commands​

  • TBD

4. Queries​

  • TBD

5. Outbound Ports​

  • AuthServicePort — TBD
  • SmsOrchestratorPort — TBD
  • ChannelRouterPort — TBD
  • AnalyticsPort — TBD
  • BillingPort — TBD
  • ObjectStoragePort — TBD

6. Orchestration Flows​

  • TBD (Verify start → dispatch → check → fallback)
  • TBD (Production-key request → owner approval → key issuance)

7. Saga & Compensations​

  • TBD

8. Error Handling​

  • TBD