# juanchi-reyes/agencia-inmobiliaria architecture

> Architecture diagram of the GitHub repository juanchi-reyes/agencia-inmobiliaria, 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/juanchi-reyes/agencia-inmobiliaria
- Repository: https://github.com/juanchi-reyes/agencia-inmobiliaria

## Overview

Sistema web Django para centralizar la operación de una agencia inmobiliaria. El flujo principal es que una persona accede a una ruta, la vista aplica la lógica de la solicitud y consulta o modifica los datos inmobiliarios; las respuestas se presentan mediante la interfaz web. Las etapas de negocio cubren inmuebles y sus atributos, propietarios, clientes, ofertas y visitas, además de cuentas, roles y recuperación de contraseña. El README documenta MVT y MariaDB. Las plantillas no aparecen en el árbol; los vínculos entre vistas y servicios no siempre son visibles en los extractos, así que esos enlaces se indican como no verificados.

Main entry points: [`apps/inmuebles/views.py`](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/views.py) (Vistas inmobiliarias), [`apps/inmuebles/models.py`](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/models.py) (Modelos inmobiliarios), [`apps/cuentas/views.py`](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/views.py) (Vistas de cuentas), [`config/urls.py`](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/config/urls.py) (Rutas Django)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Acceso web"]
  node_routing["Rutas Django<br/>[urls.py]"]
  node_account_routes["Rutas de cuentas<br/>[urls.py]"]
  node_property_routes["Rutas inmobiliarias<br/>[urls.py]"]
end

subgraph group_accounts["Cuentas y acceso"]
  node_account_views["Vistas de cuentas<br/>[views.py]"]
  node_account_forms["Formularios de cuenta<br/>[forms.py]"]
  node_roles["Roles y permisos<br/>[roles.py]"]
  node_decorators["Control de acceso<br/>[decorators.py]"]
  node_account_services["Servicios de cuenta<br/>[servicios.py]"]
  node_recovery["Recuperación de contraseña"]
end

subgraph group_property["Gestión inmobiliaria"]
  node_property_views["Vistas inmobiliarias<br/>[views.py]"]
  node_property_forms["Formularios inmobiliarios<br/>[forms.py]"]
  node_property_service["Inmuebles y tipos<br/>[services.py]"]
  node_attributes["Atributos y estancias"]
end

subgraph group_operations["Operación comercial"]
  node_owners["Propietarios"]
  node_clients["Clientes"]
  node_offers["Ofertas"]
  node_visits["Visitas"]
end

subgraph group_persistence["Persistencia"]
  node_domain_models["Modelos inmobiliarios<br/>[models.py]"]
  node_database[("MariaDB")]
end

node_person(("Usuario"))

node_person -->|"solicita página"| node_routing
node_routing -->|"deriva rutas"| node_property_views
node_routing -->|"incluye rutas"| node_account_routes
node_account_routes -->|"enruta a vistas"| node_account_views
node_property_routes -->|"enruta a vistas"| node_property_views
node_account_views -->|"procesa formularios"| node_account_forms
node_account_views -->|"consulta rol"| node_roles
node_decorators -->|"consulta rol"| node_roles
node_account_views -->|"gestiona recuperación"| node_recovery
node_account_views -.->|"delega operaciones"| node_account_services
node_account_views -->|"consulta datos"| node_domain_models
node_property_views -->|"valida entrada"| node_property_forms
node_property_views -.->|"delega inmuebles"| node_property_service
node_property_views -.->|"delega atributos"| node_attributes
node_property_views -.->|"delega propietarios"| node_owners
node_property_views -.->|"delega clientes"| node_clients
node_property_views -.->|"delega ofertas"| node_offers
node_property_views -.->|"delega visitas"| node_visits
node_property_views -->|"consulta datos"| node_domain_models
node_property_service -->|"guarda inmuebles"| node_domain_models
node_attributes -->|"guarda atributos"| node_domain_models
node_owners -->|"gestiona propietarios"| node_domain_models
node_clients -->|"gestiona clientes"| node_domain_models
node_offers -->|"gestiona ofertas"| node_domain_models
node_visits -->|"gestiona visitas"| node_domain_models
node_domain_models -->|"lee y escribe"| node_database

