# shafkhandssc15/eventflowpersonal architecture

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

- Interactive diagram: https://gitdiagram.com/shafkhandssc15/eventflowpersonal
- Repository: https://github.com/shafkhandssc15/eventflowpersonal

## Overview

Event Management Platform supports event publishing, discovery, registration, ticketing and QR check-in, venue/vendor bookings, budgets and approvals, with a four-agent event-planning workflow. The organizer submits an objective through the web client and API; the agent service plans, ranks options, proposes actions, then applies a budget gate that may pause for human approval. Web and mobile clients are separate surfaces; the README documents API-to-agent routing, while the sampled mobile code also names Supabase. Several dashboard and backend details are unsampled, so those branches are represented at subsystem level.

Main entry points: [`web/src/App.jsx`](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/App.jsx) (Web routes), [`web/src/api/client.js`](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/api/client.js) (Web API client), [`agents/orchestrator.py`](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/orchestrator.py) (Workflow orchestration), [`backend/EventManagement.Api/Data/AppDbContext.cs`](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Data/AppDbContext.cs) (EF data context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web client"]
  node_webapp["Web routes<br/>[App.jsx]"]
  node_auth["Web authentication<br/>[AuthContext.jsx]"]
  node_authpage["Sign-in<br/>[AuthPage.jsx]"]
  node_organizerdash["Organizer dashboard"]
  node_workflowui["Workflow runner"]
  node_approvalui["Approval queue<br/>[ApprovalQueue.jsx]"]
  node_otherweb["Role dashboards"]
  node_webapi["Web API client<br/>[client.js]"]
  node_realtime["Live data context"]
end

subgraph group_mobile["Mobile client"]
  node_mobileapp["Mobile experience<br/>[MobileApp.tsx]"]
  node_mobileentry["Mobile shell<br/>[App.tsx]"]
  node_mobiledata["Mobile data access<br/>[supabase.ts]"]
end

subgraph group_api["Backend API"]
  node_api_events["Events API"]
  node_api_reg["Registration API"]
  node_api_venues["Venue vendor API"]
  node_api_budget["Budget API"]
  node_api_workflow["Workflow API"]
end

subgraph group_agents["AI workflow"]
  node_agent_service["Agent service<br/>[main.py]"]
  node_orchestrator["Workflow orchestration<br/>[orchestrator.py]"]
  node_planner["Plan generation<br/>[planner_agent.py]"]
  node_analysis["Venue vendor ranking"]
  node_action["Reservation actions<br/>[action_agent.py]"]
  node_validation["Budget validation"]
  node_llm["LLM failover client<br/>[llm_client.py]"]
end

subgraph group_data["Persistence"]
  node_efcontext["EF data context<br/>[AppDbContext.cs]"]
  node_postgres[("PostgreSQL")]
  node_supabase[("Supabase")]
end

node_organizer(("Organizer"))

node_organizer -->|"uses"| node_webapp
node_webapp -->|"provides auth"| node_auth
node_webapp -->|"routes to"| node_authpage
node_webapp -->|"routes to"| node_organizerdash
node_webapp -->|"routes to"| node_workflowui
node_webapp -->|"routes to"| node_approvalui
node_webapp -->|"routes to"| node_otherweb
node_organizerdash -->|"calls"| node_webapi
node_organizerdash -->|"uses"| node_realtime
node_realtime -->|"calls"| node_webapi
node_webapi -->|"HTTP requests"| node_api_events
node_webapi -->|"HTTP requests"| node_api_reg
node_webapi -->|"HTTP requests"| node_api_venues
node_webapi -->|"HTTP requests"| node_api_budget
node_webapi -->|"HTTP requests"| node_api_workflow
node_mobileentry -->|"renders"| node_mobileapp
node_mobileapp -->|"fetches events"| node_mobiledata
node_mobiledata -.->|"reads data"| node_supabase
node_api_events -->|"uses"| node_efcontext
node_api_reg -->|"uses"| node_efcontext
node_api_venues -->|"uses"| node_efcontext
node_api_budget -->|"uses"| node_efcontext
node_efcontext -->|"persists via EF"| node_postgres
node_api_workflow -->|"HTTP dispatch"| node_agent_service
node_agent_service -->|"routes workflow"| node_orchestrator
node_orchestrator -->|"runs first"| node_planner
node_orchestrator -->|"runs next"| node_analysis
node_orchestrator -->|"runs next"| node_action
node_orchestrator -->|"runs last"| node_validation
node_planner -->|"calls"| node_llm
node_analysis -->|"calls"| node_llm
node_action -->|"calls"| node_llm
node_validation -->|"calls"| node_llm
node_orchestrator -->|"stores workflow logs"| node_supabase

click node_webapp "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/App.jsx"
click node_auth "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/context/AuthContext.jsx"
click node_authpage "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/pages/AuthPage.jsx"
click node_organizerdash "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/pages/OrganizerDashboard.jsx"
click node_workflowui "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/pages/AgentWorkflowRunner.jsx"
click node_approvalui "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/pages/ApprovalQueue.jsx"
click node_otherweb "https://github.com/shafkhandssc15/eventflowpersonal/tree/main/web/src/pages"
click node_webapi "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/api/client.js"
click node_realtime "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/context/RealtimeContext.jsx"
click node_mobileapp "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/mobile/eventflow-mobile---full/src/components/MobileApp.tsx"
click node_mobileentry "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/mobile/eventflow-mobile---full/src/App.tsx"
click node_mobiledata "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/mobile/eventflow-mobile---full/src/lib/supabase.ts"
click node_api_events "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Controllers/EventsController.cs"
click node_api_reg "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Controllers/RegistrationsController.cs"
click node_api_venues "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Controllers/VenuesVendorsController.cs"
click node_api_budget "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Controllers/BudgetsController.cs"
click node_api_workflow "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Controllers/AgentWorkflowController.cs"
click node_agent_service "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/main.py"
click node_orchestrator "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/orchestrator.py"
click node_planner "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/agents/planner_agent.py"
click node_analysis "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/agents/domain_analysis_agent.py"
click node_action "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/agents/action_agent.py"
click node_validation "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/agents/validation_agent.py"
click node_llm "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/agents/llm_client.py"
click node_efcontext "https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Data/AppDbContext.cs"

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_webapp,node_auth,node_authpage,node_organizerdash,node_workflowui,node_approvalui,node_otherweb,node_webapi,node_realtime toneBlue
class node_mobileapp,node_mobileentry,node_mobiledata toneAmber
class node_api_events,node_api_reg,node_api_venues,node_api_budget,node_api_workflow toneMint
class node_agent_service,node_orchestrator,node_planner,node_analysis,node_action,node_validation,node_llm toneRose
class node_efcontext,node_postgres,node_supabase,node_organizer toneIndigo
```

## Components

### Web client

- [Web routes](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/App.jsx): `web/src/App.jsx`
- [Web authentication](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/context/AuthContext.jsx): `web/src/context/AuthContext.jsx`
- [Sign-in](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/pages/AuthPage.jsx): `web/src/pages/AuthPage.jsx`
- [Organizer dashboard](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/pages/OrganizerDashboard.jsx): `web/src/pages/OrganizerDashboard.jsx`
- [Workflow runner](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/pages/AgentWorkflowRunner.jsx): `web/src/pages/AgentWorkflowRunner.jsx`
- [Approval queue](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/pages/ApprovalQueue.jsx): `web/src/pages/ApprovalQueue.jsx`
- [Role dashboards](https://github.com/shafkhandssc15/eventflowpersonal/tree/main/web/src/pages): `web/src/pages`
- [Web API client](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/api/client.js): `web/src/api/client.js`
- [Live data context](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/web/src/context/RealtimeContext.jsx): `web/src/context/RealtimeContext.jsx`

### Mobile client

- [Mobile experience](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/mobile/eventflow-mobile---full/src/components/MobileApp.tsx): `mobile/eventflow-mobile---full/src/components/MobileApp.tsx`
- [Mobile shell](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/mobile/eventflow-mobile---full/src/App.tsx): `mobile/eventflow-mobile---full/src/App.tsx`
- [Mobile data access](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/mobile/eventflow-mobile---full/src/lib/supabase.ts): `mobile/eventflow-mobile---full/src/lib/supabase.ts`

### Backend API

- [Events API](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Controllers/EventsController.cs): `backend/EventManagement.Api/Controllers/EventsController.cs`
- [Registration API](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Controllers/RegistrationsController.cs): `backend/EventManagement.Api/Controllers/RegistrationsController.cs`
- [Venue vendor API](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Controllers/VenuesVendorsController.cs): `backend/EventManagement.Api/Controllers/VenuesVendorsController.cs`
- [Budget API](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Controllers/BudgetsController.cs): `backend/EventManagement.Api/Controllers/BudgetsController.cs`
- [Workflow API](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Controllers/AgentWorkflowController.cs): `backend/EventManagement.Api/Controllers/AgentWorkflowController.cs`

### AI workflow

- [Agent service](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/main.py): `agents/main.py`
- [Workflow orchestration](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/orchestrator.py): `agents/orchestrator.py`
- [Plan generation](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/agents/planner_agent.py): `agents/agents/planner_agent.py`
- [Venue vendor ranking](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/agents/domain_analysis_agent.py): `agents/agents/domain_analysis_agent.py`
- [Reservation actions](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/agents/action_agent.py): `agents/agents/action_agent.py`
- [Budget validation](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/agents/validation_agent.py): `agents/agents/validation_agent.py`
- [LLM failover client](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/agents/agents/llm_client.py): `agents/agents/llm_client.py`

### Persistence

- [EF data context](https://github.com/shafkhandssc15/eventflowpersonal/blob/main/backend/EventManagement.Api/Data/AppDbContext.cs): `backend/EventManagement.Api/Data/AppDbContext.cs`
- **PostgreSQL**
- **Supabase**

### Other components

- **Organizer**

## Connections

- Organizer → Web routes: uses (evidence: `README.md`)
- Web routes → Web authentication: provides auth (evidence: `web/src/App.jsx`)
- Web routes → Sign-in: routes to (evidence: `web/src/App.jsx`)
- Web routes → Organizer dashboard: routes to (evidence: `web/src/App.jsx`)
- Web routes → Workflow runner: routes to (evidence: `web/src/App.jsx`)
- Web routes → Approval queue: routes to (evidence: `web/src/App.jsx`)
- Web routes → Role dashboards: routes to (evidence: `web/src/App.jsx`)
- Organizer dashboard → Web API client: calls (evidence: `web/src/pages/OrganizerDashboard.jsx`)
- Organizer dashboard → Live data context: uses (evidence: `web/src/pages/OrganizerDashboard.jsx`)
- Live data context → Web API client: calls (evidence: `web/src/context/RealtimeContext.jsx`)
- Web API client → Events API: HTTP requests (evidence: `web/src/api/client.js`)
- Web API client → Registration API: HTTP requests (evidence: `web/src/api/client.js`)
- Web API client → Venue vendor API: HTTP requests (evidence: `web/src/api/client.js`)
- Web API client → Budget API: HTTP requests (evidence: `web/src/api/client.js`)
- Web API client → Workflow API: HTTP requests (evidence: `web/src/api/client.js`)
- Mobile shell → Mobile experience: renders (evidence: `mobile/eventflow-mobile---full/src/App.tsx`)
- Mobile experience → Mobile data access: fetches events (evidence: `mobile/eventflow-mobile---full/src/components/MobileApp.tsx`)
- Mobile data access → Supabase: reads data
- Events API → EF data context: uses (evidence: `backend/EventManagement.Api/Controllers/EventsController.cs`)
- Registration API → EF data context: uses (evidence: `backend/EventManagement.Api/Controllers/RegistrationsController.cs`)
- Venue vendor API → EF data context: uses (evidence: `backend/EventManagement.Api/Controllers/VenuesVendorsController.cs`)
- Budget API → EF data context: uses (evidence: `backend/EventManagement.Api/Controllers/BudgetsController.cs`)
- EF data context → PostgreSQL: persists via EF (evidence: `README.md`)
- Workflow API → Agent service: HTTP dispatch (evidence: `README.md`)
- Agent service → Workflow orchestration: routes workflow (evidence: `agents/main.py`)
- Workflow orchestration → Plan generation: runs first (evidence: `agents/orchestrator.py`)
- Workflow orchestration → Venue vendor ranking: runs next (evidence: `README.md`)
- Workflow orchestration → Reservation actions: runs next (evidence: `README.md`)
- Workflow orchestration → Budget validation: runs last (evidence: `agents/orchestrator.py`)
- Plan generation → LLM failover client: calls (evidence: `agents/agents/planner_agent.py`)
- Venue vendor ranking → LLM failover client: calls (evidence: `agents/agents/domain_analysis_agent.py`)
- Reservation actions → LLM failover client: calls (evidence: `agents/agents/action_agent.py`)
- Budget validation → LLM failover client: calls (evidence: `agents/agents/validation_agent.py`)
- Workflow orchestration → Supabase: stores workflow logs (evidence: `agents/orchestrator.py`)
