# shua24/penicillisolver architecture

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

- Interactive diagram: https://gitdiagram.com/shua24/penicillisolver
- Repository: https://github.com/shua24/penicillisolver

## Overview

##### Main Components

Frontend Layer:
- Next.js Application (src/app directory)
- Client-side Routes/Pages (beranda, login, daftar, etc.)
- Static Assets (public directory)

Backend Services:
- Firebase Services
- Authentication
- Firestore Database
- Cloud Functions
- Storage
- Laravel Upload Service (uploads directory)
- File Processing
- Database Operations
- API Endpoints

Data Layer:
- Firestore Collections
- Laravel Database (MySQL/PostgreSQL)
- File Storage Systems

##### Component Relationships

**[Client Browser] ←→ [Next.js Frontend]**
- ↓
**[Next.js Frontend] ←→ [Firebase Services]**
- ↓
**[Next.js Frontend] ←→ [Laravel Upload Service]**

##### Specific Implementation Details

Frontend (Next.js):
- Use a rectangle with rounded corners to represent the Next.js application
- Sub-components for:
- Authentication flows (login, daftar, verifikasi-user)
- Main application features (beranda, hakAkses, tabel)
- Data visualization (querykuman)

Firebase Services:
- Sub-components for:
- Authentication service
- Firestore database
- Cloud Functions
- Storage rules

Laravel Upload Service:
- Sub-components for:
- File upload handling
- Excel processing
- API endpoints

##### Important Elements to Highlight

Security Layer:
- Firebase Authentication flow
- Firestore security rules
- Laravel authentication middleware

Data Flow:
- User authentication paths
- File upload processes
- Data query operations

**[Client Layer]**
- ↓
**[Application Layer]**
- ↓
**[Services Layer]**
- ↓
**[Data Layer]**

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Web Browser"]
    end

    subgraph "Next.js Frontend"
        NextApp["Next.js Application"]:::frontend
        click NextApp "https://github.com/shua24/penicillisolver/tree/main/src/app"
        
        subgraph "Authentication"
            Login["Login Page"]:::frontend
            Register["Registration Page"]:::frontend
            Verify["User Verification"]:::frontend
            click Login "https://github.com/shua24/penicillisolver/tree/main/src/app/login"
            click Register "https://github.com/shua24/penicillisolver/tree/main/src/app/daftar"
            click Verify "https://github.com/shua24/penicillisolver/tree/main/src/app/verifikasi-user"
        end

        subgraph "Main Features"
            Dashboard["Dashboard"]:::frontend
            Access["Access Control"]:::frontend
            Tables["Data Tables"]:::frontend
            Query["Bacteria Query"]:::frontend
            click Dashboard "https://github.com/shua24/penicillisolver/tree/main/src/app/beranda"
            click Access "https://github.com/shua24/penicillisolver/tree/main/src/app/hakAkses"
            click Tables "https://github.com/shua24/penicillisolver/tree/main/src/app/tabel"
            click Query "https://github.com/shua24/penicillisolver/tree/main/src/app/querykuman"
        end
    end

    subgraph "Firebase Services"
        Firebase["Firebase Core"]:::firebase
        click Firebase "https://github.com/shua24/penicillisolver/blob/main/firebase.json"
        
        Auth["Authentication"]:::firebase
        Firestore["Firestore Database"]:::firebase
        click Firestore "https://github.com/shua24/penicillisolver/blob/main/firestore.rules"
        Storage["Cloud Storage"]:::firebase
        click Storage "https://github.com/shua24/penicillisolver/blob/main/storage.rules"
        Functions["Cloud Functions"]:::firebase
        click Functions "https://github.com/shua24/penicillisolver/blob/main/functions/index.js"
    end

    subgraph "Laravel Upload Service"
        Laravel["Laravel Core"]:::laravel
        
        UploadController["File Upload Controller"]:::laravel
        click UploadController "https://github.com/shua24/penicillisolver/blob/main/uploads/app/Http/Controllers/FileUploadController.php"
        
        ExcelProcessor["Excel Processing"]:::laravel
        click ExcelProcessor "https://github.com/shua24/penicillisolver/blob/main/uploads/app/Http/Controllers/ExcelController.php"
        
        APIRoutes["API Routes"]:::laravel
        click APIRoutes "https://github.com/shua24/penicillisolver/blob/main/uploads/routes/api.php"
        
        WebRoutes["Web Routes"]:::laravel
        click WebRoutes "https://github.com/shua24/penicillisolver/blob/main/uploads/routes/web.php"
        
        Models["Database Models"]:::laravel
        click Models "https://github.com/shua24/penicillisolver/tree/main/uploads/app/Models"
    end

    subgraph "Data Layer"
        FirestoreDB[("Firestore Collections")]:::database
        click FirestoreDB "https://github.com/shua24/penicillisolver/blob/main/firestore.indexes.json"
        
        LaravelDB[("Laravel Database")]:::database
        click LaravelDB "https://github.com/shua24/penicillisolver/blob/main/uploads/config/database.php"
        
        FileStorage[("File Storage")]:::database
        click FileStorage "https://github.com/shua24/penicillisolver/tree/main/uploads/storage"
    end

    Browser --> NextApp
    NextApp --> Login & Register & Verify
    NextApp --> Dashboard & Access & Tables & Query
    
    Login & Register & Verify --> Auth
    NextApp --> Firestore
    NextApp --> Storage
    NextApp --> Functions
    
    NextApp --> UploadController
    UploadController --> ExcelProcessor
    UploadController --> APIRoutes
    UploadController --> WebRoutes
    
    Firestore --> FirestoreDB
    Laravel --> LaravelDB
    Storage --> FileStorage
    
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef firebase fill:#ff9800,stroke:#f57c00,color:white
    classDef laravel fill:#4caf50,stroke:#388e3c,color:white
    classDef database fill:#9c27b0,stroke:#7b1fa2,color:white

    %% Legend
    subgraph Legend
        Frontend["Frontend Component"]:::frontend
        FirebaseComp["Firebase Component"]:::firebase
        LaravelComp["Laravel Component"]:::laravel
        DataStore["Data Store"]:::database
    end
```
