# cngel/devtool-temcubico architecture

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

- Interactive diagram: https://gitdiagram.com/cngel/devtool-temcubico
- Repository: https://github.com/cngel/devtool-temcubico

## Overview

TemKubico is a real-estate listings API. Its main workflow accepts a user request, applies route-level validation or JWT authentication where required, then handles account or property operations and returns JSON; property creation also stores uploaded images. The graph includes the documented account, listing/search, recovery, and mail capabilities. Some recovery and persistence internals were not shown, so their relationships are omitted where the excerpts do not establish them.

Main entry points: [`routers.js`](https://github.com/cngel/devtool-temcubico/blob/main/routers.js) (API Routes), [`src/models`](https://github.com/cngel/devtool-temcubico/tree/main/src/models) (Account Data Access), [`src/controllers/hauseController.js`](https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/hauseController.js) (Listing Controller), [`server.js`](https://github.com/cngel/devtool-temcubico/blob/main/server.js) (Express Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_server["Express Server<br/>[server.js]"]
  node_routes["API Routes<br/>[routers.js]"]
  node_validation["Request Validation<br/>[validatorShema.js]"]
  node_user_validation["User Rules<br/>[userValidator.js]"]
  node_house_validation["Listing Rules"]
  node_jwt["JWT Middleware<br/>[loginMidellwere.js]"]
end

subgraph group_accounts["Accounts"]
  node_registration["Registration"]
  node_login["Login<br/>[login.js]"]
  node_profile["Profile Management<br/>[usercontroller.js]"]
  node_recovery["Password Recovery<br/>[forgetPassord.js]"]
  node_recovery_finish["Recovery Completion"]
  node_mail_sender["Recovery Mail Sender<br/>[sendMail.js]"]
end

subgraph group_listings["Property Listings"]
  node_house_controller["Listing Controller<br/>[hauseController.js]"]
  node_house_queries["Listing Queries<br/>[querys.js]"]
  node_house_model["House Model<br/>[hauseModel.js]"]
  node_image_files["Listing Images"]
end

subgraph group_data["Data and Integrations"]
  node_account_models["Account Data Access"]
  node_prisma["Prisma Client<br/>[prisma.js]"]
  node_database[("MySQL Database")]
  node_mail_transport["Mail Transport<br/>[trasport.js]"]
end

node_client(("API Client"))
node_mail_service["Email Service"]

node_client -->|"sends requests"| node_server
node_server -->|"mounts routes"| node_routes
node_routes -->|"dispatches listings"| node_house_controller
node_routes -->|"dispatches signup"| node_registration
node_routes -->|"dispatches login"| node_login
node_routes -->|"dispatches profile"| node_profile
node_routes -->|"dispatches recovery"| node_recovery
node_routes -->|"dispatches completion"| node_recovery_finish
node_routes -->|"runs validation"| node_validation
node_routes -->|"applies user rules"| node_user_validation
node_routes -->|"applies listing rules"| node_house_validation
node_routes -->|"checks protected routes"| node_jwt
node_registration -->|"creates account"| node_account_models
node_login -->|"looks up email"| node_account_models
node_profile -->|"updates profile"| node_account_models
node_recovery -->|"looks up email"| node_account_models
node_house_controller -->|"runs listing queries"| node_house_queries
node_house_controller -->|"writes uploads"| node_image_files
node_house_queries -->|"queries listings"| node_prisma
node_prisma -.->|"accesses MySQL"| node_database
node_mail_sender -->|"sends message"| node_mail_transport
node_mail_transport -.->|"delivers email"| node_mail_service

click node_server "https://github.com/cngel/devtool-temcubico/blob/main/server.js"
click node_routes "https://github.com/cngel/devtool-temcubico/blob/main/routers.js"
click node_validation "https://github.com/cngel/devtool-temcubico/blob/main/src/validators/validatorShema.js"
click node_user_validation "https://github.com/cngel/devtool-temcubico/blob/main/src/validators/userValidator.js"
click node_house_validation "https://github.com/cngel/devtool-temcubico/blob/main/src/midellwers/valideitorsToPost.js"
click node_jwt "https://github.com/cngel/devtool-temcubico/blob/main/src/midellwers/loginMidellwere.js"
click node_registration "https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/cadastroController.js"
click node_login "https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/login.js"
click node_profile "https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/usercontroller.js"
click node_recovery "https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/user/forgetPassord.js"
click node_recovery_finish "https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/user/recuperarPassword.js"
click node_account_models "https://github.com/cngel/devtool-temcubico/tree/main/src/models"
click node_house_controller "https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/hauseController.js"
click node_house_queries "https://github.com/cngel/devtool-temcubico/blob/main/src/models/querys.js"
click node_house_model "https://github.com/cngel/devtool-temcubico/blob/main/src/models/hauseModel.js"
click node_image_files "https://github.com/cngel/devtool-temcubico/tree/main/src/public/image"
click node_prisma "https://github.com/cngel/devtool-temcubico/blob/main/src/config/prisma.js"
click node_mail_sender "https://github.com/cngel/devtool-temcubico/blob/main/src/mail/sendMail.js"
click node_mail_transport "https://github.com/cngel/devtool-temcubico/blob/main/src/mail/trasport.js"

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_server,node_routes,node_validation,node_user_validation,node_house_validation,node_jwt,node_client toneBlue
class node_registration,node_login,node_profile,node_recovery,node_recovery_finish,node_mail_sender toneAmber
class node_house_controller,node_house_queries,node_house_model,node_image_files toneMint
class node_account_models,node_prisma,node_database,node_mail_transport toneRose
class node_mail_service toneIndigo
```

## Components

### HTTP API

- [Express Server](https://github.com/cngel/devtool-temcubico/blob/main/server.js): `server.js`
- [API Routes](https://github.com/cngel/devtool-temcubico/blob/main/routers.js): `routers.js`
- [Request Validation](https://github.com/cngel/devtool-temcubico/blob/main/src/validators/validatorShema.js): `src/validators/validatorShema.js`
- [User Rules](https://github.com/cngel/devtool-temcubico/blob/main/src/validators/userValidator.js): `src/validators/userValidator.js`
- [Listing Rules](https://github.com/cngel/devtool-temcubico/blob/main/src/midellwers/valideitorsToPost.js): `src/midellwers/valideitorsToPost.js`
- [JWT Middleware](https://github.com/cngel/devtool-temcubico/blob/main/src/midellwers/loginMidellwere.js): `src/midellwers/loginMidellwere.js`

### Accounts

- [Registration](https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/cadastroController.js): `src/controllers/cadastroController.js`
- [Login](https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/login.js): `src/controllers/login.js`
- [Profile Management](https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/usercontroller.js): `src/controllers/usercontroller.js`
- [Password Recovery](https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/user/forgetPassord.js): `src/controllers/user/forgetPassord.js`
- [Recovery Completion](https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/user/recuperarPassword.js): `src/controllers/user/recuperarPassword.js`
- [Recovery Mail Sender](https://github.com/cngel/devtool-temcubico/blob/main/src/mail/sendMail.js): `src/mail/sendMail.js`

### Property Listings

- [Listing Controller](https://github.com/cngel/devtool-temcubico/blob/main/src/controllers/hauseController.js): `src/controllers/hauseController.js`
- [Listing Queries](https://github.com/cngel/devtool-temcubico/blob/main/src/models/querys.js): `src/models/querys.js`
- [House Model](https://github.com/cngel/devtool-temcubico/blob/main/src/models/hauseModel.js): `src/models/hauseModel.js`
- [Listing Images](https://github.com/cngel/devtool-temcubico/tree/main/src/public/image): `src/public/image`

### Data and Integrations

- [Account Data Access](https://github.com/cngel/devtool-temcubico/tree/main/src/models): `src/models`
- [Prisma Client](https://github.com/cngel/devtool-temcubico/blob/main/src/config/prisma.js): `src/config/prisma.js`
- **MySQL Database**
- [Mail Transport](https://github.com/cngel/devtool-temcubico/blob/main/src/mail/trasport.js): `src/mail/trasport.js`

### Other components

- **API Client**
- **Email Service**

## Connections

- API Client → Express Server: sends requests (evidence: `README.md`)
- Express Server → API Routes: mounts routes (evidence: `server.js`)
- API Routes → Listing Controller: dispatches listings (evidence: `routers.js`)
- API Routes → Registration: dispatches signup (evidence: `routers.js`)
- API Routes → Login: dispatches login (evidence: `routers.js`)
- API Routes → Profile Management: dispatches profile (evidence: `routers.js`)
- API Routes → Password Recovery: dispatches recovery (evidence: `routers.js`)
- API Routes → Recovery Completion: dispatches completion (evidence: `routers.js`)
- API Routes → Request Validation: runs validation (evidence: `routers.js`)
- API Routes → User Rules: applies user rules (evidence: `routers.js`)
- API Routes → Listing Rules: applies listing rules (evidence: `routers.js`)
- API Routes → JWT Middleware: checks protected routes (evidence: `routers.js`)
- Registration → Account Data Access: creates account (evidence: `src/controllers/cadastroController.js`)
- Login → Account Data Access: looks up email (evidence: `src/controllers/login.js`)
- Profile Management → Account Data Access: updates profile (evidence: `src/controllers/usercontroller.js`)
- Password Recovery → Account Data Access: looks up email (evidence: `src/controllers/user/forgetPassord.js`)
- Listing Controller → Listing Queries: runs listing queries (evidence: `src/controllers/hauseController.js`)
- Listing Controller → Listing Images: writes uploads (evidence: `src/controllers/hauseController.js`)
- Listing Queries → Prisma Client: queries listings (evidence: `src/models/querys.js`)
- Prisma Client → MySQL Database: accesses MySQL (evidence: `README.md`)
- Recovery Mail Sender → Mail Transport: sends message (evidence: `src/mail/sendMail.js`)
- Mail Transport → Email Service: delivers email
