# plismun/website architecture

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

- Interactive diagram: https://gitdiagram.com/plismun/website
- Repository: https://github.com/plismun/website

## Overview

##### Project type and purpose
- This is a full-stack event management website built with Next.js (App Router), TypeScript, and Tailwind CSS.
- It serves public pages (conference info, FAQs, schedule), handles user flows (signup, login, payment, application), and exposes serverless API endpoints for database operations.
- It uses NextAuth for authentication, TursoDB (LibSQL-style cloud database) for persistence, and integrates external services (SMTP for email, Behold for Instagram feeds).

##### File structure
- **src/app/**
- Next.js App Router structure: each folder under /app corresponds to a route (e.g. `/app/about/page.tsx` → `/about`).
- Global layout and CSS, metadata, sitemap.
- **src/components/**
- Reusable UI components (buttons, cards, tables in /components/ui) and page-specific widgets (hero, footer, forms, dashboards).
- **src/pages/api/**
- Serverless functions organized by purpose:
– `/auth` (NextAuth)
– `/components` (dbAuth utility)
– `/internal` (admin pre-flight, email sending)
– `/modify` (write operations: signup, setApplication, etc.)
– `/retrieve` (read operations: getUsers, getApplications, etc.)
– `/utils` (seedDb, sendEmail)
- **src/lib** & **src/hooks**
- Shared utilities and custom React hooks (e.g. `useMobile`).
- **public**
- Static assets: images, PDFs, schedule files.
- **config**, **.github/workflows**, **next.config.ts**, **postcss.config.mjs**
- Environment configuration, CI/CD, build settings, linting.

##### README for additional insights
- Tech stack summary: Next.js, TypeScript, Tailwind, Vercel, NextAuth, TursoDB, Shadcn UI, Radix UI.
- Database schema overview: tables for users, applications, supervisors, payments, people, delegations, committees.
- Deployment workflow: private repo → public mirror via GitHub Actions → Vercel preview & production.
- Environment variables for DB connection, auth secrets, email, feature flags, pricing.

##### Final recommendations
- Be exhaustive: include all API groups (retrieve, modify, internal).
- Both runtime interactions (user requests, DB queries) and deployment pipelines (CI/CD).
- Critical environment variables or feature flags that drive behavior (e.g., `NEXT_PUBLIC_STAGE_*`).
- Keep it up to date each year as routes, tables, or services change.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        NX["Next.js Frontend (App Router)"]:::frontend
        PRES["Presentation Layer (src/components)"]:::frontend
        NP1["Global Styles & Layout"]:::frontend
        CH["Custom Hooks (src/hooks)"]:::frontend
        PUB["Public Static Assets"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend Layer"
        subgraph "API Routes"
            subgraph "Auth"
                NAuth["NextAuth [...nextauth].ts"]:::api
            end
            subgraph "DB Auth Utility"
                DBAuth["dbAuth.ts"]:::api
            end
            subgraph "Internal Operations"
                PreFlight["preFlightChecks.ts"]:::api
                AuthAdmin["authAdmin.ts"]:::api
                SendEmailInternal["sendEmail.ts"]:::api
            end
            subgraph "Read Operations"
                RU1["getUsers.ts"]:::api
                RU2["getApplications.ts"]:::api
                RU3["getAllApplications.ts"]:::api
                RU4["getCommittees.ts"]:::api
                RU5["getDelegations.ts"]:::api
                RU6["getPayment.ts"]:::api
                RU7["getPeopleInfo.ts"]:::api
                RU8["getAdmin.ts"]:::api
            end
            subgraph "Write Operations"
                MW1["signup.ts"]:::api
                MW2["setApplication.ts"]:::api
                MW3["acceptApplication.ts"]:::api
                MW4["setPayment.ts"]:::api
                MW5["acceptPayment.ts"]:::api
                MW6["setPeopleInfo.ts"]:::api
                MW7["updateUser.ts"]:::api
            end
            subgraph "API Utilities"
                SeedDb["seedDb.ts"]:::api
                SendEmailUtil["sendEmail.ts"]:::api
            end
        end
    end

    %% Database
    DB["TursoDB"]:::db

    %% External Services
    subgraph "External Services"
        SMTP["SMTP Service"]:::external
        INST["Behold Instagram Widget"]:::external
    end

    %% CI/CD Pipeline
    subgraph "CI/CD Pipeline"
        Dev["Developer"]:::infra
        GH["GitHub Actions"]:::infra
        Vercel["Vercel Deploy"]:::infra
    end

    %% Configuration
    CFG["Configuration (src/config)"]:::infra

    %% Interactions
    Dev -->|Push Code| GH
    GH -->|Mirror & Build| Vercel
    Vercel -->|Deploy Frontend| NX
    NX --> PRES
    NX --> NP1
    NX --> CH
    NX --> PUB
    PRES -->|REST Calls| NAuth
    PRES -->|REST Calls| DBAuth
    PRES -->|REST Calls| RU1
    PRES -->|REST Calls| RU2
    PRES -->|REST Calls| RU3
    PRES -->|REST Calls| RU4
    PRES -->|REST Calls| RU5
    PRES -->|REST Calls| RU6
    PRES -->|REST Calls| RU7
    PRES -->|REST Calls| RU8
    PRES -->|REST Calls| MW1
    PRES -->|REST Calls| MW2
    PRES -->|REST Calls| MW3
    PRES -->|REST Calls| MW4
    PRES -->|REST Calls| MW5
    PRES -->|REST Calls| MW6
    PRES -->|REST Calls| MW7
    PRES -->|REST Calls| PreFlight
    PreFlight -->|Admin Checks| AuthAdmin
    AuthAdmin -->|Invoke| SendEmailInternal
    SendEmailInternal -.->|Async Send| SMTP
    SeedDb -->|Initialize| DB
    SendEmailUtil -.->|Async Send| SMTP
    NAuth -->|User Sessions| DB
    DBAuth -->|Auth Queries| DB
    RU1 -->|SELECT| DB
    RU2 -->|SELECT| DB
    RU3 -->|SELECT| DB
    RU4 -->|SELECT| DB
    RU5 -->|SELECT| DB
    RU6 -->|SELECT| DB
    RU7 -->|SELECT| DB
    RU8 -->|SELECT| DB
    MW1 -->|INSERT| DB
    MW2 -->|INSERT| DB
    MW3 -->|UPDATE| DB
    MW4 -->|INSERT| DB
    MW5 -->|UPDATE| DB
    MW6 -->|UPDATE| DB
    MW7 -->|UPDATE| DB
    CFG --> NX
    CFG --> Vercel

    %% Click Events
    click NX "https://github.com/plismun/website/tree/main/src/app"
    click PRES "https://github.com/plismun/website/tree/main/src/components"
    click NAuth "https://github.com/plismun/website/blob/main/src/pages/api/auth/[...nextauth].ts"
    click DBAuth "https://github.com/plismun/website/blob/main/src/pages/api/components/dbAuth.ts"
    click PreFlight "https://github.com/plismun/website/blob/main/src/pages/api/internal/preFlightChecks.ts"
    click AuthAdmin "https://github.com/plismun/website/blob/main/src/pages/api/internal/authAdmin.ts"
    click SendEmailInternal "https://github.com/plismun/website/blob/main/src/pages/api/internal/sendEmail.ts"
    click RU1 "https://github.com/plismun/website/blob/main/src/pages/api/retrieve/getUsers.ts"
    click RU2 "https://github.com/plismun/website/blob/main/src/pages/api/retrieve/getApplications.ts"
    click RU3 "https://github.com/plismun/website/blob/main/src/pages/api/retrieve/getAllApplications.ts"
    click RU4 "https://github.com/plismun/website/blob/main/src/pages/api/retrieve/getCommittees.ts"
    click RU5 "https://github.com/plismun/website/blob/main/src/pages/api/retrieve/getDelegations.ts"
    click RU6 "https://github.com/plismun/website/blob/main/src/pages/api/retrieve/getPayment.ts"
    click RU7 "https://github.com/plismun/website/blob/main/src/pages/api/retrieve/getPeopleInfo.ts"
    click RU8 "https://github.com/plismun/website/blob/main/src/pages/api/retrieve/getAdmin.ts"
    click MW1 "https://github.com/plismun/website/blob/main/src/pages/api/modify/signup.ts"
    click MW2 "https://github.com/plismun/website/blob/main/src/pages/api/modify/setApplication.ts"
    click MW3 "https://github.com/plismun/website/blob/main/src/pages/api/modify/acceptApplication.ts"
    click MW4 "https://github.com/plismun/website/blob/main/src/pages/api/modify/setPayment.ts"
    click MW5 "https://github.com/plismun/website/blob/main/src/pages/api/modify/acceptPayment.ts"
    click MW6 "https://github.com/plismun/website/blob/main/src/pages/api/modify/setPeopleInfo.ts"
    click MW7 "https://github.com/plismun/website/blob/main/src/pages/api/modify/updateUser.ts"
    click SeedDb "https://github.com/plismun/website/blob/main/src/pages/api/utils/seedDb.ts"
    click SendEmailUtil "https://github.com/plismun/website/blob/main/src/pages/api/utils/sendEmail.ts"
    click CH "https://github.com/plismun/website/blob/main/src/hooks/use-mobile.ts"
    click CFG "https://github.com/plismun/website/blob/main/src/config/stages.ts"
    click NP1 "https://github.com/plismun/website/blob/main/src/app/layout.tsx"
    click PUB "https://github.com/plismun/website/tree/main/public/"
    click GH "https://github.com/plismun/website/blob/main/.github/workflows/mirror.yml"
    click Vercel "https://github.com/plismun/website/blob/main/next.config.ts"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#66b0ff,color:#000
    classDef api fill:#d4edda,stroke:#28a745,color:#000
    classDef db fill:#fff3cd,stroke:#ffc107,color:#000
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#000
    classDef infra fill:#f5c6cb,stroke:#dc3545,color:#000
```
