# ronin-12/plataforma_ciencia_4 architecture

> Architecture diagram of the GitHub repository ronin-12/plataforma_ciencia_4, 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/ronin-12/plataforma_ciencia_4
- Repository: https://github.com/ronin-12/plataforma_ciencia_4

## Overview

Murciélago is a role-based educational platform: students access classroom activities and submit results, while teachers manage classes, review group metrics, and use AI-assisted planning and game generation. The React app calls a FastAPI backend backed by PostgreSQL; the AI provider can be Gemini or a demo implementation. The graph preserves documented administration and classroom capabilities. Some frontend panels and backend routers were not sampled, so their detailed internal calls are omitted; those capabilities are represented at subsystem level.

Main entry points: [`backend/app/main.py`](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/main.py) (FastAPI app), [`frontend/src/App.jsx`](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/App.jsx) (Role-based app), [`frontend/src/services/api.js`](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/services/api.js) (API client), [`backend/app/routers/ia.py`](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/ia.py) (AI planning routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web app"]
  node_webapp["Role-based app<br/>[App.jsx]"]
  node_student_login["Student login<br/>[LoginAlumno.jsx]"]
  node_student_menu["Student menu<br/>[MenuAlumno.jsx]"]
  node_activity_view["Activity player<br/>[VisorActividad.jsx]"]
  node_teacher_panel["Teacher panel<br/>[PanelDocente.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_api_entry["FastAPI app<br/>[main.py]"]
  node_auth["Authentication<br/>[docentes.py]"]
  node_admin["Administration<br/>[admin.py]"]
end

subgraph group_classroom["Classroom learning"]
  node_student_records["Student management<br/>[alumnos.py]"]
  node_groups["Class groups<br/>[grupos.py]"]
  node_activities["Activities<br/>[actividades.py]"]
  node_results["Learning results<br/>[resultados.py]"]
  node_metrics["Group metrics<br/>[metricas.py]"]
end

subgraph group_planning["Teacher planning"]
  node_ai_routes["AI planning routes<br/>[ia.py]"]
  node_ai_provider["AI provider<br/>[__init__.py]"]
  node_privacy["AI privacy<br/>[privacidad.py]"]
end

subgraph group_platform["Data and infrastructure"]
  node_db_pool["Database pool<br/>[session.py]"]
  node_postgres[("PostgreSQL")]
  node_security["Tokens and roles<br/>[security.py]"]
end

node_learner(("Student"))
node_teacher(("Teacher"))

node_learner -->|"uses"| node_webapp
node_teacher -->|"uses"| node_webapp
node_webapp -->|"renders"| node_student_login
node_webapp -->|"renders"| node_student_menu
node_webapp -->|"renders"| node_teacher_panel
node_webapp -->|"requests through"| node_api_client
node_student_login -->|"authenticates through"| node_api_client
node_api_client -->|"HTTP requests"| node_api_entry
node_api_entry -->|"registers"| node_auth
node_api_entry -->|"registers"| node_student_records
node_api_entry -->|"registers"| node_ai_routes
node_api_entry -->|"registers"| node_results
node_api_entry -->|"registers"| node_metrics
node_api_entry -->|"registers"| node_admin
node_api_entry -->|"starts and closes"| node_db_pool
node_api_entry -.->|"registers"| node_groups
node_api_entry -.->|"registers"| node_activities
node_student_menu -.->|"opens activity"| node_activity_view
node_webapp -->|"submits scores"| node_results
node_webapp -->|"loads games"| node_student_menu
node_api_client -->|"calls endpoints"| node_student_records
node_teacher_panel -.->|"uses"| node_api_client
node_api_client -->|"requests metrics"| node_metrics
node_api_client -->|"requests AI features"| node_ai_routes
node_ai_routes -->|"selects provider"| node_ai_provider
node_ai_routes -->|"uses privacy controls"| node_privacy
node_ai_routes -->|"stores sessions and games"| node_postgres
node_student_records -->|"reads and writes"| node_postgres
node_results -->|"reads and writes"| node_postgres
node_metrics -->|"queries"| node_postgres
node_auth -->|"uses"| node_security
node_security -->|"validates account roles"| node_postgres
node_db_pool -->|"connects"| node_postgres

click node_webapp "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/App.jsx"
click node_student_login "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/components/LoginAlumno.jsx"
click node_student_menu "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/components/MenuAlumno.jsx"
click node_activity_view "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/components/VisorActividad.jsx"
click node_teacher_panel "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/components/PanelDocente.jsx"
click node_api_client "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/services/api.js"
click node_api_entry "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/main.py"
click node_auth "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/docentes.py"
click node_student_records "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/alumnos.py"
click node_groups "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/grupos.py"
click node_activities "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/actividades.py"
click node_results "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/resultados.py"
click node_metrics "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/metricas.py"
click node_ai_routes "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/ia.py"
click node_ai_provider "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/ia/__init__.py"
click node_privacy "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/ia/privacidad.py"
click node_admin "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/admin.py"
click node_db_pool "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/db/session.py"
click node_security "https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/core/security.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_webapp,node_student_login,node_student_menu,node_activity_view,node_teacher_panel,node_api_client toneBlue
class node_api_entry,node_auth,node_admin toneAmber
class node_student_records,node_groups,node_activities,node_results,node_metrics toneMint
class node_ai_routes,node_ai_provider,node_privacy toneRose
class node_db_pool,node_postgres,node_security,node_learner,node_teacher toneIndigo
```

## Components

### Web app

- [Role-based app](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Student login](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/components/LoginAlumno.jsx): `frontend/src/components/LoginAlumno.jsx`
- [Student menu](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/components/MenuAlumno.jsx): `frontend/src/components/MenuAlumno.jsx`
- [Activity player](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/components/VisorActividad.jsx): `frontend/src/components/VisorActividad.jsx`
- [Teacher panel](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/components/PanelDocente.jsx): `frontend/src/components/PanelDocente.jsx`
- [API client](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### API and access

- [FastAPI app](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/docentes.py): `backend/app/routers/docentes.py`
- [Administration](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/admin.py): `backend/app/routers/admin.py`

### Classroom learning

- [Student management](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/alumnos.py): `backend/app/routers/alumnos.py`
- [Class groups](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/grupos.py): `backend/app/routers/grupos.py`
- [Activities](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/actividades.py): `backend/app/routers/actividades.py`
- [Learning results](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/resultados.py): `backend/app/routers/resultados.py`
- [Group metrics](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/metricas.py): `backend/app/routers/metricas.py`

### Teacher planning

- [AI planning routes](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/routers/ia.py): `backend/app/routers/ia.py`
- [AI provider](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/ia/__init__.py): `backend/app/ia/__init__.py`
- [AI privacy](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/ia/privacidad.py): `backend/app/ia/privacidad.py`

### Data and infrastructure

- [Database pool](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- **PostgreSQL**
- [Tokens and roles](https://github.com/ronin-12/plataforma_ciencia_4/blob/main/backend/app/core/security.py): `backend/app/core/security.py`

### Other components

- **Student**
- **Teacher**

## Connections

- Student → Role-based app: uses (evidence: `README.md`)
- Teacher → Role-based app: uses (evidence: `README.md`)
- Role-based app → Student login: renders (evidence: `frontend/src/App.jsx`)
- Role-based app → Student menu: renders (evidence: `frontend/src/App.jsx`)
- Role-based app → Teacher panel: renders (evidence: `frontend/src/App.jsx`)
- Role-based app → API client: requests through (evidence: `frontend/src/App.jsx`)
- Student login → API client: authenticates through (evidence: `frontend/src/components/LoginAlumno.jsx`)
- API client → FastAPI app: HTTP requests (evidence: `README.md`)
- FastAPI app → Authentication: registers (evidence: `backend/app/main.py`)
- FastAPI app → Student management: registers (evidence: `backend/app/main.py`)
- FastAPI app → AI planning routes: registers (evidence: `backend/app/main.py`)
- FastAPI app → Learning results: registers (evidence: `backend/app/main.py`)
- FastAPI app → Group metrics: registers (evidence: `backend/app/main.py`)
- FastAPI app → Administration: registers (evidence: `backend/app/main.py`)
- FastAPI app → Database pool: starts and closes (evidence: `backend/app/main.py`)
- FastAPI app → Class groups: registers
- FastAPI app → Activities: registers
- Student menu → Activity player: opens activity
- Role-based app → Learning results: submits scores (evidence: `frontend/src/App.jsx`)
- Role-based app → Student menu: loads games (evidence: `frontend/src/App.jsx`)
- API client → Student management: calls endpoints (evidence: `frontend/src/services/api.js`)
- Teacher panel → API client: uses
- API client → Group metrics: requests metrics (evidence: `frontend/src/services/api.js`)
- API client → AI planning routes: requests AI features (evidence: `frontend/src/services/api.js`)
- AI planning routes → AI provider: selects provider (evidence: `backend/app/routers/ia.py`)
- AI planning routes → AI privacy: uses privacy controls (evidence: `backend/app/routers/ia.py`)
- AI planning routes → PostgreSQL: stores sessions and games (evidence: `backend/app/routers/ia.py`)
- Student management → PostgreSQL: reads and writes (evidence: `backend/app/routers/alumnos.py`)
- Learning results → PostgreSQL: reads and writes (evidence: `backend/app/routers/resultados.py`)
- Group metrics → PostgreSQL: queries (evidence: `backend/app/routers/metricas.py`)
- Authentication → Tokens and roles: uses (evidence: `backend/app/routers/docentes.py`)
- Tokens and roles → PostgreSQL: validates account roles
- Database pool → PostgreSQL: connects (evidence: `backend/app/db/session.py`)
