# bryanvalenzuela7/proyectoxeniafullpower architecture

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

- Interactive diagram: https://gitdiagram.com/bryanvalenzuela7/proyectoxeniafullpower
- Repository: https://github.com/bryanvalenzuela7/proyectoxeniafullpower

## Overview

##### Qué es este proyecto (tipo y propósito) según el árbol + README
**ProyectoXeniaFullPower** es un **gestor de SS** (probablemente “Servicio Social”) con **dos clientes**:
- **Web**: una app **Next.js (App Router)** en `ProyectoXenia/src/app` con páginas y **API Routes** en `src/app/api/...`.
- **Móviles**: una app **React Native / Expo** en `ProyectoXeniaMoviles/proyectomoviles` que consume endpoints (hay `libs/index-fetch.js`).

Además, hay una capa de **persistencia con Prisma**:
- `ProyectoXenia/prisma/schema.prisma`, `migrations/*`, `seeds/seeds.ts`, y una DB local `dev.db` (indicando **SQLite en dev**, al menos).

También aparece:
- `ProyectoXenia/gestor-ss/package.json` (posible subproyecto/paquete adicional; si no está documentado en README, en el diagrama conviene reflejarlo como “módulo/paquete adicional” o “servicio” pendiente de validar).
- `ProyectoXenia/app.js` en la raíz (posible servidor Node/Express o script; sin contenido no se puede asegurar, pero conviene ubicarlo como “entrypoint Node auxiliar” si efectivamente se usa).

##### Cómo “partir” el sistema en componentes (lo que debe verse en el diagrama)
Para que el diagrama sea lo más **exacto** posible, dibújalo en **capas** y **por contenedores** (estilo C4, aunque no hace falta seguirlo al pie de la letra).

##### Clientes (Frontends)
**Web (Next.js)**
- Páginas/rutas UI:
- `src/app/inicio/page.jsx`
- `src/app/login/page.jsx`
- `src/app/menu/page.jsx`
- `src/app/usuario/page.jsx`
- `src/app/formulario/page.jsx`
- `src/app/fetcheo/page.jsx`
- Componentes UI reutilizables:
- `src/components/*` (Navbar, Renderizado, Formulario, Footer, etc.)
- Estilos:
- `globals.css`, `styles/*.css`, Tailwind (`tailwind.config.js`, `postcss.config.js`)

**Móviles (React Native/Expo)**
- Entrada y navegación:
- `App.jsx`, `AppNavigator.js`
- Pantallas/componentes:
- `components/login.jsx`, `components/menuPrincipal.jsx`, etc.
- Capa de llamadas:
- `libs/index-fetch.js` (esto sugiere “cliente HTTP” compartido en móvil, apuntando a la API)

**En el diagrama**: representa **dos consumidores** distintos del mismo backend/API.

##### Backend (en este repo está dentro de Next)
En Next App Router, el “backend” suele ser:
- **API Routes (Route Handlers)**:
- `src/app/api/datosusuario/route.js` (colección)
- `src/app/api/datosusuario/[id]/route.js` (recurso por id)
- Además hay “routes” que parecen server actions/handlers de autenticación o similar:
- `src/app/login/route/route.js`
- `src/app/usuario/route/route.js`

**En el diagrama**: dibuja un contenedor “Next.js Server” y dentro subdivide:
- “Web UI Routes”
- “API Routes / Route Handlers”
- “Auth/User Handlers” (si aplica)

##### Persistencia (DB + ORM)
**Prisma ORM**
- Cliente Prisma:
- `src/libs/prisma.js`
- Esquema:
- `prisma/schema.prisma`
- Migraciones:
- `prisma/migrations/*`
- Seeds:
- `prisma/seeds/seeds.ts`
- DB dev:
- `prisma/dev.db` (indica SQLite local)

**En el diagrama**: pon “Prisma” como **capa de acceso a datos** entre la API y la Base de Datos.

##### Módulos/paquetes auxiliares (a representar si se usan)
- `gestor-ss/` (tiene `package.json`, puede ser un subproyecto).
- `app.js` (posible servidor/script).

Si no confirmas su rol, en un diagrama “honesto” ponlos como:
- “Servicio/Paquete auxiliar (validar)” con una nota o estilo punteado.

##### Relaciones e interacciones (flechas obligatorias)
Tu diagrama debe mostrar **dirección** y **tipo** de interacción:

##### Web (Next UI) → (HTTP internal / Next fetch) → API Routes
- Muchas veces UI y API viven en el mismo runtime de Next; aún así conviene dibujar la frontera “UI” vs “API”.

