How imnotcheguevara/mpu_studying_dashboard works
Campus Dashboard is a local macOS student dashboard that consolidates read-only Canvas and MPU SIweb data. Its main workflow synchronizes configured sources, commits normalized records to SQLite, loads a unified snapshot for the dashboard pages, and offers local calendar and reminder features. AI analysis is an optional, user-controlled branch whose suggestions remain in a confirmation queue until accepted. The README documents the product boundaries and major capabilities; source excerpts and the index confirm several internal calls, but not every runtime wiring detail.
Main entry points: DashboardModel.swift Dashboard Model · SQLiteDatabase.swift SQLite Database · SyncEngine.swift Sync Engine · AIParsingCoordinator.swift AI Parsing
Components 25
Dashboard UI
- Dashboard Model
Sources/CampusDashboard/App/DashboardModel.swift - Today View
Sources/CampusDashboard/Features/Today/TodayView.swift - Schedule View
Sources/CampusDashboard/Features/Schedule/ScheduleView.swift - Tasks View
Sources/CampusDashboard/Features/Tasks/TasksView.swift - Announcements View
Sources/CampusDashboard/Features/Announcements/AnnouncementsView.swift - Confirmation Queue
Sources/CampusDashboard/Features/Confirmations/ConfirmationQueueView.swift - Settings View
Sources/CampusDashboard/Features/Settings/SettingsView.swift
Source Connectors
- Canvas Connector
Sources/CampusDashboard/Connectors/Canvas/CanvasAPIConnector.swift - SIweb Connector
Sources/CampusDashboard/Connectors/SIweb/SIwebConnector.swift - SIweb Authorization
Sources/CampusDashboard/Connectors/SIweb/SIwebWebAuthenticationTool.swift
Sync and Storage
- Sync Engine
Sources/CampusDashboard/Sync/SyncEngine.swift - Dashboard Data
Sources/CampusDashboard/App/DashboardDataService.swift - SQLite Database
Sources/CampusDashboard/Persistence/SQLiteDatabase.swift - Schema Migrator
Sources/CampusDashboard/Persistence/DatabaseMigrator.swift
AI Assistance
- AI Parsing
Sources/CampusDashboard/AI/AIParsingCoordinator.swift - Academic Signals
Sources/CampusDashboard/AI/AcademicSignalCoordinator.swift - Schedule Target Resolver
Sources/CampusDashboard/AI/AcademicScheduleTargetResolver.swift - DeepSeek Provider
Sources/CampusDashboard/AI/DeepSeekProvider.swift
Local Features
- Calendar Service
Sources/CampusDashboard/Calendar/CampusCalendarService.swift - Apple Calendar
Sources/CampusDashboard/Calendar/EventKitEventStore.swift - Local Notifications
Sources/CampusDashboard/Notifications/CampusNotificationService.swift - Background Sync
Sources/CampusDashboard/Background/BackgroundSyncScheduler.swift
Other components
- Student
- Canvas
- MPU SIweb
Connections 28
- Student → Dashboard Model: uses
README.md - Dashboard Model → Today View: drives
Sources/CampusDashboard/Features/Today/TodayView.swift - Dashboard Model → Schedule View: drives
README.md - Dashboard Model → Tasks View: drives
Sources/CampusDashboard/Features/Tasks/TasksView.swift - Dashboard Model → Announcements View: drives
Sources/CampusDashboard/Features/Announcements/AnnouncementsView.swift - Dashboard Model → Confirmation Queue: drives
Sources/CampusDashboard/Features/Confirmations/ConfirmationQueueView.swift - Dashboard Model → Settings View: drives
Sources/CampusDashboard/Features/Settings/SettingsView.swift - Canvas Connector → Canvas: reads
README.md - SIweb Connector → MPU SIweb: reads
README.md - Settings View → SIweb Authorization: starts authorization
- SIweb Authorization → SIweb Connector: configures
Sources/CampusDashboard/Connectors/SIweb/SIwebWebAuthenticationTool.swift - Sync Engine → Canvas Connector: fetches snapshots
README.md - Sync Engine → SIweb Connector: fetches snapshots
README.md - Sync Engine → SQLite Database: writes records
Sources/CampusDashboard/Sync/SyncEngine.swift - Dashboard Data → SQLite Database: reads snapshot
Sources/CampusDashboard/App/DashboardDataService.swift - SQLite Database → Schema Migrator: runs migrations
Sources/CampusDashboard/Persistence/SQLiteDatabase.swift - Dashboard Model → Dashboard Data: loads snapshot
README.md - Dashboard Model → AI Parsing: requests analysis
Sources/CampusDashboard/App/DashboardModel.swift - Dashboard Model → Academic Signals: manages signals
Sources/CampusDashboard/App/DashboardModel.swift - Academic Signals → Schedule Target Resolver: resolves targets
Sources/CampusDashboard/AI/AcademicSignalCoordinator.swift - AI Parsing → SQLite Database: persists results
Sources/CampusDashboard/AI/AIParsingCoordinator.swift - Academic Signals → SQLite Database: persists signals
Sources/CampusDashboard/AI/AcademicSignalCoordinator.swift - AI Parsing → DeepSeek Provider: optionally invokes
Sources/CampusDashboard/AI/DeepSeekProvider.swift - Dashboard Model → Calendar Service: controls calendar
Sources/CampusDashboard/App/DashboardModel.swift - Calendar Service → Apple Calendar: writes events
README.md - Dashboard Model → Local Notifications: controls reminders
Sources/CampusDashboard/App/DashboardModel.swift - Dashboard Model → Background Sync: configures scheduling
Sources/CampusDashboard/App/DashboardModel.swift - Background Sync → Local Notifications: reconciles reminders
Sources/CampusDashboard/Background/BackgroundSyncScheduler.swift