# bautiliendo/miagenda-app architecture

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

- Interactive diagram: https://gitdiagram.com/bautiliendo/miagenda-app
- Repository: https://github.com/bautiliendo/miagenda-app

## Overview

##### Project type and purpose
- This is a full-stack Next.js 13 “App Router” application written in TypeScript.
- It provides authentication (sign-in/sign-up), a private user dashboard (agenda, events, schedule, help), public booking flows, and a collection of UI components.
- The backend layer uses Next.js server components and Server Actions, persists data via Drizzle ORM (SQL migrations/schema), and integrates with Google Calendar.

##### File structure
- Top-level configs:
- next.config.ts (Next.js settings)
- drizzle.config.ts & src/drizzle/* (DB connection, migrations, schema)
- package.json, ESLint, PostCSS, TS config.
- src/app: App Router pages, organized by route groups:
- (auth): sign-in/out, sign-up
- (private): authenticated dashboard (agenda, events CRUD, schedule, help)
- (public): booking flows by clerkUserId & eventId
- dashboard (reports) & global layout/styles.
- src/server/actions: business-logic entry points (events.ts, meetings.ts, schedule.ts)
- src/server/googleCalendar.ts: external API integration.
- src/components & src/sections: UI building blocks, forms, navigation, charts.
- src/hooks & src/lib: client hooks and shared utilities.

##### README
- Confirms a Next.js app bootstrapped by create-next-app.
- Deployment flow targeted at Vercel.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Browser / Client Zone
    subgraph "Browser / Client"
        direction TB
        subgraph "Auth Pages" 
            direction TB
            SignIn["Sign-In Page"]:::ui
            SignUp["Sign-Up Page"]:::ui
        end
        subgraph "Private Dashboard"
            direction TB
            Agenda["Agenda Page"]:::ui
            EventsList["Events List Page"]:::ui
            EventsNew["New Event Page"]:::ui
            EventsEdit["Edit Event Page"]:::ui
            Schedule["Schedule Page"]:::ui
            Help["Help Page"]:::ui
        end
        subgraph "Public Booking"
            direction TB
            PublicLayout["Public Booking Layout"]:::ui
            SelectUser["Select User Page"]:::ui
            SelectEvent["Select Event Page"]:::ui
            Loading["Loading State"]:::ui
            Success["Success Page"]:::ui
        end
        DashboardPage["Dashboard Reports Page"]:::ui
        DashboardData["Dashboard Data (JSON)"]:::ui
        GlobalLayout["Global Layout"]:::ui
        GlobalsCSS["Global Styles (CSS)"]:::ui
        UIComponents["UI Components"]:::ui
        Sections["Section Components"]:::ui
        Hooks["Client Hooks"]:::ui
        Utils["Shared Utilities"]:::ui
    end

    %% Next.js Server Zone
    subgraph "Next.js Server"
        direction TB
        AppRouter["App Router"]:::server
        Middleware["Middleware (route guarding)"]:::server
        subgraph "Business Logic (Server Actions)"
            direction TB
            EventsAction["events.ts Action"]:::server
            MeetingsAction["meetings.ts Action"]:::server
            ScheduleAction["schedule.ts Action"]:::server
        end
        GoogleCalendar["Google Calendar Integration"]:::ext
    end

    %% Data Layer
    subgraph "Database (Drizzle ORM)"
        direction TB
        DrizzleConfig["drizzle.config.ts"]:::infra
        DBConnection["db.ts (Connection)"]:::infra
        DBSchema["schema.ts"]:::infra
        Migrations1["0000_sticky_molecule_man.sql"]:::infra
        Migrations2["0001_add_price_to_events.sql"]:::infra
        Database["SQL Database"]:::db
    end

    %% External Services
    subgraph "External Services"
        direction TB
        AuthService["Authentication Service"]:::ext
    end

    %% Deployment
    Vercel["Vercel Deployment"]:::infra

    %% Static Assets
    PublicAssets["public/animations (Static Assets)"]:::infra

    %% Configs
    NextConfig["next.config.ts"]:::infra
    DrizzleRootConfig["drizzle.config.ts"]:::infra

    %% Relationships
    SignIn -->|GET/POST| AppRouter
    SignUp -->|GET/POST| AppRouter
    Agenda -->|GET| AppRouter
    EventsList -->|GET| AppRouter
    EventsNew -->|GET/POST| AppRouter
    EventsEdit -->|GET/PUT| AppRouter
    Schedule -->|GET| AppRouter
    Help -->|GET| AppRouter
    PublicLayout -->|GET| AppRouter
    SelectUser -->|GET/POST| AppRouter
    SelectEvent -->|GET/POST| AppRouter
    Loading -->|GET| AppRouter
    Success -->|GET| AppRouter
    DashboardPage -->|GET| AppRouter
    UIComponents -->|import| AppRouter
    Sections -->|import| AppRouter
    Hooks -->|import| AppRouter
    Utils -->|import| AppRouter
    GlobalLayout -->|layout| AppRouter
    GlobalsCSS -->|styles| AppRouter

    AppRouter -->|uses| Middleware
    AppRouter -->|invokes| EventsAction
    AppRouter -->|invokes| MeetingsAction
    AppRouter -->|invokes| ScheduleAction

    EventsAction -->|queries| Database
    MeetingsAction -->|queries| Database
    ScheduleAction -->|queries| Database

    EventsAction -->|calls| GoogleCalendar
    MeetingsAction -->|calls| GoogleCalendar

    SignIn <-->|auth| AuthService
    SignUp <-->|auth| AuthService

    AppRouter -->|serves| PublicAssets

    AppRouter -->|uses config| NextConfig
    DrizzleConfig -->|configures| Database
    DBConnection -->|connects| Database
    DBSchema -->|defines| Database
    Migrations1 -->|migrates| Database
    Migrations2 -->|migrates| Database

    AppRouter -->|deploys to| Vercel

    %% Click Events
    click NextConfig "https://github.com/bautiliendo/miagenda-app/blob/master/next.config.ts"
    click DrizzleRootConfig "https://github.com/bautiliendo/miagenda-app/blob/master/drizzle.config.ts"
    click DBConnection "https://github.com/bautiliendo/miagenda-app/blob/master/src/drizzle/db.ts"
    click DBSchema "https://github.com/bautiliendo/miagenda-app/blob/master/src/drizzle/schema.ts"
    click Migrations1 "https://github.com/bautiliendo/miagenda-app/blob/master/src/drizzle/migrations/0000_sticky_molecule_man.sql"
    click Migrations2 "https://github.com/bautiliendo/miagenda-app/blob/master/src/drizzle/migrations/0001_add_price_to_events.sql"
    click SignIn "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(auth)/sign-in/[[...sign-in]]/page.tsx"
    click SignUp "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(auth)/sign-up/[[...sign-up]]/page.tsx"
    click Agenda "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(private)/agenda/page.tsx"
    click EventsList "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(private)/events/page.tsx"
    click EventsNew "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(private)/events/new/page.tsx"
    click EventsEdit "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(private)/events/[eventId]/edit/page.tsx"
    click Schedule "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(private)/schedule/page.tsx"
    click Help "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(private)/help/page.tsx"
    click PublicLayout "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(public)/layout.tsx"
    click SelectUser "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(public)/book/[clerkUserId]/page.tsx"
    click SelectEvent "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(public)/book/[clerkUserId]/[eventId]/page.tsx"
    click Loading "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(public)/book/[clerkUserId]/[eventId]/loading.tsx"
    click Success "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/(public)/book/[clerkUserId]/[eventId]/success/page.tsx"
    click DashboardPage "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/dashboard/page.tsx"
    click DashboardData "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/dashboard/data.json"
    click GlobalLayout "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/layout.tsx"
    click GlobalsCSS "https://github.com/bautiliendo/miagenda-app/blob/master/src/app/globals.css"
    click EventsAction "https://github.com/bautiliendo/miagenda-app/blob/master/src/server/actions/events.ts"
    click MeetingsAction "https://github.com/bautiliendo/miagenda-app/blob/master/src/server/actions/meetings.ts"
    click ScheduleAction "https://github.com/bautiliendo/miagenda-app/blob/master/src/server/actions/schedule.ts"
    click GoogleCalendar "https://github.com/bautiliendo/miagenda-app/blob/master/src/server/googleCalendar.ts"
    click Middleware "https://github.com/bautiliendo/miagenda-app/blob/master/src/middleware.ts"
    click UIComponents "https://github.com/bautiliendo/miagenda-app/tree/master/src/components"
    click Sections "https://github.com/bautiliendo/miagenda-app/tree/master/src/sections"
    click Hooks "https://github.com/bautiliendo/miagenda-app/blob/master/src/hooks/use-mobile.ts"
    click Utils "https://github.com/bautiliendo/miagenda-app/blob/master/src/lib/formatters.ts"
    click Utils "https://github.com/bautiliendo/miagenda-app/blob/master/src/lib/getValidTimesFromSchedule.ts"
    click Utils "https://github.com/bautiliendo/miagenda-app/blob/master/src/lib/utils.ts"
    click PublicAssets "https://github.com/bautiliendo/miagenda-app/blob/master/public/animations/time.json"
    click PublicAssets "https://github.com/bautiliendo/miagenda-app/blob/master/public/animations/time2.json"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0366d6,stroke-width:1px
    classDef server fill:#D2F8D2,stroke:#228B22,stroke-width:1px
    classDef db fill:#FFD2A6,stroke:#E97600,stroke-width:1px
    classDef ext fill:#E3D2FF,stroke:#800080,stroke-width:1px
    classDef infra fill:#EEEEEE,stroke:#666666,stroke-width:1px
```
