# lampspace/swarm-drones-web-system architecture

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

- Interactive diagram: https://gitdiagram.com/lampspace/swarm-drones-web-system
- Repository: https://github.com/lampspace/swarm-drones-web-system

## Overview

##### Project type and purpose
- This is a full-stack web application called “Swarm Drone Websystem.”
- Frontend: Next.js (React)
- Backend: Laravel (PHP)
- Purpose: control and monitor a swarm of drones via a web UI, communicate with drones (ROS), persist data in a database, expose REST APIs for CRUD operations on users, swarms, missions.

##### File structure
- Top-level folders:
- api/ → Laravel application (app/, config/, routes/, resources/, tests/, Dockerfile, .env)
- frontend/ → Next.js app (pages/, components/, services/, assets/, Dockerfile, .env)
- nginx/ → reverse proxy configuration
- docker-compose.yml → orchestrates nginx, api, frontend, database
- The Laravel “app/Services” and “app/Models” directories point to a service-layer and MVC pattern.
- The Next.js folder contains pages/ (SSR/SSG routes), components/, hooks/ (including a ros.js hook for WebSocket to ROS).
- Infrastructure concerns (Dockerfiles, compose, nginx) Live at the root and in each service directory.

##### README for additional insights
- Indicates Docker Compose hosts: drones.svute.test → frontend, api-drones.svute.test → API.
- Uses Laravel Sanctum for auth, likely a MySQL container, maybe Redis for queues/caching (check docker-compose.yml).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Browser
    Browser["User's Browser"]

    %% Infrastructure Layer
    Nginx["nginx Reverse Proxy"]:::infra
    Orchestration["Docker Compose Network"]:::infra

    %% Containers
    subgraph "Containers"
        direction TB
        Frontend["Next.js Frontend"]:::ui
        API["Laravel API"]:::backend
        MySQL["MySQL Database"]:::data
        Redis["Redis Cache/Queue"]:::data
    end

    %% External Services
    ROS["ROS Bridge (WebSocket)"]:::external

    %% Connections
    Browser -->|HTTPS| Nginx
    Nginx -->|routes to UI| Frontend
    Nginx -->|routes to API| API
    Frontend -->|REST API Calls| API
    API -->|SQL Queries| MySQL
    API -->|Cache/Queue Calls| Redis
    Frontend <-->|WebSocket| ROS

    %% Click Events - Infrastructure
    click Nginx "https://github.com/lampspace/swarm-drones-web-system/blob/master/nginx/nginx.conf.example"
    click Orchestration "https://github.com/lampspace/swarm-drones-web-system/blob/master/docker-compose.yml"

    %% Click Events - Frontend
    click Frontend "https://github.com/lampspace/swarm-drones-web-system/tree/master/frontend/"
    click Pages "https://github.com/lampspace/swarm-drones-web-system/tree/master/frontend/pages/"
    click Components "https://github.com/lampspace/swarm-drones-web-system/tree/master/frontend/components/"
    click ROSHook "https://github.com/lampspace/swarm-drones-web-system/blob/master/frontend/hooks/ros.js"
    click AuthHook "https://github.com/lampspace/swarm-drones-web-system/blob/master/frontend/hooks/auth.js"
    click Axios "https://github.com/lampspace/swarm-drones-web-system/blob/master/frontend/lib/axios.js"
    click UsersService "https://github.com/lampspace/swarm-drones-web-system/blob/master/frontend/services/users.js"
    click SwarmsService "https://github.com/lampspace/swarm-drones-web-system/blob/master/frontend/services/swarms.js"
    click MissionsService "https://github.com/lampspace/swarm-drones-web-system/blob/master/frontend/services/missions.js"

    %% Click Events - Backend API
    click API "https://github.com/lampspace/swarm-drones-web-system/tree/master/api/"
    click AuthController "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Http/Controllers/AuthController.php"
    click UserController "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Http/Controllers/UserController.php"
    click SwarmController "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Http/Controllers/SwarmController.php"
    click MissionController "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Http/Controllers/PlannerMissionController.php"
    click AuthService "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Services/AuthService.php"
    click UserService "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Services/UserService.php"
    click SwarmService "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Services/SwarmService.php"
    click MissionService "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Services/PlannerMissionService.php"
    click UserModel "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Models/User.php"
    click SwarmModel "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Models/Swarm.php"
    click MissionModel "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Models/PlannerMission.php"
    click APIRoutes "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/routes/api.php"
    click AuthRoutes "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/routes/auth.php"
    click MiddlewareAuth "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Http/Middleware/Authenticate.php"
    click MiddlewareCsrf "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/app/Http/Middleware/VerifyCsrfToken.php"
    click Migrations "https://github.com/lampspace/swarm-drones-web-system/tree/master/api/database/migrations/"
    click Seeder "https://github.com/lampspace/swarm-drones-web-system/blob/master/api/database/seeders/UserSeeder.php"

    %% Styles
    classDef ui fill:#ccf,stroke:#000,color:#000
    classDef backend fill:#cfc,stroke:#000,color:#000
    classDef infra fill:#fcf,stroke:#000,color:#000
    classDef data fill:#ffc,stroke:#000,color:#000
    classDef external fill:#ecf,stroke:#000,color:#000

    %% Assign classes
    class Frontend ui
    class API backend
    class MySQL data
    class Redis data
    class Nginx,Orchestration infra
    class ROS external

    %% Additional nodes for click targets
    Pages["Pages Directory"]:::ui
    Components["Components Directory"]:::ui
    ROSHook["ROS WebSocket Hook"]:::ui
    AuthHook["Auth Hook"]:::ui
    Axios["Axios HTTP Client"]:::ui
    UsersService["Users Service"]:::ui
    SwarmsService["Swarms Service"]:::ui
    MissionsService["Missions Service"]:::ui

    AuthController["AuthController.php"]:::backend
    UserController["UserController.php"]:::backend
    SwarmController["SwarmController.php"]:::backend
    MissionController["PlannerMissionController.php"]:::backend
    AuthService["AuthService.php"]:::backend
    UserService["UserService.php"]:::backend
    SwarmService["SwarmService.php"]:::backend
    MissionService["PlannerMissionService.php"]:::backend
    UserModel["User.php"]:::data
    SwarmModel["Swarm.php"]:::data
    MissionModel["PlannerMission.php"]:::data
    APIRoutes["api.php"]:::backend
    AuthRoutes["auth.php"]:::backend
    MiddlewareAuth["Authenticate.php"]:::backend
    MiddlewareCsrf["VerifyCsrfToken.php"]:::backend
    Migrations["Migrations Directory"]:::backend
    Seeder["UserSeeder.php"]:::backend

    %% Connections for directory nodes
    Frontend --> Pages
    Frontend --> Components
    Frontend --> ROSHook
    Frontend --> AuthHook
    Frontend --> Axios
    Frontend --> UsersService
    Frontend --> SwarmsService
    Frontend --> MissionsService

    API --> AuthController
    API --> UserController
    API --> SwarmController
    API --> MissionController
    API --> AuthService
    API --> UserService
    API --> SwarmService
    API --> MissionService
    API --> UserModel
    API --> SwarmModel
    API --> MissionModel
    API --> APIRoutes
    API --> AuthRoutes
    API --> MiddlewareAuth
    API --> MiddlewareCsrf
    API --> Migrations
    API --> Seeder
```
