# mateobetancurb/bienes-raices-web-site architecture

> Architecture diagram of the GitHub repository mateobetancurb/bienes-raices-web-site, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mateobetancurb/bienes-raices-web-site
- Repository: https://github.com/mateobetancurb/bienes-raices-web-site

## Overview

##### Main Components
- Client (Browser): Renders HTML/CSS/JS (views, `public/js`, `public/css`)
- Web Server (Express):
– Entry Point: `index.js`
– Routes: `routes/*.js`
– Controllers: `controllers/*.js`
– Middlewares: `middlewares/*.js`
– Helpers (emails, tokens): `helpers/*.js`
- Data Layer:
– Models: `models/*.js`
– DB Connection: `config/db.js`
– Seeders: `seed/*.js`
- Static Asset Pipeline: Webpack (`webpack.config.js`), PostCSS (`postcss.config.js`), Tailwind (`tailwind.config.js`)
- File Storage: `public/uploads` via `subirImagen` middleware
- External Services: Email service (in `helpers/emails.js`), token generation (`helpers/tokens.js`)

##### Relationships & Interactions
- Browser → HTTP Request → Express Route → Controller → Model → Database → Controller → Response → Browser
- Controllers invoke Helpers (email confirmation, token handling)
- Middlewares handle authentication (`identificarUsuario`, `protegerRuta`) and file uploads (`subirImagen`)
- Static asset requests served directly from `public/`
- Build pipeline (Webpack/PostCSS) generates assets into `public/css` and `public/js`
- Seed scripts populate initial data in the database

##### Architectural Patterns & Principles
- MVC (Models, Views, Controllers) for clear separation of concerns
- Layered Architecture (Presentation, Application, Data)
- Configuration Management for environment-driven DB connections
- Extensibility via Helpers and Seeders

##### Relevant Technologies
- Node.js, Express.js
- Pug templating engine
- Tailwind CSS, PostCSS, Webpack
- Relational or NoSQL database (configured in `config/db.js`)
- Email service integration (helpers/emails.js)
- Authentication & Authorization middlewares

