# matiasv4squez/integracion-iv-x-ii architecture

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

- Interactive diagram: https://gitdiagram.com/matiasv4squez/integracion-iv-x-ii
- Repository: https://github.com/matiasv4squez/integracion-iv-x-ii

## Overview

This repository tree describes a tutoring platform: a web client supports account access, tutor discovery, availability, applications, and tutoring sessions, backed by separate authentication, tutor/catalog, session, and moderation services. The sampled controllers show HTTP requests entering application use cases; the session API also documents its availability dependency. The README provides no architectural detail, and unsampled service wiring and frontend API destinations are therefore not asserted.

Main entry points: [`2/api-gateway/src/aplicacion/casos-de-uso/reenviar-peticion.ts`](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/api-gateway/src/aplicacion/casos-de-uso/reenviar-peticion.ts) (Request forwarding), [`2/materias-tutores/src/database/prisma.service.ts`](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/materias-tutores/src/database/prisma.service.ts) (Tutor data store), [`2/agendamiento-sesiones/src/sessions/infraestructura/http/sessions.controller.ts`](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/agendamiento-sesiones/src/sessions/infraestructura/http/sessions.controller.ts) (Session endpoints), [`2/agendamiento-sesiones/src/sessions/aplicacion/casos-de-uso/gestionar-sesiones.ts`](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/agendamiento-sesiones/src/sessions/aplicacion/casos-de-uso/gestionar-sesiones.ts) (Session workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_routes["App routes<br/>[AppRoutes.tsx]"]
  node_web_features["Tutoring features"]
end

subgraph group_gateway["Gateway"]
  node_gateway_app["Request gateway<br/>[app.module.ts]"]
  node_gateway_forward["Request forwarding"]
end

subgraph group_identity["Identity"]
  node_auth_api["Account endpoints"]
  node_auth_service["Authentication<br/>[auth.service.ts]"]
end

subgraph group_tutors["Tutors and catalog"]
  node_tutor_search["Tutor search"]
  node_subjects["Subject catalog"]
  node_availability["Tutor availability"]
  node_applications["Tutor applications"]
  node_tutor_store[("Tutor data store<br/>[prisma.service.ts]")]
end

subgraph group_sessions["Tutoring sessions"]
  node_session_api["Session endpoints"]
  node_session_use_cases["Session workflows"]
  node_session_domain["Session rules<br/>[sesion.ts]"]
  node_session_store[("Session persistence")]
end

subgraph group_moderation["Moderation"]
  node_reports["Reports and review"]
  node_session_notices["Session conflict integration"]
end

node_people(("Platform users"))

node_people -->|"use"| node_routes
node_routes -->|"routes to"| node_web_features
node_web_features -.->|"requests"| node_gateway_app
node_gateway_app -->|"registers"| node_gateway_forward
node_gateway_forward -.->|"forwards to"| node_auth_api
node_gateway_forward -.->|"forwards to"| node_tutor_search
node_gateway_forward -.->|"forwards to"| node_session_api
node_gateway_forward -.->|"forwards to"| node_reports
node_auth_api -->|"calls"| node_auth_service
node_auth_service -.->|"creates session"| node_session_store
node_tutor_search -.->|"reads"| node_tutor_store
node_subjects -.->|"reads"| node_tutor_store
node_availability -.->|"updates"| node_tutor_store
node_applications -.->|"stores applications"| node_tutor_store
node_session_api -->|"calls"| node_session_use_cases
node_session_api -.->|"queries availability"| node_availability
node_session_use_cases -.->|"uses rules"| node_session_domain
node_session_use_cases -.->|"persists"| node_session_store
node_reports -->|"queries conflicts"| node_session_notices

click node_routes "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/fronted/src/app/AppRoutes.tsx"
click node_web_features "https://github.com/matiasv4squez/integracion-iv-x-ii/tree/main/2/fronted/src/features"
click node_gateway_app "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/api-gateway/src/app.module.ts"
click node_gateway_forward "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/api-gateway/src/aplicacion/casos-de-uso/reenviar-peticion.ts"
click node_auth_api "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/usuarios-auth/src/usuarios/infraestructura/http/usuarios.controller.ts"
click node_auth_service "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/usuarios-auth/src/auth/aplicacion/auth.service.ts"
click node_tutor_search "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/materias-tutores/src/tutores/infraestructura/http/tutores.controller.ts"
click node_subjects "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/materias-tutores/src/materias/infraestructura/http/materias.controller.ts"
click node_availability "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/materias-tutores/src/disponibilidad/infraestructura/http/disponibilidad.controller.ts"
click node_applications "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/materias-tutores/src/postulaciones/infraestructura/http/postulaciones.controller.ts"
click node_tutor_store "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/materias-tutores/src/database/prisma.service.ts"
click node_session_api "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/agendamiento-sesiones/src/sessions/infraestructura/http/sessions.controller.ts"
click node_session_use_cases "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/agendamiento-sesiones/src/sessions/aplicacion/casos-de-uso/gestionar-sesiones.ts"
click node_session_domain "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/agendamiento-sesiones/src/sessions/dominio/entidades/sesion.ts"
click node_session_store "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/agendamiento-sesiones/src/sessions/infraestructura/persistencia/repositorio-sesiones-prisma.ts"
click node_reports "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/reportes-moderacion/src/reportes/infraestructura/http/reportes.controller.ts"
click node_session_notices "https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/reportes-moderacion/src/integraciones/infraestructura/http/avisos-sesion.controller.ts"

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_routes,node_web_features,node_people toneBlue
class node_gateway_app,node_gateway_forward toneAmber
class node_auth_api,node_auth_service toneMint
class node_tutor_search,node_subjects,node_availability,node_applications,node_tutor_store toneRose
class node_session_api,node_session_use_cases,node_session_domain,node_session_store toneIndigo
class node_reports,node_session_notices toneTeal
```

## Components

### Web client

- [App routes](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/fronted/src/app/AppRoutes.tsx): `2/fronted/src/app/AppRoutes.tsx`
- [Tutoring features](https://github.com/matiasv4squez/integracion-iv-x-ii/tree/main/2/fronted/src/features): `2/fronted/src/features`

### Gateway

- [Request gateway](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/api-gateway/src/app.module.ts): `2/api-gateway/src/app.module.ts`
- [Request forwarding](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/api-gateway/src/aplicacion/casos-de-uso/reenviar-peticion.ts): `2/api-gateway/src/aplicacion/casos-de-uso/reenviar-peticion.ts`

### Identity

- [Account endpoints](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/usuarios-auth/src/usuarios/infraestructura/http/usuarios.controller.ts): `2/usuarios-auth/src/usuarios/infraestructura/http/usuarios.controller.ts`
- [Authentication](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/usuarios-auth/src/auth/aplicacion/auth.service.ts): `2/usuarios-auth/src/auth/aplicacion/auth.service.ts`

### Tutors and catalog

- [Tutor search](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/materias-tutores/src/tutores/infraestructura/http/tutores.controller.ts): `2/materias-tutores/src/tutores/infraestructura/http/tutores.controller.ts`
- [Subject catalog](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/materias-tutores/src/materias/infraestructura/http/materias.controller.ts): `2/materias-tutores/src/materias/infraestructura/http/materias.controller.ts`
- [Tutor availability](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/materias-tutores/src/disponibilidad/infraestructura/http/disponibilidad.controller.ts): `2/materias-tutores/src/disponibilidad/infraestructura/http/disponibilidad.controller.ts`
- [Tutor applications](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/materias-tutores/src/postulaciones/infraestructura/http/postulaciones.controller.ts): `2/materias-tutores/src/postulaciones/infraestructura/http/postulaciones.controller.ts`
- [Tutor data store](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/materias-tutores/src/database/prisma.service.ts): `2/materias-tutores/src/database/prisma.service.ts`

### Tutoring sessions

- [Session endpoints](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/agendamiento-sesiones/src/sessions/infraestructura/http/sessions.controller.ts): `2/agendamiento-sesiones/src/sessions/infraestructura/http/sessions.controller.ts`
- [Session workflows](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/agendamiento-sesiones/src/sessions/aplicacion/casos-de-uso/gestionar-sesiones.ts): `2/agendamiento-sesiones/src/sessions/aplicacion/casos-de-uso/gestionar-sesiones.ts`
- [Session rules](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/agendamiento-sesiones/src/sessions/dominio/entidades/sesion.ts): `2/agendamiento-sesiones/src/sessions/dominio/entidades/sesion.ts`
- [Session persistence](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/agendamiento-sesiones/src/sessions/infraestructura/persistencia/repositorio-sesiones-prisma.ts): `2/agendamiento-sesiones/src/sessions/infraestructura/persistencia/repositorio-sesiones-prisma.ts`

### Moderation

- [Reports and review](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/reportes-moderacion/src/reportes/infraestructura/http/reportes.controller.ts): `2/reportes-moderacion/src/reportes/infraestructura/http/reportes.controller.ts`
- [Session conflict integration](https://github.com/matiasv4squez/integracion-iv-x-ii/blob/main/2/reportes-moderacion/src/integraciones/infraestructura/http/avisos-sesion.controller.ts): `2/reportes-moderacion/src/integraciones/infraestructura/http/avisos-sesion.controller.ts`

### Other components

- **Platform users**

## Connections

- Platform users → App routes: use (evidence: `2/fronted/src/app/AppRoutes.tsx`)
- App routes → Tutoring features: routes to (evidence: `2/fronted/src/app/AppRoutes.tsx`)
- Tutoring features → Request gateway: requests
- Request gateway → Request forwarding: registers (evidence: `2/api-gateway/src/app.module.ts`)
- Request forwarding → Account endpoints: forwards to
- Request forwarding → Tutor search: forwards to
- Request forwarding → Session endpoints: forwards to
- Request forwarding → Reports and review: forwards to
- Account endpoints → Authentication: calls (evidence: `2/usuarios-auth/src/usuarios/infraestructura/http/usuarios.controller.ts`)
- Authentication → Session persistence: creates session
- Tutor search → Tutor data store: reads
- Subject catalog → Tutor data store: reads
- Tutor availability → Tutor data store: updates
- Tutor applications → Tutor data store: stores applications
- Session endpoints → Session workflows: calls (evidence: `2/agendamiento-sesiones/src/sessions/infraestructura/http/sessions.controller.ts`)
- Session endpoints → Tutor availability: queries availability
- Session workflows → Session rules: uses rules (evidence: `2/agendamiento-sesiones/src/sessions/aplicacion/casos-de-uso/gestionar-sesiones.ts`)
- Session workflows → Session persistence: persists
- Reports and review → Session conflict integration: queries conflicts (evidence: `2/reportes-moderacion/src/reportes/infraestructura/http/reportes.controller.ts`)
