# williamrolando88/scientech-private architecture

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

- Interactive diagram: https://gitdiagram.com/williamrolando88/scientech-private
- Repository: https://github.com/williamrolando88/scientech-private

## Overview

##### Main System Components

a) Frontend Layer:
- Next.js Application (src/pages)
- Component Structure
- Dashboard Components
- Auth Components
- Shared Components
- Theme System (src/lib/theme)

b) Core Business Logic Layer:
- Modules (src/lib/modules)
- Balance Calculator
- Document Parser
- Import Calculator
- Double Entry Accounting

c) Service Layer:
- Firebase Services
- Authentication
- Firestore Database
- Custom Services (src/services)

d) Data Layer:
- Types and Schemas (src/types, src/lib/schemas)
- Constants and Enums

##### Component Relationships

Key interactions:

**Client Browser → Next.js Pages → Components → Services → Firebase**
- ↓
- Business Logic
- ↓
- Data Layer

##### Specific Implementation Details

Crucial elements:

a) Authentication Flow:
- Login Component → AuthGuard → Firebase Auth
- RoleBasedGuard for permissions

b) Data Flow:
- Firestore Collections
- Cache Hooks (src/hooks/cache)
- Query Management

##### Key Subsystems to Highlight

a) Dashboard Modules:
- Import Calculator
- Document Parser
- Balance Calculator
- Sales/Purchases Management

b) Authentication System:
- Guards
- Role Management
- Firebase Integration

##### Integration Points

Connections:

- Firebase Configuration
- API Endpoints
- External Service Integration

##### Development Environment

Configuration elements:

- Environment Variables
- Build Process
- Deployment Flow

This will provide a clear understanding of the system's architecture while maintaining enough detail for implementation guidance.

## Diagram (Mermaid)

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

    subgraph "Frontend Layer"
        NextPages["Next.js Pages"]:::frontend
        DashComps["Dashboard Components"]:::frontend
        AuthComps["Auth Components"]:::frontend
        SharedComps["Shared Components"]:::frontend
        ThemeSystem["Theme System"]:::frontend
    end

    subgraph "Core Business Logic"
        BalanceCalc["Balance Calculator"]:::logic
        DocParser["Document Parser"]:::logic
        ImportCalc["Import Calculator"]:::logic
        DoubleEntry["Double Entry Accounting"]:::logic
    end

    subgraph "Service Layer"
        FirebaseAuth["Firebase Authentication"]:::service
        FirestoreDB["Firestore Database"]:::service
        CustomServices["Custom Services"]:::service
    end

    subgraph "Data Layer"
        Types["Types & Interfaces"]:::data
        Schemas["Data Schemas"]:::data
        Constants["Constants"]:::data
        Enums["Enums"]:::data
    end

    subgraph "Infrastructure"
        Cache["Cache Management"]:::infra
        Routes["Route Management"]:::infra
        FirebaseConfig["Firebase Configuration"]:::infra
    end

    %% Relationships
    Browser --> NextPages
    NextPages --> DashComps
    NextPages --> AuthComps
    NextPages --> SharedComps
    
    DashComps & AuthComps & SharedComps --> ThemeSystem
    DashComps --> BalanceCalc
    DashComps --> DocParser
    DashComps --> ImportCalc
    DashComps --> DoubleEntry
    
    AuthComps --> FirebaseAuth
    
    BalanceCalc & DocParser & ImportCalc & DoubleEntry --> CustomServices
    CustomServices --> FirestoreDB
    FirebaseAuth --> FirestoreDB
    
    CustomServices --> Cache
    
    Types & Schemas & Constants & Enums --> CustomServices
    
    FirebaseAuth & FirestoreDB --> FirebaseConfig
    NextPages --> Routes

    %% Click Events
    click NextPages "https://github.com/williamrolando88/scientech-private/tree/main/src/pages/"
    click DashComps "https://github.com/williamrolando88/scientech-private/tree/main/src/components/dashboard/"
    click AuthComps "https://github.com/williamrolando88/scientech-private/tree/main/src/components/auth/"
    click SharedComps "https://github.com/williamrolando88/scientech-private/tree/main/src/components/shared/"
    click ThemeSystem "https://github.com/williamrolando88/scientech-private/tree/main/src/lib/theme/"
    click BalanceCalc "https://github.com/williamrolando88/scientech-private/blob/main/src/lib/modules/balanceCalculator.ts"
    click DocParser "https://github.com/williamrolando88/scientech-private/tree/main/src/lib/modules/documentParser/"
    click ImportCalc "https://github.com/williamrolando88/scientech-private/blob/main/src/lib/modules/importCalculator.ts"
    click DoubleEntry "https://github.com/williamrolando88/scientech-private/blob/main/src/lib/modules/doubleEntryAccounting.ts"
    click FirestoreDB "https://github.com/williamrolando88/scientech-private/tree/main/src/services/firestore/"
    click FirebaseAuth "https://github.com/williamrolando88/scientech-private/tree/main/src/services/auth/"
    click CustomServices "https://github.com/williamrolando88/scientech-private/tree/main/src/services/"
    click Types "https://github.com/williamrolando88/scientech-private/tree/main/src/types/"
    click Schemas "https://github.com/williamrolando88/scientech-private/tree/main/src/lib/schemas/"
    click Constants "https://github.com/williamrolando88/scientech-private/tree/main/src/lib/constants/"
    click Enums "https://github.com/williamrolando88/scientech-private/tree/main/src/lib/enums/"
    click Cache "https://github.com/williamrolando88/scientech-private/tree/main/src/hooks/cache/"
    click Routes "https://github.com/williamrolando88/scientech-private/tree/main/src/routes/"
    click FirebaseConfig "https://github.com/williamrolando88/scientech-private/blob/main/src/settings/firebase.ts"

    %% Styles
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef logic fill:#2ecc71,stroke:#27ae60,color:white
    classDef service fill:#f1c40f,stroke:#f39c12,color:black
    classDef data fill:#e74c3c,stroke:#c0392b,color:white
    classDef infra fill:#9b59b6,stroke:#8e44ad,color:white

    %% Legend
    subgraph Legend
        Frontend["Frontend Component"]:::frontend
        Logic["Business Logic"]:::logic
        Service["Service Component"]:::service
        Data["Data Component"]:::data
        Infrastructure["Infrastructure"]:::infra
    end
```
