How icssc/antalmanac works
AntAlmanac Scheduler is a UC Irvine quarterly course-planning web app, accompanied by an iOS WebView wrapper and AANTS, a service that emails subscribers about enrollment changes. The web workflow is course search, section inspection, and schedule planning, with calendar, map, grade, enrollment, and review features. Its backend exposes typed API access and persists user and schedule data. AANTS scans subscriptions, checks section changes, and queues rendered email notifications. Web backend wiring and several feature implementations are represented at directory level; the shown excerpts do not establish their precise call paths.
Main entry points: (main) Scheduler UI · index.ts Subscription Scan · SectionTable Section Details · routers API Routers
Components 23
Course Planning
- Scheduler UI
apps/antalmanac/src/app/(main) - Course Search
apps/antalmanac/src/components/RightPane/CoursePane - Section Details
apps/antalmanac/src/components/RightPane/SectionTable - Schedule Calendar
apps/antalmanac/src/components/Calendar - Schedule State
apps/antalmanac/src/stores/Schedules.ts - Campus Map
apps/antalmanac/src/components/Map - Course Insights
apps/antalmanac/src/components/RightPane/SectionTable/SectionTablePopover - Instructor Reviews
apps/antalmanac/src/components/ReviewPrompt
Web Backend
- tRPC API
apps/antalmanac/src/backend/trpc.ts - API Routers
apps/antalmanac/src/backend/routers - RDS Access
apps/antalmanac/src/backend/lib/rds
Email Notifications
- Subscription Scan
apps/aants/src/index.ts - Subscription Data
apps/aants/src/helpers/subscriptionData.ts - Notification Dispatch
apps/aants/src/helpers/notificationDispatch.ts - Email Template
apps/aants/src/emails/CourseNotificationEmail.tsx - Email Queue
apps/aants/src/helpers/emailQueue.ts
Client Apps
- iOS WebView
apps/ios/src/AntAlmanac/WebView.swift - WebView Controller
apps/ios/src/AntAlmanac/ViewController.swift
Shared Data
- Anteater API
packages/anteater-api/src/client/index.ts - PostgreSQL
packages/db/src/schema
Other components
- Student
- AWS Email Services
- iOS User
Connections 24
- Student → Scheduler UI: uses
README.md - Scheduler UI → Course Search: searches
- Course Search → Section Details: selects sections
- Scheduler UI → Schedule Calendar: previews schedule
README.md - Scheduler UI → Campus Map: views locations
README.md - Section Details → Course Insights: opens insights
README.md - Section Details → Instructor Reviews: opens reviews
README.md - Scheduler UI → Schedule State: updates
- Scheduler UI → tRPC API: requests data
- tRPC API → API Routers: dispatches
- API Routers → RDS Access: accesses records
- RDS Access → PostgreSQL: reads and writes
- API Routers → Anteater API: fetches UCI data
- Subscription Scan → Subscription Data: loads subscriptions
apps/aants/src/index.ts - Subscription Scan → Anteater API: checks sections
- Subscription Data → PostgreSQL: reads and updates
apps/aants/src/helpers/subscriptionData.ts - Subscription Data → Anteater API: creates client
apps/aants/src/helpers/subscriptionData.ts - Subscription Scan → Notification Dispatch: sends notifications
apps/aants/src/index.ts - Notification Dispatch → Email Template: renders
apps/aants/src/helpers/notificationDispatch.ts - Notification Dispatch → Email Queue: queues email
apps/aants/src/helpers/notificationDispatch.ts - Email Queue → AWS Email Services: delivers via
README.md - iOS User → iOS WebView: uses
README.md - iOS WebView → WebView Controller: delegates navigation
apps/ios/src/AntAlmanac/WebView.swift - WebView Controller → Scheduler UI: loads web app
README.md