How ronin-12/plataforma_ciencia_4 works
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: main.py FastAPI app · App.jsx Role-based app · api.js API client · ia.py AI planning routes
Components 22
Web app
- Role-based app
frontend/src/App.jsx - Student login
frontend/src/components/LoginAlumno.jsx - Student menu
frontend/src/components/MenuAlumno.jsx - Activity player
frontend/src/components/VisorActividad.jsx - Teacher panel
frontend/src/components/PanelDocente.jsx - API client
frontend/src/services/api.js
API and access
- FastAPI app
backend/app/main.py - Authentication
backend/app/routers/docentes.py - Administration
backend/app/routers/admin.py
Classroom learning
- Student management
backend/app/routers/alumnos.py - Class groups
backend/app/routers/grupos.py - Activities
backend/app/routers/actividades.py - Learning results
backend/app/routers/resultados.py - Group metrics
backend/app/routers/metricas.py
Teacher planning
- AI planning routes
backend/app/routers/ia.py - AI provider
backend/app/ia/__init__.py - AI privacy
backend/app/ia/privacidad.py
Data and infrastructure
- Database pool
backend/app/db/session.py - PostgreSQL
- Tokens and roles
backend/app/core/security.py
Other components
- Student
- Teacher
Connections 33
- Student → Role-based app: uses
README.md - Teacher → Role-based app: uses
README.md - Role-based app → Student login: renders
frontend/src/App.jsx - Role-based app → Student menu: renders
frontend/src/App.jsx - Role-based app → Teacher panel: renders
frontend/src/App.jsx - Role-based app → API client: requests through
frontend/src/App.jsx - Student login → API client: authenticates through
frontend/src/components/LoginAlumno.jsx - API client → FastAPI app: HTTP requests
README.md - FastAPI app → Authentication: registers
backend/app/main.py - FastAPI app → Student management: registers
backend/app/main.py - FastAPI app → AI planning routes: registers
backend/app/main.py - FastAPI app → Learning results: registers
backend/app/main.py - FastAPI app → Group metrics: registers
backend/app/main.py - FastAPI app → Administration: registers
backend/app/main.py - FastAPI app → Database pool: starts and closes
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
frontend/src/App.jsx - Role-based app → Student menu: loads games
frontend/src/App.jsx - API client → Student management: calls endpoints
frontend/src/services/api.js - Teacher panel → API client: uses
- API client → Group metrics: requests metrics
frontend/src/services/api.js - API client → AI planning routes: requests AI features
frontend/src/services/api.js - AI planning routes → AI provider: selects provider
backend/app/routers/ia.py - AI planning routes → AI privacy: uses privacy controls
backend/app/routers/ia.py - AI planning routes → PostgreSQL: stores sessions and games
backend/app/routers/ia.py - Student management → PostgreSQL: reads and writes
backend/app/routers/alumnos.py - Learning results → PostgreSQL: reads and writes
backend/app/routers/resultados.py - Group metrics → PostgreSQL: queries
backend/app/routers/metricas.py - Authentication → Tokens and roles: uses
backend/app/routers/docentes.py - Tokens and roles → PostgreSQL: validates account roles
- Database pool → PostgreSQL: connects
backend/app/db/session.py