# idraynar/activities-agenda architecture

> Architecture diagram of the GitHub repository idraynar/activities-agenda, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/idraynar/activities-agenda
- Repository: https://github.com/idraynar/activities-agenda

## Overview

##### Project type and purpose
- This is a full-stack web application (“Activities Agenda”) built with Next.js 15.
- It provides user registration, authentication, activity creation & reservation, plus an admin dashboard with analytics.
- Backend runs as Next.js API routes (serverless functions) with Prisma ORM and PostgreSQL.
- Frontend uses React components, TailwindCSS, client/server components, and Leaflet for maps.

##### File structure
- Top-level “app/” directory contains:
- app/page.tsx, global layouts, error handlers
- app/api/… – all RESTful API routes (activities, auth, dashboard stats, reservations, etc.)
- app/components/… – reusable React UI components
- app/dashboard/… – admin dashboard pages & components
- pages for login, register, profile, forgot/reset password
- “lib/” contains shared Node-side logic (lib/auth.ts, lib/prisma.ts).
- “prisma/” holds schema.prisma, migrations, seed script.
- “middleware.ts” implements Next.js middleware (e.g., authentication).
- Config files: next.config.js/ts, tailwind.config.js, sentry configs for error monitoring.

##### README for additional insights
- Confirms tech stack: Next.js SSR/SSG, React 19, TailwindCSS, HeadlessUI, Leaflet, NextAuth.js, Prisma, PostgreSQL, Sentry, SMTP/Gmail for emails.
- Describes user vs. admin flows, real-time reservations, dynamic metadata (SEO), performance optimizations.

##### Main components
a. Frontend
- Next.js pages & client components (React)
- UI components (app/components)
- Leaflet map module
- TailwindCSS styling
b. Backend
- Next.js API Routes (Serverless Functions)
- Authentication layer (NextAuth.js, middleware.ts)
- Business logic (lib/auth.ts)
- Validation & error handling
c. Database
- PostgreSQL (Neon) accessed via Prisma ORM
- Prisma migration & seed scripts
d. External Services
- SMTP/Gmail for email (forgot/reset password)
- Optional TMDB API (if used)
- Sentry for error monitoring (client, server, edge)
e. CI/CD & Deployment
- GitHub Actions (CI)
- Next.js build & deployment (Vercel or custom host)

##### Relationships and data flow
- User browser ⇄ Next.js React pages (SSR/SSG)
- React pages call API routes via fetch or Next.js internal calls
- API routes authenticate via NextAuth, then call lib/prisma to read/write PostgreSQL
- Prisma generates SQL queries to the database
- Reservation emails triggered via SMTP service
- Sentry captures errors at client/server
- Admin dashboard fetches stats from API → Prisma → DB

