How aswine2005/aksameet works
AksaMeet provides authenticated online classes with Stream-powered meetings, automatic attendance, and private on-device attention insights. The main flow is host creation, participant lobby and join, local camera analysis, periodic presence reports, host live monitoring, then history and meeting reports. MongoDB stores meeting and participant records; Stream carries video/chat. README documents capabilities not fully sampled, so those branches are represented at their documented routes or directories; edges without source or README evidence are omitted.
Main entry points: store.ts MongoDB records · meetings/route.ts Meeting creation · useAttentionTracker.ts Local attention tracker · presence/route.ts Presence endpoint
Components 27
Meetings
- Meeting web UI
src/app/[meetingId]/meeting/page.tsx - Meeting provider
src/contexts/MeetProvider.tsx - Lobby & setup
src/components/MeetingPreview.tsx - Meeting creation
src/app/api/meetings/route.ts
Attendance & Insights
- Local attention tracker
src/hooks/useAttentionTracker.ts - Face analysis
src/lib/client/faceAnalyzer.ts - Attention scoring
src/lib/attention.ts - Presence reporting
src/hooks/usePresence.ts - Presence endpoint
src/app/api/meetings/[meetingId]/presence/route.ts - Attendance calculations
src/lib/attendance.ts - Host live panel
src/components/InsightsPanel.tsx - Live data polling
src/hooks/useHostLive.ts - Live endpoint
src/app/api/meetings/[meetingId]/live/route.ts - Camera check
src/app/check/page.tsx
History & Reports
- Meeting history
src/app/history/page.tsx - History endpoint
src/app/api/history/route.ts - Meeting report
src/app/history/[meetingId]/page.tsx - Report & CSV
src/app/api/meetings/[meetingId]/report/route.ts
Services & persistence
- Stream video & chat
- Stream token
src/app/api/token/route.ts - MongoDB records
src/lib/store.ts - MongoDB connection
src/lib/db.ts - Auth & report services
src/lib/server.ts - Clerk identity
- Profile sync webhook
src/app/api/webhooks/route.ts
Other components
- Host
- Participant
Connections 35
- Host → Meeting creation: creates
src/app/api/meetings/route.ts - Meeting creation → Auth & report services: gets identity
src/app/api/meetings/route.ts - Meeting creation → Stream video & chat: creates call
src/app/api/meetings/route.ts - Meeting creation → MongoDB records: creates record
src/app/api/meetings/route.ts - Participant → Lobby & setup: prepares devices
src/components/MeetingPreview.tsx - Meeting web UI → Meeting provider: uses
src/contexts/MeetProvider.tsx - Meeting provider → Stream token: requests token
src/contexts/MeetProvider.tsx - Stream token → Stream video & chat: issues token
src/app/api/token/route.ts - Meeting provider → Stream video & chat: connects clients
src/contexts/MeetProvider.tsx - Participant → Local attention tracker: analyzes locally
README.md - Local attention tracker → Face analysis: reads camera
src/hooks/useAttentionTracker.ts - Local attention tracker → Attention scoring: scores frames
src/hooks/useAttentionTracker.ts - Local attention tracker → Presence reporting: supplies state
- Presence reporting → Presence endpoint: posts heartbeat
README.md - Presence endpoint → Auth & report services: authenticates
src/app/api/meetings/[meetingId]/presence/route.ts - Presence endpoint → MongoDB records: records presence
src/app/api/meetings/[meetingId]/presence/route.ts - Presence endpoint → Attendance calculations: calculates summaries
src/app/api/meetings/[meetingId]/presence/route.ts - Host → Host live panel: monitors class
README.md - Host live panel → Live data polling: loads live data
src/components/InsightsPanel.tsx - Live data polling → Live endpoint: polls
src/hooks/useHostLive.ts - Live endpoint → MongoDB records: reads records
- Host → Meeting history: opens history
README.md - Participant → Meeting history: opens history
README.md - Meeting history → History endpoint: loads meetings
README.md - History endpoint → MongoDB records: reads hosted and attended
src/app/api/history/route.ts - Host → Meeting report: views report
README.md - Participant → Meeting report: views own record
README.md - Meeting report → Report & CSV: requests report
- Report & CSV → Auth & report services: builds report
src/app/api/meetings/[meetingId]/report/route.ts - Report & CSV → MongoDB records: loads meeting data
src/app/api/meetings/[meetingId]/report/route.ts - MongoDB records → MongoDB connection: gets collections
src/lib/store.ts - Auth & report services → Clerk identity: checks identity
src/lib/server.ts - Camera check → Face analysis: previews analysis
- Profile sync webhook → Stream video & chat: syncs profiles
src/app/api/webhooks/route.ts - Clerk identity → Profile sync webhook: sends user events
src/app/api/webhooks/route.ts