How yugraj20/selfattendancee works
Self Attendance is a local-first attendance tracker: users manage subjects and a timetable, record class outcomes, and review attendance calculations and history. The React app is the main coordinator; IndexedDB is the local source of truth, with optional Google sign-in and Firestore mirroring. It also supports AI-assisted timetable and text imports, validated backup/restore, and Excel export. The README documents these product flows; some UI wiring is unsampled, so the graph omits uncertain component-level calls.
Main entry points: App.tsx App coordinator · sync.ts Cloud sync · math.ts Attendance calculations · main.tsx React entry
Components 18
App and attendance
- React entry
src/main.tsx - App coordinator
src/App.tsx - Floating navigation
src/components/FloatingNav.tsx - Quick marking
src/components/QuickMarkModal.tsx - Subject management
src/components/SubjectsPage.tsx - Monthly attendance
src/components/MonthlyAttendance.tsx
Attendance domain
- Attendance calculations
src/math.ts
Persistence and sync
- IndexedDB store
src/db.ts - Firebase auth setup
src/firebase.ts - Cloud sync
src/sync.ts
Import and export
- Timetable AI import
src/gemini.ts - Attendance text import
src/attendance-import.ts - Backup and restore
src/backup.ts - Excel export UI
src/components/ExcelExportModal.tsx - Excel generation
src/excel-export.ts
Other components
- Student
- Firestore
- Gemini API
Connections 19
- Student → React entry: opens app
README.md - React entry → App coordinator: renders
src/main.tsx - Student → App coordinator: tracks attendance
README.md - App coordinator → IndexedDB store: reads and writes
README.md - App coordinator → Cloud sync: coordinates sync
README.md - App coordinator → Firebase auth setup: signs in
README.md - Cloud sync → IndexedDB store: reads local data
src/sync.ts - Cloud sync → Firestore: mirrors data
src/sync.ts - Firebase auth setup → Firestore: configures access
src/firebase.ts - App coordinator → Attendance calculations: calculates attendance
src/App.tsx - Subject management → Attendance calculations: calculates subject stats
src/components/SubjectsPage.tsx - Quick marking → Attendance calculations: uses date helper
src/components/QuickMarkModal.tsx - App coordinator → Timetable AI import: imports timetable
README.md - App coordinator → Attendance text import: imports attendance
README.md - Timetable AI import → Gemini API: sends timetable file
src/gemini.ts - Attendance text import → Gemini API: sends text for parsing
- App coordinator → Backup and restore: backs up and restores
README.md - App coordinator → Excel export UI: offers export
src/App.tsx - Excel export UI → Excel generation: generates workbook
src/components/ExcelExportModal.tsx