# elis3o2/infancias architecture

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

- Interactive diagram: https://gitdiagram.com/elis3o2/infancias
- Repository: https://github.com/elis3o2/infancias

## Overview

This is a case-management application for receiving and processing requests concerning children/adolescents: users submit contact, institution, people, family, and supporting-document data; staff review and validate or reject requests, with person histories and reporting as adjacent workflows. The frontend route table exposes request, history, search, and report screens. Backend models represent requests, people, and locations, while integrations include external identity and clinical-history services. Evidence is limited to the supplied excerpts and SOURCE INDEX; several backend view-to-service and frontend-to-backend links cannot be verified here.

Main entry points: [`frontend/src/routes/AppRoutes.tsx`](https://github.com/elis3o2/infancias/blob/master/frontend/src/routes/AppRoutes.tsx) (Application routes), [`backend/src/apps/solicitud/models.py`](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/solicitud/models.py) (Request records), [`backend/src/apps/solicitud/serializers.py`](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/solicitud/serializers.py) (Request serializers), [`backend/src/apps/persona/serializers.py`](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/persona/serializers.py) (Person serializers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User workflows"]
  node_routes["Application routes<br/>[AppRoutes.tsx]"]
  node_create["Request creation<br/>[CreatePage.tsx]"]
  node_request_submit["Submit request"]
  node_review["Request review"]
  node_person_ui["Person workflows<br/>[api.ts]"]
  node_history["Child history"]
  node_reports["Reports<br/>[ReportesPage.tsx]"]
end

subgraph group_requests["Request processing"]
  node_request_api["Request API client<br/>[api.ts]"]
  node_request_service["Request operations<br/>[Validacion.py]"]
  node_request_schema["Request serializers<br/>[serializers.py]"]
  node_request_data[("Request records<br/>[models.py]")]
  node_report_service["Report generation<br/>[Reporte.py]"]
end

subgraph group_people["People and records"]
  node_person_schema["Person serializers<br/>[serializers.py]"]
  node_person_data[("Person records<br/>[models.py]")]
  node_location_data[("Location records<br/>[models.py]")]
  node_location_schema["Location serializers<br/>[serializers.py]"]
end

subgraph group_integrations["External services"]
  node_clinical_ui["Clinical history lookup"]
  node_clinical_client["Clinical history client"]
  node_external_identity["Identity integration<br/>[Renaper.py]"]
  node_identity_contracts["External contracts<br/>[clases.py]"]
end

node_staff(("Staff user"))
node_mysql[("MySQL database")]

node_staff -->|"uses"| node_routes
node_routes -->|"routes to"| node_create
node_routes -->|"routes to"| node_history
node_routes -->|"routes to"| node_reports
node_routes -->|"routes to"| node_review
node_create -.->|"uses"| node_request_submit
node_request_submit -->|"submits via"| node_request_api
node_review -->|"validates via"| node_request_api
node_request_schema -->|"uses"| node_person_schema
node_request_schema -->|"uses"| node_location_schema
node_request_schema -->|"serializes"| node_request_data
node_person_schema -->|"serializes"| node_person_data
node_person_schema -->|"uses"| node_location_schema
node_location_schema -->|"serializes"| node_location_data
node_request_data -->|"references"| node_location_data
node_person_data -->|"references"| node_location_data
node_clinical_ui -->|"queries through"| node_clinical_client
node_reports -.->|"requests"| node_report_service
node_request_service -.->|"updates"| node_request_data
node_request_data -.->|"stored in"| node_mysql
node_external_identity -->|"uses contracts"| node_identity_contracts

click node_routes "https://github.com/elis3o2/infancias/blob/master/frontend/src/routes/AppRoutes.tsx"
click node_create "https://github.com/elis3o2/infancias/blob/master/frontend/src/pages/CreatePage/CreatePage.tsx"
click node_request_submit "https://github.com/elis3o2/infancias/blob/master/frontend/src/pages/CreatePage/useSolicitudCreate.ts"
click node_request_api "https://github.com/elis3o2/infancias/blob/master/frontend/src/features/solicitud/api.ts"
click node_review "https://github.com/elis3o2/infancias/blob/master/frontend/src/features/solicitud/components/Cargados/validacion/useSolicitudValidacion.ts"
click node_request_service "https://github.com/elis3o2/infancias/blob/master/backend/src/apps/solicitud/services/Validacion.py"
click node_request_schema "https://github.com/elis3o2/infancias/blob/master/backend/src/apps/solicitud/serializers.py"
click node_request_data "https://github.com/elis3o2/infancias/blob/master/backend/src/apps/solicitud/models.py"
click node_person_ui "https://github.com/elis3o2/infancias/blob/master/frontend/src/features/persona/api.ts"
click node_history "https://github.com/elis3o2/infancias/blob/master/frontend/src/pages/HistorialNinoPage.tsx"
click node_person_schema "https://github.com/elis3o2/infancias/blob/master/backend/src/apps/persona/serializers.py"
click node_person_data "https://github.com/elis3o2/infancias/blob/master/backend/src/apps/persona/models.py"
click node_location_data "https://github.com/elis3o2/infancias/blob/master/backend/src/apps/domicilio/models.py"
click node_location_schema "https://github.com/elis3o2/infancias/blob/master/backend/src/apps/domicilio/serializers.py"
click node_reports "https://github.com/elis3o2/infancias/blob/master/frontend/src/pages/ReportesPage.tsx"
click node_report_service "https://github.com/elis3o2/infancias/blob/master/backend/src/apps/solicitud/services/Reporte.py"
click node_clinical_ui "https://github.com/elis3o2/infancias/blob/master/frontend/src/features/api_externa/useHistoriasClinicas.ts"
click node_clinical_client "https://github.com/elis3o2/infancias/blob/master/frontend/src/features/api_externa/historiasClinicas.ts"
click node_external_identity "https://github.com/elis3o2/infancias/blob/master/backend/src/apps/api_externa/services/Renaper.py"
click node_identity_contracts "https://github.com/elis3o2/infancias/blob/master/backend/src/apps/api_externa/clases.py"

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_create,node_request_submit,node_review,node_person_ui,node_history,node_reports,node_staff toneBlue
class node_request_api,node_request_service,node_request_schema,node_request_data,node_report_service,node_mysql toneAmber
class node_person_schema,node_person_data,node_location_data,node_location_schema toneMint
class node_clinical_ui,node_clinical_client,node_external_identity,node_identity_contracts toneRose
```

## Components

### User workflows

- [Application routes](https://github.com/elis3o2/infancias/blob/master/frontend/src/routes/AppRoutes.tsx): `frontend/src/routes/AppRoutes.tsx`
- [Request creation](https://github.com/elis3o2/infancias/blob/master/frontend/src/pages/CreatePage/CreatePage.tsx): `frontend/src/pages/CreatePage/CreatePage.tsx`
- [Submit request](https://github.com/elis3o2/infancias/blob/master/frontend/src/pages/CreatePage/useSolicitudCreate.ts): `frontend/src/pages/CreatePage/useSolicitudCreate.ts`
- [Request review](https://github.com/elis3o2/infancias/blob/master/frontend/src/features/solicitud/components/Cargados/validacion/useSolicitudValidacion.ts): `frontend/src/features/solicitud/components/Cargados/validacion/useSolicitudValidacion.ts`
- [Person workflows](https://github.com/elis3o2/infancias/blob/master/frontend/src/features/persona/api.ts): `frontend/src/features/persona/api.ts`
- [Child history](https://github.com/elis3o2/infancias/blob/master/frontend/src/pages/HistorialNinoPage.tsx): `frontend/src/pages/HistorialNinoPage.tsx`
- [Reports](https://github.com/elis3o2/infancias/blob/master/frontend/src/pages/ReportesPage.tsx): `frontend/src/pages/ReportesPage.tsx`

### Request processing

- [Request API client](https://github.com/elis3o2/infancias/blob/master/frontend/src/features/solicitud/api.ts): `frontend/src/features/solicitud/api.ts`
- [Request operations](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/solicitud/services/Validacion.py): `backend/src/apps/solicitud/services/Validacion.py`
- [Request serializers](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/solicitud/serializers.py): `backend/src/apps/solicitud/serializers.py`
- [Request records](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/solicitud/models.py): `backend/src/apps/solicitud/models.py`
- [Report generation](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/solicitud/services/Reporte.py): `backend/src/apps/solicitud/services/Reporte.py`

### People and records

- [Person serializers](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/persona/serializers.py): `backend/src/apps/persona/serializers.py`
- [Person records](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/persona/models.py): `backend/src/apps/persona/models.py`
- [Location records](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/domicilio/models.py): `backend/src/apps/domicilio/models.py`
- [Location serializers](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/domicilio/serializers.py): `backend/src/apps/domicilio/serializers.py`

### External services

- [Clinical history lookup](https://github.com/elis3o2/infancias/blob/master/frontend/src/features/api_externa/useHistoriasClinicas.ts): `frontend/src/features/api_externa/useHistoriasClinicas.ts`
- [Clinical history client](https://github.com/elis3o2/infancias/blob/master/frontend/src/features/api_externa/historiasClinicas.ts): `frontend/src/features/api_externa/historiasClinicas.ts`
- [Identity integration](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/api_externa/services/Renaper.py): `backend/src/apps/api_externa/services/Renaper.py`
- [External contracts](https://github.com/elis3o2/infancias/blob/master/backend/src/apps/api_externa/clases.py): `backend/src/apps/api_externa/clases.py`

### Other components

- **Staff user**
- **MySQL database**

## Connections

- Staff user → Application routes: uses (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Application routes → Request creation: routes to (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Application routes → Child history: routes to (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Application routes → Reports: routes to (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Application routes → Request review: routes to (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Request creation → Submit request: uses
- Submit request → Request API client: submits via (evidence: `frontend/src/pages/CreatePage/useSolicitudCreate.ts`)
- Request review → Request API client: validates via (evidence: `frontend/src/features/solicitud/components/Cargados/validacion/useSolicitudValidacion.ts`)
- Request serializers → Person serializers: uses (evidence: `backend/src/apps/solicitud/serializers.py`)
- Request serializers → Location serializers: uses (evidence: `backend/src/apps/solicitud/serializers.py`)
- Request serializers → Request records: serializes (evidence: `backend/src/apps/solicitud/serializers.py`)
- Person serializers → Person records: serializes (evidence: `backend/src/apps/persona/serializers.py`)
- Person serializers → Location serializers: uses (evidence: `backend/src/apps/persona/serializers.py`)
- Location serializers → Location records: serializes (evidence: `backend/src/apps/domicilio/serializers.py`)
- Request records → Location records: references (evidence: `backend/src/apps/solicitud/models.py`)
- Person records → Location records: references (evidence: `backend/src/apps/persona/models.py`)
- Clinical history lookup → Clinical history client: queries through (evidence: `frontend/src/features/api_externa/useHistoriasClinicas.ts`)
- Reports → Report generation: requests
- Request operations → Request records: updates
- Request records → MySQL database: stored in
- Identity integration → External contracts: uses contracts (evidence: `backend/src/apps/api_externa/services/Renaper.py`)
