# lonelystar16/av_aldomartinez802d_equipo1 architecture

> Architecture diagram of the GitHub repository lonelystar16/av_aldomartinez802d_equipo1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lonelystar16/av_aldomartinez802d_equipo1
- Repository: https://github.com/lonelystar16/av_aldomartinez802d_equipo1

## Overview

CascoVision is an on-premise construction-site PPE monitoring system. Its intended workflow is camera video → edge detection and risk-zone filtering → direct zonal beacon alert and incident reporting → incident history for the risk-prevention dashboard. The repository also contains model-training and evaluation tools and a working API, while the README says the complete edge, dashboard, beacon firmware, and notification deployment remains in development. Some planned branches are therefore documented capabilities rather than sampled implementations.

Main entry points: [`Fase 2/Evidencias Proyecto/src/api/app/main.py`](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/api/app/main.py) (Incident API), [`Fase 2/Evidencias Proyecto/src/edge/agente.py`](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/edge/agente.py) (Edge Agent), [`Fase 2/Evidencias Proyecto/src/api/app/almacen.py`](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/api/app/almacen.py) (Incident Storage), [`Fase 2/Evidencias Proyecto/Yolo/modelamiento/motor_cascovision.py`](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/motor_cascovision.py) (PPE Detection Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vision["Vision and Zones"]
  node_detector["PPE Detection Engine"]
  node_risk_zones["Risk Zones<br/>[zonas.py]"]
  node_model_training["Model Training<br/>[entrenamiento.py]"]
  node_model_evaluation["Model Evaluation<br/>[evaluacion.py]"]
  node_onnx_export["ONNX Export<br/>[exportar_onnx.py]"]
end

subgraph group_edge["Edge Monitoring"]
  node_edge_agent["Edge Agent<br/>[agente.py]"]
  node_monitor_api["API Monitor<br/>[monitoreo_api.py]"]
end

subgraph group_backend["Incident Backend"]
  node_api["Incident API<br/>[main.py]"]
  node_api_config["API Configuration<br/>[config.py]"]
  node_storage["Incident Storage<br/>[almacen.py]"]
  node_json_store[("JSON Store<br/>[almacen.py]")]
  node_postgres[("PostgreSQL")]
end

subgraph group_operations["Safety Operations"]
  node_beacon["Zone Beacon"]
  node_notifications["SMS and Email"]
  node_dashboard["Web Dashboard"]
end

node_camera(("IP Camera"))
node_safety_user(("Risk Supervisor"))

node_camera -->|"streams video"| node_edge_agent
node_edge_agent -->|"analyzes frames"| node_detector
node_monitor_api -->|"reuses engine"| node_detector
node_detector -->|"checks zones"| node_risk_zones
node_model_training -.->|"evaluates model"| node_model_evaluation
node_model_evaluation -.->|"exports model"| node_onnx_export
node_edge_agent -->|"alerts directly"| node_beacon
node_edge_agent -->|"reports incidents"| node_api
node_monitor_api -->|"posts incidents"| node_api
node_api -->|"reads settings"| node_api_config
node_api -->|"persists and queries"| node_storage
node_storage -->|"stores locally"| node_json_store
node_storage -->|"stores in database"| node_postgres
node_api -.->|"sends alerts"| node_notifications
node_safety_user -.->|"reviews incidents"| node_dashboard
node_dashboard -->|"queries incidents"| node_api
node_api -->|"returns history"| node_dashboard

click node_edge_agent "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/edge/agente.py"
click node_monitor_api "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/monitoreo_api.py"
click node_detector "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/motor_cascovision.py"
click node_risk_zones "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/zonas.py"
click node_model_training "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/entrenamiento.py"
click node_model_evaluation "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/evaluacion.py"
click node_onnx_export "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/exportar_onnx.py"
click node_api "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/api/app/main.py"
click node_api_config "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/api/app/config.py"
click node_storage "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/api/app/almacen.py"
click node_json_store "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/api/app/almacen.py"
click node_beacon "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/tree/main/Fase%202/Evidencias%20Proyecto/src/firmware"
click node_dashboard "https://github.com/lonelystar16/av_aldomartinez802d_equipo1/tree/main/Fase%202/Evidencias%20Proyecto/src/dashboard"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_detector,node_risk_zones,node_model_training,node_model_evaluation,node_onnx_export toneBlue
class node_edge_agent,node_monitor_api toneAmber
class node_api,node_api_config,node_storage,node_json_store,node_postgres toneMint
class node_beacon,node_notifications,node_dashboard toneRose
class node_camera,node_safety_user toneIndigo
```

## Components

### Vision and Zones

- [PPE Detection Engine](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/motor_cascovision.py): `Fase 2/Evidencias Proyecto/Yolo/modelamiento/motor_cascovision.py`
- [Risk Zones](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/zonas.py): `Fase 2/Evidencias Proyecto/Yolo/modelamiento/zonas.py`
- [Model Training](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/entrenamiento.py): `Fase 2/Evidencias Proyecto/Yolo/modelamiento/entrenamiento.py`
- [Model Evaluation](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/evaluacion.py): `Fase 2/Evidencias Proyecto/Yolo/modelamiento/evaluacion.py`
- [ONNX Export](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/exportar_onnx.py): `Fase 2/Evidencias Proyecto/Yolo/modelamiento/exportar_onnx.py`

### Edge Monitoring

- [Edge Agent](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/edge/agente.py): `Fase 2/Evidencias Proyecto/src/edge/agente.py`
- [API Monitor](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/Yolo/modelamiento/monitoreo_api.py): `Fase 2/Evidencias Proyecto/Yolo/modelamiento/monitoreo_api.py`

### Incident Backend

- [Incident API](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/api/app/main.py): `Fase 2/Evidencias Proyecto/src/api/app/main.py`
- [API Configuration](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/api/app/config.py): `Fase 2/Evidencias Proyecto/src/api/app/config.py`
- [Incident Storage](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/api/app/almacen.py): `Fase 2/Evidencias Proyecto/src/api/app/almacen.py`
- [JSON Store](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/blob/main/Fase%202/Evidencias%20Proyecto/src/api/app/almacen.py): `Fase 2/Evidencias Proyecto/src/api/app/almacen.py`
- **PostgreSQL**

### Safety Operations

- [Zone Beacon](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/tree/main/Fase%202/Evidencias%20Proyecto/src/firmware): `Fase 2/Evidencias Proyecto/src/firmware`
- **SMS and Email**
- [Web Dashboard](https://github.com/lonelystar16/av_aldomartinez802d_equipo1/tree/main/Fase%202/Evidencias%20Proyecto/src/dashboard): `Fase 2/Evidencias Proyecto/src/dashboard`

### Other components

- **IP Camera**
- **Risk Supervisor**

## Connections

- IP Camera → Edge Agent: streams video (evidence: `README.md`)
- Edge Agent → PPE Detection Engine: analyzes frames (evidence: `Fase 2/Evidencias Proyecto/src/edge/agente.py`)
- API Monitor → PPE Detection Engine: reuses engine (evidence: `Fase 2/Evidencias Proyecto/Yolo/modelamiento/monitoreo_api.py`)
- PPE Detection Engine → Risk Zones: checks zones (evidence: `Fase 2/Evidencias Proyecto/Yolo/modelamiento/motor_cascovision.py`)
- Model Training → Model Evaluation: evaluates model
- Model Evaluation → ONNX Export: exports model
- Edge Agent → Zone Beacon: alerts directly (evidence: `README.md`)
- Edge Agent → Incident API: reports incidents (evidence: `README.md`)
- API Monitor → Incident API: posts incidents (evidence: `Fase 2/Evidencias Proyecto/Yolo/modelamiento/monitoreo_api.py`)
- Incident API → API Configuration: reads settings (evidence: `Fase 2/Evidencias Proyecto/src/api/app/main.py`)
- Incident API → Incident Storage: persists and queries (evidence: `Fase 2/Evidencias Proyecto/src/api/app/main.py`)
- Incident Storage → JSON Store: stores locally (evidence: `Fase 2/Evidencias Proyecto/src/api/app/almacen.py`)
- Incident Storage → PostgreSQL: stores in database (evidence: `README.md`)
- Incident API → SMS and Email: sends alerts (evidence: `README.md`)
- Risk Supervisor → Web Dashboard: reviews incidents (evidence: `README.md`)
- Web Dashboard → Incident API: queries incidents (evidence: `README.md`)
- Incident API → Web Dashboard: returns history (evidence: `README.md`)
