How shadhin78/x-29-advance works
X-29 is a private academic execution workspace. The main flow is an administrator entering through authentication, using dashboard studios to plan and track study, and persisting changes locally with queued cloud sync. The graph retains the README’s major product domains; legacy archived code is excluded from the active architecture. Several feature routes, stores, and integrations are represented from documented capabilities and tree paths, since their source was not sampled; their uncertain connections are omitted.
Main entry points: useTaskStore.ts Study tasks · DashboardStudio.tsx Dashboard overview · syncService.ts Cloud sync queue · SubjectsStudio.tsx Subjects and syllabus
Components 23
Access and shell
- Login
app/login/page.tsx - Auth service
services/authService.ts - Auth gate
components/auth/AuthGate.tsx - Dashboard shell
components/shell/AppShell.tsx
Planning and syllabus
- Master config
features/config/components/MasterConfigStudio.tsx - Taxonomy service
features/taxonomy/services/taxonomyService.ts - Subjects and syllabus
features/subjects/components/SubjectsStudio.tsx - Target allocation
features/targets/services/targetAllocationEngine.ts
Study execution
- Daily actions
features/daily-actions/components/DailyActionsStudio.tsx - Study tasks
stores/useTaskStore.ts - Schedule matrix
features/schedule/components/ScheduleStudio.tsx - Focus timer
features/focus/services/timerEngine.ts - Timer state
stores/useTimerStore.ts - Exam routine
features/exam/services/examService.ts
Progress and outcomes
- Dashboard overview
features/dashboard/components/DashboardStudio.tsx - Pace studio
features/pace/services/paceEngine.ts - Outcome and CGPA
features/outcome/services/outcomeEngine.ts - Visual analytics
features/analytics/services/analyticsService.ts
Persistence and sync
- IndexedDB
lib/storage/indexeddb.ts - Cloud sync queue
lib/sync/syncService.ts - Firebase services
lib/firebase/client.ts - Firestore
lib/firebase/firestore.ts
Other components
- Administrator
Connections 23
- Administrator → Login: signs in
- Login → Auth service: authenticates
- Auth service → Firebase services: uses auth
services/authService.ts - Auth gate → Auth service: checks session
- Auth gate → Dashboard shell: opens workspace
- Dashboard shell → Dashboard overview: presents overview
- Dashboard overview → Daily actions: surfaces checklist
- Dashboard overview → Exam routine: shows countdown
- Dashboard overview → Pace studio: shows progress
- Master config → Taxonomy service: edits taxonomy
- Subjects and syllabus → Study tasks: tracks chapters
- Target allocation → Daily actions: allocates targets
- Daily actions → Study tasks: updates tasks
- Schedule matrix → Subjects and syllabus: allocates study time
- Focus timer → Timer state: computes timer state
- Study tasks → IndexedDB: reads and writes
stores/useTaskStore.ts - Study tasks → Cloud sync queue: queues changes
stores/useTaskStore.ts - Cloud sync queue → IndexedDB: stores queue
lib/sync/syncService.ts - Cloud sync queue → Firebase services: checks current user
lib/sync/syncService.ts - Cloud sync queue → Firestore: writes patches
lib/sync/syncService.ts - Pace studio → Subjects and syllabus: estimates velocity
- Outcome and CGPA → Subjects and syllabus: calculates results
- Visual analytics → Study tasks: analyzes activity