# i-maged/event-manager architecture

> Architecture diagram of the GitHub repository i-maged/event-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/i-maged/event-manager
- Repository: https://github.com/i-maged/event-manager

## Overview

Event Manager is a Next.js application for organizers and attendees. The principal workflow is browsing or searching events, opening an event, then creating/managing it or RSVPing; organizer tools also cover rosters, check-in, invites, and exports. Domain services enforce event, RSVP, invitation, and notification behavior, with Prisma-backed PostgreSQL persistence. The graph preserves documented calendar, timezone, comments, and notification capabilities. Some routes and services were not sampled, so their links are shown only where the README or source index supports them.

Main entry points: [`src/lib/events.ts`](https://github.com/i-maged/event-manager/blob/main/src/lib/events.ts) (Event services), [`src/app/events/actions.ts`](https://github.com/i-maged/event-manager/blob/main/src/app/events/actions.ts) (Event management), [`src/app/events/page.tsx`](https://github.com/i-maged/event-manager/blob/main/src/app/events/page.tsx) (Event discovery), [`src/app`](https://github.com/i-maged/event-manager/tree/main/src/app) (Next.js app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User experience"]
  node_app["Next.js app"]
end

subgraph group_workflow["Application workflows"]
  node_browse["Event discovery<br/>[page.tsx]"]
  node_create["Event creation<br/>[actions.ts]"]
  node_manage["Event management<br/>[actions.ts]"]
  node_eventdetail["Event details<br/>[page.tsx]"]
  node_organizer["Organizer dashboard<br/>[page.tsx]"]
  node_invites["Private invites<br/>[invite.ts]"]
  node_comments["Event comments<br/>[actions.ts]"]
  node_notificationsui["Notification center<br/>[page.tsx]"]
  node_calendar["Calendar export<br/>[calendar.ts]"]
  node_csv["Attendee export<br/>[attendee-csv.ts]"]
end

subgraph group_domain["Domain services"]
  node_events["Event services<br/>[events.ts]"]
  node_discovery["Browse parameters<br/>[discovery.ts]"]
  node_rsvp["RSVP and waitlist<br/>[rsvp.ts]"]
  node_checkin["Attendee check-in<br/>[check-in.ts]"]
  node_notify["Notification services<br/>[notifications.ts]"]
  node_time["Timezone scheduling<br/>[time.ts]"]
  node_ai["AI search and discovery"]
end

subgraph group_platform["Identity and persistence"]
  node_auth["Neon Auth<br/>[server.ts]"]
  node_actions["Server actions<br/>[actions.ts]"]
  node_dbclient["Prisma data access<br/>[db.ts]"]
  node_postgres[("Neon PostgreSQL")]
  node_gc["Rate-limit cleanup"]
end

node_browser(("Browser users"))

node_browser -->|"requests pages"| node_app
node_app -->|"checks sessions"| node_auth
node_app -->|"renders browse"| node_browse
node_browser -->|"submits event"| node_create
node_create -->|"creates event"| node_events
node_create -->|"requests embedding"| node_ai
node_browser -->|"submits changes"| node_manage
node_manage -->|"updates events"| node_events
node_manage -->|"changes RSVP"| node_rsvp
node_manage -->|"handles check-in"| node_checkin
node_manage -->|"manages invites"| node_invites
node_manage -->|"fans out updates"| node_notify
node_browse -->|"parses filters"| node_discovery
node_browse -->|"loads event page"| node_events
node_browse -->|"loads recommendations"| node_ai
node_eventdetail -.->|"loads event"| node_events
node_organizer -->|"loads organizer events"| node_events
node_comments -->|"searches comments"| node_ai
node_notificationsui -->|"loads notifications"| node_notify
node_notificationsui -->|"formats event times"| node_time
node_calendar -.->|"exports event time"| node_eventdetail
node_csv -->|"reads attendees"| node_events
node_events -->|"queries data"| node_dbclient
node_notify -->|"reads and writes"| node_dbclient
node_dbclient -->|"persists data"| node_postgres
node_auth -->|"supplies sessions"| node_app
node_gc -->|"cleans counters"| node_postgres

click node_app "https://github.com/i-maged/event-manager/tree/main/src/app"
click node_browse "https://github.com/i-maged/event-manager/blob/main/src/app/events/page.tsx"
click node_create "https://github.com/i-maged/event-manager/blob/main/src/app/events/new/actions.ts"
click node_manage "https://github.com/i-maged/event-manager/blob/main/src/app/events/actions.ts"
click node_eventdetail "https://github.com/i-maged/event-manager/blob/main/src/app/events/%5Bid%5D/page.tsx"
click node_organizer "https://github.com/i-maged/event-manager/blob/main/src/app/my-events/page.tsx"
click node_invites "https://github.com/i-maged/event-manager/blob/main/src/lib/invite.ts"
click node_comments "https://github.com/i-maged/event-manager/blob/main/src/app/events/%5Bid%5D/comments/actions.ts"
click node_notificationsui "https://github.com/i-maged/event-manager/blob/main/src/app/notifications/page.tsx"
click node_calendar "https://github.com/i-maged/event-manager/blob/main/src/lib/calendar.ts"
click node_csv "https://github.com/i-maged/event-manager/blob/main/src/lib/attendee-csv.ts"
click node_events "https://github.com/i-maged/event-manager/blob/main/src/lib/events.ts"
click node_discovery "https://github.com/i-maged/event-manager/blob/main/src/lib/discovery.ts"
click node_rsvp "https://github.com/i-maged/event-manager/blob/main/src/lib/rsvp.ts"
click node_checkin "https://github.com/i-maged/event-manager/blob/main/src/lib/check-in.ts"
click node_notify "https://github.com/i-maged/event-manager/blob/main/src/lib/notifications.ts"
click node_time "https://github.com/i-maged/event-manager/blob/main/src/lib/time.ts"
click node_ai "https://github.com/i-maged/event-manager/tree/main/src/lib/ai"
click node_auth "https://github.com/i-maged/event-manager/blob/main/src/lib/auth/server.ts"
click node_actions "https://github.com/i-maged/event-manager/blob/main/src/app/events/actions.ts"
click node_dbclient "https://github.com/i-maged/event-manager/blob/main/src/db.ts"
click node_gc "https://github.com/i-maged/event-manager/blob/main/functions/rate-limit-cleanup.ts"

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_browser toneBlue
class node_browse,node_create,node_manage,node_eventdetail,node_organizer,node_invites,node_comments,node_notificationsui,node_calendar,node_csv toneAmber
class node_events,node_discovery,node_rsvp,node_checkin,node_notify,node_time,node_ai toneMint
class node_auth,node_actions,node_dbclient,node_postgres,node_gc toneRose
```

## Components

### User experience

- [Next.js app](https://github.com/i-maged/event-manager/tree/main/src/app): `src/app`

### Application workflows

- [Event discovery](https://github.com/i-maged/event-manager/blob/main/src/app/events/page.tsx): `src/app/events/page.tsx`
- [Event creation](https://github.com/i-maged/event-manager/blob/main/src/app/events/new/actions.ts): `src/app/events/new/actions.ts`
- [Event management](https://github.com/i-maged/event-manager/blob/main/src/app/events/actions.ts): `src/app/events/actions.ts`
- [Event details](https://github.com/i-maged/event-manager/blob/main/src/app/events/%5Bid%5D/page.tsx): `src/app/events/[id]/page.tsx`
- [Organizer dashboard](https://github.com/i-maged/event-manager/blob/main/src/app/my-events/page.tsx): `src/app/my-events/page.tsx`
- [Private invites](https://github.com/i-maged/event-manager/blob/main/src/lib/invite.ts): `src/lib/invite.ts`
- [Event comments](https://github.com/i-maged/event-manager/blob/main/src/app/events/%5Bid%5D/comments/actions.ts): `src/app/events/[id]/comments/actions.ts`
- [Notification center](https://github.com/i-maged/event-manager/blob/main/src/app/notifications/page.tsx): `src/app/notifications/page.tsx`
- [Calendar export](https://github.com/i-maged/event-manager/blob/main/src/lib/calendar.ts): `src/lib/calendar.ts`
- [Attendee export](https://github.com/i-maged/event-manager/blob/main/src/lib/attendee-csv.ts): `src/lib/attendee-csv.ts`

### Domain services

- [Event services](https://github.com/i-maged/event-manager/blob/main/src/lib/events.ts): `src/lib/events.ts`
- [Browse parameters](https://github.com/i-maged/event-manager/blob/main/src/lib/discovery.ts): `src/lib/discovery.ts`
- [RSVP and waitlist](https://github.com/i-maged/event-manager/blob/main/src/lib/rsvp.ts): `src/lib/rsvp.ts`
- [Attendee check-in](https://github.com/i-maged/event-manager/blob/main/src/lib/check-in.ts): `src/lib/check-in.ts`
- [Notification services](https://github.com/i-maged/event-manager/blob/main/src/lib/notifications.ts): `src/lib/notifications.ts`
- [Timezone scheduling](https://github.com/i-maged/event-manager/blob/main/src/lib/time.ts): `src/lib/time.ts`
- [AI search and discovery](https://github.com/i-maged/event-manager/tree/main/src/lib/ai): `src/lib/ai`

### Identity and persistence

- [Neon Auth](https://github.com/i-maged/event-manager/blob/main/src/lib/auth/server.ts): `src/lib/auth/server.ts`
- [Server actions](https://github.com/i-maged/event-manager/blob/main/src/app/events/actions.ts): `src/app/events/actions.ts`
- [Prisma data access](https://github.com/i-maged/event-manager/blob/main/src/db.ts): `src/db.ts`
- **Neon PostgreSQL**
- [Rate-limit cleanup](https://github.com/i-maged/event-manager/blob/main/functions/rate-limit-cleanup.ts): `functions/rate-limit-cleanup.ts`

### Other components

- **Browser users**

## Connections

- Browser users → Next.js app: requests pages (evidence: `README.md`)
- Next.js app → Neon Auth: checks sessions (evidence: `src/app/events/page.tsx`)
- Next.js app → Event discovery: renders browse (evidence: `src/app/events/page.tsx`)
- Browser users → Event creation: submits event
- Event creation → Event services: creates event (evidence: `src/app/events/new/actions.ts`)
- Event creation → AI search and discovery: requests embedding (evidence: `src/app/events/new/actions.ts`)
- Browser users → Event management: submits changes
- Event management → Event services: updates events (evidence: `src/app/events/actions.ts`)
- Event management → RSVP and waitlist: changes RSVP (evidence: `src/app/events/actions.ts`)
- Event management → Attendee check-in: handles check-in (evidence: `src/app/events/actions.ts`)
- Event management → Private invites: manages invites (evidence: `src/app/events/actions.ts`)
- Event management → Notification services: fans out updates (evidence: `src/app/events/actions.ts`)
- Event discovery → Browse parameters: parses filters (evidence: `src/app/events/page.tsx`)
- Event discovery → Event services: loads event page (evidence: `src/app/events/page.tsx`)
- Event discovery → AI search and discovery: loads recommendations (evidence: `src/app/events/page.tsx`)
- Event details → Event services: loads event
- Organizer dashboard → Event services: loads organizer events (evidence: `src/app/my-events/page.tsx`)
- Event comments → AI search and discovery: searches comments
- Notification center → Notification services: loads notifications (evidence: `src/app/notifications/page.tsx`)
- Notification center → Timezone scheduling: formats event times (evidence: `src/app/notifications/page.tsx`)
- Calendar export → Event details: exports event time
- Attendee export → Event services: reads attendees (evidence: `src/app/api/events/[id]/attendees/route.ts`)
- Event services → Prisma data access: queries data (evidence: `src/lib/events.ts`)
- Notification services → Prisma data access: reads and writes (evidence: `src/lib/notifications.ts`)
- Prisma data access → Neon PostgreSQL: persists data (evidence: `README.md`)
- Neon Auth → Next.js app: supplies sessions (evidence: `README.md`)
- Rate-limit cleanup → Neon PostgreSQL: cleans counters (evidence: `README.md`)
