# bracr10/homework3_db architecture

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

- Interactive diagram: https://gitdiagram.com/bracr10/homework3_db
- Repository: https://github.com/bracr10/homework3_db

## Overview

A continuación, encontrarás una guía detallada (en español y pensada para un diagrama en blanco y negro) que explica cómo representar con precisión la arquitectura del proyecto “DB POC” (backend Express/TypeScript y frontend Next.js) en un diagrama de sistema.

##### Tipo de proyecto y propósito
- Proyecto full-stack POC de gestión de empleados.
- Backend: API REST en Node.js/Express con TypeScript y SQL Server.
- Frontend: Interfaz en Next.js (React) consumiendo la API.

##### Análisis de la estructura de archivos
- Carpeta raíz:
· db-poc-api/ → código del servidor Express.
· db-poc-ui/  → aplicación Next.js (UI).
- Backend (db-poc-api):
· src/app.ts → punto de entrada.
· src/routes.ts → definición de rutas REST.
· src/controllers/ → controladores HTTP.
· src/services/    → lógica de negocio.
· src/models/      → mapeo de entidades (ORM o definiciones).
· src/dtos/        → contratos de datos (entrada/salida).
· src/config/      → configuración DB.
· src/scripts/sql/ → scripts y procedimientos almacenados SQL.
- Frontend (db-poc-ui):
· src/app/         → páginas y layouts de Next.js.
· src/app/components/ → componentes React.
· src/app/services/   → llamadas HTTP a la API.
· src/app/styles/     → estilos CSS/Tailwind.

##### Pautas para el diagrama de arquitectura
a. Componentes principales:
1. Cliente (navegador web)
2. Frontend Next.js
3. Backend Express/TypeScript
4. Base de datos SQL Server
5. (Opcional) Scripts SQL/procedimientos almacenados

b. Relaciones e interacciones:
- Flechas HTTP (GET/POST) → del Frontend al Backend por rutas REST.
- Flechas SQL → del Backend (servicios) a la base de datos.
- Internamente en el Backend:
– Controlador → Servicio → Modelo → Base de datos.
– DTOs para validar y transformar datos en cada salto.

c. Patrones y principios de diseño:
- Arquitectura en capas (controllers, services, models).
- Separación clara de responsabilidades (MVC ligero).
- Contratos de datos mediante DTOs.
- Código de infraestructura (config, scripts) aislado.

d. Tecnologías clave a anotar:
- TypeScript (∗). Express (∗).
- Next.js. React. TailwindCSS (UI).
- SQL Server (DB), procedimientos almacenados.

##### Directrices específicas para un full-stack
- Dibuja dos bloques grandes: Frontend y Backend, separados por un borde o etiqueta.
- Dentro del Backend, subdivide en:
· Capa de rutas/controladores
· Capa de servicios
· Capa de modelos y scripts SQL
- Conecta Backend a la base de datos con flechas etiquetadas “Query/SP”.
- Destaca las rutas REST principales (por ejemplo: /api/employee, /api/health).

##### Elementos gráficos a incluir (blanco y negro)
- Rectángulos para cada componente (p. ej., “Next.js UI”, “Express API”).
- Flechas sólidas para flujo de datos, con etiquetas (GET, POST, SQL Query).
- Líneas punteadas para dependencias internas (DTOs, config).
- Diferentes formas (rectángulos redondeados para servicios, rectángulos normales para controladores) para distinguir capas.
- Leyenda al pie explicando símbolos y anotaciones.

##### Consejos finales
- Sé muy detallado: muestra cada capa y cómo fluye la información.
- Rotula cada flecha y componente con su nombre y tecnología.
- Asegúrate de plasmar los scripts/procedimientos SQL como una subdivisión de la capa de datos.

Con estas indicaciones podrás crear un diagrama de arquitectura en blanco y negro que refleje con precisión la estructura de este proyecto full-stack, mostrando tanto la interacción entre frontend, backend y base de datos, como la organización interna en capas del servidor.

