How chen-yihua/auto-scheduling-system works
Auto Scheduling System brings manually entered tasks and GitHub, Jira, and Moodle work into one dashboard, estimates missing task priority and duration with AI, and suggests calendar-based schedules. Users connect external accounts, review synced items and Google Calendar availability, then use rule-based scheduling suggestions. The graph also includes the separate GitHub PR-summary webhook. Edges are limited to relationships visible in excerpts, SOURCE INDEX references, or README statements; several frontend and domain implementations were not sampled, so uncertain internal calls are omitted.
Main entry points: main.py FastAPI app · oauth.py Calendar tokens · mongodb.py MongoDB · manualTask.py Task routes
Components 34
Dashboard
- Dashboard
Frontend/components/TheMain/index.vue - Task form
Frontend/components/TheMain/TaskForm.vue - Data composables
Frontend/composables - Calendar embed
Frontend/components/TheMain/GoogleCalendarEmbed.vue
API routes
- FastAPI app
Backend/main.py - Task routes
Backend/routers/manualTask.py - GitHub routes
Backend/routers/github.py - Jira routes
Backend/routers/jira.py - Moodle routes
Backend/routers/moodle.py - Account routes
Backend/routers/linkedAccount.py - Calendar OAuth routes
Backend/routers/oauth.py - Schedule routes
Backend/routers/schedule.py - PR webhook
Backend/routers/webhook.py
Task and schedule logic
- Manual tasks
Backend/crud/manualTask.py - Schedulable items
Backend/crud/schedulable_items.py - Schedule logic
Backend/crud/schedule.py - Task inference
Backend/crud/task_inference.py - External sync
Backend/crud/external_sync.py - GitHub sync
Backend/crud/github.py - Account links
Backend/crud/linkedAccount.py - Calendar tokens
Backend/crud/oauth.py
External integrations
- Calendar operations
Backend/services/google_calendar.py - GitHub
- Jira
- Moodle
- Google Calendar
- Gemini
- Discord
Security and storage
- MongoDB
Backend/db/mongodb.py - Clerk JWT auth
Backend/db/security.py - Short-term cache
Backend/cache.py - Redis
- Rate limiting
Backend/rate_limit.py
Other components
- User
Connections 48
- User → Dashboard: views
- Dashboard → Task form: renders
Frontend/components/TheMain/index.vue - Dashboard → Data composables: loads dashboard data
Frontend/components/TheMain/index.vue - Dashboard → Calendar embed: renders
Frontend/components/TheMain/index.vue - Task form → Data composables: manages task form
- Data composables → FastAPI app: calls API
- FastAPI app → Task routes: registers
Backend/main.py - FastAPI app → GitHub routes: registers
Backend/main.py - FastAPI app → Jira routes: registers
Backend/main.py - FastAPI app → Moodle routes: registers
Backend/main.py - FastAPI app → Account routes: registers
Backend/main.py - FastAPI app → Calendar OAuth routes: registers
Backend/main.py - FastAPI app → Schedule routes: registers
Backend/main.py - FastAPI app → PR webhook: registers
Backend/main.py - Task routes → Manual tasks: calls
Backend/routers/manualTask.py - Task routes → Task inference: infers fields
Backend/routers/manualTask.py - Task routes → Clerk JWT auth: authenticates
Backend/routers/manualTask.py - Task routes → Rate limiting: limits requests
Backend/routers/manualTask.py - GitHub routes → GitHub sync: calls
Backend/routers/github.py - Jira routes → External sync: syncs items
- Moodle routes → External sync: syncs items
- Account routes → Account links: calls
Backend/routers/linkedAccount.py - Calendar OAuth routes → Calendar tokens: calls
Backend/routers/oauth.py - Schedule routes → Calendar tokens: gets availability
Backend/routers/schedule.py - Schedule routes → Schedule logic: calls
Backend/routers/schedule.py - Schedule routes → Schedulable items: gets tasks
Backend/routers/schedule.py - GitHub sync → External sync: syncs items
Backend/crud/github.py - GitHub sync → MongoDB: reads and writes
Backend/crud/github.py - Schedulable items → Manual tasks: reads tasks
Backend/crud/schedulable_items.py - Schedulable items → MongoDB: reads and writes
Backend/crud/schedulable_items.py - Manual tasks → MongoDB: reads and writes
- Account links → MongoDB: stores credentials
- Calendar tokens → MongoDB: stores tokens
Backend/crud/oauth.py - Calendar tokens → Short-term cache: caches free slots
Backend/crud/oauth.py - Short-term cache → Redis: uses if configured
- Calendar tokens → Calendar operations: fetches and creates events
Backend/crud/oauth.py - Calendar OAuth routes → Calendar operations: fetches calendars and events
Backend/routers/oauth.py - Calendar operations → Google Calendar: requests calendar data
Backend/services/google_calendar.py - GitHub sync → GitHub: fetches issues and PRs
- External sync → Jira: fetches issues
- External sync → Moodle: fetches assignments
- Task inference → Gemini: estimates fields
- PR webhook → GitHub: handles PR events
Backend/routers/webhook.py - PR webhook → Gemini: summarizes PR
Backend/routers/webhook.py - PR webhook → Discord: posts summary
Backend/routers/webhook.py - Schedule logic → Calendar tokens: uses free slots
- Schedule logic → Google Calendar: suggests calendar slots
- FastAPI app → MongoDB: ensures indexes
Backend/main.py