How cjake28/taskflow-app works
TaskFlow is a full-stack personal task-management product. Its main workflow is that a signed-in user creates and organizes tasks, then tracks due dates, activity, and progress through task views, the calendar, and dashboard. Account security and profile management, image attachments, OAuth, and configurable notifications extend that workflow. The graph combines documented product capabilities with sampled routing, authentication, storage, and service code; several feature-level connections are documented rather than verified in source excerpts.
Main entry points: routes.ts API router · prisma.ts PostgreSQL · sessions.service.ts Session management · users.service.ts Profile management
Components 23
Web application
- Web shell
frontend/src/app/router.tsx - Task views
frontend/src/features/tasks/pages/tasks-page.tsx - Progress views
frontend/src/features/dashboard/pages/dashboard-page.tsx - Account views
frontend/src/features/profile/pages/profile-page.tsx
Identity and account
- Authentication
backend/src/modules/auth/auth.service.ts - Session management
backend/src/modules/auth/sessions.service.ts - OAuth sign-in
backend/src/modules/oauth/oauth.service.ts - Profile management
backend/src/modules/users/users.service.ts
Task workspace
- Task management
backend/src/modules/tasks/tasks.service.ts - Image handling
backend/src/modules/images/images.service.ts
Insights and notifications
- Dashboard data
backend/src/modules/dashboard/dashboard.service.ts - Activity history
backend/src/modules/activities/activity.service.ts - Notifications
backend/src/modules/notifications/notifications.service.ts
Backend platform
- Shared schemas
packages/shared/src/schemas/task.ts - API router
backend/src/routes.ts - Object storage
backend/src/storage/create-storage.ts - Background jobs
backend/src/jobs/job-queue.ts - Email delivery
backend/src/mail/mail.transport.ts - PostgreSQL
backend/src/database/prisma.ts - Redis
backend/src/redis/redis.ts
Other components
- User
- Google / GitHub
- SMTP service
Connections 30
- User → Web shell: uses
README.md - Web shell → Task views: opens
- Task views → API router: requests tasks
- Progress views → API router: requests progress
- Account views → API router: manages account
- API router → Authentication: mounts routes
backend/src/routes.ts - API router → OAuth sign-in: mounts routes
backend/src/routes.ts - API router → Profile management: mounts routes
backend/src/routes.ts - API router → Task management: mounts routes
backend/src/routes.ts - API router → Image handling: mounts routes
backend/src/routes.ts - API router → Dashboard data: mounts routes
backend/src/routes.ts - API router → Activity history: mounts routes
backend/src/routes.ts - API router → Notifications: mounts routes
backend/src/routes.ts - Authentication → Session management: creates sessions
- Session management → PostgreSQL: reads / writes
backend/src/modules/auth/sessions.service.ts - Session management → Redis: checks cache
backend/src/modules/auth/sessions.service.ts - Task management → PostgreSQL: reads / writes
- Activity history → PostgreSQL: reads / writes
- Dashboard data → PostgreSQL: queries metrics
- Profile management → PostgreSQL: reads / writes
backend/src/modules/users/users.service.ts - Profile management → Session management: revokes sessions
backend/src/modules/users/users.service.ts - Profile management → Background jobs: enqueues email
backend/src/modules/users/users.service.ts - OAuth sign-in → Google / GitHub: exchanges code
backend/src/modules/oauth/oauth.service.ts - OAuth sign-in → Session management: creates session
backend/src/modules/oauth/oauth.service.ts - Image handling → Object storage: stores images
- Object storage → PostgreSQL: stores metadata
- Notifications → Background jobs: schedules delivery
- Background jobs → Email delivery: dispatches email
- Email delivery → SMTP service: sends mail
- Shared schemas → Task views: validates data