# devacampuzano/bootcamp-l2-g051-c3-pr-i-v architecture

> Architecture diagram of the GitHub repository devacampuzano/bootcamp-l2-g051-c3-pr-i-v, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v
- Repository: https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v

## Overview

Para dibujar un diagrama de arquitectura claro, preciso y ajustado a este repositorio (un “monorepo” con varios proyectos de ejemplo del bootcamp), sigue estos pasos:

##### Identifica el propósito global y los sub-proyectos
- El README raíz indica que es un contenedor de prácticas de JavaScript, React, Node/Bun, Flask, MySQL, TypeScript, etc.
- Cada carpeta numerada (01-javascript, 02-primer-proyecto-react, 03-js-vs-ts, 04-api-peliculas, 05-Mysql, 06-express, 07-test-bun, 08-server) es un proyecto independiente, con su propia tecnología y patrón arquitectónico.

##### Clasifica los proyectos por tipo y stack
- 01-javascript: página estática HTML+JS (front-end puro).
- 02-primer-proyecto-react y 04-api-peliculas: SPAs en React con Vite, TypeScript y estructura de componentes/páginas.
- 03-js-vs-ts: ejemplos comparativos de JS vs TS (biblioteca local, sin infraestructura de despliegue).
- 05-Mysql: scripts SQL y esquemas de base de datos.
- 06-express y 08-server: servidores Node.js/Express, organización MVC ligera (modelos en src/models, controlador en index.js).
- 07-test-bun: script de prueba usando Bun + TS.

##### Para cada sub-proyecto crea un diagrama separado, siguiendo esta plantilla
a. Componentes principales
- Frontend (HTML/JS o React),
- Bundler (Vite/Bun/Node),
- Backend/API (Express/Flask),
- Base de datos (MySQL),
- Servicios externos (APIs de terceros, p.ej. TMDB en 04-api-peliculas).
b. Relaciones e interacciones
- Flechas HTTP/REST (cliente → servidor → DB),
- Llamadas internas (componentes → servicios · modules),
- Flujo de construcción (fuente → bundler → bundle).
c. Patrones arquitectónicos
- SPA con capa de rutas/páginas y servicios de datos,
- MVC ligero en Express (modelo-vista-controlador),
- Monolito educativo vs micro-servicio modular.
d. Tecnologías clave
- React, TypeScript, Vite, Node.js, Bun, Express, MySQL, Flask (aunque Flask no aparece en carpetas, se menciona que se maneja en el bootcamp).

##### Guía para adaptar el diagrama al tipo de proyecto
- Front-end puro (01-javascript):
- Un rectángulo para “Browser” mostrando HTML/CSS/JS.
- Un rectángulo para “index.js” que interactúa con el DOM.
- SPA React (02 y 04):
- Nodos para “Componente raíz (App.tsx)”, “Components”, “Pages”, “movieDB.ts (servicio API)”.
- Flujo: Browser → Vite dev server/static → React App → movieDB.ts → External TMDB API.
- API-películas (front-only):
- Añade un cilindro o nube para “TMDB API”.
- Servidor Express (06, 08):
- Módulos: index.js (entrypoint), src/models (capa de datos), opcional src/controllers.
- Cilindro para “MySQL” si se conecta (o placeholder si no).
- Flechas: Cliente HTTP → Express routes → Modelos → Base de datos.
- MySQL (05):
- Úsalo como base de datos compartida: diagrama de ER o despliegue de servidor MySQL.
- Scripts Bun (07):
- Nodo “Bun runtime” ejecutando index.ts.

##### Elementos imprescindibles en el diagrama
- Etiquetas claras en cada componente (p.ej. “Vite dev server”, “App.tsx”, “Express Router”).
- Flechas direccionales que indiquen el flujo de datos o dependencias.
- Front-end (azul), Backend/API (verde), Bases de datos (amarillo/cilindro), Servicios externos (nube).

