# necroanubis/skilledguard architecture

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

- Interactive diagram: https://gitdiagram.com/necroanubis/skilledguard
- Repository: https://github.com/necroanubis/skilledguard

## Overview

##### Project type and purpose
- This is a full-stack web application called “Skilled Guard,” designed to automate the registration and control of technological equipment within an organization.
- Frontend for users and security staff, a backend REST API, encrypted relational database, QR code scanning, PDF/Excel reporting.

##### File structure
- Top-level folders:
- Base_de_Datos – database scripts, schema definitions, seed data.
- CódigoBackend – Java/Spring Boot application, controllers, services, repositories.
- CódigoForntend – modern JavaScript SPA (React/Angular/Vue placeholder).
- Documentación – design docs, API specs, UML, user guides.
- Each module has its own README explaining setup, dependencies, build steps.

##### README for architectural insights
- Backend: Java 17+, Spring Boot 3, Spring Security (JWT), layered MVC.
- Database: MySQL with encrypted fields, migration scripts in Base_de_Datos.
- Frontend: a component-based SPA, communicates via JSON over HTTPS.
- Core features: user/role management, device registration, QR-based check-in/out, activity history, report generation.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Frontend Layer"
        FrontendModule["Frontend SPA\n(CódigoForntend/)"]:::frontend
    end

    subgraph "Backend Stack"
        BackendModule["Backend REST API\n(CódigoBackend/)"]:::backend

        subgraph "Presentation (Controllers)"
            Controllers["REST Controllers"]:::backend
        end
        subgraph "Business (Services & Security)"
            Services["Services & Security"]:::backend
        end
        subgraph "Data (Repositories)"
            Repos["Repositories (ORM)"]:::backend
        end
    end

    DBscripts["Database Scripts & Schema\n(Base_de_Datos/)"]:::database
    Database["MySQL Database\n(Encrypted)"]:::database

    Reporting["Reporting Engine\n(PDF/Excel)"]:::external
    QRLib["QR Code Library"]:::external
    Email["SMTP/Email Service"]:::external
    ExtAuth["External Auth Service\n(Optional)"]:::external

    DocModule["Project Documentation\n(Documentación/)"]:::external
    RootReadme["Project Overview & Setup\n(README.md)"]:::external

    BDRM["Base_de_Datos README"]:::external
    BackendRM["CódigoBackend README"]:::external
    FrontendRM["CódigoForntend README"]:::external

    FrontendModule -->|HTTPS/JSON| Controllers
    Controllers -->|invoke| Services
    Services -->|ORM/JDBC| Repos
    Repos -->|SQL| Database
    DBscripts -->|migrations| Database
    Services -->|generate| Reporting
    Services -->|use| QRLib
    Services -->|send| Email
    Controllers -->|auth request| ExtAuth

    RootReadme --- DocModule
    DocModule --- BDRM
    DocModule --- BackendRM
    DocModule --- FrontendRM

    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef backend fill:#90EE90,stroke:#333,stroke-width:1px
    classDef database fill:#FFA500,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px

    click DBscripts "https://github.com/necroanubis/skilledguard/tree/main/Base_de_Datos/"
    click FrontendModule "https://github.com/necroanubis/skilledguard/tree/main/CódigoForntend/"
    click BackendModule "https://github.com/necroanubis/skilledguard/tree/main/CódigoBackend/"
    click DocModule "https://github.com/necroanubis/skilledguard/tree/main/Documentación/"
    click RootReadme "https://github.com/necroanubis/skilledguard/blob/main/README.md"
    click BDRM "https://github.com/necroanubis/skilledguard/blob/main/Base_de_Datos/README.txt"
    click BackendRM "https://github.com/necroanubis/skilledguard/blob/main/CódigoBackend/README.txt"
    click FrontendRM "https://github.com/necroanubis/skilledguard/blob/main/CódigoForntend/README.txt"
```
