How ronbell1/airesume works
Project type and purpose
• This is a full-stack AI-powered web application (“AI Resume Builder & ATS Checker”).
• Frontend: Next.js (App Router, TypeScript, Tailwind CSS)
• Backend API: Python FastAPI microservice (AI engine & resume analysis)
• Database: PostgreSQL via Prisma ORM
• Authentication/session management via Auth.js (or Supabase) and Next.js API routes
File structure
• app/: Next.js App Router pages (“page.tsx”, “layout.tsx”), client/server components, built-in API routes under app/api/ (auth & resume endpoints)
• components/ & components/ui/: Reusable UI primitives (buttons, dialogs, toggles, forms, etc.)
• hooks/: Custom React hooks for mobile detection and toast notifications
• lib/: Shared client/server modules (auth-client, auth-schema, prisma client, resume helpers, session utils)
• prisma/: Database schema and migrations for Users, Resumes, etc.
• public/ & styles/: Static assets & global CSS
• Root config: next.config.mjs, tsconfig.json, tailwind.config.ts, package.json
README
• Confirms split between Next.js frontend (port 3000) and FastAPI backend (port 8000)
• AI model served via FastAPI
• Usage patterns: resume build pages, upload/analysis endpoints, real-time preview, user auth
• Frontend (Next.js App)
• API Layer (Next.js API Routes for auth & basic resume CRUD)
• AI Service (Python FastAPI microservice running AI/ML resume analyzer)
• Database (PostgreSQL via Prisma)
• Authentication Provider (Auth.js or Supabase)
• Static Asset store / CDN (public folder or S3)
1. User Browser → Next.js Frontend (React pages/components)
2. Frontend → Next.js API Routes (POST /api/auth, /api/resume) → Database (store user accounts, resume drafts)
3. Frontend → FastAPI Service (HTTP calls to /analyze) → AI Model → FastAPI → JSON response → Frontend
4. Next.js API Routes ↔ Auth Provider (OAuth/JWT session management)
5. Frontend ↔ Static Asset store (avatars, downloads, PDF previews)
c. Architectural patterns & design principles:
• App Router (Next.js) separating client & server components
• “API Gateway” – Next.js API for user-facing endpoints, delegating AI work to FastAPI
• Prism a ORM for type-safe DB access
• Component-based UI with a design system in components/ui/
• Separation of concerns: UI, business logic (lib/ and hooks/), data layer (API + DB), and ML service
d. Key technologies & frameworks:
• React & Next.js (App Directory)
• TypeScript & Tailwind CSS
• Python FastAPI + custom NLP/ML model
• Prisma ORM & PostgreSQL
• Auth.js (or Supabase) for authentication
• Vercel (or Docker/Kubernetes) for deployment