# nehuen233/controltech architecture

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

- Interactive diagram: https://gitdiagram.com/nehuen233/controltech
- Repository: https://github.com/nehuen233/controltech

## Overview

ControlTech is a multi-institution school-lab management system. Users sign in, then manage their institution’s labs, equipment, software, maintenance and alerts; SUPERADMIN users manage institutions and subscription payments. The React app routes users to these workflows and calls the Express API; backend controllers enforce access and persist data in MySQL. The README also documents first-time institution setup, payment status and suspension behavior. Some subsystems are represented by their existing directories because their implementation files were not sampled.

Main entry points: [`backend/src/routes/index.js`](https://github.com/nehuen233/controltech/blob/main/backend/src/routes/index.js) (API routes), [`backend/src/config/db.js`](https://github.com/nehuen233/controltech/blob/main/backend/src/config/db.js) (MySQL database), [`frontend/src/App.jsx`](https://github.com/nehuen233/controltech/blob/main/frontend/src/App.jsx) (App navigation), [`frontend/src/api.js`](https://github.com/nehuen233/controltech/blob/main/frontend/src/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["App navigation<br/>[App.jsx]"]
  node_authui["Session context<br/>[AuthContext.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_setupui["Setup wizard<br/>[index.jsx]"]
  node_labui["Lab management<br/>[Laboratorios.jsx]"]
  node_equipmentui["Equipment management<br/>[Equipos.jsx]"]
  node_maintenanceui["Maintenance UI<br/>[Mantenimientos.jsx]"]
  node_alertsui["Live alerts<br/>[Alertas.jsx]"]
  node_platformui["Platform screens"]
end

subgraph group_service["API and identity"]
  node_server["Express server<br/>[server.js]"]
  node_routes["API routes<br/>[index.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_users["User administration"]
  node_access["Access controls<br/>[acceso.js]"]
  node_history["Action history<br/>[historial.js]"]
end

subgraph group_operations["Lab operations"]
  node_labs["Lab records"]
  node_equipment["Equipment records"]
  node_software["Software and licenses"]
  node_maintenance["Maintenance records"]
  node_alerts["Alerts and events"]
end

subgraph group_platform["Institutions and billing"]
  node_institutions["Institution administration"]
  node_payments["Payment management<br/>[pagosController.js]"]
  node_billing["Billing lifecycle<br/>[cobros.js]"]
end

subgraph group_storage["Persistence"]
  node_db[("MySQL database<br/>[db.js]")]
  node_schema["Schema and migrations<br/>[esquema.js]"]
end

node_user(("School user"))

node_user -->|"uses"| node_app
node_app -->|"checks session"| node_authui
node_app -->|"routes to"| node_setupui
node_app -->|"routes to"| node_labui
node_app -->|"routes to"| node_equipmentui
node_app -->|"routes to"| node_maintenanceui
node_app -->|"uses"| node_alertsui
node_app -->|"routes to"| node_platformui
node_authui -->|"requests session"| node_api
node_setupui -->|"sends setup data"| node_api
node_labui -->|"requests data"| node_api
node_equipmentui -->|"requests data"| node_api
node_maintenanceui -->|"requests data"| node_api
node_alertsui -->|"opens stream"| node_api
node_api -->|"sends API requests"| node_server
node_server -->|"mounts"| node_routes
node_server -->|"starts checks"| node_billing
node_routes -->|"applies auth"| node_auth
node_routes -->|"dispatches to"| node_users
node_routes -->|"dispatches to"| node_labs
node_routes -->|"dispatches to"| node_equipment
node_routes -->|"dispatches to"| node_software
node_routes -->|"dispatches to"| node_maintenance
node_routes -->|"dispatches to"| node_alerts
node_routes -->|"dispatches to"| node_institutions
node_routes -->|"dispatches to"| node_payments
node_auth -->|"checks identity"| node_db
node_users -->|"reads and writes"| node_db
node_labs -->|"reads and writes"| node_db
node_equipment -->|"reads and writes"| node_db
node_equipment -->|"checks lab access"| node_access
node_maintenance -->|"reads and writes"| node_db
node_maintenance -->|"resolves and notifies"| node_alerts
node_alerts -->|"reads and writes"| node_db
node_institutions -->|"reads and writes"| node_db
node_institutions -->|"uses billing rules"| node_billing
node_payments -->|"reads and writes"| node_db
node_payments -->|"applies payment rules"| node_billing
node_billing -->|"reviews accounts"| node_db
node_billing -->|"emits notices"| node_alerts
node_schema -->|"checks schema"| node_db
node_users -->|"records actions"| node_history
node_payments -->|"records actions"| node_history

click node_app "https://github.com/nehuen233/controltech/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/nehuen233/controltech/blob/main/frontend/src/AuthContext.jsx"
click node_api "https://github.com/nehuen233/controltech/blob/main/frontend/src/api.js"
click node_setupui "https://github.com/nehuen233/controltech/blob/main/frontend/src/pages/PrimerosPasos/index.jsx"
click node_labui "https://github.com/nehuen233/controltech/blob/main/frontend/src/pages/Laboratorios.jsx"
click node_equipmentui "https://github.com/nehuen233/controltech/blob/main/frontend/src/pages/Equipos.jsx"
click node_maintenanceui "https://github.com/nehuen233/controltech/blob/main/frontend/src/pages/Mantenimientos.jsx"
click node_alertsui "https://github.com/nehuen233/controltech/blob/main/frontend/src/components/Alertas.jsx"
click node_platformui "https://github.com/nehuen233/controltech/tree/main/frontend/src/pages"
click node_server "https://github.com/nehuen233/controltech/blob/main/backend/src/server.js"
click node_routes "https://github.com/nehuen233/controltech/blob/main/backend/src/routes/index.js"
click node_auth "https://github.com/nehuen233/controltech/blob/main/backend/src/middlewares/auth.js"
click node_users "https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/usuariosController.js"
click node_labs "https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/laboratoriosController.js"
click node_equipment "https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/equiposController.js"
click node_software "https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/softwareController.js"
click node_maintenance "https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/mantenimientosController.js"
click node_alerts "https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/alertasController.js"
click node_institutions "https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/institucionController.js"
click node_payments "https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/pagosController.js"
click node_billing "https://github.com/nehuen233/controltech/blob/main/backend/src/utils/cobros.js"
click node_db "https://github.com/nehuen233/controltech/blob/main/backend/src/config/db.js"
click node_schema "https://github.com/nehuen233/controltech/blob/main/backend/src/config/esquema.js"
click node_access "https://github.com/nehuen233/controltech/blob/main/backend/src/utils/acceso.js"
click node_history "https://github.com/nehuen233/controltech/blob/main/backend/src/utils/historial.js"

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_app,node_authui,node_api,node_setupui,node_labui,node_equipmentui,node_maintenanceui,node_alertsui,node_platformui,node_user toneBlue
class node_server,node_routes,node_auth,node_users,node_access,node_history toneAmber
class node_labs,node_equipment,node_software,node_maintenance,node_alerts toneMint
class node_institutions,node_payments,node_billing toneRose
class node_db,node_schema toneIndigo
```

## Components

### Web application

- [App navigation](https://github.com/nehuen233/controltech/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session context](https://github.com/nehuen233/controltech/blob/main/frontend/src/AuthContext.jsx): `frontend/src/AuthContext.jsx`
- [API client](https://github.com/nehuen233/controltech/blob/main/frontend/src/api.js): `frontend/src/api.js`
- [Setup wizard](https://github.com/nehuen233/controltech/blob/main/frontend/src/pages/PrimerosPasos/index.jsx): `frontend/src/pages/PrimerosPasos/index.jsx`
- [Lab management](https://github.com/nehuen233/controltech/blob/main/frontend/src/pages/Laboratorios.jsx): `frontend/src/pages/Laboratorios.jsx`
- [Equipment management](https://github.com/nehuen233/controltech/blob/main/frontend/src/pages/Equipos.jsx): `frontend/src/pages/Equipos.jsx`
- [Maintenance UI](https://github.com/nehuen233/controltech/blob/main/frontend/src/pages/Mantenimientos.jsx): `frontend/src/pages/Mantenimientos.jsx`
- [Live alerts](https://github.com/nehuen233/controltech/blob/main/frontend/src/components/Alertas.jsx): `frontend/src/components/Alertas.jsx`
- [Platform screens](https://github.com/nehuen233/controltech/tree/main/frontend/src/pages): `frontend/src/pages`

### API and identity

- [Express server](https://github.com/nehuen233/controltech/blob/main/backend/src/server.js): `backend/src/server.js`
- [API routes](https://github.com/nehuen233/controltech/blob/main/backend/src/routes/index.js): `backend/src/routes/index.js`
- [Authentication](https://github.com/nehuen233/controltech/blob/main/backend/src/middlewares/auth.js): `backend/src/middlewares/auth.js`
- [User administration](https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/usuariosController.js): `backend/src/controllers/usuariosController.js`
- [Access controls](https://github.com/nehuen233/controltech/blob/main/backend/src/utils/acceso.js): `backend/src/utils/acceso.js`
- [Action history](https://github.com/nehuen233/controltech/blob/main/backend/src/utils/historial.js): `backend/src/utils/historial.js`

### Lab operations

- [Lab records](https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/laboratoriosController.js): `backend/src/controllers/laboratoriosController.js`
- [Equipment records](https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/equiposController.js): `backend/src/controllers/equiposController.js`
- [Software and licenses](https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/softwareController.js): `backend/src/controllers/softwareController.js`
- [Maintenance records](https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/mantenimientosController.js): `backend/src/controllers/mantenimientosController.js`
- [Alerts and events](https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/alertasController.js): `backend/src/controllers/alertasController.js`

### Institutions and billing

- [Institution administration](https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/institucionController.js): `backend/src/controllers/institucionController.js`
- [Payment management](https://github.com/nehuen233/controltech/blob/main/backend/src/controllers/pagosController.js): `backend/src/controllers/pagosController.js`
- [Billing lifecycle](https://github.com/nehuen233/controltech/blob/main/backend/src/utils/cobros.js): `backend/src/utils/cobros.js`

### Persistence

- [MySQL database](https://github.com/nehuen233/controltech/blob/main/backend/src/config/db.js): `backend/src/config/db.js`
- [Schema and migrations](https://github.com/nehuen233/controltech/blob/main/backend/src/config/esquema.js): `backend/src/config/esquema.js`

### Other components

- **School user**

## Connections

- School user → App navigation: uses
- App navigation → Session context: checks session (evidence: `frontend/src/App.jsx`)
- App navigation → Setup wizard: routes to (evidence: `frontend/src/App.jsx`)
- App navigation → Lab management: routes to (evidence: `frontend/src/App.jsx`)
- App navigation → Equipment management: routes to (evidence: `frontend/src/App.jsx`)
- App navigation → Maintenance UI: routes to (evidence: `frontend/src/App.jsx`)
- App navigation → Live alerts: uses (evidence: `frontend/src/App.jsx`)
- App navigation → Platform screens: routes to (evidence: `frontend/src/App.jsx`)
- Session context → API client: requests session (evidence: `frontend/src/AuthContext.jsx`)
- Setup wizard → API client: sends setup data (evidence: `frontend/src/pages/PrimerosPasos/index.jsx`)
- Lab management → API client: requests data (evidence: `frontend/src/pages/Laboratorios.jsx`)
- Equipment management → API client: requests data (evidence: `frontend/src/pages/Equipos.jsx`)
- Maintenance UI → API client: requests data (evidence: `frontend/src/pages/Mantenimientos.jsx`)
- Live alerts → API client: opens stream (evidence: `frontend/src/api.js`)
- API client → Express server: sends API requests (evidence: `frontend/src/api.js`)
- Express server → API routes: mounts
- Express server → Billing lifecycle: starts checks (evidence: `backend/src/server.js`)
- API routes → Authentication: applies auth (evidence: `backend/src/routes/index.js`)
- API routes → User administration: dispatches to (evidence: `backend/src/routes/index.js`)
- API routes → Lab records: dispatches to (evidence: `backend/src/routes/index.js`)
- API routes → Equipment records: dispatches to (evidence: `backend/src/routes/index.js`)
- API routes → Software and licenses: dispatches to (evidence: `backend/src/routes/index.js`)
- API routes → Maintenance records: dispatches to (evidence: `backend/src/routes/index.js`)
- API routes → Alerts and events: dispatches to (evidence: `backend/src/routes/index.js`)
- API routes → Institution administration: dispatches to (evidence: `backend/src/routes/index.js`)
- API routes → Payment management: dispatches to (evidence: `backend/src/routes/index.js`)
- Authentication → MySQL database: checks identity (evidence: `backend/src/middlewares/auth.js`)
- User administration → MySQL database: reads and writes (evidence: `backend/src/controllers/usuariosController.js`)
- Lab records → MySQL database: reads and writes (evidence: `backend/src/controllers/laboratoriosController.js`)
- Equipment records → MySQL database: reads and writes (evidence: `backend/src/controllers/equiposController.js`)
- Equipment records → Access controls: checks lab access (evidence: `backend/src/controllers/equiposController.js`)
- Maintenance records → MySQL database: reads and writes (evidence: `backend/src/controllers/mantenimientosController.js`)
- Maintenance records → Alerts and events: resolves and notifies (evidence: `backend/src/controllers/mantenimientosController.js`)
- Alerts and events → MySQL database: reads and writes (evidence: `backend/src/controllers/alertasController.js`)
- Institution administration → MySQL database: reads and writes (evidence: `backend/src/controllers/institucionController.js`)
- Institution administration → Billing lifecycle: uses billing rules (evidence: `backend/src/controllers/institucionController.js`)
- Payment management → MySQL database: reads and writes (evidence: `backend/src/controllers/pagosController.js`)
- Payment management → Billing lifecycle: applies payment rules (evidence: `backend/src/controllers/pagosController.js`)
- Billing lifecycle → MySQL database: reviews accounts (evidence: `backend/src/utils/cobros.js`)
- Billing lifecycle → Alerts and events: emits notices (evidence: `backend/src/utils/cobros.js`)
- Schema and migrations → MySQL database: checks schema (evidence: `backend/src/config/esquema.js`)
- User administration → Action history: records actions (evidence: `backend/src/controllers/usuariosController.js`)
- Payment management → Action history: records actions (evidence: `backend/src/controllers/pagosController.js`)
