# danielayala-06/proyecto-final-seminario architecture

> Architecture diagram of the GitHub repository danielayala-06/proyecto-final-seminario, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/danielayala-06/proyecto-final-seminario
- Repository: https://github.com/danielayala-06/proyecto-final-seminario

## Overview

##### Project type and purpose
- This is a full-stack web application (“Proyecto para gestionar prestamos”) built with Node.js/Express on the back end, serving a server-rendered multi-page UI and client-side JavaScript for dynamic behavior. Its goal is to allow users to create and manage clients, loans (préstamos), and payments (pagos).

##### File structure
- Top-level server entry: server.js
- Configuration: config/db.js (database connection)
- Routing layer: routes/*Router.js (Express routers for cliente, prestamos, pagos)
- Controller layer: controllers/*Controller.js (business logic for each entity)
- Public (web assets):
- public/views/... (HTML templates organized by feature)
- public/js/*.js (client-side scripts)
- Package and environment: package.json / .gitignore / .vscode

Pattern: a classic MVC (Model-View-Controller) or layered architecture:
- Router → Controller → Database
- Views + JS handle the client side

##### README

a. Main components
1. Client browser (renders HTML + runs client JS)
2. Web server (Node.js/Express)
- Router layer
- Controller layer
- Database access (via config/db.js)
3. Database (e.g., MySQL / PostgreSQL / MongoDB)
4. Static asset store (public folder)
5. Optional: Development tools (VSCode launch, environment variables)

b. Relationships and interactions
- The client issues HTTP requests (GET/POST) to Express routers.
- Routers forward to controllers.
- Controllers validate input, execute queries via the DB connector in config/db.js.
- Database returns results; controllers format responses.
- Server renders HTML views or returns JSON.
- Client-side JS fetches additional data or posts new data.

c. Architectural patterns and principles
- Layered / MVC: clear separation between routing, business logic, and data access.
- Directory-by-feature organization for views and scripts.
- Single responsibility: each controller handles one entity (cliente, prestamo, pago).

d. Key technologies
- Node.js, Express.js
- Database driver (e.g., mysql2 or mongoose) in config/db.js
- HTML templating (static HTML in public/views)
- Client-side JS for dynamic forms
- package.json for dependencies

##### Detail
- Important scripts (e.g., pago.js calls /pagos endpoint).
- Which HTML view maps to which router/controller.
- Environment/config dependencies (e.g., .env for DB credentials).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    ClientBrowser["Client Browser"]:::client
    Views["HTML Templates (public/views/)"]:::client
    Scripts["Client-side JS (public/js/)"]:::client

    %% Server Layer
    subgraph "Server (Node.js/Express)"
        Entry["server.js"]:::server
        subgraph "Routing Layer"
            ClienteRouter["Express Router: clienteRouter.js"]:::server
            PrestamoRouter["Express Router: prestamoRouter.js"]:::server
            PagosRouter["Express Router: pagosRouter.js"]:::server
        end
        subgraph "Controller Layer"
            ClienteController["Cliente Controller (controllers/clienteController.js)"]:::server
            PrestamosController["Prestamos Controller (controllers/prestamosController.js)"]:::server
            PagosController["Pagos Controller (controllers/pagosController.js)"]:::server
        end
        DataAccess["Config/DB Connector (config/db.js)"]:::server
        Support["Package & Env (package.json, .gitignore, .vscode)"]:::support
    end

    %% Database Layer
    DB["Database"]:::db

    %% Connections
    ClientBrowser -->|"HTTP GET/POST"| Entry
    ClientBrowser -->|"Renders HTML & JS"| Views
    ClientBrowser -->|"Executes Scripts"| Scripts

    Entry --> ClienteRouter
    Entry --> PrestamoRouter
    Entry --> PagosRouter

    ClienteRouter -->|"calls"| ClienteController
    PrestamoRouter -->|"calls"| PrestamosController
    PagosRouter -->|"calls"| PagosController

    ClienteController -->|"queries"| DataAccess
    PrestamosController -->|"queries"| DataAccess
    PagosController -->|"queries"| DataAccess

    DataAccess -->|"connects to"| DB
    Support -.-> Entry

    %% Click Events
    click ClientBrowser "https://github.com/danielayala-06/proyecto-final-seminario/tree/main/public/views/"
    click Views "https://github.com/danielayala-06/proyecto-final-seminario/tree/main/public/views/"
    click Scripts "https://github.com/danielayala-06/proyecto-final-seminario/tree/main/public/js/"
    click Entry "https://github.com/danielayala-06/proyecto-final-seminario/blob/main/server.js"
    click DataAccess "https://github.com/danielayala-06/proyecto-final-seminario/blob/main/config/db.js"
    click ClienteRouter "https://github.com/danielayala-06/proyecto-final-seminario/blob/main/routes/clienteRouter.js"
    click PrestamoRouter "https://github.com/danielayala-06/proyecto-final-seminario/blob/main/routes/prestamoRouter.js"
    click PagosRouter "https://github.com/danielayala-06/proyecto-final-seminario/blob/main/routes/pagosRouter.js"
    click ClienteController "https://github.com/danielayala-06/proyecto-final-seminario/blob/main/controllers/clienteController.js"
    click PrestamosController "https://github.com/danielayala-06/proyecto-final-seminario/blob/main/controllers/prestamosController.js"
    click PagosController "https://github.com/danielayala-06/proyecto-final-seminario/blob/main/controllers/pagosController.js"
    click Support "https://github.com/danielayala-06/proyecto-final-seminario/blob/main/package.json"

    %% Styles
    classDef client fill:#D6EAF8,stroke:#2980B9,color:#1B4F72
    classDef server fill:#D5F5E3,stroke:#27AE60,color:#145A32
    classDef db fill:#FAD7A0,stroke:#D68910,color:#7E5109
    classDef support fill:#E8DAEF,stroke:#8E44AD,color:#4A235A
```
