Project 16 of ~34

🤝 First Gen Navigator — Architecture

College access service for first-gen students. SvelteKit + Deno + Supabase + Ollama (Mac Mini) for essay coaching + PDF parsing.

🛠️ Tech Stack

ComponentTechnologyWhy
Student UITelegram Bot + SMSText-first, no app install needed. Students already on Telegram.
Counselor UISvelteKit dashboardTrack student progress, manage cohorts, view outcomes
BackendDeno 2Aid letter parser, essay coach agent, scholarship matcher
DatabaseSupabase (PostgreSQL)Students, sessions, scholarship database, essay drafts
AIOllama (Mac Mini)Essay coaching, financial aid explanation, guide generation
PDF ParsingPdfParse + custom parserAid letter parsing, text extraction from scanned PDFs
PaymentsStripe (Outgrow alternative)District invoicing, sliding scale payments

🗄️ Data Model

students
iduuid
namevarchar(255)
phonevarchar(20)Telegram + SMS
household_incomeintegerFor sliding scale
intended_majorvarchar(100)
hs_namevarchar(255)
cohortuuid (FK)District/group
statusenumaid_letter, essay, scholarship, decision, enrolled
scholarships
iduuid
namevarchar(255)
amountinteger
requirements_jsonjsonbGPA, demographics, major, income
deadlinedate
urlvarchar(500)
sourcevarchar(100)national, state, local, school
essay_sessions
iduuid
student_iduuid (FK)
intake_jsonjsonbAnswers from intake interview
drafts_jsonjsonb[]Generated drafts
final_drafttextStudent's final version
statusenumintake, drafting, revision, final

🤖 AI Pipeline

Aid Letter Decoder
PDF parsed → structured data (COA, EFC, awards). Ollama generates plain-English explanation: "Your actual cost is $X, not $Y. Here's what to do next."
Essay Coaching
Structured intake interview via Telegram → Ollama generates 3-5 essay variations in different narrative styles. Student reviews, requests revisions, finalizes.
Scholarship Matching
Student profile (GPA, income, major, demographics) → match against scholarship DB → ranked list with deadline reminders.
Freshman Year Guide
College name + student major → Ollama generates personalized guide from web research + institutional knowledge.

Requirements  |  All Projects  |  Presentation →