# santiagourdaneta/sistema-de-asistencia architecture

> Architecture diagram of the GitHub repository santiagourdaneta/sistema-de-asistencia, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/santiagourdaneta/sistema-de-asistencia
- Repository: https://github.com/santiagourdaneta/sistema-de-asistencia

## Overview

##### Project Type and Purpose
- This is a monolithic, full-stack PHP web application for attendance control (sistema_asistencia).
- Purpose: Allow small businesses to register employees and track their daily attendance (“marcados”) via a browser interface backed by a MySQL database.

##### File Structure Analysis
Top-level
- README.md, SECURITY.md, schema.sql – documentation and DB schema
- conectar.php – shared DB connection
- index.php – public entry point
- determinar_movimiento.php – likely AJAX or business logic endpoint
- css/, js/, less/, img/ – static assets and source for CSS build pipeline
- gulpfile.js, package.json – asset build (Gulp+Node)
- vendor/ – third-party PHP libraries (if any)
Admin module (/admin)
- login.php, cerrar_sesion.php, inicio_admin.php, index.php – authentication and landing pages
- /empleados – CRUD operations, photos, sub-includes (head, nav, footer, scripts)
- /marcados – attendance listing per date, with its own sub-includes
- /comunes – shared layout templates used across admin pages

##### Key Architectural Components
- Presentation layer: PHP pages + HTML templates (common head, nav, footer, scripts).
- Static asset pipeline: LESS source → Gulp task → CSS (freelancer.css) + JS libraries.
- Business logic: Procedural PHP scripts under /admin/empleados and /admin/marcados.
- Data access layer: conectar.php used by each module to communicate with MySQL.
- Data store: MySQL database (schema defined in schema.sql).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Browser
    subgraph "Client"
        Browser["Browser"]:::user
    end

    %% Build Pipeline
    subgraph "Build Pipeline"
        direction TB
        LESS["LESS Source (less/)"]:::server
        Gulp["Gulp (gulpfile.js)"]:::server
        Package["Node Config (package.json)"]:::server
        CSS["Compiled CSS (css/freelancer.css)"]:::user
        JS1["JS App (js/freelancer.js)"]:::user
        JS2["Validation Lib (js/jqBootstrapValidation.js)"]:::user
    end

    %% Web Server and Application
    subgraph "Web Server (PHP Application)"
        direction TB

        %% Public Site
        subgraph "Public Site (Presentation Layer)"
            direction TB
            Index["index.php"]:::server
            Determ["determinar_movimiento.php"]:::server
        end

        %% Admin Site
        subgraph "Admin Site"
            direction TB

            subgraph "Auth & Landing"
                Login["login.php"]:::server
                Logout["cerrar_sesion.php"]:::server
                AdminHome["inicio_admin.php"]:::server
                AdminIndex["index.php"]:::server
            end

            subgraph "Employee Module (Business Logic)"
                direction TB
                EmpIndex["index.php"]:::server
                Registrar["registrar.php"]:::server
                Edit["editar.php"]:::server
                PermsEmp["permisos.php"]:::server
                ConsultMarc["consultar_marcados.php"]:::server
                CodeReg["codigo_registrar.php"]:::server
                CodeEdit["codigo_editar.php"]:::server
                subgraph "Photos"
                    Fotos["fotos/"]:::user
                    EmpImg["img/"]:::user
                end
            end

            subgraph "Attendance Module (Marcados)"
                direction TB
                MarcIndex["index.php"]:::server
                ListMarc["listar_marcados.php"]:::server
                PermsMarc["permisos.php"]:::server
            end

            subgraph "Shared Template Includes"
                direction TB
                HeadAdmin["admin/comunes/head.php"]:::server
                NavAdmin["admin/comunes/nav.php"]:::server
                NavAdmin2["admin/comunes/nav_admin.php"]:::server
                FooterAdmin["admin/comunes/footer.php"]:::server
                ScriptsAdmin["admin/comunes/scripts.php"]:::server
                Head["comunes/head.php"]:::server
                Nav["comunes/nav.php"]:::server
                Nav2["comunes/nav_admin.php"]:::server
                Footer["comunes/footer.php"]:::server
                Scripts["comunes/scripts.php"]:::server
            end

            subgraph "Data Access Layer"
                ConectarPub["conectar.php"]:::server
                ConectarEmp["admin/empleados/conectar.php"]:::server
            end
        end

        Vendor["vendor/"]:::server
    end

    %% Database
    DB["MySQL Database"]:::db
    Schema["schema.sql"]:::server

    %% Relationships
    Browser -->|"HTTP Requests"| Index
    Browser -->|"HTTP Requests"| Determ
    Browser -->|"HTTP Requests"| Login
    Browser -->|"HTTP Requests"| EmpIndex
    Browser -->|"HTTP Requests"| MarcIndex
    Browser -->|"Fetch Assets"| CSS
    Browser -->|"Fetch Assets"| JS1
    Browser -->|"Fetch Assets"| JS2

    LESS --> Gulp
    Package --> Gulp
    Gulp --> CSS
    Gulp --> JS1

    Index --> ConectarPub
    Determ --> ConectarPub
    ConectarPub --> DB
    ConectarEmp --> DB

    Login --> ConectarPub
    Logout --> ConectarPub
    AdminHome --> ConectarPub
    AdminIndex --> ConectarPub

    EmpIndex --> ConectarEmp
    Registrar --> ConectarEmp
    Edit --> ConectarEmp
    PermsEmp --> ConectarEmp
    ConsultMarc --> ConectarEmp
    CodeReg --> ConectarEmp
    CodeEdit --> ConectarEmp

    MarcIndex --> ConectarPub
    ListMarc --> ConectarPub
    PermsMarc --> ConectarPub

    Schema --> DB

    %% Click Events
    click Index "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/index.php"
    click Determ "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/determinar_movimiento.php"
    click ConectarPub "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/conectar.php"
    click ConectarEmp "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/empleados/conectar.php"
    click Login "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/login.php"
    click Logout "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/cerrar_sesion.php"
    click AdminHome "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/inicio_admin.php"
    click AdminIndex "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/index.php"
    click EmpIndex "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/empleados/index.php"
    click Registrar "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/empleados/registrar.php"
    click Edit "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/empleados/editar.php"
    click PermsEmp "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/empleados/permisos.php"
    click ConsultMarc "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/empleados/consultar_marcados.php"
    click CodeReg "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/empleados/codigo_registrar.php"
    click CodeEdit "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/empleados/codigo_editar.php"
    click Fotos "https://github.com/santiagourdaneta/sistema-de-asistencia/tree/master/admin/empleados/fotos/"
    click EmpImg "https://github.com/santiagourdaneta/sistema-de-asistencia/tree/master/admin/empleados/img/"
    click MarcIndex "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/marcados/index.php"
    click ListMarc "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/marcados/listar_marcados.php"
    click PermsMarc "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/marcados/permisos.php"
    click HeadAdmin "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/comunes/head.php"
    click NavAdmin "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/comunes/nav.php"
    click NavAdmin2 "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/comunes/nav_admin.php"
    click FooterAdmin "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/comunes/footer.php"
    click ScriptsAdmin "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/admin/comunes/scripts.php"
    click Head "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/comunes/head.php"
    click Nav "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/comunes/nav.php"
    click Nav2 "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/comunes/nav_admin.php"
    click Footer "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/comunes/footer.php"
    click Scripts "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/comunes/scripts.php"
    click LESS "https://github.com/santiagourdaneta/sistema-de-asistencia/tree/master/less/"
    click Gulp "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/gulpfile.js"
    click Package "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/package.json"
    click CSS "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/css/freelancer.css"
    click JS1 "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/js/freelancer.js"
    click JS2 "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/js/jqBootstrapValidation.js"
    click Schema "https://github.com/santiagourdaneta/sistema-de-asistencia/blob/master/schema.sql"
    click Vendor "https://github.com/santiagourdaneta/sistema-de-asistencia/tree/master/vendor/"

    %% Styles
    classDef user fill:#e0f7e9,stroke:#2d8f4d,color:#2d8f4d;
    classDef server fill:#e3f2fd,stroke:#1976d2,color:#1976d2;
    classDef db fill:#fff3e0,stroke:#fb8c00,color:#e65100;
```
