How masterhiruma/sistema_autonomo_control_de_acceso works
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)