How hemanthkumargt/startby works
StartBy is a Flask task-management web app. The main workflow is a signed-in user creating and managing tasks, then viewing dashboard status and due dates; optional estimates add start-by risk guidance and reminders. Routes delegate business rules to services, which use SQL repositories over SQLite. The README documents additional capture, voice, calendar, analytics, backup, and monitoring capabilities. Some of those branches are represented from documentation because their source was not sampled; edges are limited to documented or indexed relationships.
Main entry points: task_service.py Task rules · db.py SQLite · reminder_service.py Reminder sweep · capture_service.py Smart capture
Components 34
Web experience
- Web UI
app/static/js - Auth routes
app/routes/auth.py - Task routes
app/routes/tasks.py - Capture routes
app/routes/capture.py - Voice routes
app/routes/voice.py - Voice note routes
app/routes/voice_notes.py - Calendar routes
app/routes/calendar.py - Insights routes
app/routes/insights.py - Reminder cron
app/routes/cron.py
Task domain
- Task rules
app/services/task_service.py - Estimates and risk
app/services/estimate_service.py - Activity history
app/services/activity_service.py - Reminder sweep
app/services/reminder_service.py
User workflows
- Smart capture
app/services/capture_service.py - Voice assistant
app/services/assistant_service.py - Daily briefing
app/services/briefing_service.py - Voice notes
app/services/voice_note_service.py - Calendar sync
app/services/calendar_service.py - Overload insights
app/services/insights_service.py - Authentication rules
app/services/auth_service.py - Nightly backup
app/services/backup_service.py
Persistence and integrations
- Task repository
app/repositories/task_repo.py - Reminder repository
app/repositories/reminder_repo.py - Activity repository
app/repositories/activity_repo.py - User repository
app/repositories/user_repo.py - Calendar repository
app/repositories/calendar_repo.py - SQLite
app/db.py
Other components
- User
- Email service
- Gemini API
- Google Calendar API
- Cloud Tasks
app/gcp/cloudtasks.py - Pub/Sub and BigQuery
app/gcp/pubsub.py - Cloud Storage
app/gcp/storage.py
Connections 37
- User → Web UI: uses
README.md - Web UI → Task routes: sends task requests
README.md - Web UI → Auth routes: sends auth requests
README.md - Task routes → Task rules: delegates to
app/routes/tasks.py - Auth routes → Authentication rules: delegates to
app/routes/auth.py - Task rules → Task repository: reads and writes
app/services/task_service.py - Task rules → Reminder repository: clears reminders
app/services/task_service.py - Task rules → Activity history: records changes
app/services/task_service.py - Task rules → Estimates and risk: calculates risk
app/services/task_service.py - Activity history → Activity repository: records activity
app/services/activity_service.py - Authentication rules → User repository: reads and writes
app/services/auth_service.py - Reminder cron → Reminder sweep: runs sweep
app/routes/cron.py - Reminder sweep → Reminder repository: finds candidates
app/services/reminder_service.py - Reminder sweep → Task repository: reads tasks
app/services/reminder_service.py - Reminder sweep → Estimates and risk: computes start times
app/services/reminder_service.py - Reminder sweep → Email service: sends notices
README.md - Capture routes → Smart capture: handles capture
- Smart capture → Gemini API: extracts text
README.md - Smart capture → Task rules: creates draft tasks
app/services/capture_service.py - Voice routes → Voice assistant: handles questions
- Voice routes → Daily briefing: builds briefing
- Voice routes → Gemini API: transcribes audio
README.md - Voice note routes → Voice notes: manages notes
- Voice notes → Smart capture: hands off note
README.md - Calendar routes → Calendar sync: delegates to
app/routes/calendar.py - Calendar sync → Calendar repository: reads and writes links
app/services/calendar_service.py - Calendar sync → Google Calendar API: syncs events
README.md - Insights routes → Overload insights: requests insights
- Task repository → SQLite: queries
README.md - Reminder repository → SQLite: queries
README.md - User repository → SQLite: queries
README.md - Calendar repository → SQLite: queries
README.md - Activity repository → SQLite: queries
README.md - Task rules → Cloud Tasks: schedules start reminders
- Task rules → Pub/Sub and BigQuery: publishes task events
- Nightly backup → SQLite: snapshots
README.md - Nightly backup → Cloud Storage: stores backup
README.md