How edwinsebastian-crypto/spp works
SPP is a pedagogical-practice platform: users manage placements, activities and evidence, then tutors and students conduct evaluations and directors review outcomes and accreditation reports. The React client talks to the Express monolith, which owns practice-domain workflows and persistence; it delegates evaluation to a separate FastAPI service and notification delivery to an Express service. The README documents these service boundaries and storage integrations. Some subsystem internals are unsampled, so their nodes follow documented capabilities and their edges are limited to documented relationships or shown imports.
Main entry points: index.js Express routes · dispatcher.service.js Idempotent mail dispatcher · ActivitiesAndEvidencesApp.jsx Practice and evaluation UI · api.js HTTP API client
Components 26
React client
- Practice and evaluation UI
spp_practicas/frontend/src/components/activities/ActivitiesAndEvidencesApp.jsx - Director dashboards
spp_practicas/frontend/src/components/director/DirectorEvaluationsDashboardApp.jsx - React entry point
spp_practicas/frontend/src/main.jsx - HTTP API client
spp_practicas/frontend/src/core/api.js
Practice monolith
- Express routes
spp_practicas/src/routes/index.js - Domain controllers
spp_practicas/src/controllers/practice.controller.js - Practice and report services
spp_practicas/src/services/practice.service.js - Evidence management
spp_practicas/src/services/evidence.service.js - Domain repositories
spp_practicas/src/repositories/practice.repository.js - Monolith HTTP app
spp_practicas/src/app.js - Evaluation gateway
spp_practicas/src/services/evaluation-gateway.service.js - Notification gateway
spp_practicas/src/infrastructure/notification-service.js
Evaluation service
- Evaluation API
servicio_evaluacion/backend/app/main.py - Tutor, student, director APIs
servicio_evaluacion/backend/app/routers - Question and evaluation workflows
servicio_evaluacion/backend/app/services/calificacion.py - Practice evidence client
servicio_evaluacion/backend/app/services/evidencias_client.py - AI question generation
servicio_evaluacion/backend/app/services/generador.py
Notification service
- Notification HTTP app
servicio_notificaciones/src/app.js - Idempotent mail dispatcher
servicio_notificaciones/src/services/dispatcher.service.js - Scheduled notification jobs
servicio_notificaciones/src/services/jobs.service.js - Email delivery
servicio_notificaciones/src/infrastructure/mailer.js
Persistence and integrations
- Evaluation database
servicio_evaluacion/backend/app/database.py - Practice data store
spp_practicas/src/infrastructure/postgres.js - Evidence file storage
spp_practicas/src/infrastructure/file-storage.js - Notification queue and history
servicio_notificaciones/src/infrastructure/mongo.js
Other components
- Students, tutors, directors
Connections 23
- Students, tutors, directors → Practice and evaluation UI: use
README.md - React entry point → Practice and evaluation UI: mounts
spp_practicas/frontend/src/main.jsx - React entry point → Director dashboards: mounts
spp_practicas/frontend/src/main.jsx - Practice and evaluation UI → HTTP API client: requests data
spp_practicas/frontend/src/components/activities/ActivitiesAndEvidencesApp.jsx - Director dashboards → HTTP API client: requests data
spp_practicas/frontend/src/components/director/DirectorEvaluationsDashboardApp.jsx - HTTP API client → Express routes: HTTP requests
README.md - Monolith HTTP app → Express routes: registers
spp_practicas/src/app.js - Express routes → Domain controllers: routes to
- Domain controllers → Practice and report services: delegates to
- Practice and report services → Domain repositories: reads and writes
README.md - Evidence management → Evidence file storage: stores files
- Domain repositories → Practice data store: queries
README.md - Evaluation gateway → Evaluation API: secure proxy
README.md - Notification gateway → Notification HTTP app: sends events
README.md - Evaluation API → Tutor, student, director APIs: registers
servicio_evaluacion/backend/app/main.py - Tutor, student, director APIs → Question and evaluation workflows: invokes
servicio_evaluacion/backend/app/routers/estudiante.py - Question and evaluation workflows → Evaluation database: persists results
README.md - AI question generation → Question and evaluation workflows: supports evaluation
- Practice evidence client → Express routes: fetches evidence
servicio_evaluacion/backend/app/services/evidencias_client.py - Notification HTTP app → Idempotent mail dispatcher: serves dispatch
- Idempotent mail dispatcher → Notification queue and history: queues and updates
README.md - Scheduled notification jobs → Notification queue and history: reads queue
- Idempotent mail dispatcher → Email delivery: delivers email
README.md