click node_routing "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/config/urls.py"
click node_account_routes "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/urls.py"
click node_property_routes "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/urls.py"
click node_account_views "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/views.py"
click node_account_forms "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/forms.py"
click node_roles "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/roles.py"
click node_decorators "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/decorators.py"
click node_account_services "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/servicios.py"
click node_recovery "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/recuperacion_services.py"
click node_property_views "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/views.py"
click node_property_forms "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/forms.py"
click node_property_service "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/services.py"
click node_attributes "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/atributos_services.py"
click node_owners "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/propietarios_services.py"
click node_clients "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/clientes_services.py"
click node_offers "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/ofertas_services.py"
click node_visits "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/visitas_services.py"
click node_domain_models "https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/models.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_routing,node_account_routes,node_property_routes toneBlue
class node_account_views,node_account_forms,node_roles,node_decorators,node_account_services,node_recovery toneAmber
class node_property_views,node_property_forms,node_property_service,node_attributes toneMint
class node_owners,node_clients,node_offers,node_visits toneRose
class node_domain_models,node_database,node_person toneIndigo
```

## Components

### Acceso web

- [Rutas Django](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/config/urls.py): `config/urls.py`
- [Rutas de cuentas](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/urls.py): `apps/cuentas/urls.py`
- [Rutas inmobiliarias](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/urls.py): `apps/inmuebles/urls.py`

### Cuentas y acceso

- [Vistas de cuentas](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/views.py): `apps/cuentas/views.py`
- [Formularios de cuenta](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/forms.py): `apps/cuentas/forms.py`
- [Roles y permisos](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/roles.py): `apps/cuentas/roles.py`
- [Control de acceso](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/decorators.py): `apps/cuentas/decorators.py`
- [Servicios de cuenta](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/servicios.py): `apps/cuentas/servicios.py`
- [Recuperación de contraseña](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/cuentas/recuperacion_services.py): `apps/cuentas/recuperacion_services.py`

### Gestión inmobiliaria

- [Vistas inmobiliarias](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/views.py): `apps/inmuebles/views.py`
- [Formularios inmobiliarios](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/forms.py): `apps/inmuebles/forms.py`
- [Inmuebles y tipos](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/services.py): `apps/inmuebles/services.py`
- [Atributos y estancias](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/atributos_services.py): `apps/inmuebles/atributos_services.py`

### Operación comercial

- [Propietarios](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/propietarios_services.py): `apps/inmuebles/propietarios_services.py`
- [Clientes](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/clientes_services.py): `apps/inmuebles/clientes_services.py`
- [Ofertas](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/ofertas_services.py): `apps/inmuebles/ofertas_services.py`
- [Visitas](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/visitas_services.py): `apps/inmuebles/visitas_services.py`

### Persistencia

- [Modelos inmobiliarios](https://github.com/juanchi-reyes/agencia-inmobiliaria/blob/main/apps/inmuebles/models.py): `apps/inmuebles/models.py`
- **MariaDB**

### Other components

- **Usuario**

## Connections

- Usuario → Rutas Django: solicita página
- Rutas Django → Vistas inmobiliarias: deriva rutas (evidence: `config/urls.py`)
- Rutas Django → Rutas de cuentas: incluye rutas
- Rutas de cuentas → Vistas de cuentas: enruta a vistas (evidence: `apps/cuentas/urls.py`)
- Rutas inmobiliarias → Vistas inmobiliarias: enruta a vistas (evidence: `apps/inmuebles/urls.py`)
- Vistas de cuentas → Formularios de cuenta: procesa formularios (evidence: `apps/cuentas/views.py`)
- Vistas de cuentas → Roles y permisos: consulta rol (evidence: `apps/cuentas/views.py`)
- Control de acceso → Roles y permisos: consulta rol (evidence: `apps/cuentas/decorators.py`)
- Vistas de cuentas → Recuperación de contraseña: gestiona recuperación (evidence: `apps/cuentas/views.py`)
- Vistas de cuentas → Servicios de cuenta: delega operaciones (evidence: `apps/cuentas/views.py`)
- Vistas de cuentas → Modelos inmobiliarios: consulta datos (evidence: `apps/cuentas/views.py`)
- Vistas inmobiliarias → Formularios inmobiliarios: valida entrada (evidence: `apps/inmuebles/views.py`)
- Vistas inmobiliarias → Inmuebles y tipos: delega inmuebles (evidence: `apps/inmuebles/views.py`)
- Vistas inmobiliarias → Atributos y estancias: delega atributos (evidence: `apps/inmuebles/views.py`)
- Vistas inmobiliarias → Propietarios: delega propietarios (evidence: `apps/inmuebles/views.py`)
- Vistas inmobiliarias → Clientes: delega clientes (evidence: `apps/inmuebles/views.py`)
- Vistas inmobiliarias → Ofertas: delega ofertas (evidence: `apps/inmuebles/views.py`)
- Vistas inmobiliarias → Visitas: delega visitas (evidence: `apps/inmuebles/views.py`)
- Vistas inmobiliarias → Modelos inmobiliarios: consulta datos (evidence: `apps/inmuebles/views.py`)
- Inmuebles y tipos → Modelos inmobiliarios: guarda inmuebles (evidence: `apps/inmuebles/services.py`)
- Atributos y estancias → Modelos inmobiliarios: guarda atributos (evidence: `apps/inmuebles/atributos_services.py`)
- Propietarios → Modelos inmobiliarios: gestiona propietarios (evidence: `apps/inmuebles/propietarios_services.py`)
- Clientes → Modelos inmobiliarios: gestiona clientes (evidence: `apps/inmuebles/clientes_services.py`)
- Ofertas → Modelos inmobiliarios: gestiona ofertas (evidence: `apps/inmuebles/ofertas_services.py`)
- Visitas → Modelos inmobiliarios: gestiona visitas (evidence: `apps/inmuebles/visitas_services.py`)
- Modelos inmobiliarios → MariaDB: lee y escribe
