How jinllo/p3.1c works
Libro de Clases Virtual is a school-attendance management system with a FastAPI backend and web and mobile clients. Users authenticate and then manage students, courses, attendance, reports, calendar events, and notifications; administrators also manage users and roles. The backend exposes these capabilities through API routers and stores domain records in a relational database. The README documents product features not all sampled in source; edges for those capabilities cite the README, while source-level wiring is limited to the excerpts and index shown.
Main entry points: main.py FastAPI application · database.py Relational database · auth.py Authentication API · attendance.py Attendance API
Components 27
User clients
- Web application
frontend/src/App.tsx - Mobile application
mobile-app/app/(tabs)
Identity and access
- Web session
frontend/src/context/AuthContext.tsx - Mobile session
mobile-app/src/context/AuthContext.tsx - Firebase auth
mobile-app/src/services/firebaseAuth.ts - Authentication API
backend/app/api/auth.py - Role permissions
backend/app/core/permissions.py
School operations
- Student management
frontend/src/pages/StudentsPage.tsx - Course management
frontend/src/pages/CoursesPage.tsx - Attendance entry
frontend/src/pages/AttendancePage.tsx - School calendar
frontend/src/pages/CalendarPage.tsx - Student API
backend/app/api/students.py - Course API
backend/app/api/courses.py - Attendance API
backend/app/api/attendance.py - Attendance service
backend/app/services/attendance_service.py - Calendar API
backend/app/api/calendar.py
Reports and alerts
- Reports and metrics
frontend/src/pages/MonthlyReportPage.tsx - Reports API
backend/app/api/reports.py - PDF and Excel export
backend/export_service.py - Dashboard metrics
backend/app/api/dashboard.py - Notifications center
frontend/src/pages/NotificationsPage.tsx - Notifications API
backend/app/api/notifications.py - Absence alerts
backend/app/services/notification_service.py
API and data
- FastAPI application
backend/app/main.py - Domain records
backend/app/models/__init__.py - Relational database
backend/app/core/database.py
Other components
- School users
Connections 35
- School users → Web application: uses
frontend/src/App.tsx - School users → Mobile application: uses
- Web application → Web session: provides session
frontend/src/App.tsx - Web session → Authentication API: requests login
frontend/src/context/AuthContext.tsx - Mobile application → Mobile session: authenticates
- Mobile session → Firebase auth: delegates sign-in
mobile-app/src/context/AuthContext.tsx - Mobile session → Authentication API: exchanges token
mobile-app/src/context/AuthContext.tsx - Authentication API → Relational database: reads and writes
backend/app/api/auth.py - FastAPI application → Authentication API: registers router
backend/app/main.py - FastAPI application → Student API: registers router
backend/app/main.py - FastAPI application → Attendance API: registers router
backend/app/main.py - FastAPI application → Course API: registers router
backend/app/main.py - FastAPI application → Calendar API: registers router
backend/app/main.py - FastAPI application → Reports API: registers router
backend/app/main.py - FastAPI application → Notifications API: registers router
backend/app/main.py - FastAPI application → Dashboard metrics: registers router
backend/app/main.py - Student management → Student API: manages students
- Course management → Course API: manages courses
- Attendance entry → Attendance API: records attendance
frontend/src/pages/AttendancePage.tsx - Attendance API → Attendance service: delegates attendance
backend/app/services/attendance_service.py - Attendance API → Relational database: stores records
- School calendar → Calendar API: manages events
- Reports and metrics → Reports API: requests reports
- Reports API → PDF and Excel export: exports files
- Dashboard metrics → Relational database: computes metrics
- Notifications center → Notifications API: manages alerts
- Notifications API → Absence alerts: dispatches alerts
- Absence alerts → Relational database: reads records
backend/app/services/notification_service.py - Student API → Relational database: reads and writes
- Course API → Relational database: reads and writes
- Calendar API → Relational database: reads and writes
- Reports API → Relational database: queries records
- Attendance service → Domain records: uses domain models
backend/app/services/attendance_service.py - FastAPI application → Relational database: creates tables
backend/app/main.py - Role permissions → Authentication API: enforces roles