##### App Móvil → (HTTPS) → API Routes en Next
- Aquí sí es claramente red.

##### API Routes → (Prisma Client) → DB (SQLite dev / otra en prod)
- Si hay `.env`, sugiere `DATABASE_URL` configurable. Dibuja la DB como “SQLite (dev) / (RDBMS en prod si aplica)”.

##### (Opcional) Seeds/Migrations → DB
- No es tráfico runtime, pero sí parte de la arquitectura operativa (pipeline de datos).

##### Patrones/decisiones arquitectónicas que vale la pena destacar visualmente
- **BFF integrado**: Next.js hace de frontend + backend (API Routes) en un solo deployment.
- **API tipo REST** (por estructura `/api/datosusuario` y `/api/datosusuario/[id]`).
- **ORM Prisma** como capa DAL.
- **Multi-client** (Web + Mobile) consumiendo la misma API.
- **Shared “fetch layer”** (al menos en móvil) vía `libs/index-fetch.js`; en web también hay `src/libs/index-fetch.js` (hay una en web: `ProyectoXenia/src/libs/index-fetch.js`), lo que sugiere un patrón de “API client” para centralizar llamadas.

##### Cómo dibujar el “mejor” diagrama para ESTE proyecto (recomendación práctica)
Hazlo en 3 niveles (en 1 sola lámina o 3 láminas separadas):

##### Nivel 1: Contexto (quién usa qué)
- Actor: “Usuario”
- Sistemas:
- “Xenia Web”
- “Xenia Móviles”
- “ProyectoXenia Backend (Next.js API)”
- “Base de Datos”
- Flechas: Usuario→Web, Usuario→Móvil, Web→API, Móvil→API, API→DB

##### Nivel 2: Contenedores (dentro del repo)
- Contenedor: **ProyectoXenia (Next.js App)**
- Subcajas:
- UI Routes (`src/app/*/page.jsx`)
- API Routes (`src/app/api/**/route.js`)
- Auth/User handlers (`src/app/**/route/route.js`)
- Libs (`src/libs/prisma.js`, `src/libs/index-fetch.js`)
- Contenedor: **Prisma**
- Schema/migrations/seeds
- Contenedor: **DB**
- `dev.db` (dev)
- Contenedor: **ProyectoXeniaMoviles (Expo RN)**
- UI + navegación + `libs/index-fetch.js`

##### Nivel 3: Componentes (solo lo más “crítico”)
- Dentro de API:
- `datosusuario` collection handler
- `datosusuario/:id` handler
- (si aplica) login handler, usuario handler
- Dentro de persistencia:
- Prisma Client
- Tablas/modelos (derivados de schema.prisma; aquí conviene leer el schema para nombrarlas en el diagrama: User, DatosUsuario, etc.)

##### Elementos visuales que DEBES incluir (para que sea muy detallado)
- **Labels claros** con rutas reales:
- “GET/POST /api/datosusuario”
- “GET/PUT/DELETE /api/datosusuario/:id” (si corresponde; confirma en código)
- **Flechas dirigidas** con protocolo:
- “HTTPS/JSON”
- “Prisma query”
- **Colores/figuras por tipo**:
- Clientes (Web/Mobile): rectángulos azules
- Backend (Next Server): rectángulo verde
- Persistencia (Prisma): rombo/capa intermedia o rectángulo amarillo
- DB: cilindro
- Elementos “por validar” (gestor-ss, app.js): borde punteado gris
- **Notas operativas**:
- `.env` (config: `DATABASE_URL`, secrets)
- Migraciones/seeds (flujo offline)

##### Checklist para que el diagrama sea “lo más exacto”
1) Abre `ProyectoXenia/package.json` y `ProyectoXeniaMoviles/proyectomoviles/package.json` para confirmar:
- scripts (dev/build/start), puertos, si hay proxy/baseURL, etc.
##### Revisa cada `route.js` para anotar métodos HTTP y dependencias (auth, validaciones).
4) Decide si `gestor-ss/` y `app.js` participan en runtime; si sí, dibuja sus flechas. Si no, márcalos como “tooling/experimental”.

