# urosptrvc/levelup-project-tracking architecture

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

- Interactive diagram: https://gitdiagram.com/urosptrvc/levelup-project-tracking
- Repository: https://github.com/urosptrvc/levelup-project-tracking

## Overview

##### Main System Components

a) Frontend Layer:
- Next.js Client Components
- Authentication UI (Login/Register)
- Shipment Management Interface
- File Upload Interface
- Theme System (Dark/Light)

b) Backend Layer:
- Next.js API Routes
- Authentication System (NextAuth)
- File Processing Service
- Data Mapping Service

c) Database Layer:
- MySQL Database (via Prisma ORM)
- Shipment Data Storage
- User Management

##### Component Relationships

**[Client Layer] <-> [API Layer] <-> [Database Layer]**
- ↑               ↑

**[Auth Provider] <-> [Auth API]**

##### Detailed Component Breakdown

Frontend Components:
**[Pages]**
- Auth Pages (Login/Register)
- Shipment List
- Shipment Details
- Upload Interface

**[Components]**
- Navigation
- Data Tables
- Search
- UI Components

Backend Services:
**[API Routes]**
- Auth Service
- Login
- Register
- Shipment Service
- Upload
- Retrieve
- Delete

Data Flow:
**[XLSX Files] -> [Upload API] -> [Data Mapping] -> [Database]**
- ↓
- [Formatted Response]

##### Key Technical Elements to Highlight

- NextAuth Integration with Prisma
- Role-based Access Control (User/Admin)
- File Processing Pipeline
- Data Mapping System for Different Carriers

##### Integration Points

Clear integration between:
- NextAuth and Prisma
- TanStack Query for data fetching
- XLSX.js for file processing
- Tailwind CSS and Shadcn/ui components

- The role-based access control system
- The file processing pipeline for different courier services
- The data transformation and mapping logic
- The client-side state management with TanStack Query

This system design should emphasize the application's focus on secure file processing, data transformation, and role-based access control while maintaining a clean and intuitive user interface.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        FE1["Authentication UI"]
        FE2["Shipment Management"]
        FE3["File Upload Interface"]
        FE4["Theme System"]
        FE5["Navigation"]
        FE6["Data Tables"]
        FE7["Search"]
        FE8["Shipment Details"]
        FE9["UI Components"]
    end

    subgraph API
        API1["Auth API"]
        API2["File Processing"]
        API3["Data Mapping"]
        API4["Shipment API"]
    end

    subgraph Database
        DB1[("MySQL/Prisma")]
        DB2["Database Client"]
    end

    %% Client Layer Relationships
    FE1 --> API1
    FE2 --> API4
    FE3 --> API2
    FE6 --> API4
    FE7 --> API4
    FE8 --> API4

    %% API Layer Relationships
    API1 --> DB1
    API2 --> API3
    API3 --> DB1
    API4 --> DB1
    DB1 --- DB2

    %% File Processing Flow
    XLSX["XLSX Files"] --> API2
    API2 --> MAP["Data Transformation"]
    MAP --> DB1

    %% Styling
    classDef frontend fill:#3b82f6,color:#fff
    classDef api fill:#22c55e,color:#fff
    classDef database fill:#7c3aed,color:#fff
    classDef file fill:#f97316,color:#fff

    class FE1,FE2,FE3,FE4,FE5,FE6,FE7,FE8,FE9 frontend
    class API1,API2,API3,API4,MAP api
    class DB1,DB2 database
    class XLSX file

    %% Click Events
    click FE1 "https://github.com/urosptrvc/Levelup-Project-Tracking/tree/master/src/components/auth/"
    click FE2 "https://github.com/urosptrvc/Levelup-Project-Tracking/tree/master/src/app/shipments/"
    click FE3 "https://github.com/urosptrvc/Levelup-Project-Tracking/tree/master/src/app/shipments/upload/"
    click FE4 "https://github.com/urosptrvc/Levelup-Project-Tracking/blob/master/src/components/ThemeSwitcherBtn.tsx"
    click FE5 "https://github.com/urosptrvc/Levelup-Project-Tracking/blob/master/src/components/Navbar.tsx"
    click FE6 "https://github.com/urosptrvc/Levelup-Project-Tracking/tree/master/src/components/table/"
    click FE7 "https://github.com/urosptrvc/Levelup-Project-Tracking/blob/master/src/components/SearchComp.tsx"
    click FE8 "https://github.com/urosptrvc/Levelup-Project-Tracking/tree/master/src/components/shipdetails/"
    click FE9 "https://github.com/urosptrvc/Levelup-Project-Tracking/tree/master/src/components/ui/"
    click API1 "https://github.com/urosptrvc/Levelup-Project-Tracking/tree/master/src/app/api/auth/"
    click API2 "https://github.com/urosptrvc/Levelup-Project-Tracking/blob/master/src/app/api/shipments/upload/route.ts"
    click API3 "https://github.com/urosptrvc/Levelup-Project-Tracking/blob/master/src/app/utils/carrierMappings.ts"
    click API4 "https://github.com/urosptrvc/Levelup-Project-Tracking/tree/master/src/app/api/"
    click DB1 "https://github.com/urosptrvc/Levelup-Project-Tracking/blob/master/prisma/schema.prisma"
    click DB2 "https://github.com/urosptrvc/Levelup-Project-Tracking/blob/master/src/lib/prisma.ts"
```
