# akshatshrivastava0104/eventflow architecture

> Architecture diagram of the GitHub repository akshatshrivastava0104/eventflow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/akshatshrivastava0104/eventflow
- Repository: https://github.com/akshatshrivastava0104/eventflow

## Overview

EventFlow is an event-management platform with a React client and Go API. Attendees browse events, register, check out, and access confirmations, tickets, and notifications; organization owners manage events, attendees, staff, and reporting, while staff scan tickets and administrators view platform analytics. The client routes users to these workflows and centralizes API calls and authentication. The backend tree shows corresponding domain areas plus notification and outbox workers. The README is empty, and sampled backend wiring is limited, so backend interactions are not asserted as verified call paths.

Main entry points: [`Backend/internal/router/router.go`](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Backend/internal/router/router.go) (API routing), [`Frontend/src/App.tsx`](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/App.tsx) (Route application), [`Frontend/src/lib/queries.ts`](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/lib/queries.ts) (Query services), [`Frontend/src/lib/api.ts`](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/lib/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Route application<br/>[App.tsx]"]
  node_auth["Session and roles<br/>[AuthContext.tsx]"]
  node_clientapi["API client<br/>[api.ts]"]
  node_queries["Query services<br/>[queries.ts]"]
end

subgraph group_attendee["Attendee workflows"]
  node_discovery["Event discovery"]
  node_registration["Registration and checkout"]
  node_confirmation["Confirmation and tickets"]
  node_useraccount["User account"]
end

subgraph group_operations["Organization operations"]
  node_owner_events["Event management<br/>[EventEditor.tsx]"]
  node_owner_ops["Owner operations"]
  node_staff_ops["Staff operations"]
  node_analytics["Analytics<br/>[Analytics.tsx]"]
end

subgraph group_backend["API domains"]
  node_api_routes["API routing<br/>[router.go]"]
  node_auth_service["Authentication"]
  node_event_service["Events"]
  node_registration_service["Registrations"]
  node_ticket_service["Tickets"]
  node_checkin_service["Check-in"]
  node_waitlist_service["Waitlist"]
  node_organization_service["Organizations and staff"]
  node_notification_service["Notifications"]
  node_stats_service["Statistics"]
  node_outbox["Notification outbox"]
  node_database[("PostgreSQL<br/>[postgresql.go]")]
end

node_visitor(("Visitor or user"))

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_discovery
node_app -->|"routes to"| node_registration
node_app -->|"routes to"| node_confirmation
node_app -->|"routes to"| node_owner_events
node_app -->|"routes to"| node_owner_ops
node_app -->|"routes to"| node_staff_ops
node_app -.->|"routes to"| node_analytics
node_app -->|"provides context"| node_auth
node_auth -->|"requests identity"| node_clientapi
node_queries -->|"makes requests"| node_clientapi
node_owner_events -->|"uses event queries"| node_queries
node_discovery -->|"uses event queries"| node_queries
node_confirmation -->|"uses registration queries"| node_queries
node_clientapi -.->|"HTTP API"| node_api_routes
node_api_routes -.-> node_auth_service
node_api_routes -.-> node_event_service
node_api_routes -.-> node_registration_service
node_api_routes -.-> node_ticket_service
node_api_routes -.-> node_checkin_service
node_api_routes -.-> node_waitlist_service
node_api_routes -.-> node_organization_service
node_api_routes -.-> node_notification_service
node_api_routes -.-> node_stats_service

click node_app "https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/App.tsx"
click node_auth "https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/contexts/AuthContext.tsx"
click node_clientapi "https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/lib/api.ts"
click node_queries "https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/lib/queries.ts"
click node_discovery "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Frontend/src/pages/public"
click node_registration "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Frontend/src/pages/user"
click node_confirmation "https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/pages/user/RegistrationSuccess.tsx"
click node_useraccount "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Frontend/src/pages/user"
click node_owner_events "https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/pages/owner/EventEditor.tsx"
click node_owner_ops "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Frontend/src/pages/owner"
click node_staff_ops "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Frontend/src/pages/staff"
click node_analytics "https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/pages/admin/Analytics.tsx"
click node_api_routes "https://github.com/akshatshrivastava0104/eventflow/blob/tester/Backend/internal/router/router.go"
click node_auth_service "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/auth"
click node_event_service "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/event"
click node_registration_service "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/registration"
click node_ticket_service "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/ticket"
click node_checkin_service "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/check-in"
click node_waitlist_service "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/waitlist"
click node_organization_service "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/organization"
click node_notification_service "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/notification"
click node_stats_service "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/stats"
click node_outbox "https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/outbox"
click node_database "https://github.com/akshatshrivastava0104/eventflow/blob/tester/Backend/internal/database/postgresql.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth,node_clientapi,node_queries,node_visitor toneBlue
class node_discovery,node_registration,node_confirmation,node_useraccount toneAmber
class node_owner_events,node_owner_ops,node_staff_ops,node_analytics toneMint
class node_api_routes,node_auth_service,node_event_service,node_registration_service,node_ticket_service,node_checkin_service,node_waitlist_service,node_organization_service,node_notification_service,node_stats_service,node_outbox,node_database toneRose
```

## Components

### Web client

- [Route application](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/App.tsx): `Frontend/src/App.tsx`
- [Session and roles](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/contexts/AuthContext.tsx): `Frontend/src/contexts/AuthContext.tsx`
- [API client](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/lib/api.ts): `Frontend/src/lib/api.ts`
- [Query services](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/lib/queries.ts): `Frontend/src/lib/queries.ts`

### Attendee workflows

- [Event discovery](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Frontend/src/pages/public): `Frontend/src/pages/public`
- [Registration and checkout](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Frontend/src/pages/user): `Frontend/src/pages/user`
- [Confirmation and tickets](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/pages/user/RegistrationSuccess.tsx): `Frontend/src/pages/user/RegistrationSuccess.tsx`
- [User account](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Frontend/src/pages/user): `Frontend/src/pages/user`

### Organization operations

- [Event management](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/pages/owner/EventEditor.tsx): `Frontend/src/pages/owner/EventEditor.tsx`
- [Owner operations](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Frontend/src/pages/owner): `Frontend/src/pages/owner`
- [Staff operations](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Frontend/src/pages/staff): `Frontend/src/pages/staff`
- [Analytics](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Frontend/src/pages/admin/Analytics.tsx): `Frontend/src/pages/admin/Analytics.tsx`

### API domains

- [API routing](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Backend/internal/router/router.go): `Backend/internal/router/router.go`
- [Authentication](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/auth): `Backend/internal/auth`
- [Events](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/event): `Backend/internal/event`
- [Registrations](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/registration): `Backend/internal/registration`
- [Tickets](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/ticket): `Backend/internal/ticket`
- [Check-in](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/check-in): `Backend/internal/check-in`
- [Waitlist](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/waitlist): `Backend/internal/waitlist`
- [Organizations and staff](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/organization): `Backend/internal/organization`
- [Notifications](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/notification): `Backend/internal/notification`
- [Statistics](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/stats): `Backend/internal/stats`
- [Notification outbox](https://github.com/akshatshrivastava0104/eventflow/tree/tester/Backend/internal/outbox): `Backend/internal/outbox`
- [PostgreSQL](https://github.com/akshatshrivastava0104/eventflow/blob/tester/Backend/internal/database/postgresql.go): `Backend/internal/database/postgresql.go`

### Other components

- **Visitor or user**

## Connections

- Visitor or user → Route application: opens (evidence: `Frontend/src/App.tsx`)
- Route application → Event discovery: routes to (evidence: `Frontend/src/App.tsx`)
- Route application → Registration and checkout: routes to (evidence: `Frontend/src/App.tsx`)
- Route application → Confirmation and tickets: routes to (evidence: `Frontend/src/App.tsx`)
- Route application → Event management: routes to (evidence: `Frontend/src/App.tsx`)
- Route application → Owner operations: routes to (evidence: `Frontend/src/App.tsx`)
- Route application → Staff operations: routes to (evidence: `Frontend/src/App.tsx`)
- Route application → Analytics: routes to (evidence: `Frontend/src/App.tsx`)
- Route application → Session and roles: provides context (evidence: `Frontend/src/main.tsx`)
- Session and roles → API client: requests identity (evidence: `Frontend/src/contexts/AuthContext.tsx`)
- Query services → API client: makes requests (evidence: `Frontend/src/lib/queries.ts`)
- Event management → Query services: uses event queries (evidence: `Frontend/src/pages/owner/EventEditor.tsx`)
- Event discovery → Query services: uses event queries (evidence: `Frontend/src/pages/public/Landing.tsx`)
- Confirmation and tickets → Query services: uses registration queries (evidence: `Frontend/src/pages/user/RegistrationSuccess.tsx`)
- API client → API routing: HTTP API
- API routing → Authentication
- API routing → Events
- API routing → Registrations
- API routing → Tickets
- API routing → Check-in
- API routing → Waitlist
- API routing → Organizations and staff
- API routing → Notifications
- API routing → Statistics