Con esto obtendrás un diagrama detallado, sin “sobrepensarlo”, pero separando el sistema en todos los componentes relevantes que el repo realmente contiene.

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =========================
  %% Nivel 1 - Contexto
  %% =========================
  U["Usuario"]:::actor

  WEBAPP["Xenia Web (Next.js App Router)"]:::client
  MOBAPP["Xenia Móviles (React Native / Expo)"]:::client

  subgraph "ProyectoXenia (Next.js BFF: UI + API en el mismo deployment)"
    direction TB

    subgraph "Web UI (App Router)"
      direction TB
      WEB_LAYOUT["Root Layout\n(layout.js)"]:::frontend
      WEB_HOME["Entry Page\n(page.js)"]:::frontend
      WEB_PAGES["UI Routes\ninicio/login/menu/usuario/formulario/fetcheo"]:::frontend
      WEB_COMPONENTS["UI Components (reutilizables)\nNavbar / Formulario / Renderizado / Footer"]:::frontend

      subgraph "Styles + Tailwind"
        direction TB
        WEB_GLOBALS["globals.css"]:::sty
        WEB_STYLES_DIR["styles/*"]:::sty
        WEB_TAILWIND["tailwind.config.js"]:::sty
        WEB_POSTCSS["postcss.config.js"]:::sty
      end

      WEB_LAYOUT -->|"render"| WEB_HOME
      WEB_HOME -->|"render"| WEB_PAGES
      WEB_PAGES -->|"compose"| WEB_COMPONENTS
      WEB_COMPONENTS -->|"uses"| WEB_GLOBALS
      WEB_COMPONENTS -->|"uses"| WEB_STYLES_DIR
      WEB_PAGES -->|"uses"| WEB_GLOBALS
      WEB_PAGES -->|"uses"| WEB_STYLES_DIR
    end

    subgraph "Backend (Next.js Route Handlers)"
      direction TB
      API_REST["API Routes (REST)\nApp Router Route Handlers"]:::api
      API_DU_COLL["/api/datosusuario\n(collection)"]:::api
      API_DU_ID["/api/datosusuario/:id\n(resource)"]:::api
      API_AUTH_LOGIN["Auth Handler\n/login/route/route.js"]:::api
      API_AUTH_USUARIO["User Handler\n/usuario/route/route.js"]:::api

      API_REST -->|"routes"| API_DU_COLL
      API_REST -->|"routes"| API_DU_ID
      API_REST -->|"routes"| API_AUTH_LOGIN
      API_REST -->|"routes"| API_AUTH_USUARIO
    end

    subgraph "Libs (capa compartida)"
      direction TB
      WEB_FETCH["HTTP Client / Fetch Layer\n(index-fetch.js)"]:::lib
      PRISMA_CLIENT["Prisma Client (DAL)\n(prisma.js)"]:::dal
      ENV["Env Config\n(.env: DATABASE_URL, secrets)"]:::config

      WEB_FETCH -->|"reads"| ENV
      PRISMA_CLIENT -->|"reads"| ENV
    end

    WEB_PAGES -->|"fetch (internal/HTTP)"| WEB_FETCH
    WEB_FETCH -->|"HTTPS/JSON"| API_REST
    API_REST -->|"uses"| PRISMA_CLIENT
  end

  subgraph "ProyectoXeniaMoviles (Expo React Native)"
    direction TB
    MOB_APP["App Entry\n(App.jsx)"]:::mobile
    MOB_NAV["Navigation\n(AppNavigator.js)"]:::mobile
    MOB_SCREENS["Screens/Components\n(login/menu/Navbar/Renderizado)"]:::mobile
    MOB_FETCH["HTTP Client / Fetch Layer\n(libs/index-fetch.js)"]:::lib
    MOB_PKG["Tooling\n(package.json)"]:::config
    MOB_APPJSON["Config\n(app.json)"]:::config
    MOB_BABEL["Config\n(babel.config.js)"]:::config

    MOB_APP -->|"uses"| MOB_NAV
    MOB_NAV -->|"navigates"| MOB_SCREENS
    MOB_SCREENS -->|"calls"| MOB_FETCH
  end

  subgraph "Persistencia"
    direction TB
    PRISMA_SCHEMA["Prisma Schema\n(schema.prisma)"]:::dal
    PRISMA_MIGR["Prisma Migrations\n(migrations/*)"]:::ops
    PRISMA_SEEDS["Seeds\n(seeds.ts)"]:::ops
    PRISMA_DELETE["Utility Script\n(deleteData.js)"]:::ops
    DB[("Database\nSQLite dev (dev.db)\n(RDBMS en prod: configurable)")]:::db

    PRISMA_SCHEMA -->|"defines models"| PRISMA_CLIENT
    PRISMA_MIGR -->|"migrate (offline)"| DB
    PRISMA_SEEDS -->|"seed (offline)"| DB
    PRISMA_DELETE -->|"cleanup (offline)"| DB
    PRISMA_CLIENT -->|"Prisma query"| DB
  end

  subgraph "Auxiliar (validar rol)"
    direction TB
    AUX_GESTOR["gestor-ss (paquete/subproyecto)\n(validar uso)"]:::aux
    AUX_APPJS["app.js (entrypoint/script)\n(validar uso)"]:::aux
  end

  %% Relaciones de contexto
  U -->|"usa"| WEBAPP
  U -->|"usa"| MOBAPP

  WEBAPP -->|"UI/SSR/SPA"| WEB_LAYOUT
  MOBAPP -->|"app runtime"| MOB_APP

  MOB_FETCH -->|"HTTPS/JSON"| API_REST

  %% =========================
  %% Click events (component mapping)
  %% =========================
  click WEB_PAGES "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/tree/main/ProyectoXenia/src/app"
  click WEB_LAYOUT "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/src/app/layout.js"
  click WEB_HOME "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/src/app/page.js"
  click WEB_COMPONENTS "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/tree/main/ProyectoXenia/src/components"
  click WEB_GLOBALS "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/src/app/globals.css"
  click WEB_STYLES_DIR "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/tree/main/ProyectoXenia/src/app/styles"
  click WEB_TAILWIND "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/tailwind.config.js"
  click WEB_POSTCSS "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/postcss.config.js"

  click API_DU_COLL "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/src/app/api/datosusuario/route.js"
  click API_DU_ID "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/src/app/api/datosusuario/[id]/route.js"
  click API_AUTH_LOGIN "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/src/app/login/route/route.js"
  click API_AUTH_USUARIO "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/src/app/usuario/route/route.js"

  click WEB_FETCH "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/src/libs/index-fetch.js"
  click PRISMA_CLIENT "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/src/libs/prisma.js"
  click PRISMA_SCHEMA "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/prisma/schema.prisma"
  click PRISMA_MIGR "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/tree/main/ProyectoXenia/prisma/migrations"
  click PRISMA_SEEDS "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/prisma/seeds/seeds.ts"
  click DB "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/prisma/dev.db"
  click PRISMA_DELETE "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/prisma/deleteData/deleteData.js"
  click ENV "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/.env"

  click MOB_APP "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXeniaMoviles/proyectomoviles/App.jsx"
  click MOB_NAV "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXeniaMoviles/proyectomoviles/AppNavigator.js"
  click MOB_SCREENS "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/tree/main/ProyectoXeniaMoviles/proyectomoviles/components"
  click MOB_FETCH "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXeniaMoviles/proyectomoviles/libs/index-fetch.js"
  click MOB_PKG "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXeniaMoviles/proyectomoviles/package.json"
  click MOB_APPJSON "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXeniaMoviles/proyectomoviles/app.json"
  click MOB_BABEL "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXeniaMoviles/proyectomoviles/babel.config.js"

  click AUX_GESTOR "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/gestor-ss/package.json"
  click AUX_APPJS "https://github.com/bryanvalenzuela7/proyectoxeniafullpower/blob/main/ProyectoXenia/app.js"

  %% =========================
  %% Styles
  %% =========================
  classDef actor fill:#F3F4F6,stroke:#6B7280,stroke-width:1px,color:#111827;
  classDef client fill:#DBEAFE,stroke:#2563EB,stroke-width:1.5px,color:#0F172A;
  classDef frontend fill:#BFDBFE,stroke:#1D4ED8,stroke-width:1.5px,color:#0F172A;
  classDef mobile fill:#C7D2FE,stroke:#4338CA,stroke-width:1.5px,color:#0F172A;
  classDef api fill:#BBF7D0,stroke:#16A34A,stroke-width:1.5px,color:#052E16;
  classDef lib fill:#A7F3D0,stroke:#0F766E,stroke-width:1.5px,color:#042F2E;
  classDef dal fill:#FDE68A,stroke:#D97706,stroke-width:1.5px,color:#451A03;
  classDef db fill:#FCD34D,stroke:#B45309,stroke-width:2px,color:#451A03;
  classDef ops fill:#FEF3C7,stroke:#B45309,stroke-width:1.5px,color:#451A03;
  classDef sty fill:#E9D5FF,stroke:#7C3AED,stroke-width:1.5px,color:#2E1065;
  classDef config fill:#E5E7EB,stroke:#4B5563,stroke-width:1.5px,color:#111827;
  classDef aux fill:#FFFFFF,stroke:#9CA3AF,stroke-width:1.5px,stroke-dasharray:6 4,color:#374151;
```
