How off-xero/pequenos-reyes works
Pequeños Reyes is an institutional school portal. Families browse published activities, sign in, select a child and submit an activity registration with simulated payment; staff publish activities and manage organizers, while management can handle payments. The React client communicates with a FastAPI REST API, whose domain services use PostgreSQL for transactional records and MongoDB for audit history. Other documented portal areas include announcements, documents, pre-enrollment and contact. Edges reflect the supplied excerpts, source index references and README; unsampled domain modules are represented at their existing directory paths.
Main entry points: main.py API application · CalendarioSeccion.jsx Activity calendar · auth.py Session service · http.js API client
Components 23
React portal
- Portal shell
HITO-2/frontend-react/src/App.jsx - Session state
HITO-2/frontend-react/src/context/SesionProvider.jsx - Activity calendar
HITO-2/frontend-react/src/pages/CalendarioSeccion.jsx - Event registration
HITO-2/frontend-react/src/components/FlujoInscripcionEventos.jsx - Activity publishing
HITO-2/frontend-react/src/components/GestionActividades.jsx - Organizer management
HITO-2/frontend-react/src/components/GestionOrganizadores.jsx - API client
HITO-2/frontend-react/src/services/http.js - Portal sections
HITO-2/frontend-react/src/pages
FastAPI API
- API application
HITO-3/backend/app/main.py - Event routes
HITO-3/backend/app/api/eventos.py - Registration routes
HITO-3/backend/app/api/inscripciones.py - Authentication and portal
HITO-3/backend/app/api/auth.py - Other domain routes
HITO-3/backend/app/api
Domain services
- Access control
HITO-3/backend/app/core/permisos.py - Session service
HITO-3/backend/app/services/auth.py - Event service
HITO-3/backend/app/services/eventos.py - Registration and payments
HITO-3/backend/app/services/inscripciones.py - Audit service
HITO-3/backend/app/services/auditoria.py
Persistence
- Domain records
HITO-3/backend/app/db/models.py - PostgreSQL
HITO-3/backend/app/db/postgres.py - MongoDB audit log
HITO-3/backend/app/db/mongo.py
External services
- Weather provider
Other components
- Families and staff
Connections 31
- Families and staff → Portal shell: uses
README.md - Portal shell → Session state: mounts
HITO-2/frontend-react/src/App.jsx - Portal shell → Portal sections: renders
HITO-2/frontend-react/src/App.jsx - Families and staff → Activity calendar: browses
README.md - Activity calendar → Event registration: renders
HITO-2/frontend-react/src/pages/CalendarioSeccion.jsx - Activity calendar → Activity publishing: renders
HITO-2/frontend-react/src/pages/CalendarioSeccion.jsx - Activity calendar → Organizer management: renders
HITO-2/frontend-react/src/pages/CalendarioSeccion.jsx - Event registration → API client: calls
HITO-2/frontend-react/src/components/FlujoInscripcionEventos.jsx - Activity publishing → API client: calls
HITO-2/frontend-react/src/components/GestionActividades.jsx - Organizer management → API client: calls
HITO-2/frontend-react/src/components/GestionOrganizadores.jsx - API client → API application: sends API requests
README.md - Families and staff → Portal sections: uses
README.md - Portal sections → Weather provider: requests forecast
- API application → Event routes: registers
HITO-3/backend/app/main.py - API application → Registration routes: registers
HITO-3/backend/app/main.py - API application → Authentication and portal: registers
HITO-3/backend/app/main.py - API application → Other domain routes: registers
HITO-3/backend/app/main.py - Event routes → Event service: delegates to
HITO-3/backend/app/api/eventos.py - Registration routes → Registration and payments: delegates to
HITO-3/backend/app/api/inscripciones.py - Authentication and portal → Session service: delegates to
HITO-3/backend/app/api/auth.py - Event service → Domain records: uses
HITO-3/backend/app/services/eventos.py - Registration and payments → Domain records: uses
HITO-3/backend/app/api/inscripciones.py - Session service → Domain records: reads and writes
HITO-3/backend/app/services/auth.py - Session service → Audit service: records login events
HITO-3/backend/app/services/auth.py - Authentication and portal → Access control: requires identity
HITO-3/backend/app/api/auth.py - Access control → Session service: validates tokens
HITO-3/backend/app/core/permisos.py - Domain records → PostgreSQL: uses base
HITO-3/backend/app/db/models.py - Audit service → MongoDB audit log: writes audit log
HITO-3/backend/app/services/auditoria.py - Families and staff → Other domain routes: uses announcements, documents, contact
README.md - Families and staff → Other domain routes: submits pre-enrollment
README.md - Event registration → Registration and payments: submits registration
README.md