# zdenkolini/elysia-starter architecture

> Architecture diagram of the GitHub repository zdenkolini/elysia-starter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zdenkolini/elysia-starter
- Repository: https://github.com/zdenkolini/elysia-starter

## Overview

##### Main Components

a) API Layer:
- ElysiaJS Web Server
- API Endpoints (particularly the employee module)
- Middleware Components (CORS, JWT, Bearer, Logger)
- Swagger Documentation Interface

b) Service Layer:
- Employee Service Module
- Query Building System

c) Data Layer:
- PostgreSQL Database
- Drizzle ORM
- Database Schema

**┌─────────────────┐**
- Client Apps   │
- ┬────────┘

**┌────────▼────────┐**
- API Layer     │
- (ElysiaJS)    │
- ┬────────┘

**┌────────▼────────┐**
- Service Layer   │
- ┬────────┘

**┌────────▼────────┐**
- Data Layer    │
- ┘

##### Detailed Component Breakdown

a) API Layer (Top):
- Employee-router.ts endpoint

b) Service Layer (Middle):
- Query building system (from src/lib/query)
- How the query builder connects to both service and data layers

c) Data Layer (Bottom):
- PostgreSQL database
- Drizzle ORM interface
- Schema.ts structure

##### Important Relationships

- HTTP requests flowing from top to bottom
- Database queries flowing from services to data layer
- Query builder utility usage across services

##### Additional Elements

- Configuration components (drizzle.config.ts)
- Utility functions (timestamps.ts)
- Query building system components

##### Technical Details to Highlight

- ┌─────────────────────────┐
- ElysiaJS Server     │
- ┌─────────────────┐   │
- CORS  │  JWT   │   │
- Swagger│ Logger │   │
- ┘   │
- ┬──────────────┘

- ┌──────────▼──────────────┐
- Employee Module      │
- ┌────────────────────┐  │
- Query Builder    │  │
- ┘  │
- ┬──────────────┘

- ┌──────────▼──────────────┐
- Drizzle ORM        │
- PostgreSQL DB       │
- ┘

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client
        C[Client Applications]
    end

    subgraph API
        WS["ElysiaJS Web Server"]:::server
        EP["Employee API Endpoints"]:::api
        SW["Swagger Documentation"]:::util
        MW["Middleware (CORS, JWT, Bearer, Logger)"]:::util
    end

    subgraph Service
        ES["Employee Service"]:::service
        QB["Query Builder"]:::util
        QC["SQL Query Config"]:::util
        QF["Query Filters Schema"]:::util
    end

    subgraph Data
        DR["Drizzle ORM"]:::db
        PG[("PostgreSQL Database")]:::db
        SC["Database Schema"]:::db
        DC["Database Connection"]:::db
        TU["Timestamp Utilities"]:::util
        DBC["Database Config"]:::db
    end

    C --> WS
    WS --> EP
    WS --> SW
    WS --> MW
    
    EP --> ES
    ES --> QB
    QB --> QC
    QB --> QF
    
    ES --> DR
    DR --> DC
    DC --> PG
    DR --> SC
    SC --> TU
    DR --> DBC

    %% Click Events
    click WS "https://github.com/zdenkolini/elysia-starter/blob/main/src/index.ts"
    click EP "https://github.com/zdenkolini/elysia-starter/blob/main/src/module/employee/employee-router.ts"
    click ES "https://github.com/zdenkolini/elysia-starter/blob/main/src/module/employee/employee-service.ts"
    click QB "https://github.com/zdenkolini/elysia-starter/blob/main/src/lib/query/buildQuery.ts"
    click QC "https://github.com/zdenkolini/elysia-starter/blob/main/src/lib/query/buildSQLQueryConfig.ts"
    click QF "https://github.com/zdenkolini/elysia-starter/blob/main/src/lib/query/filtersWithQuerySchema.ts"
    click SC "https://github.com/zdenkolini/elysia-starter/blob/main/src/db/schema.ts"
    click DC "https://github.com/zdenkolini/elysia-starter/blob/main/src/db/index.ts"
    click DBC "https://github.com/zdenkolini/elysia-starter/blob/main/drizzle.config.ts"
    click TU "https://github.com/zdenkolini/elysia-starter/blob/main/src/db/timestamps.ts"

    %% Styles
    classDef server fill:#1E88E5,stroke:#0D47A1,color:white
    classDef api fill:#42A5F5,stroke:#1976D2,color:white
    classDef service fill:#4CAF50,stroke:#2E7D32,color:white
    classDef util fill:#90A4AE,stroke:#546E7A,color:white
    classDef db fill:#FF7043,stroke:#E64A19,color:white

    %% Legend
    subgraph Legend
        L1["API Component"]:::api
        L2["Service Component"]:::service
        L3["Database Component"]:::db
        L4["Utility Component"]:::util
    end
```
