# montesjuan1256672/lockersmanagement architecture

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

- Interactive diagram: https://gitdiagram.com/montesjuan1256672/lockersmanagement
- Repository: https://github.com/montesjuan1256672/lockersmanagement

## Overview

LockersManagement is a Razor Pages application for managing locker availability, assignments and occupancy, with administrative monitoring and reports. The principal workflow is a user entering the web application, viewing available lockers and occupancy, then using locker-management operations; separate branches cover login/permissions, incidents, reporting and access-control events. The service layer owns database queries and integrations, and reports explicitly enrich locker records with turnstile events. Page-handler excerpts and the README were unavailable, so links from pages to services are not asserted; the page-to-service associations are shown as unverified dashed edges.

Main entry points: [`LockersManagement/Program.cs`](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Program.cs) (Application startup), [`LockersManagement/Services/Locker/LockerService.cs`](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Locker/LockerService.cs) (Locker operations), [`LockersManagement/Services/Login/LoginService.cs`](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Login/LoginService.cs) (Login and roles), [`LockersManagement/Services/Reporte/ReporteService.cs`](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Reporte/ReporteService.cs) (Report generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_loginpage["Login page<br/>[Index.cshtml.cs]"]
  node_availablepage["Available lockers"]
  node_occupancypage["Occupancy page"]
  node_managepage["Management page<br/>[Index.cshtml.cs]"]
  node_monitorpage["Monitoring page"]
  node_reportpage["Reports page<br/>[Reportes.cshtml.cs]"]
  node_startup["Application startup<br/>[Program.cs]"]
end

subgraph group_identity["Identity and access"]
  node_login["Login and roles<br/>[LoginService.cs]"]
  node_usercontext["User context<br/>[UsuarioContext.cs]"]
end

subgraph group_lockers["Locker operations"]
  node_lockerservice["Locker operations<br/>[LockerService.cs]"]
  node_lockercontext["Locker context<br/>[LockerContext.cs]"]
  node_incidents["Incident recording"]
  node_dbhelper["Database access<br/>[DL.cs]"]
  node_models["Domain models"]
end

subgraph group_insights["Reports and monitoring"]
  node_reportservice["Report generation<br/>[ReporteService.cs]"]
end

subgraph group_integrations["Access integrations"]
  node_torniquete["Turnstile events"]
  node_ccure["CCure events<br/>[CCureService.cs]"]
end

node_user(("Web user"))
node_lockerdb[("Locker and workforce data")]
node_accessdb[("Turnstile event store")]
node_ccuredb[("CCure event store")]
node_directory[("LDAP directory")]

node_user -.->|"opens"| node_loginpage
node_user -.->|"views"| node_availablepage
node_user -.->|"views"| node_occupancypage
node_user -.->|"opens"| node_managepage
node_user -.->|"views"| node_monitorpage
node_user -.->|"requests"| node_reportpage
node_loginpage -.->|"authenticates"| node_login
node_availablepage -.->|"queries"| node_lockerservice
node_occupancypage -.->|"queries"| node_lockerservice
node_managepage -.->|"manages"| node_lockerservice
node_monitorpage -.->|"monitors"| node_lockerservice
node_reportpage -.->|"requests"| node_reportservice
node_reportservice -->|"enriches with"| node_torniquete
node_login -->|"validates credentials"| node_directory
node_login -->|"reads user and roles"| node_lockerdb
node_login -->|"checks events"| node_accessdb
node_lockerservice -->|"executes queries"| node_dbhelper
node_dbhelper -->|"queries"| node_lockerdb
node_incidents -->|"executes queries"| node_dbhelper
node_incidents -->|"records incident"| node_lockerdb
node_reportservice -->|"executes query"| node_dbhelper
node_reportservice -->|"reads locker history"| node_lockerdb
node_torniquete -->|"queries events"| node_accessdb
node_ccure -->|"queries events"| node_ccuredb
node_startup -->|"registers service"| node_login
node_startup -->|"registers service"| node_lockerservice
node_startup -->|"registers service"| node_incidents
node_startup -->|"registers service"| node_reportservice
node_startup -->|"registers service"| node_torniquete
node_startup -->|"registers service"| node_ccure

click node_loginpage "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Index.cshtml.cs"
click node_availablepage "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Disponibles.cshtml.cs"
click node_occupancypage "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Ocupacion.cshtml.cs"
click node_managepage "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Gestionar/Index.cshtml.cs"
click node_monitorpage "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Gestionar/Monitoreo.cshtml.cs"
click node_reportpage "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Gestionar/Reportes.cshtml.cs"
click node_login "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Login/LoginService.cs"
click node_usercontext "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Usuario/UsuarioContext.cs"
click node_lockerservice "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Locker/LockerService.cs"
click node_lockercontext "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Locker/LockerContext.cs"
click node_incidents "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Incidente/IncidenteLockerService.cs"
click node_reportservice "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Reporte/ReporteService.cs"
click node_torniquete "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Torniquete/TorniqueteService.cs"
click node_ccure "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/CCure/CCureService.cs"
click node_dbhelper "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Data/DL.cs"
click node_models "https://github.com/montesjuan1256672/lockersmanagement/tree/master/LockersManagement/Models"
click node_startup "https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Program.cs"

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_loginpage,node_availablepage,node_occupancypage,node_managepage,node_monitorpage,node_reportpage,node_startup,node_user toneBlue
class node_login,node_usercontext,node_lockerdb,node_accessdb,node_ccuredb,node_directory toneAmber
class node_lockerservice,node_lockercontext,node_incidents,node_dbhelper,node_models toneMint
class node_reportservice toneRose
class node_torniquete,node_ccure toneIndigo
```

## Components

### Web experience

- [Login page](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Index.cshtml.cs): `LockersManagement/Pages/Index.cshtml.cs`
- [Available lockers](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Disponibles.cshtml.cs): `LockersManagement/Pages/Disponibles.cshtml.cs`
- [Occupancy page](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Ocupacion.cshtml.cs): `LockersManagement/Pages/Ocupacion.cshtml.cs`
- [Management page](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Gestionar/Index.cshtml.cs): `LockersManagement/Pages/Gestionar/Index.cshtml.cs`
- [Monitoring page](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Gestionar/Monitoreo.cshtml.cs): `LockersManagement/Pages/Gestionar/Monitoreo.cshtml.cs`
- [Reports page](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Pages/Gestionar/Reportes.cshtml.cs): `LockersManagement/Pages/Gestionar/Reportes.cshtml.cs`
- [Application startup](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Program.cs): `LockersManagement/Program.cs`

### Identity and access

- [Login and roles](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Login/LoginService.cs): `LockersManagement/Services/Login/LoginService.cs`
- [User context](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Usuario/UsuarioContext.cs): `LockersManagement/Services/Usuario/UsuarioContext.cs`

### Locker operations

- [Locker operations](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Locker/LockerService.cs): `LockersManagement/Services/Locker/LockerService.cs`
- [Locker context](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Locker/LockerContext.cs): `LockersManagement/Services/Locker/LockerContext.cs`
- [Incident recording](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Incidente/IncidenteLockerService.cs): `LockersManagement/Services/Incidente/IncidenteLockerService.cs`
- [Database access](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Data/DL.cs): `LockersManagement/Data/DL.cs`
- [Domain models](https://github.com/montesjuan1256672/lockersmanagement/tree/master/LockersManagement/Models): `LockersManagement/Models`

### Reports and monitoring

- [Report generation](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Reporte/ReporteService.cs): `LockersManagement/Services/Reporte/ReporteService.cs`

### Access integrations

- [Turnstile events](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/Torniquete/TorniqueteService.cs): `LockersManagement/Services/Torniquete/TorniqueteService.cs`
- [CCure events](https://github.com/montesjuan1256672/lockersmanagement/blob/master/LockersManagement/Services/CCure/CCureService.cs): `LockersManagement/Services/CCure/CCureService.cs`

### Other components

- **Web user**
- **Locker and workforce data**
- **Turnstile event store**
- **CCure event store**
- **LDAP directory**

## Connections

- Web user → Login page: opens
- Web user → Available lockers: views
- Web user → Occupancy page: views
- Web user → Management page: opens
- Web user → Monitoring page: views
- Web user → Reports page: requests
- Login page → Login and roles: authenticates
- Available lockers → Locker operations: queries
- Occupancy page → Locker operations: queries
- Management page → Locker operations: manages
- Monitoring page → Locker operations: monitors
- Reports page → Report generation: requests
- Report generation → Turnstile events: enriches with (evidence: `LockersManagement/Services/Reporte/ReporteService.cs`)
- Login and roles → LDAP directory: validates credentials (evidence: `LockersManagement/Services/Login/LoginService.cs`)
- Login and roles → Locker and workforce data: reads user and roles (evidence: `LockersManagement/Services/Login/LoginService.cs`)
- Login and roles → Turnstile event store: checks events (evidence: `LockersManagement/Services/Login/LoginService.cs`)
- Locker operations → Database access: executes queries (evidence: `LockersManagement/Services/Locker/LockerService.cs`)
- Database access → Locker and workforce data: queries
- Incident recording → Database access: executes queries (evidence: `LockersManagement/Services/Incidente/IncidenteLockerService.cs`)
- Incident recording → Locker and workforce data: records incident (evidence: `LockersManagement/Services/Incidente/IncidenteLockerService.cs`)
- Report generation → Database access: executes query (evidence: `LockersManagement/Services/Reporte/ReporteService.cs`)
- Report generation → Locker and workforce data: reads locker history (evidence: `LockersManagement/Services/Reporte/ReporteService.cs`)
- Turnstile events → Turnstile event store: queries events (evidence: `LockersManagement/Services/Torniquete/TorniqueteService.cs`)
- CCure events → CCure event store: queries events (evidence: `LockersManagement/Services/CCure/CCureService.cs`)
- Application startup → Login and roles: registers service (evidence: `LockersManagement/Program.cs`)
- Application startup → Locker operations: registers service (evidence: `LockersManagement/Program.cs`)
- Application startup → Incident recording: registers service (evidence: `LockersManagement/Program.cs`)
- Application startup → Report generation: registers service (evidence: `LockersManagement/Program.cs`)
- Application startup → Turnstile events: registers service (evidence: `LockersManagement/Program.cs`)
- Application startup → CCure events: registers service (evidence: `LockersManagement/Program.cs`)
