# kaffe-diem/kaffediem architecture

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

- Interactive diagram: https://gitdiagram.com/kaffe-diem/kaffediem
- Repository: https://github.com/kaffe-diem/kaffediem

## Overview

##### Main Components

Frontend Layer:
- Client-side application (Svelte)
- Public facing routes (/account, /tos)
- Admin routes (/admin/orders/kitchen, /admin/orders/frontdesk)
- Routes (/display)
- Component structure (under src/lib/components)
- Store management (src/lib/stores)

Backend Layer:
- PocketBase database (indicated by pocketbase directory and configuration)
- Server-side logic (hooks.server.ts)
- API endpoints

Infrastructure:
- Firebase Hosting (indicated by .firebaserc and firebase.json)
- GitHub Actions CI/CD (.github/workflows)

**[Client Layer]**
- ↑↓
**[Application Layer]**
- ↑↓
**[Data Layer]**
- ↑↓
**[Infrastructure Layer]**

##### Component Relationships

- Frontend stores (authStore, menuStore, messageStore, orderStore) and their corresponding components
- PocketBase client (src/lib/pocketbase) and the stores
- Admin interfaces and their respective backend services
- System and order management system

##### Detailed Component Breakdown

Frontend Modules:
**[Public Routes] --- [Admin Routes] --- [Display Routes]**
- ↓               ↓                    ↓
**[Shared Components: Nav, Footer, Rating, etc.]**
- ↓
**[Stores: Auth, Menu, Message, Order]**
- ↓
**[PocketBase Client]**

Backend Services:
**[PocketBase Database]**
- ↑
**[Server Hooks]**
- ↑
**[API Layer]**

##### Additional Elements

Include:
- Environment configuration flow
- Build and deployment pipeline
- Error handling and state management
- User role separation (admin vs customer)

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        PublicRoutes["Public Routes"]
        AdminRoutes["Admin Routes"]
        DisplayRoutes["Display Routes"]
        
        subgraph Components
            NavComp["Navigation"]:::component
            AuthBtn["Auth Button"]:::component
            MenuItems["Menu Items"]:::component
        end
        
        subgraph Stores
            AuthStore["Auth Store"]:::store
            MenuStore["Menu Store"]:::store
            MessageStore["Message Store"]:::store
            OrderStore["Order Store"]:::store
            PBStore["PocketBase Store"]:::store
        end
    end
    
    subgraph Backend
        PBClient["PocketBase Client"]:::backend
        ServerHooks["Server Hooks"]:::backend
        
        subgraph OrderManagement
            Kitchen["Kitchen Interface"]:::admin
            Frontdesk["Frontdesk Interface"]:::admin
            OrderDisplay["Order Display"]:::display
        end
    end
    
    subgraph Infrastructure
        PocketBase[(PocketBase DB)]:::database
        Firebase["Firebase Hosting"]:::infra
        GitHub["GitHub Actions"]:::infra
        Docker["Docker"]:::infra
    end
    
    %% Relationships
    PublicRoutes --> NavComp
    PublicRoutes --> AuthBtn
    AdminRoutes --> OrderManagement
    DisplayRoutes --> OrderDisplay
    
    AuthBtn --> AuthStore
    MenuItems --> MenuStore
    OrderManagement --> OrderStore
    OrderManagement --> MessageStore
    
    Stores --> PBClient
    PBClient --> ServerHooks
    ServerHooks --> PocketBase
    
    OrderStore --> PocketBase
    MessageStore --> PocketBase
    
    %% Infrastructure Connections
    GitHub --> Firebase
    Docker --> PocketBase
    
    %% Click Events
    click NavComp "https://github.com/kaffe-diem/kaffediem/blob/main/src/lib/components/Nav.svelte"
    click AuthBtn "https://github.com/kaffe-diem/kaffediem/blob/main/src/lib/components/AuthButton.svelte"
    click Kitchen "https://github.com/kaffe-diem/kaffediem/blob/main/src/routes/admin/orders/kitchen/+page.svelte"
    click Frontdesk "https://github.com/kaffe-diem/kaffediem/blob/main/src/routes/admin/orders/frontdesk/+page.svelte"
    click OrderDisplay "https://github.com/kaffe-diem/kaffediem/blob/main/src/routes/display/OrderList.svelte"
    click AuthStore "https://github.com/kaffe-diem/kaffediem/blob/main/src/lib/stores/authStore.ts"
    click MenuStore "https://github.com/kaffe-diem/kaffediem/blob/main/src/lib/stores/menuStore.ts"
    click MessageStore "https://github.com/kaffe-diem/kaffediem/blob/main/src/lib/stores/messageStore.ts"
    click OrderStore "https://github.com/kaffe-diem/kaffediem/blob/main/src/lib/stores/orderStore.ts"
    click PBStore "https://github.com/kaffe-diem/kaffediem/blob/main/src/lib/stores/pbStore.ts"
    click PBClient "https://github.com/kaffe-diem/kaffediem/blob/main/src/lib/pocketbase/index.ts"
    click ServerHooks "https://github.com/kaffe-diem/kaffediem/blob/main/src/hooks.server.ts"
    click PublicRoutes "https://github.com/kaffe-diem/kaffediem/tree/main/src/routes/account/"
    click AdminRoutes "https://github.com/kaffe-diem/kaffediem/tree/main/src/routes/admin/"
    click DisplayRoutes "https://github.com/kaffe-diem/kaffediem/tree/main/src/routes/display/"
    click Components "https://github.com/kaffe-diem/kaffediem/tree/main/src/lib/components/"
    
    %% Styling
    classDef component fill:#a8d1ff,stroke:#333
    classDef store fill:#ffe0a8,stroke:#333
    classDef backend fill:#a8ffd1,stroke:#333
    classDef admin fill:#ffa8d1,stroke:#333
    classDef display fill:#d1a8ff,stroke:#333
    classDef database fill:#e0a8ff,stroke:#333
    classDef infra fill:#d1d1d1,stroke:#333
    
    %% Legend
    subgraph Legend
        L1["Frontend Component"]:::component
        L2["Store"]:::store
        L3["Backend Service"]:::backend
        L4["Admin Interface"]:::admin
        L5["Display Interface"]:::display
        L6["Database"]:::database
        L7["Infrastructure"]:::infra
    end
```
