# pollolopez/estacionamiento_proyecto architecture

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

- Interactive diagram: https://gitdiagram.com/pollolopez/estacionamiento_proyecto
- Repository: https://github.com/pollolopez/estacionamiento_proyecto

## Overview

Sistema web municipal de estacionamiento medido: conductores registran y finalizan estacionamientos, mientras inspectores verifican vehículos y emiten infracciones; vendedores y administradores gestionan cobros, caja y configuración. El flujo principal documentado va de las vistas a los casos de uso y servicios, aplicando reglas de dominio y persistiendo datos en modelos Django. Se preservan también los flujos de autenticación, MercadoPago, tesorería y notificaciones. Las relaciones entre capas se apoyan en el README y las dependencias indicadas en el índice; no se inspeccionaron las vistas por rol completas.

Main entry points: [`app_estacionamiento/use_cases/estacionar_vehiculo.py`](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/use_cases/estacionar_vehiculo.py) (Registro de estacionamiento), [`app_estacionamiento/views.py`](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views.py) (Fachada de vistas), [`app_estacionamiento/models.py`](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/models.py) (Modelos municipales), [`app_estacionamiento/services/verificacion.py`](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/services/verificacion.py) (Verificación vehicular)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Acceso web"]
  node_urls["Rutas Django<br/>[urls.py]"]
  node_auth["Autenticación<br/>[views_auth.py]"]
  node_conductor_view["Vistas conductor<br/>[views_conductor.py]"]
  node_inspector_view["Vistas inspector<br/>[views_inspector.py]"]
  node_vendedor_view["Vistas vendedor<br/>[views_vendedor.py]"]
  node_admin_view["Vistas admin<br/>[views_admin.py]"]
  node_tesorero_view["Vistas tesorero<br/>[views_tesorero.py]"]
  node_fachada["Fachada de vistas<br/>[views.py]"]
end

subgraph group_operacion["Estacionamiento e inspección"]
  node_estacionar["Registro de estacionamiento"]
  node_horarios["Horarios y vencimientos<br/>[horarios.py]"]
  node_verificacion["Verificación vehicular<br/>[verificacion.py]"]
  node_infracciones["Infracciones<br/>[infracciones.py]"]
end

subgraph group_pagos["Pagos y caja"]
  node_pago_publico["Pago por patente"]
  node_mercadopago["MercadoPago<br/>[views_mp.py]"]
  node_saldo["Saldo conductor<br/>[saldo.py]"]
  node_caja["Caja y comisiones<br/>[caja.py]"]
end

subgraph group_gestion["Gestión municipal"]
  node_push["Notificaciones push<br/>[views_push.py]"]
end

subgraph group_dominio["Datos y negocio"]
  node_modelos[("Modelos municipales<br/>[models.py]")]
  node_politicas["Políticas de dominio<br/>[verificacion.py]"]
  node_estados["Estados vehiculares<br/>[enums.py]"]
  node_fabrica["Fábrica estacionamientos<br/>[factories.py]"]
end

node_conductor(("Conductor"))
node_inspector(("Inspector"))
node_vendedor(("Vendedor"))
node_admin(("Administrador"))

