# miguelcont264/sistemascrew-labs architecture

> Architecture diagram of the GitHub repository miguelcont264/sistemascrew-labs, 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/miguelcont264/sistemascrew-labs
- Repository: https://github.com/miguelcont264/sistemascrew-labs

## Overview

SistemasCrew-Labs is a PHP/MySQL laboratory-equipment inventory and circulation system. Users sign in, then work through permission-filtered inventory, loan, return, history, and user-maintenance features; administrators can manage catalog data and users. The README documents the broader UI capabilities, while sampled controller and model code confirms key inventory, loan, return, and authorization behavior. Some frontend-to-API wiring and unsampled modules are not visible in the excerpts, so those connections are shown only as unverified where appropriate.

Main entry points: [`index.php`](https://github.com/miguelcont264/sistemascrew-labs/blob/main/index.php) (Protected workspace), [`api/core/Connection.php`](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/core/Connection.php) (PDO connection), [`api/auth/auth.middleWare.php`](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/auth/auth.middleWare.php) (Permission middleware), [`api/models/Usuario.php`](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/models/Usuario.php) (User and identity data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_login_page["Login and registration<br/>[login.php]"]
  node_home["Protected workspace<br/>[index.php]"]
  node_inventory_ui["Inventory UI<br/>[inventario.js]"]
  node_loans_ui["Loans UI<br/>[prestamos.js]"]
  node_returns_ui["Returns UI<br/>[devoluciones.js]"]
  node_history_ui["History UI<br/>[historial.js]"]
  node_users_ui["Users UI<br/>[usuarios.js]"]
end

subgraph group_auth["Identity and access"]
  node_login_api["Login and registration API<br/>[login.php]"]
  node_session_auth["Session and cookie auth<br/>[auth.php]"]
  node_permission_gate["Permission middleware"]
  node_login_limits["Login attempt limits<br/>[LoginAttempts.php]"]
end

subgraph group_operations["Equipment operations"]
  node_equipment_api["Equipment management<br/>[Equipos.php]"]
  node_equipment_model["Equipment operations<br/>[Equipo.php]"]
  node_loan_api["Loan processing<br/>[Prestamos.php]"]
  node_return_api["Return processing<br/>[Devoluciones.php]"]
  node_catalog_api["Equipment catalogs<br/>[Categorias.php]"]
  node_catalog_models[("Category data<br/>[Categorias.php]")]
end

subgraph group_accounts["People and history"]
  node_user_api["User maintenance<br/>[Usuarios.php]"]
  node_history_api["Loan history<br/>[Historial.php]"]
  node_user_model["User and identity data<br/>[Usuario.php]"]
  node_history_model["History queries<br/>[Historial.php]"]
end

subgraph group_platform["API and persistence"]
  node_connection["PDO connection<br/>[Connection.php]"]
  node_configuration["Runtime configuration<br/>[Configuration.php]"]
end

node_visitor(("Visitor / user"))
node_mysql[("MySQL / MariaDB")]

node_visitor -->|"opens"| node_login_page
node_visitor -->|"uses"| node_home
node_login_page -.->|"authenticates"| node_login_api
node_login_api -->|"uses"| node_session_auth
node_login_api -->|"checks attempts"| node_login_limits
node_home -->|"requires session"| node_session_auth
node_home -->|"checks permissions"| node_user_model
node_home -.->|"loads module"| node_inventory_ui
node_home -.->|"loads module"| node_loans_ui
node_home -.->|"loads module"| node_returns_ui
node_home -.->|"loads module"| node_history_ui
node_home -.->|"loads module"| node_users_ui
node_inventory_ui -.->|"requests data"| node_equipment_api
node_loans_ui -.->|"requests loans"| node_loan_api
node_returns_ui -.->|"requests returns"| node_return_api
node_history_ui -.->|"requests history"| node_history_api
node_users_ui -.->|"requests users"| node_user_api
node_equipment_api -->|"checks access"| node_permission_gate
node_equipment_api -->|"dispatches operations"| node_equipment_model
node_equipment_model -->|"generates code prefix"| node_catalog_models
node_equipment_model -->|"queries database"| node_connection
node_loan_api -->|"checks access"| node_permission_gate
node_loan_api -->|"reads and writes loans"| node_connection
node_return_api -->|"checks access"| node_permission_gate
node_return_api -->|"updates returns"| node_connection
node_catalog_api -->|"checks access"| node_permission_gate
node_catalog_api -->|"dispatches queries"| node_catalog_models
node_user_api -.->|"checks access"| node_permission_gate
node_user_api -->|"uses"| node_user_model
node_history_api -->|"checks access"| node_permission_gate
node_history_api -->|"queries history"| node_history_model
node_session_auth -->|"checks identity"| node_user_model
node_permission_gate -->|"checks permissions"| node_user_model
node_user_model -->|"uses database"| node_connection
node_history_model -->|"queries database"| node_connection
node_connection -->|"loads settings"| node_configuration
node_connection -->|"connects"| node_mysql

click node_login_page "https://github.com/miguelcont264/sistemascrew-labs/blob/main/login.php"
click node_home "https://github.com/miguelcont264/sistemascrew-labs/blob/main/index.php"
click node_inventory_ui "https://github.com/miguelcont264/sistemascrew-labs/blob/main/Js/inventario.js"
click node_loans_ui "https://github.com/miguelcont264/sistemascrew-labs/blob/main/Js/prestamos.js"
click node_returns_ui "https://github.com/miguelcont264/sistemascrew-labs/blob/main/Js/devoluciones.js"
click node_history_ui "https://github.com/miguelcont264/sistemascrew-labs/blob/main/Js/historial.js"
click node_users_ui "https://github.com/miguelcont264/sistemascrew-labs/blob/main/Js/usuarios.js"
click node_login_api "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/auth/login.php"
click node_session_auth "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/helpers/auth.php"
click node_permission_gate "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/auth/auth.middleWare.php"
click node_login_limits "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/auth/LoginAttempts.php"
click node_equipment_api "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Equipos.php"
click node_equipment_model "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/models/Equipo.php"
click node_loan_api "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Prestamos.php"
click node_return_api "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Devoluciones.php"
click node_catalog_api "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Categorias.php"
click node_catalog_models "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/models/Categorias.php"
click node_user_api "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Usuarios.php"
click node_history_api "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Historial.php"
click node_user_model "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/models/Usuario.php"
click node_history_model "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/models/Historial.php"
click node_connection "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/core/Connection.php"
click node_configuration "https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/core/Configuration.php"

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_login_page,node_home,node_inventory_ui,node_loans_ui,node_returns_ui,node_history_ui,node_users_ui,node_visitor toneBlue
class node_login_api,node_session_auth,node_permission_gate,node_login_limits,node_mysql toneAmber
class node_equipment_api,node_equipment_model,node_loan_api,node_return_api,node_catalog_api,node_catalog_models toneMint
class node_user_api,node_history_api,node_user_model,node_history_model toneRose
class node_connection,node_configuration toneIndigo
```

## Components

### User interface

- [Login and registration](https://github.com/miguelcont264/sistemascrew-labs/blob/main/login.php): `login.php`
- [Protected workspace](https://github.com/miguelcont264/sistemascrew-labs/blob/main/index.php): `index.php`
- [Inventory UI](https://github.com/miguelcont264/sistemascrew-labs/blob/main/Js/inventario.js): `Js/inventario.js`
- [Loans UI](https://github.com/miguelcont264/sistemascrew-labs/blob/main/Js/prestamos.js): `Js/prestamos.js`
- [Returns UI](https://github.com/miguelcont264/sistemascrew-labs/blob/main/Js/devoluciones.js): `Js/devoluciones.js`
- [History UI](https://github.com/miguelcont264/sistemascrew-labs/blob/main/Js/historial.js): `Js/historial.js`
- [Users UI](https://github.com/miguelcont264/sistemascrew-labs/blob/main/Js/usuarios.js): `Js/usuarios.js`

### Identity and access

- [Login and registration API](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/auth/login.php): `api/auth/login.php`
- [Session and cookie auth](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/helpers/auth.php): `api/helpers/auth.php`
- [Permission middleware](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/auth/auth.middleWare.php): `api/auth/auth.middleWare.php`
- [Login attempt limits](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/auth/LoginAttempts.php): `api/auth/LoginAttempts.php`

### Equipment operations

- [Equipment management](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Equipos.php): `api/admin/Equipos.php`
- [Equipment operations](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/models/Equipo.php): `api/models/Equipo.php`
- [Loan processing](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Prestamos.php): `api/admin/Prestamos.php`
- [Return processing](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Devoluciones.php): `api/admin/Devoluciones.php`
- [Equipment catalogs](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Categorias.php): `api/admin/Categorias.php`
- [Category data](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/models/Categorias.php): `api/models/Categorias.php`

### People and history

- [User maintenance](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Usuarios.php): `api/admin/Usuarios.php`
- [Loan history](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/admin/Historial.php): `api/admin/Historial.php`
- [User and identity data](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/models/Usuario.php): `api/models/Usuario.php`
- [History queries](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/models/Historial.php): `api/models/Historial.php`

### API and persistence

- [PDO connection](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/core/Connection.php): `api/core/Connection.php`
- [Runtime configuration](https://github.com/miguelcont264/sistemascrew-labs/blob/main/api/core/Configuration.php): `api/core/Configuration.php`

### Other components

- **Visitor / user**
- **MySQL / MariaDB**

## Connections

- Visitor / user → Login and registration: opens (evidence: `README.md`)
- Visitor / user → Protected workspace: uses (evidence: `README.md`)
- Login and registration → Login and registration API: authenticates
- Login and registration API → Session and cookie auth: uses (evidence: `api/auth/login.php`)
- Login and registration API → Login attempt limits: checks attempts (evidence: `api/auth/login.php`)
- Protected workspace → Session and cookie auth: requires session (evidence: `index.php`)
- Protected workspace → User and identity data: checks permissions (evidence: `index.php`)
- Protected workspace → Inventory UI: loads module
- Protected workspace → Loans UI: loads module
- Protected workspace → Returns UI: loads module
- Protected workspace → History UI: loads module
- Protected workspace → Users UI: loads module
- Inventory UI → Equipment management: requests data
- Loans UI → Loan processing: requests loans
- Returns UI → Return processing: requests returns
- History UI → Loan history: requests history
- Users UI → User maintenance: requests users
- Equipment management → Permission middleware: checks access (evidence: `api/admin/Equipos.php`)
- Equipment management → Equipment operations: dispatches operations (evidence: `api/admin/Equipos.php`)
- Equipment operations → Category data: generates code prefix (evidence: `api/models/Equipo.php`)
- Equipment operations → PDO connection: queries database (evidence: `api/models/Equipo.php`)
- Loan processing → Permission middleware: checks access (evidence: `api/admin/Prestamos.php`)
- Loan processing → PDO connection: reads and writes loans (evidence: `api/admin/Prestamos.php`)
- Return processing → Permission middleware: checks access (evidence: `api/admin/Devoluciones.php`)
- Return processing → PDO connection: updates returns (evidence: `api/admin/Devoluciones.php`)
- Equipment catalogs → Permission middleware: checks access (evidence: `api/admin/Categorias.php`)
- Equipment catalogs → Category data: dispatches queries (evidence: `api/admin/Categorias.php`)
- User maintenance → Permission middleware: checks access (evidence: `api/admin/Usuarios.php`)
- User maintenance → User and identity data: uses (evidence: `api/admin/Usuarios.php`)
- Loan history → Permission middleware: checks access (evidence: `api/admin/Historial.php`)
- Loan history → History queries: queries history (evidence: `api/admin/Historial.php`)
- Session and cookie auth → User and identity data: checks identity (evidence: `api/helpers/auth.php`)
- Permission middleware → User and identity data: checks permissions (evidence: `api/auth/auth.middleWare.php`)
- User and identity data → PDO connection: uses database (evidence: `api/models/Usuario.php`)
- History queries → PDO connection: queries database (evidence: `api/models/Historial.php`)
- PDO connection → Runtime configuration: loads settings (evidence: `api/core/Connection.php`)
- PDO connection → MySQL / MariaDB: connects (evidence: `api/core/Connection.php`)
