Skip to content
PinTeach Docs

Task Registry

All tasks are complete. 60 tables, 53 enums, 78 migrations.

Phase 0: Foundation

Section titled “Phase 0: Foundation”
TaskTypeDescription
T-001InfraTurborepo + Bun monorepo (5 packages)
T-002InfraDocker Compose (PostgreSQL 5433, Redis 6379)
T-003InfraDrizzle ORM + migration system
T-004BackendCore schema (teachers, students, auth_sessions)
T-005InfraShared package (Zod schemas + types)
T-006BackendFastify 5 setup (CORS, cookies, auth, rate limiting)
T-007FrontendReact 19 + Vite 6 + TanStack Router + shadcn/ui
T-008BackendDevelopment seed data

Phase 1: Auth & Onboarding

Section titled “Phase 1: Auth & Onboarding”
TaskTypeDescription
T-101IntegrationGoogle OAuth for teachers
T-102BackendTeacher onboarding API
T-103FrontendDashboard layout + collapsible sidebar
T-104Frontend4-step onboarding wizard
T-105IntegrationGoogle Calendar connection

Phase 2: Scheduling & Booking

Section titled “Phase 2: Scheduling & Booking”
TaskTypeDescription
T-201BackendAvailability system (schedules, rules, overrides, activations)
T-202BackendUnified service model (3 dimensions)
T-203BackendSlot engine (10-step algorithm)
T-204FrontendPublic booking page
T-205BackendTrial booking (free + paid)
T-206FrontendTeacher trial management
T-207FrontendCalendar view (week + agenda)
T-208IntegrationTrial notification emails

Phase 3: Payments & Enrollment

Section titled “Phase 3: Payments & Enrollment”
TaskTypeDescription
T-301IntegrationStripe Connect setup
T-302BackendStripe webhooks (idempotent)
T-303IntegrationPaid trial flow
T-304BackendEnrollment system with session accounting
T-305BackendCredit system (immutable ledger + idempotency)
T-306BackendStudent magic link auth
T-307FrontendStudent portal
T-308IntegrationPurchase + booking email templates

Phase 4: Policy & Legal

Section titled “Phase 4: Policy & Legal”
TaskTypeDescription
T-401BackendCancellation policy engine (per-service rules)
T-402BackendLegal documents (versioned, acceptance)
T-403BackendAuto-complete system (BullMQ)
T-404FrontendTeacher settings pages

Phase 5: Student Management & CRM

Section titled “Phase 5: Student Management & CRM”
TaskTypeDescription
T-501Full StackStudent CRUD + lifecycle tracking
T-502Full StackContact log (WhatsApp/email/phone)
T-503BackendStudent lifecycle events (14 types)
T-504BackendLifecycle detection worker (daily cron)
T-505Full StackRetention metrics + insights
T-506Full StackStudent preferred hours

Phase 6: Resource Library & Materials

Section titled “Phase 6: Resource Library & Materials”
TaskTypeDescription
T-601BackendMaterial folders (hierarchical, cascade soft-delete)
T-602Full StackLesson templates
T-603Full StackResource library
T-604IntegrationGoogle Drive integration + auto-copy
T-605FrontendMaterials browser (list/grid/kanban)
T-606Full StackTags & categories
T-607BackendContent analytics

Phase 7: Review System

Section titled “Phase 7: Review System”
TaskTypeDescription
T-701BackendReviews (rating, source, status, import)
T-702BackendReview requests (in_app/email/link)
T-703BackendReview settings (auto-request, auto-approve)
T-704FrontendTeacher reviews page (5 tabs)
T-705FrontendPublic reviews section
T-706FrontendStudent review form

Phase 8: Widgets & Public Presence

Section titled “Phase 8: Widgets & Public Presence”
TaskTypeDescription
T-801Full StackWidget system (booking/storefront/reviews)
T-802FrontendReviews widget (4 layouts)
T-803FrontendPublic teacher profile + layout editor
T-804BackendProfile analytics

Phase 9: Audit & GDPR

Section titled “Phase 9: Audit & GDPR”
TaskTypeDescription
T-901BackendAudit log (append-only, fire-and-forget)
T-902BackendAudit cleanup worker (monthly)
T-903BackendGDPR data export (14 tables)
T-904BackendGDPR data erasure (anonymize + delete)
T-905BackendErasure requests (30-day due date)
T-906BackendData retention (weekly cron)
T-907Full StackPrivacy routes + UI

Phase 10: Resilience & Performance

Section titled “Phase 10: Resilience & Performance”
TaskTypeDescription
T-1001BackendCircuit breaker (Redis-backed)
T-1002BackendRate limiter (sliding-window)
T-1003BackendCalendar sync worker (5 min cron)
T-1004FrontendOptimistic updates (11 hooks)
T-1005FrontendKeyboard shortcuts + command palette

Phase 11: Waitlist & Overflow

Section titled “Phase 11: Waitlist & Overflow”
TaskTypeDescription
T-1101Full StackWaitlist system (auto-notify, 48h offers)

Phase 12: Session Architecture

Section titled “Phase 12: Session Architecture”
TaskTypeDescription
T-1201BackendSession satellites (3 tables)
T-1202BackendGroup sessions (participants junction)
T-1203BackendCourses (schedule items + progress)

Phase 13: OAuth & Integration Refactor

Section titled “Phase 13: OAuth & Integration Refactor”
TaskTypeDescription
T-1301BackendProvider-agnostic OAuth
T-1302BackendSoft-delete pattern (7 tables)

Background Jobs Summary (11 workers)

Section titled “Background Jobs Summary (11 workers)”
#WorkerSchedulePurpose
1auto-completePer sessionComplete after end + grace
2calendar-sync5 min cronRetry pending syncs
3drive-copyOn demandCopy Drive files
4drive-sync3 AM dailyVerify file integrity
5lifecycle-detection6 AM dailyDetect gaps, churn, streaks
6content-analyticsPeriodicAggregate usage metrics
7audit-cleanup1st of monthClean old logs
8data-retentionSunday 3 AMGDPR enforcement
9waitlist-expiryHourlyExpire stale offers
10metric-alertsPeriodicCheck metric alert thresholds
11scheduled-messagesDelayed jobsContact reminders for teachers