How andrejrunb/-quila-pro-v-1.0.0 works
Áquila Pro is an offline-first school operating system spanning desktop, mobile, and web experiences, with learning support, assessment, attendance, family communication, and governance capabilities. The documented user journey runs from teacher planning and assessment through student study activities to family follow-up. Source excerpts establish several desktop alert, persistence, notification, and media-gateway relationships; many other capabilities are documented in the README but their wiring is unsampled. Archived mobile and cloud modules are kept distinct from the current product surfaces.
Main entry points: AlertEngine.ts Attendance Alerts · LoginScreen.tsx Archived Login · OmrCorrectionService.ts Exam Foundry · index.tsx Mobile Companion
Components 31
Learning and Assessment
- Exam Foundry
apps/electron/src/main/services/OmrCorrectionService.ts - OMR Correction
apps/electron/src/main/services/OmrCorrectionService.ts - Learning Studio
apps/electron/src/services/PedagogicalTriEngine.ts - Study Activities
apps/electron/src/services/WordwallGameEngine.ts - Interactive Content
apps/electron/src/services/H5PPerseusEngine.ts - Gamification Catalog
apps/media-gateway/src/services/GamificationCatalogService.ts - Media Gateway
apps/media-gateway/src/services/MediaGatewayService.ts
School Operations
- Attendance Alerts
apps/electron/src/main/services/AlertEngine.ts - Behavior Analysis
apps/electron/src/main/services/BehavioralEngine.ts - Notification Queue
apps/electron/src/main/services/NotificationQueueService.ts - Push Notifications
apps/electron/src/main/services/PushNotificationService.ts
Desktop Platform
- Local Database
apps/electron/src/database/Database.ts - WebSocket Server
apps/electron/src/main/services/WebSocketServer.ts - Desktop Logger
apps/electron/src/main/logger.ts - Logger Service
apps/electron/src/main/services/Logger.ts - SQLite Recovery
apps/electron/src/main/services/SQLiteDisasterRecoveryService.ts - Security Service
apps/electron/src/main/services/SecurityService.ts - AI Contracts
apps/electron/src/services/AiTypes.ts - Media Contracts
apps/media-gateway/src/types/mediaContracts.ts
Student and Family Apps
- Mobile Companion
apps/mobile/app/(tabs)/index.tsx - Family Channel
apps/electron/src/main/services/ParentPortalService.ts - Web Portals
apps/web/src/app/portal/aluno/page.tsx
Archived Clients and Cloud
- Archived Mobile
archive/aquila-mobile/src/screens/TimelineScreen.tsx - Geofencing Service
archive/aquila-mobile/src/services/LocationService.ts - Archived Login
archive/aquilapro_mobile/src/screens/LoginScreen.tsx - Archived Parent App
archive/aquilapro_mobile/src/screens/ParentDashboard.tsx - Archived Guard App
archive/aquilapro_mobile/src/screens/GuardDashboard.tsx - Archived Teacher App
archive/aquilapro_mobile/src/screens/TeacherDashboard.tsx - Cloud WhatsApp Route
archive/aquila-cloud/src/routes/whatsapp.ts - Cloud PostgreSQL Pool
archive/aquila-cloud/src/db/pool.ts
Other components
- Teacher
Connections 17
- Teacher → Learning Studio: plans learning
README.md - Teacher → Exam Foundry: creates assessments
README.md - Exam Foundry → OMR Correction: produces answer sheets
README.md - Exam Foundry → Mobile Companion: sends via gateway
README.md - Learning Studio → Mobile Companion: provides study content
README.md - Mobile Companion → Family Channel: supports review
README.md - Attendance Alerts → Local Database: records attendance
apps/electron/src/main/services/AlertEngine.ts - Attendance Alerts → Behavior Analysis: processes recognition
apps/electron/src/main/services/AlertEngine.ts - Attendance Alerts → Notification Queue: queues messages
apps/electron/src/main/services/AlertEngine.ts - Desktop Logger → Logger Service: initializes
apps/electron/src/main/logger.ts - Media Gateway → Media Contracts: uses contracts
apps/media-gateway/src/services/MediaGatewayService.ts - Gamification Catalog → Media Contracts: uses contracts
apps/media-gateway/src/services/GamificationCatalogService.ts - Geofencing Service → Cloud WhatsApp Route: sends arrival events
- Archived Mobile → Geofencing Service: starts geofencing
archive/aquila-mobile/App.tsx - Archived Login → Archived Parent App: routes to
archive/aquilapro_mobile/App.tsx - Archived Login → Archived Guard App: routes to
archive/aquilapro_mobile/App.tsx - Archived Login → Archived Teacher App: routes to
archive/aquilapro_mobile/App.tsx