node_conductor -->|"usa"| node_conductor_view
node_inspector -->|"usa"| node_inspector_view
node_vendedor -->|"usa"| node_vendedor_view
node_admin -->|"usa"| node_admin_view
node_urls -->|"enruta"| node_fachada
node_fachada -->|"reexporta"| node_auth
node_fachada -->|"reexporta"| node_conductor_view
node_fachada -->|"reexporta"| node_inspector_view
node_fachada -->|"reexporta"| node_vendedor_view
node_fachada -->|"reexporta"| node_admin_view
node_fachada -->|"reexporta"| node_tesorero_view
node_conductor_view -->|"invoca casos"| node_estacionar
node_estacionar -->|"crea"| node_fabrica
node_estacionar -->|"consulta reglas"| node_horarios
node_estacionar -->|"consulta y debita"| node_saldo
node_estacionar -->|"gestiona tolerancia"| node_infracciones
node_estacionar -->|"lee y escribe"| node_modelos
node_estacionar -->|"aplica reglas"| node_politicas
node_estacionar -->|"crea"| node_fabrica
node_inspector_view -.->|"verifica"| node_verificacion
node_verificacion -->|"consulta y registra"| node_modelos
node_verificacion -->|"construye resultado"| node_politicas
node_politicas -->|"usa estados"| node_estados
node_infracciones -->|"crea actas"| node_modelos
node_vendedor_view -.->|"gestiona cobros"| node_caja
node_mercadopago -.->|"procesa pagos"| node_pago_publico
node_pago_publico -->|"registra pagos"| node_modelos
node_mercadopago -.->|"acredita saldo"| node_saldo
node_tesorero_view -.->|"consulta caja"| node_caja
node_admin_view -.->|"gestiona configuración"| node_modelos
node_push -->|"consulta suscripciones"| node_modelos