## Diagram (Mermaid)

```mermaid
flowchart TB
    Cliente(["Cliente (Navegador Web)"]):::external

    subgraph "Frontend Next.js"
        UI["Next.js UI"]:::frontend
        subgraph "Páginas y Layouts"
            AppDir["src/app/"]:::frontend
            Layout["layout.tsx"]:::frontend
            PageHome["page.tsx"]:::frontend
            PageLogin["login/page.tsx"]:::frontend
            PageEmployee["employee/page.tsx"]:::frontend
            PageMovement["movement/page.tsx"]:::frontend
            PageStats["stats/page.tsx"]:::frontend
            PageVacation["vacation/page.tsx"]:::frontend
        end
        subgraph "Componentes React"
            Components["src/app/components/"]:::frontend
        end
        subgraph "Servicios HTTP UI"
            UIServiceDir["src/app/services/"]:::frontend
            DataService1["getEmployees.ts"]:::frontend
            DataService2["insertEmployee.ts"]:::frontend
        end
        subgraph "Estilos"
            Styles["src/app/styles/"]:::frontend
        end
    end

    subgraph "Backend Express/TypeScript"
        API["Express API"]:::backend
        Entry["app.ts"]:::backend
        Routes["routes.ts"]:::backend
        subgraph "Controladores"
            EmployeeCtrl["Employee.controller.ts"]:::controller
            LoginCtrl["Login.controller.ts"]:::controller
        end
        subgraph "Servicios"
            EmployeeSvc["Employee.service.ts"]:::service
            AuthSvc["Auth.service.ts"]:::service
            ApplicationsSvc["Applications.service.ts"]:::service
            MovementSvc["Movement.service.ts"]:::service
            PositionSvc["Position.service.ts"]:::service
            StatsSvc["Stats.service.ts"]:::service
        end
        subgraph "Modelos"
            EmployeeModel["EmployeeModel.ts"]:::model
            ApplicationModel["ApplicationModel.ts"]:::model
            MovementTypeModel["MovementTypeModel.ts"]:::model
            MovementsModel["MovementsModel.ts"]:::model
            PositionModel["PositionModel.ts"]:::model
        end
        subgraph "DTOs"
            EmployeeDTO["EmployeeDTO.ts"]:::dto
            AuthDTO["AuthDTO.ts"]:::dto
            ApplicationsDTO["ApplicationsDTO.ts"]:::dto
            MovementsDTO["MovementsDTO.ts"]:::dto
            PositionDTO["PositionDTO.ts"]:::dto
            StatsDTO["StatsDTO.ts"]:::dto
            ErrorResponseDTO["ErrorResponseDTO.ts"]:::dto
        end
        Config["src/config/db.config.ts"]:::config
        Scripts["src/scripts/sql/"]:::script
    end

    DB["SQL Server"]:::db

    Cliente -->|HTTP GET/POST| UI
    UI -->|fetch /api/*| API

    API --> Entry
    Entry --> Routes
    Routes -->|REST /api/employee| EmployeeCtrl
    Routes -->|REST /api/health| LoginCtrl

    EmployeeCtrl -->|invoca| EmployeeSvc
    LoginCtrl -->|invoca| AuthSvc

    EmployeeSvc -->|usa| EmployeeModel
    AuthSvc -->|usa| ApplicationModel
    ApplicationsSvc -->|usa| ApplicationModel
    MovementSvc -->|usa| MovementsModel
    PositionSvc -->|usa| PositionModel
    StatsSvc -->|usa| MovementsModel

    EmployeeModel -->|Query/SP| DB
    ApplicationModel -->|Query/SP| DB
    MovementsModel -->|Query/SP| DB
    PositionModel -->|Query/SP| DB
    Scripts -->|SP/Init| DB

    EmployeeCtrl -.->|valida| EmployeeDTO
    EmployeeSvc -.->|transforma| EmployeeDTO
    AuthSvc -.->|transforma| AuthDTO

    Cliente --> UI
    UI --> AppDir
    UI --> Components
    UI --> UIServiceDir
    UI --> Styles

    click AppDir "https://github.com/bracr10/homework3_db/tree/main/db-poc-ui/src/app/"
    click Layout "https://github.com/bracr10/homework3_db/blob/main/db-poc-ui/src/app/layout.tsx"
    click PageHome "https://github.com/bracr10/homework3_db/blob/main/db-poc-ui/src/app/page.tsx"
    click PageLogin "https://github.com/bracr10/homework3_db/blob/main/db-poc-ui/src/app/login/page.tsx"
    click PageEmployee "https://github.com/bracr10/homework3_db/blob/main/db-poc-ui/src/app/employee/page.tsx"
    click PageMovement "https://github.com/bracr10/homework3_db/blob/main/db-poc-ui/src/app/movement/page.tsx"
    click PageStats "https://github.com/bracr10/homework3_db/blob/main/db-poc-ui/src/app/stats/page.tsx"
    click PageVacation "https://github.com/bracr10/homework3_db/blob/main/db-poc-ui/src/app/vacation/page.tsx"
    click Components "https://github.com/bracr10/homework3_db/tree/main/db-poc-ui/src/app/components/"
    click UIServiceDir "https://github.com/bracr10/homework3_db/tree/main/db-poc-ui/src/app/services/"
    click Entry "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/app.ts"
    click Routes "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/routes.ts"
    click EmployeeCtrl "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/controllers/Employee.controller.ts"
    click LoginCtrl "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/controllers/Login.controller.ts"
    click EmployeeSvc "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/services/Employee.service.ts"
    click AuthSvc "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/services/Auth.service.ts"
    click ApplicationsSvc "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/services/Applications.service.ts"
    click MovementSvc "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/services/Movement.service.ts"
    click PositionSvc "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/services/Position.service.ts"
    click StatsSvc "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/services/Stats.service.ts"
    click EmployeeModel "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/models/EmployeeModel.ts"
    click ApplicationModel "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/models/ApplicationModel.ts"
    click MovementTypeModel "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/models/MovementTypeModel.ts"
    click MovementsModel "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/models/MovementsModel.ts"
    click PositionModel "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/models/PositionModel.ts"
    click EmployeeDTO "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/dtos/EmployeeDTO.ts"
    click AuthDTO "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/dtos/AuthDTO.ts"
    click ApplicationsDTO "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/dtos/ApplicationsDTO.ts"
    click MovementsDTO "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/dtos/MovementsDTO.ts"
    click PositionDTO "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/dtos/PositionDTO.ts"
    click StatsDTO "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/dtos/StatsDTO.ts"
    click ErrorResponseDTO "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/dtos/ErrorResponseDTO.ts"
    click Config "https://github.com/bracr10/homework3_db/blob/main/db-poc-api/src/config/db.config.ts"
    click Scripts "https://github.com/bracr10/homework3_db/tree/main/db-poc-api/src/scripts/sql/"

    classDef external fill:#cccccc,stroke:#000,stroke-width:1px
    classDef frontend fill:#e0f7fa,stroke:#000,stroke-width:1px
    classDef backend fill:#ffe0b2,stroke:#000,stroke-width:1px
    classDef controller fill:#fff9c4,stroke:#000,stroke-width:1px
    classDef service fill:#d1c4e9,stroke:#000,stroke-width:1px,stroke-dasharray: 5 5
    classDef model fill:#b2dfdb,stroke:#000,stroke-width:1px
    classDef dto stroke:#000,stroke-width:1px,stroke-dasharray: 2 2
    classDef config fill:#ffccbc,stroke:#000,stroke-width:1px
    classDef script fill:#c8e6c9,stroke:#000,stroke-width:1px
    classDef db fill:#cfd8dc,stroke:#000,stroke-width:2px,stroke-dasharray: 4 2
```