##### Architectural patterns & principles
- Monolithic full-stack “app” folder structure (separation of concerns: pages vs. components vs. API)
- Serverless functions for each API endpoint (scoped, stateless handlers)
- Prisma as repository/DAO layer
- NextAuth.js middleware for authentication & session management
- TailwindCSS for utility-first styling
- Component-based UI with HeadlessUI for accessibility
- -view module decoupled via Leaflet

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Browser
    Browser["User Browser"]:::external

    %% Frontend Layer
    subgraph "Frontend (Next.js + React)" 
        direction TB
        subgraph "Pages" 
            direction TB
            Home["Home / Landing Page"]:::frontend
            Login["Login Page"]:::frontend
            Register["Register Page"]:::frontend
            Profile["Profile Page"]:::frontend
            Forgot["Forgot Password Page"]:::frontend
            ResetFlow["Reset Password Flow"]:::frontend
            GlobalLayout["Global Layout & Error Handling"]:::frontend
        end
        subgraph "UI Components"
            direction TB
            ReusableUI["Reusable UI Components"]:::frontend
            ActivityMap["ActivityMap (Leaflet)"]:::frontend
            ActivityMapSection["ActivityMapSection (Leaflet)"]:::frontend
            DashboardNav["Dashboard Navigation"]:::frontend
            RecentRes["RecentReservations Widget"]:::frontend
            StatsCard["StatsCard Widget"]:::frontend
            TopActivities["TopActivities Widget"]:::frontend
        end
        Tailwind["TailwindCSS Styling"]:::frontend
    end

    %% Server/API Layer
    subgraph "Backend (Next.js API Routes)" 
        direction TB
        subgraph "Activities"
            direction TB
            ActivitiesList["GET /api/activities"]:::backend
            ActivitiesDetail["GET/PUT/DELETE /api/activities/[id]"]:::backend
            ActivityTypes["/api/activity-types"]:::backend
        end
        subgraph "Authentication"
            direction TB
            NextAuth["NextAuth Route"]:::backend
            AuthRegister["Register Route"]:::backend
            AuthForgot["Forgot Password Route"]:::backend
            AuthReset["Reset Password Route"]:::backend
        end
        ProfileAPI["/api/profile"]:::backend
        subgraph "Reservations"
            direction TB
            ReservationsList["/api/reservations"]:::backend
            ReservationsDetail["/api/reservations/[activityId]"]:::backend
        end
        DashboardStats["/api/dashboard/stats"]:::backend
        SentryAPI["/api/sentry-example-api"]:::backend
        Middleware["middleware.ts"]:::backend
        AuthLib["lib/auth.ts"]:::backend
        PrismaClient["lib/prisma.ts"]:::backend
    end

    %% Database Layer
    subgraph "Database (Prisma + PostgreSQL)" 
        direction TB
        Schema["prisma/schema.prisma"]:::database
        Migrations["prisma/migrations/**"]:::database
        SeedScript["prisma/seed.ts & scripts/seed-reservations.ts"]:::database
        PostgreSQL["PostgreSQL Database"]:::database
    end

    %% External Services
    subgraph "External Services" 
        direction TB
        SMTP["SMTP/Gmail Email Service"]:::external
        TMDB["Optional TMDB API"]:::external
        Sentry["Sentry Monitoring"]:::external
    end

    %% CI/CD & Deployment
    subgraph "CI/CD & Deployment"
        direction TB
        GitHubActions["GitHub Actions (CI)"]:::external
        Vercel["Vercel Deployment"]:::external
    end

    %% Connections
    Browser -->|"requests"| Home
    Browser --> Login
    Browser --> Register
    Browser --> Profile
    Browser --> Forgot
    Browser --> ResetFlow
    Home -->|"renders using"| ReusableUI
    Home -->|"renders using"| ActivityMapSection
    AnyComp(ActivityMap) --> Tailwind

    Home -->|"calls API"| ActivitiesList
    Login -->|"calls API"| NextAuth
    Register -->|"calls API"| AuthRegister
    Forgot -->|"calls API"| AuthForgot
    ResetFlow -->|"calls API"| AuthReset
    Profile -->|"calls API"| ProfileAPI

    ActivitiesList -->|uses| AuthLib
    ActivitiesDetail -->|uses| AuthLib
    AuthRegister -->|uses| AuthLib
    AuthForgot -->|uses| AuthLib
    AuthReset -->|uses| AuthLib
    NextAuth -->|uses| AuthLib
    ProfileAPI -->|uses| AuthLib
    ReservationsList -->|uses| AuthLib
    ReservationsDetail -->|uses| AuthLib
    DashboardStats -->|uses| AuthLib
    SentryAPI -->|uses| AuthLib

    ActivitiesList -->|queries| PrismaClient
    ActivitiesDetail -->|queries| PrismaClient
    ActivityTypes -->|queries| PrismaClient
    ProfileAPI -->|queries| PrismaClient
    ReservationsList -->|queries| PrismaClient
    ReservationsDetail -->|queries| PrismaClient
    DashboardStats -->|queries| PrismaClient
    SentryAPI -->|reports errors via| Sentry

    PrismaClient -->|migrates/seed| Schema
    PrismaClient -->|executes migrations| Migrations
    PrismaClient -->|seeds data via| SeedScript
    PrismaClient -->|runs queries| PostgreSQL

    NextAuth -->|sends emails via| SMTP
    AuthForgot -->|sends emails via| SMTP
    AuthReset -->|sends emails via| SMTP

    GitHubActions -->|build & test| NextAuth
    GitHubActions -->|deploy| Vercel

    %% Click Events
    click Home "https://github.com/idraynar/activities-agenda/blob/main/app/page.tsx"
    click Login "https://github.com/idraynar/activities-agenda/blob/main/app/login/page.tsx"
    click Register "https://github.com/idraynar/activities-agenda/blob/main/app/register/page.tsx"
    click Profile "https://github.com/idraynar/activities-agenda/blob/main/app/profile/page.tsx"
    click Forgot "https://github.com/idraynar/activities-agenda/blob/main/app/forgot-password/page.tsx"
    click ResetFlow "https://github.com/idraynar/activities-agenda/blob/main/app/reset-password/page.tsx"
    click GlobalLayout "https://github.com/idraynar/activities-agenda/blob/main/app/layout.tsx"
    click GlobalLayout "https://github.com/idraynar/activities-agenda/blob/main/app/global-error.tsx"
    click GlobalLayout "https://github.com/idraynar/activities-agenda/blob/main/app/not-found.tsx"
    click ReusableUI "https://github.com/idraynar/activities-agenda/tree/main/app/components"
    click ActivityMap "https://github.com/idraynar/activities-agenda/blob/main/app/components/ActivityMap.tsx"
    click ActivityMapSection "https://github.com/idraynar/activities-agenda/blob/main/app/components/ActivityMapSection.tsx"
    click DashboardNav "https://github.com/idraynar/activities-agenda/blob/main/app/dashboard/components/DashboardNav.tsx"
    click RecentRes "https://github.com/idraynar/activities-agenda/blob/main/app/dashboard/components/RecentReservations.tsx"
    click StatsCard "https://github.com/idraynar/activities-agenda/blob/main/app/dashboard/components/StatsCard.tsx"
    click TopActivities "https://github.com/idraynar/activities-agenda/blob/main/app/dashboard/components/TopActivities.tsx"
    click ActivitiesList "https://github.com/idraynar/activities-agenda/blob/main/app/api/activities/route.ts"
    click ActivitiesDetail "https://github.com/idraynar/activities-agenda/blob/main/app/api/activities/[id]/route.ts"
    click ActivityTypes "https://github.com/idraynar/activities-agenda/blob/main/app/api/activity-types/route.ts"
    click NextAuth "https://github.com/idraynar/activities-agenda/blob/main/app/api/auth/[...nextauth]/route.ts"
    click AuthRegister "https://github.com/idraynar/activities-agenda/blob/main/app/api/auth/register/route.ts"
    click AuthForgot "https://github.com/idraynar/activities-agenda/blob/main/app/api/auth/forgot-password/route.ts"
    click AuthReset "https://github.com/idraynar/activities-agenda/blob/main/app/api/auth/reset-password/route.ts"
    click ProfileAPI "https://github.com/idraynar/activities-agenda/blob/main/app/api/profile/route.ts"
    click ReservationsList "https://github.com/idraynar/activities-agenda/blob/main/app/api/reservations/route.ts"
    click ReservationsDetail "https://github.com/idraynar/activities-agenda/blob/main/app/api/reservations/[activityId]/route.ts"
    click DashboardStats "https://github.com/idraynar/activities-agenda/blob/main/app/api/dashboard/stats/route.ts"
    click SentryAPI "https://github.com/idraynar/activities-agenda/blob/main/app/api/sentry-example-api/route.ts"
    click AuthLib "https://github.com/idraynar/activities-agenda/blob/main/lib/auth.ts"
    click PrismaClient "https://github.com/idraynar/activities-agenda/blob/main/lib/prisma.ts"
    click Middleware "https://github.com/idraynar/activities-agenda/blob/main/middleware.ts"
    click Schema "https://github.com/idraynar/activities-agenda/blob/main/prisma/schema.prisma"
    click Migrations "https://github.com/idraynar/activities-agenda/tree/main/prisma/migrations"
    click SeedScript "https://github.com/idraynar/activities-agenda/blob/main/prisma/seed.ts"
    click GitHubActions "https://github.com/idraynar/activities-agenda/tree/main/github/workflows"
    click Vercel "https://github.com/idraynar/activities-agenda/blob/main/next.config.js"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#004085,color:#004085
    classDef backend fill:#d4edda,stroke:#155724,color:#155724
    classDef database fill:#fff3cd,stroke:#856404,color:#856404
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#6c757d
```