click node_urls "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/sitio/urls.py"
click node_auth "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_auth.py"
click node_conductor_view "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_conductor.py"
click node_inspector_view "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_inspector.py"
click node_vendedor_view "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_vendedor.py"
click node_admin_view "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_admin.py"
click node_tesorero_view "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_tesorero.py"
click node_fachada "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views.py"
click node_estacionar "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/use_cases/estacionar_vehiculo.py"
click node_horarios "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/services/horarios.py"
click node_verificacion "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/services/verificacion.py"
click node_infracciones "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/services/infracciones.py"
click node_pago_publico "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/use_cases/procesar_pago_publico.py"
click node_mercadopago "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_mp.py"
click node_saldo "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/services/saldo.py"
click node_caja "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/services/caja.py"
click node_push "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_push.py"
click node_modelos "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/models.py"
click node_politicas "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/domain/verificacion.py"
click node_estados "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/domain/enums.py"
click node_fabrica "https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/factories.py"

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_urls,node_auth,node_conductor_view,node_inspector_view,node_vendedor_view,node_admin_view,node_tesorero_view,node_fachada toneBlue
class node_estacionar,node_horarios,node_verificacion,node_infracciones toneAmber
class node_pago_publico,node_mercadopago,node_saldo,node_caja toneMint
class node_push toneRose
class node_modelos,node_politicas,node_estados,node_fabrica,node_conductor,node_inspector,node_vendedor,node_admin toneIndigo
```

## Components

### Acceso web

- [Rutas Django](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/sitio/urls.py): `sitio/urls.py`
- [Autenticación](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_auth.py): `app_estacionamiento/views_auth.py`
- [Vistas conductor](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_conductor.py): `app_estacionamiento/views_conductor.py`
- [Vistas inspector](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_inspector.py): `app_estacionamiento/views_inspector.py`
- [Vistas vendedor](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_vendedor.py): `app_estacionamiento/views_vendedor.py`
- [Vistas admin](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_admin.py): `app_estacionamiento/views_admin.py`
- [Vistas tesorero](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_tesorero.py): `app_estacionamiento/views_tesorero.py`
- [Fachada de vistas](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views.py): `app_estacionamiento/views.py`

### Estacionamiento e inspección

- [Registro de estacionamiento](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/use_cases/estacionar_vehiculo.py): `app_estacionamiento/use_cases/estacionar_vehiculo.py`
- [Horarios y vencimientos](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/services/horarios.py): `app_estacionamiento/services/horarios.py`
- [Verificación vehicular](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/services/verificacion.py): `app_estacionamiento/services/verificacion.py`
- [Infracciones](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/services/infracciones.py): `app_estacionamiento/services/infracciones.py`

### Pagos y caja

- [Pago por patente](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/use_cases/procesar_pago_publico.py): `app_estacionamiento/use_cases/procesar_pago_publico.py`
- [MercadoPago](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_mp.py): `app_estacionamiento/views_mp.py`
- [Saldo conductor](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/services/saldo.py): `app_estacionamiento/services/saldo.py`
- [Caja y comisiones](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/services/caja.py): `app_estacionamiento/services/caja.py`

### Gestión municipal

- [Notificaciones push](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/views_push.py): `app_estacionamiento/views_push.py`

### Datos y negocio

- [Modelos municipales](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/models.py): `app_estacionamiento/models.py`
- [Políticas de dominio](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/domain/verificacion.py): `app_estacionamiento/domain/verificacion.py`
- [Estados vehiculares](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/domain/enums.py): `app_estacionamiento/domain/enums.py`
- [Fábrica estacionamientos](https://github.com/pollolopez/estacionamiento_proyecto/blob/main/app_estacionamiento/factories.py): `app_estacionamiento/factories.py`

### Other components

- **Conductor**
- **Inspector**
- **Vendedor**
- **Administrador**

## Connections

- Conductor → Vistas conductor: usa (evidence: `README.md`)
- Inspector → Vistas inspector: usa (evidence: `README.md`)
- Vendedor → Vistas vendedor: usa (evidence: `README.md`)
- Administrador → Vistas admin: usa (evidence: `README.md`)
- Rutas Django → Fachada de vistas: enruta (evidence: `sitio/urls.py`)
- Fachada de vistas → Autenticación: reexporta (evidence: `app_estacionamiento/views.py`)
- Fachada de vistas → Vistas conductor: reexporta (evidence: `app_estacionamiento/views.py`)
- Fachada de vistas → Vistas inspector: reexporta (evidence: `app_estacionamiento/views.py`)
- Fachada de vistas → Vistas vendedor: reexporta (evidence: `app_estacionamiento/views.py`)
- Fachada de vistas → Vistas admin: reexporta (evidence: `app_estacionamiento/views.py`)
- Fachada de vistas → Vistas tesorero: reexporta (evidence: `app_estacionamiento/views.py`)
- Vistas conductor → Registro de estacionamiento: invoca casos (evidence: `README.md`)
- Registro de estacionamiento → Fábrica estacionamientos: crea (evidence: `app_estacionamiento/use_cases/estacionar_vehiculo.py`)
- Registro de estacionamiento → Horarios y vencimientos: consulta reglas (evidence: `app_estacionamiento/use_cases/estacionar_vehiculo.py`)
- Registro de estacionamiento → Saldo conductor: consulta y debita (evidence: `app_estacionamiento/use_cases/estacionar_vehiculo.py`)
- Registro de estacionamiento → Infracciones: gestiona tolerancia (evidence: `app_estacionamiento/use_cases/estacionar_vehiculo.py`)
- Registro de estacionamiento → Modelos municipales: lee y escribe (evidence: `app_estacionamiento/use_cases/estacionar_vehiculo.py`)
- Registro de estacionamiento → Políticas de dominio: aplica reglas (evidence: `app_estacionamiento/use_cases/estacionar_vehiculo.py`)
- Registro de estacionamiento → Fábrica estacionamientos: crea (evidence: `app_estacionamiento/use_cases/estacionar_vehiculo.py`)
- Vistas inspector → Verificación vehicular: verifica
- Verificación vehicular → Modelos municipales: consulta y registra (evidence: `app_estacionamiento/services/verificacion.py`)
- Verificación vehicular → Políticas de dominio: construye resultado (evidence: `app_estacionamiento/services/verificacion.py`)
- Políticas de dominio → Estados vehiculares: usa estados (evidence: `app_estacionamiento/domain/verificacion.py`)
- Infracciones → Modelos municipales: crea actas (evidence: `app_estacionamiento/services/infracciones.py`)
- Vistas vendedor → Caja y comisiones: gestiona cobros
- MercadoPago → Pago por patente: procesa pagos
- Pago por patente → Modelos municipales: registra pagos (evidence: `app_estacionamiento/use_cases/procesar_pago_publico.py`)
- MercadoPago → Saldo conductor: acredita saldo
- Vistas tesorero → Caja y comisiones: consulta caja
- Vistas admin → Modelos municipales: gestiona configuración
- Notificaciones push → Modelos municipales: consulta suscripciones (evidence: `app_estacionamiento/views_push.py`)