##### Consejos finales
- Sé detallado: incluye cada carpeta importante (src/components, src/pages, models).
- No temas replicar el nivel de granularidad de la carpeta: mejor muchos componentes bien nombrados que uno gigante.
- Asegura que cualquier persona que vea el diagrama pueda localizar fácilmente el folder/file correspondiente en el repositorio.

Con este enfoque modular, tendrás diagramas precisos para cada práctica del bootcamp, reflejando claramente tecnologías, componentes y flujos de datos.

## Diagram (Mermaid)

```mermaid
flowchart TB
  %% 01-javascript
  subgraph "01-javascript (Frontend Pure)" 
    style 01-javascript fill:#f0f8ff,stroke:#000,stroke-width:1px
    J01_HTML["index.html"]:::frontend
    J01_JS["index.js"]:::frontend
    J01_LIST_HTML["listar-datos.html"]:::frontend
    J01_LIST_JS["listar-datos.js"]:::frontend
  end
  J01_HTML -->|loads| J01_JS
  J01_LIST_HTML -->|loads| J01_LIST_JS

  %% 02-primer-proyecto-react
  subgraph "02-primer-proyecto-react (React SPA)" 
    style 02-primer-proyecto-react fill:#f0f8ff,stroke:#000,stroke-width:1px
    R02_HTML["index.html"]:::frontend
    R02_VITE["vite.config.ts"]:::backend
    R02_MAIN["main.tsx"]:::frontend
    R02_APP["App.tsx"]:::frontend
    R02_INPUT["InputNumber.tsx"]:::frontend
    R02_ASSETS["assets"]:::frontend
    R02_TSCONF["tsconfig.json"]:::backend
  end
  R02_HTML -->|served by Vite| R02_VITE
  R02_VITE -->|bundles| R02_MAIN
  R02_MAIN -->|renders| R02_APP
  R02_APP -->|uses| R02_INPUT
  R02_APP -->|loads| R02_ASSETS

  %% 03-js-vs-ts
  subgraph "03-js-vs-ts (JS vs TS Examples)"
    style 03-js-vs-ts fill:#f0f8ff,stroke:#000,stroke-width:1px
    C03_JS["example.js"]:::frontend
    C03_TS["example.ts"]:::frontend
  end

  %% 04-api-peliculas
  subgraph "04-api-peliculas (React + TMDB API)"
    style 04-api-peliculas fill:#f0f8ff,stroke:#000,stroke-width:1px
    P04_HTML["index.html"]:::frontend
    P04_VITE["vite.config.ts"]:::backend
    P04_MAIN["main.tsx"]:::frontend
    P04_APP["App.tsx"]:::frontend
    P04_MOVIESVC["movieDB.ts"]:::backend
    P04_LAYOUT["Layout.tsx"]:::frontend
    P04_TAG["Tag.tsx"]:::frontend
    subgraph Pages
      LOGIN["login/index.tsx"]:::frontend
      REGISTER["register/index.tsx"]:::frontend
      DASH["dashboard/index.tsx"]:::frontend
      DETAILS["movies-details/index.tsx"]:::frontend
      NOTFOUND["404/index.tsx"]:::frontend
    end
    TMDB["TMDB API"]:::external
  end
  P04_HTML -->|served by Vite| P04_VITE
  P04_VITE -->|bundles| P04_MAIN
  P04_MAIN -->|renders| P04_APP
  P04_APP -->|routes to| Pages
  P04_APP -->|calls| P04_MOVIESVC
  P04_MOVIESVC -->|requests| TMDB

  %% 05-Mysql
  subgraph "05-Mysql (Database Scripts)"
    style 05-Mysql fill:#fffacd,stroke:#000,stroke-width:1px
    SQL_DUMP["Dump20250505.sql"]:::db
    SQL_EX1["primera-clase.sql"]:::db
    SQL_JOIN["funciones-join.sql"]:::db
    SQL_VET["veterinaria.sql"]:::db
  end

  %% 06-express
  subgraph "06-express (Node Express API)"
    style 06-express fill:#d0f0c0,stroke:#000,stroke-width:1px
    E06_ENTRY["index.js"]:::backend
    E06_PKG["package.json"]:::backend
  end

  %% 07-test-bun
  subgraph "07-test-bun (Bun TS Script)"
    style 07-test-bun fill:#add8e6,stroke:#000,stroke-width:1px
    B07_INDEX["index.ts"]:::backend
    B07_TSCONF["tsconfig.json"]:::backend
    B07_PKG["package.json"]:::backend
    B07_LOCK["bun.lock"]:::backend
  end
  B07_INDEX --> B07_TSCONF

  %% 08-server
  subgraph "08-server (Express MVC Light)"
    style 08-server fill:#d0f0c0,stroke:#000,stroke-width:1px
    S08_ENTRY["index.js"]:::backend
    S08_MODEL["src/models/Server.js"]:::backend
    S08_PKG["package.json"]:::backend
  end
  S08_ENTRY -->|uses| S08_MODEL

  %% Click Events
  click J01_HTML "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/01-javascript/index.html"
  click J01_JS "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/01-javascript/index.js"
  click J01_LIST_HTML "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/01-javascript/listar-datos.html"
  click J01_LIST_JS "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/01-javascript/listar-datos.js"
  click R02_HTML "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/02-primer-proyecto-react/index.html"
  click R02_VITE "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/02-primer-proyecto-react/vite.config.ts"
  click R02_MAIN "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/02-primer-proyecto-react/src/main.tsx"
  click R02_APP "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/02-primer-proyecto-react/src/App.tsx"
  click R02_INPUT "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/02-primer-proyecto-react/src/compontentes/InpuntNumber.tsx"
  click R02_ASSETS "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/tree/main/02-primer-proyecto-react/src/assets"
  click R02_TSCONF "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/02-primer-proyecto-react/tsconfig.json"
  click C03_JS "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/03-js-vs-ts/example.js"
  click C03_TS "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/03-js-vs-ts/example.ts"
  click P04_HTML "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/index.html"
  click P04_VITE "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/vite.config.ts"
  click P04_MAIN "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/src/main.tsx"
  click P04_APP "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/src/App.tsx"
  click P04_MOVIESVC "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/src/movieDB.ts"
  click P04_LAYOUT "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/src/components/Layout.tsx"
  click P04_TAG "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/src/components/Tag.tsx"
  click LOGIN "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/src/pages/login/index.tsx"
  click REGISTER "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/src/pages/register/index.tsx"
  click DASH "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/src/pages/dashboard/index.tsx"
  click DETAILS "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/src/pages/movies-details/index.tsx"
  click NOTFOUND "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/04-api-peliculas/src/pages/404/index.tsx"
  click SQL_DUMP "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/05-Mysql/Dump20250505.sql"
  click SQL_EX1 "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/05-Mysql/primera-clase.sql"
  click SQL_JOIN "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/05-Mysql/funciones-join.sql"
  click SQL_VET "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/05-Mysql/veterinaria.sql"
  click E06_ENTRY "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/06-express/index.js"
  click E06_PKG "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/06-express/package.json"
  click B07_INDEX "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/07-test-bun/index.ts"
  click B07_TSCONF "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/07-test-bun/tsconfig.json"
  click B07_PKG "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/07-test-bun/package.json"
  click B07_LOCK "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/07-test-bun/bun.lock"
  click S08_ENTRY "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/08-server/index.js"
  click S08_MODEL "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/08-server/src/models/Server.js"
  click S08_PKG "https://github.com/devacampuzano/bootcamp-l2-g051-c3-pr-i-v/blob/main/08-server/package.json"

  %% Styles
  classDef frontend fill:#add8e6,stroke:#000,stroke-width:1px
  classDef backend fill:#90ee90,stroke:#000,stroke-width:1px
  classDef db fill:#fffacd,stroke:#000,stroke-width:1px
  classDef external fill:#f5f5f5,stroke:#000,stroke-width:1px
```