##### Detailed Coverage
- `config/db.js` and `models/*.js` as the Data Model component
- `routes/*.js` under API Gateway or Router
- Middleware (`identificarUsuario`, `protegerRuta`, `subirImagen`) on the request flow
- Distinguish source JS (`src/js`) from built JS (`public/js`)
- Seeder folder (`seed/*.js`) as an auxiliary data-initialization module

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Browser["Client (Browser)"]:::presentation
        Views["views/"]:::presentation
        StaticCSS["public/css/app.css,\npublic/css/tailwind.css"]:::presentation
        StaticJSBuilt["public/js/*.js"]:::presentation
        StaticJSSrc["src/js/*.js"]:::presentation
    end

    %% Static Asset Pipeline
    subgraph "Static Asset Pipeline"
        direction TB
        Webpack["webpack.config.js"]:::pipeline
        PostCSS["postcss.config.js"]:::pipeline
        Tailwind["tailwind.config.js"]:::pipeline
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        Server["index.js"]:::application
        subgraph "Routes"
            direction TB
            AppRoutes["routes/appRoutes.js"]:::application
            APIRoutes["routes/apiRoutes.js"]:::application
            PropRoutes["routes/propiedadesRoutes.js"]:::application
            UserRoutes["routes/usuarioRoutes.js"]:::application
        end
        subgraph "Controllers"
            direction TB
            AppCtrl["controllers/appController.js"]:::application
            APICtrl["controllers/apiController.js"]:::application
            PropCtrl["controllers/propiedadesController.js"]:::application
            UserCtrl["controllers/usuarioController.js"]:::application
        end
        subgraph "Middlewares"
            direction TB
            AuthIdent["middlewares/identificarUsuario.js"]:::application
            AuthProtect["middlewares/protegerRuta.js"]:::application
            UploadImg["middlewares/subirImagen.js"]:::application
        end
        subgraph "Helpers / Services"
            direction TB
            Emails["helpers/emails.js"]:::application
            Tokens["helpers/tokens.js"]:::application
            HelpersIndex["helpers/index.js"]:::application
        end
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        DBConfig["config/db.js"]:::data
        subgraph "Models"
            direction TB
            Categoria["models/Categoria.js"]:::data
            Precio["models/Precio.js"]:::data
            Propiedad["models/Propiedad.js"]:::data
            Usuario["models/Usuario.js"]:::data
            Mensaje["models/Mensaje.js"]:::data
            ModelsIndex["models/index.js"]:::data
        end
        subgraph "Seeders"
            direction TB
            SeedCat["seed/categorias.js"]:::data
            SeedPrice["seed/precios.js"]:::data
            SeedUser["seed/usuarios.js"]:::data
            Seeder["seed/seeder.js"]:::data
        end
        Database[(Database)]:::data
    end

    %% External Services
    subgraph "External Services"
        direction TB
        EmailSvc["Email Service"]:::external
        TokenSvc["Token Generator"]:::external
    end

    %% Flows
    Browser -->|HTTP Request| AppRoutes
    AppRoutes --> AppCtrl
    APIRoutes --> APICtrl
    PropRoutes --> PropCtrl
    UserRoutes --> UserCtrl

    AppCtrl -->|uses| ModelsIndex
    APICtrl -->|uses| ModelsIndex
    PropCtrl -->|uses| ModelsIndex
    UserCtrl -->|uses| ModelsIndex

    AppCtrl -->|calls| Emails
    AppCtrl -->|calls| Tokens
    APICtrl -->|calls| Emails
    APICtrl -->|calls| Tokens

    AuthIdent --> AppRoutes
    AuthProtect --> PropRoutes
    UploadImg --> PropRoutes

    ModelsIndex --> Categoria
    ModelsIndex --> Precio
    ModelsIndex --> Propiedad
    ModelsIndex --> Usuario
    ModelsIndex --> Mensaje

    Categoria --> Database
    Precio --> Database
    Propiedad --> Database
    Usuario --> Database
    Mensaje --> Database
    DBConfig --> Database

    SeedCat --> Database
    SeedPrice --> Database
    SeedUser --> Database
    Seeder --> Database

    Emails --> EmailSvc
    Tokens --> TokenSvc

    Webpack -->|builds assets| StaticCSS
    Webpack -->|builds assets| StaticJSBuilt
    PostCSS -->|processes CSS| StaticCSS
    Tailwind -->|configures CSS| StaticCSS

    Browser -->|loads| StaticCSS
    Browser -->|loads| StaticJSBuilt
    Browser -->|loads| Views

    %% Click Events
    click Views "https://github.com/mateobetancurb/bienes-raices-web-site/tree/main/views/"
    click StaticCSS "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/public/css/app.css"
    click StaticCSS "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/public/css/tailwind.css"
    click StaticJSBuilt "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/public/js/*.js"
    click StaticJSSrc "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/src/js/*.js"
    click Webpack "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/webpack.config.js"
    click PostCSS "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/postcss.config.js"
    click Tailwind "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/tailwind.config.js"
    click Server "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/index.js"
    click AppRoutes "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/routes/appRoutes.js"
    click APIRoutes "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/routes/apiRoutes.js"
    click PropRoutes "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/routes/propiedadesRoutes.js"
    click UserRoutes "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/routes/usuarioRoutes.js"
    click AppCtrl "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/controllers/appController.js"
    click APICtrl "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/controllers/apiController.js"
    click PropCtrl "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/controllers/propiedadesController.js"
    click UserCtrl "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/controllers/usuarioController.js"
    click AuthIdent "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/middlewares/identificarUsuario.js"
    click AuthProtect "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/middlewares/protegerRuta.js"
    click UploadImg "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/middlewares/subirImagen.js"
    click Emails "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/helpers/emails.js"
    click Tokens "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/helpers/tokens.js"
    click HelpersIndex "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/helpers/index.js"
    click DBConfig "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/config/db.js"
    click Categoria "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/models/Categoria.js"
    click Precio "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/models/Precio.js"
    click Propiedad "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/models/Propiedad.js"
    click Usuario "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/models/Usuario.js"
    click Mensaje "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/models/Mensaje.js"
    click ModelsIndex "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/models/index.js"
    click SeedCat "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/seed/categorias.js"
    click SeedPrice "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/seed/precios.js"
    click SeedUser "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/seed/usuarios.js"
    click Seeder "https://github.com/mateobetancurb/bienes-raices-web-site/blob/main/seed/seeder.js"

    %% Styles
    classDef presentation fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef application fill:#d4edda,stroke:#333,stroke-width:1px
    classDef data fill:#ffe5b4,stroke:#333,stroke-width:1px
    classDef external fill:#e2e3e5,stroke:#333,stroke-width:1px
    classDef pipeline fill:#e0ccff,stroke:#333,stroke-width:1px
```
