# pnetlab/pnetlab_main architecture

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

- Interactive diagram: https://gitdiagram.com/pnetlab/pnetlab_main
- Repository: https://github.com/pnetlab/pnetlab_main

## Overview

##### High-Level Architecture Components

a. Core System Layers:
- Frontend Layer (React-based UI)
- Backend Layer (Dual architecture: Legacy API + Laravel)
- Device Management Layer
- Storage Layer

b. Key Subsystems:
- Authentication System
- Lab Management System
- Device Emulation System
- Template Management System
- Configuration Management

##### Detailed Component Breakdown

a. Frontend Components:
- React Application (/store/resources/react)
- Theme System (/themes)
- Admin Interface
- Lab Interface
- Device Configuration Interface

b. Backend Services:
- Legacy API Controller (api.php)
- Laravel API Controllers (/store/app/Http/Controllers)
- Device Controllers
- Authentication Service
- Template Service

c. Device Management:
- QEMU Devices
- IOL Devices
- Docker Devices
- Dynamips Devices
- VPCS Devices

##### Data Flow Representation

Interactions between:
- User Interface → API Layer
- API Layer → Device Management
- Template System → Device Configuration
- Configuration Storage → Device Execution

##### Integration Points

Highlight:
- Template Integration
- Device Driver Integration
- Console Access Methods
- Storage System Integration

##### Key Design Elements

Use these visual elements:

##### Specific Implementation Details

Include:
- Template file location (/templates)
- Device implementation files (/devices)
- Configuration storage paths
- API endpoints structure

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Define styles
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef backend fill:#2ecc71,stroke:#27ae60,color:white
    classDef device fill:#e67e22,stroke:#d35400,color:white
    classDef storage fill:#f1c40f,stroke:#f39c12,color:black
    classDef auth fill:#9b59b6,stroke:#8e44ad,color:white
    classDef management fill:#1abc9c,stroke:#16a085,color:white

    %% Frontend Layer
    subgraph Frontend
        UI[React Application]:::frontend
        AdminUI[Admin Interface]:::frontend
        LabUI[Lab Interface]:::frontend
        DeviceUI[Device Config Interface]:::frontend
    end
    click UI "https://github.com/pnetlab/pnetlab_main/tree/main/store/resources/react"

    %% Backend Layer
    subgraph Backend
        LegacyAPI[Legacy API]:::backend
        LaravelAPI[Laravel API]:::backend
        AuthService[Authentication Service]:::auth
        TemplateService[Template Service]:::management
    end
    click LegacyAPI "https://github.com/pnetlab/pnetlab_main/blob/main/api.php"
    click LaravelAPI "https://github.com/pnetlab/pnetlab_main/tree/main/store/app/Http/Controllers"
    click AuthService "https://github.com/pnetlab/pnetlab_main/tree/main/store/app/Http/Controllers/Auth"
    click TemplateService "https://github.com/pnetlab/pnetlab_main/tree/main/templates"

    %% Device Management Layer
    subgraph DeviceManagement
        DeviceController[Device Controller]:::device
        QEMU[QEMU Devices]:::device
        IOL[IOL Devices]:::device
        Docker[Docker Devices]:::device
        Dynamips[Dynamips Devices]:::device
        VPCS[VPCS Devices]:::device
    end
    click DeviceController "https://github.com/pnetlab/pnetlab_main/blob/main/devices/device.php"
    click QEMU "https://github.com/pnetlab/pnetlab_main/tree/main/devices/qemu"
    click IOL "https://github.com/pnetlab/pnetlab_main/tree/main/devices/iol"
    click Dynamips "https://github.com/pnetlab/pnetlab_main/tree/main/devices/dynamips"
    click VPCS "https://github.com/pnetlab/pnetlab_main/tree/main/devices/vpcs"

    %% Lab Management Layer
    subgraph LabManagement
        LabController[Lab Controller]:::management
        SessionController[Session Controller]:::management
        LabModel[Lab Model]:::management
    end
    click LabController "https://github.com/pnetlab/pnetlab_main/blob/main/store/app/Http/Controllers/Admin/LabsController.php"
    click SessionController "https://github.com/pnetlab/pnetlab_main/blob/main/store/app/Http/Controllers/Admin/Lab_sessionsController.php"
    click LabModel "https://github.com/pnetlab/pnetlab_main/blob/main/store/app/Model/Admin/Lab_sessions.php"

    %% Configuration Layer
    subgraph Configuration
        ConfigManager[Configuration Manager]:::storage
        Templates[Templates]:::storage
    end
    click ConfigManager "https://github.com/pnetlab/pnetlab_main/tree/main/configs"
    click Templates "https://github.com/pnetlab/pnetlab_main/tree/main/templates"

    %% Connections
    UI --> LegacyAPI & LaravelAPI
    AdminUI & LabUI & DeviceUI --> LaravelAPI
    LaravelAPI --> AuthService
    LaravelAPI --> LabController
    LabController --> SessionController
    SessionController --> LabModel
    LaravelAPI --> DeviceController
    DeviceController --> QEMU & IOL & Docker & Dynamips & VPCS
    DeviceController --> ConfigManager
    TemplateService --> Templates
    Templates --> DeviceController

    %% Legend
    subgraph Legend
        Frontend_L[Frontend Components]:::frontend
        Backend_L[Backend Services]:::backend
        Device_L[Device Components]:::device
        Storage_L[Storage Components]:::storage
        Auth_L[Authentication]:::auth
        Management_L[Management Services]:::management
    end
```
