# masterhiruma/sistema_autonomo_control_de_acceso architecture

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

- Interactive diagram: https://gitdiagram.com/masterhiruma/sistema_autonomo_control_de_acceso
- Repository: https://github.com/masterhiruma/sistema_autonomo_control_de_acceso

## Overview

##### Project type and purpose
- This is a hybrid embedded-to-PC “intelligent access control” system.
- Hardware: an Arduino handles sensors (ultrasonic, RFID, switches) and actuators (servo, LEDs).
- Software: a Python desktop application on PC/Laptop implements core logic, GUI, database, validation (RFID, QR, facial), reporting.

##### File structure
- Top-level folders:
- Prueba_ejecutable: design documents and PDFs explaining components.
- codigo_modular: production Python modules (13 .py files + data files).
- fase0_1…fase_7: historical phases of code evolution (for reference).
- v1.3: packaged release, similar structure to codigo_modular.
- Key Python modules in codigo_modular:
- arduino_comms.py – serial I/O with Arduino
- state_machine_logic.py – main state machine
- validation_logic.py – credential checks (RFID, QR, facial)
- db_manager.py – SQLite user DB interface
- config_manager.py – (future) load JSON configs
- gui_manager.py – Tkinter GUI (panels: main, user mgmt, reports)
- reporting_logging.py – daily counters, log persistence, report generation
- facial_recognition_utils.py & generar_encodings.py – face-encoding creation & matching
- buscar_camaras.py – camera detection module
- global_state.py & constants.py – shared state & static values
- main_app.py – application bootstrap and orchestration
- Data files:
- sistema_acceso.db (SQLite)
- estado_diario.json (daily counters & event logs)
- encodings_faciales.pkl (serialized face encodings)
- Config & build artifacts in v1.3:
- requirements.txt, spec files for PyInstaller packaging.

##### README for architectural insights
- Two major subsystems: Arduino (embedded) ↔ Python (desktop).
- Python subdivided into:
1. Communication layer (serial I/O)
2. State Machine layer (door logic, mode selection, emergency)
3. Validation layer (RFID, QR, facial)
4. Persistence layer (SQLite + JSON + file reports)
5. Presentation layer (Tkinter GUI panels)
6. Utility layers (config, constants, global state, logging/reporting)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Hardware Layer
    subgraph "Hardware Layer"
        style Arduino fill:#d3d3d3,stroke:#333,stroke-width:1px
        Arduino["Arduino (Firmware)"]:::hardware
    end

    %% Python Application Layer
    subgraph "Python Application"
        direction TB

        %% Communication Layer
        ArduinoComms["Serial Interface\n(pySerial comms)"]:::core
        click ArduinoComms "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/arduino_comms.py"

        %% State Machine Layer
        StateMachine["State Machine Logic\n(door control FSM)"]:::core
        click StateMachine "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/state_machine_logic.py"

        %% Validation Layer
        Validation["Validation Logic\n(RFID, QR, facial)"]:::core
        click Validation "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/validation_logic.py"

        %% Persistence Layer
        subgraph Persistence
            direction TB
            DBManager["Database Manager\n(SQLite interface)"]:::persistence
            click DBManager "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/db_manager.py"
            DB["SQLite Database"]:::database
            click DB "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/sistema_acceso.db"
            JSONState["JSON State Persistence\n(daily counters & logs)"]:::persistence
            click JSONState "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/estado_diario.json"
        end

        %% Presentation Layer
        GUI["GUI Manager\n(Tkinter)"]:::presentation
        click GUI "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/gui_manager.py"

        %% Reporting & Logging
        Reporting["Reporting & Logging\n(reports, log persistence)"]:::persistence
        click Reporting "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/reporting_logging.py"

        %% Utilities Layer
        Config["Configuration Manager"]:::utility
        click Config "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/config_manager.py"
        Constants["Global Constants"]:::utility
        click Constants "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/constants.py"
        GlobalState["Global State"]:::utility
        click GlobalState "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/global_state.py"

        CameraDetect["Camera Detection Utility"]:::utility
        click CameraDetect "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/buscar_camaras.py"
        FaceUtils["Facial Recognition Utilities"]:::utility
        click FaceUtils "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/facial_recognition_utils.py"
        EncoderGen["Face Encoding Generator"]:::utility
        click EncoderGen "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/generar_encodings.py"

        %% Orchestration
        MainApp["Application Bootstrap\n& Orchestration"]:::core
        click MainApp "https://github.com/masterhiruma/sistema_autonomo_control_de_acceso/blob/main/codigo_modular/main_app.py"
    end

    %% External Libraries
    subgraph "External Libraries"
        style ExtLibs fill:#fff2cc
        OpenCV["OpenCV"]:::external
        FaceRecog["face_recognition"]:::external
        Pyzbar["pyzbar"]:::external
        TkinterLib["Tkinter"]:::external
    end

    %% Data Stores
    subgraph "Data Stores"
        style Stores fill:#e6ffe6
        DB
        JSONState
    end

    %% Interactions
    Arduino -->|"Serial USB"| ArduinoComms
    ArduinoComms -->|"sensor data"| StateMachine
    StateMachine -->|"controls"| ArduinoComms
    StateMachine -->|"triggers validation"| Validation
    Validation -->|"query"| DBManager
    DBManager -->|"reads/writes"| DB
    Reporting -->|"writes logs"| JSONState
    StateMachine -->|"events"| Reporting
    GUI -->|"user commands/events"| StateMachine
    StateMachine -->|"updates GUI"| GUI
    Validation -->|"uses"| CameraDetect
    Validation -->|"uses"| FaceUtils
    Validation -->|"generates encodings via"| EncoderGen
    MainApp --> StateMachine
    MainApp --> ArduinoComms
    MainApp --> GUI
    MainApp --> Reporting
    MainApp --> Config
    MainApp --> Constants
    MainApp --> GlobalState

    %% Config propagation
    Config -.-> ArduinoComms
    Config -.-> StateMachine
    Config -.-> Validation
    Config -.-> DBManager
    Config -.-> GUI
    Config -.-> Reporting

    %% External libs usage
    FaceUtils --> OpenCV
    FaceUtils --> FaceRecog
    Validation --> Pyzbar
    GUI --> TkinterLib

    %% Styles
    classDef hardware fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef core fill:#cfe2f3,stroke:#2f75b5,stroke-width:1px
    classDef persistence fill:#d9ead3,stroke:#6aa84f,stroke-width:1px
    classDef presentation fill:#f9cb9c,stroke:#b45f06,stroke-width:1px
    classDef utility fill:#fff2cc,stroke:#bf9000,stroke-width:1px
    classDef external fill:#fff2cc,stroke:#bf9000,stroke-width:1px
    classDef database fill:#d9ead3,stroke:#38761d,stroke-width:1px
```
