How puj-course/fis_2630_1204_g4 works
SignIA is a web platform for learning and recognizing the Colombian Sign Language alphabet. The main practice flow captures camera frames, requests recognition, presents the detected letter, and records practice results and learning progress. The backend also supports accounts, profiles, sessions, history, administration, and password recovery. Recognition and practice orchestration are shown where the index or excerpts support them; many route and service implementations were not sampled, so uncertain links are omitted.
Main entry points: useReconocimiento.ts Recognition polling · main.py FastAPI entry · vision_service.py Vision service · resultados_service.py Practice results
Components 26
Web client
- App navigation
src/front/srcFront/App.tsx - Practice screen
src/front/srcFront/Practica.tsx - Camera capture
src/front/srcFront/hooks/useCamara.ts - Recognition polling
src/front/srcFront/hooks/useReconocimiento.ts - Recognition result
src/front/srcFront/components/ResultadoReconocimiento.tsx - Vision API client
src/front/srcFront/services/vision.ts - Practice recorder
src/front/srcFront/services/FachadaRegistroPractica.ts
API and identity
- FastAPI entry
app/main.py - Authentication routes
app/routes/autenticacion.py - Authentication service
app/services/autenticacion_service.py - Token security
app/security.py - Domain API routes
app/routes
Sign recognition
- Vision route
app/routes/vision.py - Vision service
app/services/vision_service.py - Recognition engine
app/vision/reconocimiento.py - Detector manager
app/vision/gestor_detectores.py - Vowel recognition
app/vision/vocales.py
Practice and learning
- Practice results
app/services/resultados_service.py - Learning progress
app/services/progreso_service.py - Attempt tracking
app/services/intentos_service.py - Learning evaluation
app/services/aprendizaje_service.py - Learning repository
app/repositories/aprendizaje_repository.py
Data and integrations
- PostgreSQL
conf/database.py - Recovery email
app/services/correo_recuperacion_service.py - Microsoft OAuth
app/services/microsoft_oauth_service.py
Other components
- Learner
Connections 28
- Learner → App navigation: uses
README.md - App navigation → Practice screen: routes to
src/front/srcFront/App.tsx - Practice screen → Camera capture: captures with
- Practice screen → Recognition polling: uses
- Recognition polling → Vision API client: requests recognition
src/front/srcFront/hooks/useReconocimiento.ts - Recognition polling → Camera capture: captures frames
src/front/srcFront/hooks/useReconocimiento.ts - Vision API client → FastAPI entry: calls backend
- Recognition polling → Recognition result: updates result
src/front/srcFront/components/ResultadoReconocimiento.tsx - FastAPI entry → Authentication routes: registers route
app/main.py - FastAPI entry → Vision route: registers route
app/main.py - FastAPI entry → Domain API routes: registers routes
app/main.py - Authentication routes → Authentication service: delegates authentication
app/routes/autenticacion.py - Authentication routes → Token security: checks tokens
app/routes/autenticacion.py - Token security → Authentication service: loads user
app/security.py - Token security → PostgreSQL: checks revocation
app/security.py - Vision route → Vision service: delegates recognition
- Vision service → Detector manager: uses detectors
app/services/vision_service.py - Vision service → Recognition engine: uses recognition
app/services/vision_service.py - Vision service → App navigation: closes detectors
- Learner → Practice recorder: submits practice
- Practice recorder → Practice results: records result
- Practice recorder → Learning progress: records progress
- Practice results → Attempt tracking: registers attempt
app/services/resultados_service.py - Practice results → Learning evaluation: evaluates learning
app/services/resultados_service.py - Learning progress → PostgreSQL: reads and writes
app/services/progreso_service.py - Practice results → PostgreSQL: reads and writes
app/services/resultados_service.py - Authentication service → PostgreSQL: connects through
app/services/autenticacion_service.py - Recovery email → Microsoft OAuth: obtains authorization
app/services/correo_recuperacion_service.py