Event-Crypt

flowchart LR
    subgraph Clients
      WEB["Web Browser<br/>Voting/Ticketing"]
      USSDGW["USSD Gateway/Telco"]
      ADMIN["Admin/Super Admin<br/>Filament UI"]
    end

    subgraph App["Laravel Monolith"]
      ROUTES["Routes + Middleware"]
      CTRL["Controllers"]
      SVC["Domain Services<br/>Hubtel, Voting, Receipt, Notifications"]
      JOBS["Queue Jobs + Scheduler"]
      MODELS["Eloquent Models + Scopes"]
      CACHE["Cache Store"]
    end

    subgraph Data
      DB["PostgreSQL / SQLite"]
    end

    subgraph External
      HUBTEL["Hubtel APIs<br/>Checkout / Status / Send Money"]
      PAYSTACK["Paystack APIs<br/>Legacy/parallel support"]
      SMS["SMS Providers<br/>Hubtel/Arkesel"]
      CLOUD["Cloudinary"]
      CI["GitHub Actions CI"]
    end

    WEB --> ROUTES
    ADMIN --> ROUTES
    USSDGW --> ROUTES
    ROUTES --> CTRL --> SVC --> MODELS --> DB
    CTRL --> CACHE
    SVC --> CACHE
    SVC --> HUBTEL
    SVC --> PAYSTACK
    SVC --> SMS
    SVC --> CLOUD
    JOBS --> SVC
    JOBS --> DB
    JOBS --> HUBTEL
    CI --> App

sequenceDiagram
    participant U as Voter (Web)
    participant FE as Vue + Inertia
    participant BE as Laravel Controllers/Services
    participant HP as Hubtel Checkout
    participant WH as Hubtel Webhook
    participant JOB as Verification Jobs
    participant DB as Database

    U->>FE: Select nominee/category + quantity
    FE->>BE: Submit vote checkout request
    BE->>DB: Create pending payment
    BE->>HP: Initialize checkout
    HP-->>U: Checkout URL / redirect
    U->>HP: Complete payment
    HP->>WH: Payment callback
    WH->>BE: Process webhook payload
    BE->>DB: Mark payment successful
    BE->>DB: Create votes + increment nominee totals
    Note over JOB,BE: Fallback verification runs if webhook delayed/missed

sequenceDiagram
    participant T as Telco/USSD Gateway
    participant UC as UssdController
    participant C as Cache
    participant HS as HubtelService
    participant DB as Database

    T->>UC: /api/ussd (new session)
    UC->>C: Create ussd_state_<sessionID>
    T->>UC: User code/category/quantity/confirm inputs
    UC->>C: Update session state per level
    UC->>DB: Create pending payment
    UC->>HS: Charge mobile money
    HS-->>UC: Prompt/PIN/OTP status
    UC-->>T: Continue/end session response