# trivetribe/trivetribe architecture

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

- Interactive diagram: https://gitdiagram.com/trivetribe/trivetribe
- Repository: https://github.com/trivetribe/trivetribe

## Overview

##### Main Components

A. Frontend Layer:
- Next.js Application (Client-Side)
- Pages (/src/app/*)
- Components (organized by feature)
- Client-side Actions

B. API Layer:
- Next.js API Routes (/src/app/api/*)
- Authentication endpoints
- Events management
- Announcements
- Badges system

C. Backend Services:
- Pocketbase (Database + Authentication)
- User management
- Events storage
- Badges tracking
- Announcements

D. External Services:
- Vercel (Hosting & Deployment)

##### Component Relationships

**[Frontend Components] ←→ [Next.js API Routes] ←→ [Pocketbase Services]**

##### Detailed Component Breakdown

- Authentication (Login)
- Events Management
- Badges System
- User Settings
- History Tracking
- Announcements

- /api/auth/login
- /api/events
- /api/badges
- /api/announcements

- Pocketbase Collections:
- Users
- Events
- Badges
- BadgesReceived
- Announcements

##### Data Flow Patterns

- User authentication flow
- Event creation and RSVP process
- Badge earning and distribution
- XP accumulation system

##### Technical Implementation Details

Highlight:
- TypeScript integration
- TailwindCSS styling
- Next.js server components
- Pocketbase client integration

##### Additional Notes

Annotations for:
- Authentication flow
- Data persistence patterns
- Real-time update mechanisms
- Scalability considerations

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles
    classDef frontend fill:#3b82f6,color:white
    classDef api fill:#22c55e,color:white
    classDef backend fill:#f97316,color:white
    classDef database fill:#6b7280,color:white
    classDef external fill:#8b5cf6,color:white
    classDef gamification fill:#ec4899,color:white

    %% Frontend Layer
    subgraph Frontend
        Login["Authentication"]:::frontend
        Events["Events Management"]:::frontend
        Badges["Badges System"]:::frontend
        Settings["User Settings"]:::frontend
        History["History Tracking"]:::frontend
        
        subgraph Components
            BadgeComps["Badge Components"]:::frontend
            EventComps["Event Components"]:::frontend
            FormComps["Form Components"]:::frontend
            LoginComps["Login Components"]:::frontend
            GenComps["General Components"]:::frontend
        end
        
        Actions["Client Actions"]:::frontend
    end

    %% API Layer
    subgraph APILayer
        AuthAPI["Authentication API"]:::api
        EventsAPI["Events API"]:::api
        BadgesAPI["Badges API"]:::api
        AnnouncementsAPI["Announcements API"]:::api
        Middleware["Auth Middleware"]:::api
    end

    %% Backend Layer
    subgraph Backend
        PBClient["Pocketbase Client"]:::backend
        
        subgraph PocketbaseServices
            UserMgmt["User Management"]:::backend
            EventMgmt["Events Management"]:::backend
            BadgeMgmt["Badges Management"]:::backend
            AnnouncementMgmt["Announcements Management"]:::backend
            BadgeTrackMgmt["Badges Received Tracking"]:::backend
        end
        
        subgraph DataModels
            UserModel["User Model"]:::backend
            EventModel["Event Model"]:::backend
            BadgeModel["Badge Model"]:::backend
            AnnouncementModel["Announcement Model"]:::backend
            BadgeReceivedModel["Badges Received Model"]:::backend
        end
    end

    %% External Services
    Vercel["Vercel Hosting"]:::external
    PocketbaseDB[(Pocketbase DB)]:::database

    %% Relationships
    Login --> AuthAPI
    Events --> EventsAPI
    Badges --> BadgesAPI
    
    AuthAPI --> PBClient
    EventsAPI --> PBClient
    BadgesAPI --> PBClient
    AnnouncementsAPI --> PBClient
    
    PBClient --> PocketbaseDB
    
    Frontend --> Middleware
    Middleware --> APILayer
    
    PocketbaseServices --> PocketbaseDB
    DataModels --> PocketbaseServices

    %% Click Events
    click Login "https://github.com/TriveTribe/TriveTribe/blob/main/src/app/login/page.tsx"
    click Events "https://github.com/TriveTribe/TriveTribe/blob/main/src/app/events/page.tsx"
    click Badges "https://github.com/TriveTribe/TriveTribe/blob/main/src/app/badges/page.tsx"
    click Settings "https://github.com/TriveTribe/TriveTribe/blob/main/src/app/settings/page.tsx"
    click History "https://github.com/TriveTribe/TriveTribe/blob/main/src/app/history/page.tsx"
    
    click BadgeComps "https://github.com/TriveTribe/TriveTribe/tree/main/src/components/badgeComponents/"
    click EventComps "https://github.com/TriveTribe/TriveTribe/tree/main/src/components/eventComponents/"
    click FormComps "https://github.com/TriveTribe/TriveTribe/tree/main/src/components/formComponents/"
    click LoginComps "https://github.com/TriveTribe/TriveTribe/tree/main/src/components/loginComponents/"
    click GenComps "https://github.com/TriveTribe/TriveTribe/tree/main/src/components/generalComponents/"
    
    click AuthAPI "https://github.com/TriveTribe/TriveTribe/blob/main/src/app/api/auth/login/route.ts"
    click EventsAPI "https://github.com/TriveTribe/TriveTribe/blob/main/src/app/api/events/route.ts"
    click BadgesAPI "https://github.com/TriveTribe/TriveTribe/blob/main/src/app/api/badges/route.ts"
    click AnnouncementsAPI "https://github.com/TriveTribe/TriveTribe/blob/main/src/app/api/announcements/route.ts"
    
    click UserMgmt "https://github.com/TriveTribe/TriveTribe/tree/main/src/utils/pocketbase/auth/"
    click EventMgmt "https://github.com/TriveTribe/TriveTribe/tree/main/src/utils/pocketbase/events/"
    click BadgeMgmt "https://github.com/TriveTribe/TriveTribe/tree/main/src/utils/pocketbase/badges/"
    click AnnouncementMgmt "https://github.com/TriveTribe/TriveTribe/tree/main/src/utils/pocketbase/announcements/"
    click BadgeTrackMgmt "https://github.com/TriveTribe/TriveTribe/tree/main/src/utils/pocketbase/badgesReceived/"
    
    click UserModel "https://github.com/TriveTribe/TriveTribe/blob/main/src/models/userModel.ts"
    click EventModel "https://github.com/TriveTribe/TriveTribe/blob/main/src/models/eventModel.ts"
    click BadgeModel "https://github.com/TriveTribe/TriveTribe/blob/main/src/models/badgeModel.ts"
    click AnnouncementModel "https://github.com/TriveTribe/TriveTribe/blob/main/src/models/announcementModel.ts"
    click BadgeReceivedModel "https://github.com/TriveTribe/TriveTribe/blob/main/src/models/badgesReceivedModel.ts"
    
    click Actions "https://github.com/TriveTribe/TriveTribe/blob/main/src/app/actions.ts"
    click Middleware "https://github.com/TriveTribe/TriveTribe/blob/main/src/middleware.ts"
    click PBClient "https://github.com/TriveTribe/TriveTribe/blob/main/src/utils/pocketbase/client.ts"
```
