API Request Flow

GraphQL Request Flow

Client request
   -> /graphql (Express + Apollo middleware)
      -> context creation (auth, loaders, helpers)
         -> resolver execution
            -> models/helpers/external services
               -> GraphQL response

Subscription Flow (WebSockets)

Client subscription
   -> WebSocket /graphql
      -> token extraction/auth
         -> pubsub/listener wiring
            -> live event payload back to client

Webhook Flow

External provider (Stripe/Jira)
   -> /stripe or /jira endpoint
      -> dedicated webhook handler
         -> internal side-effects (DB updates, cleanup, notifications)

Notes for Non-Technical Stakeholders

• GraphQL is the contract between frontend and backend.
• Webhooks let external systems trigger backend behavior automatically.
• WebSocket subscriptions support live updates (for example, chat events).