# AI InterviewMentor — Hackathon Task Breakdown

## Phase 1: Project Scaffolding

- [ ] Initialize frontend (Vite + React + TypeScript)
- [ ] Install frontend deps (tailwindcss, react-router-dom, zustand)
- [ ] Configure Tailwind with dark theme
- [ ] Initialize backend (FastAPI project structure)
- [ ] Install backend deps (requirements.txt)
- [ ] Create `.env.example` with all required variables
- [ ] Create Dockerfile (multi-stage: Node build + Python runtime)
- [ ] Set up NeonDB and run schema migrations

## Phase 2: Auth System

- [ ] `backend/auth/password.py` — bcrypt hash + verify
- [ ] `backend/auth/jwt.py` — sign + verify access/refresh tokens
- [ ] `backend/db/connection.py` — NeonDB async pool (asyncpg)
- [ ] `backend/db/queries.py` — user CRUD + refresh token queries
- [ ] `backend/routers/auth.py` — signup, login, refresh, logout endpoints
- [ ] `backend/main.py` — FastAPI app with lifespan, router registration
- [ ] `frontend/src/store/authStore.ts` — Zustand auth store
- [ ] `frontend/src/api/auth.ts` — login, signup, refresh, logout API calls
- [ ] `frontend/src/api/client.ts` — base fetch wrapper with auto-refresh
- [ ] `frontend/src/pages/Login.tsx`
- [ ] `frontend/src/pages/Signup.tsx` — with role selector + class code input
- [ ] `frontend/src/components/shared/ProtectedRoute.tsx`
- [ ] `frontend/src/components/shared/Navbar.tsx`
- [ ] `frontend/src/App.tsx` — React Router setup

## Phase 3: Instructor — Batch & Topic Management

- [ ] `backend/routers/batches.py` — create batch, get batch with class code
- [ ] `backend/routers/topics.py` — add topic, list topics, unlock/lock topic
- [ ] `frontend/src/pages/InstructorDashboard.tsx` — batch info, class code display, topic list
- [ ] `frontend/src/components/instructor/StatCard.tsx`
- [ ] `frontend/src/api/topics.ts`

## Phase 4: Question Bank Upload

- [ ] `backend/routers/upload.py` — parse CSV, validate, insert questions into DB
- [ ] `frontend/src/pages/Upload.tsx` — CSV upload page
- [ ] `frontend/src/components/instructor/UploadZone.tsx` — drag-and-drop CSV zone
- [ ] `frontend/src/api/upload.ts`

## Phase 5: LangGraph Interview Engine

- [ ] `backend/graph/state.py` — InterviewState TypedDict
- [ ] `backend/prompts.py` — all prompt builders (ask, evaluate, counter, summarize, report)
- [ ] `backend/graph/nodes.py` — ask_question, evaluate_answer, counter_question, summarize, generate_report
- [ ] `backend/graph/graph.py` — graph builder, conditional edges, compile
- [ ] `backend/checkpointer.py` — AsyncPostgresSaver setup
- [ ] `backend/routers/interview.py` — /interview/start, /interview/turn, /interview/state

## Phase 6: Student Interview UI

- [ ] `frontend/src/store/interviewStore.ts` — Zustand interview store
- [ ] `frontend/src/api/interview.ts` — start, turn, state API calls
- [ ] `frontend/src/pages/Interview.tsx` — interview chat page
- [ ] `frontend/src/components/interview/ChatWindow.tsx`
- [ ] `frontend/src/components/interview/MessageBubble.tsx`
- [ ] `frontend/src/components/interview/TypeInput.tsx`
- [ ] `frontend/src/components/interview/ProgressBar.tsx`

## Phase 7: Reports & Feedback

- [ ] `backend/routers/sessions.py` — get session detail + feedback
- [ ] `frontend/src/api/sessions.ts`
- [ ] `frontend/src/pages/Report.tsx` — score display + feedback breakdown
- [ ] `frontend/src/components/report/ScoreRing.tsx`
- [ ] `frontend/src/components/report/FeedbackCard.tsx`
- [ ] `frontend/src/components/report/SummaryBlock.tsx`

## Phase 8: Student Dashboard

- [ ] `frontend/src/pages/StudentDashboard.tsx` — unlocked topics + past attempts
- [ ] `frontend/src/components/student/TopicChip.tsx`
- [ ] `frontend/src/components/student/AttemptRow.tsx`
- [ ] `frontend/src/api/topics.ts` — student topic list endpoint

## Phase 9: Instructor Analytics

- [ ] `backend/routers/instructor.py` — dashboard stats, student detail endpoints
- [ ] `frontend/src/pages/InstructorDashboard.tsx` — class stats + student score table
- [ ] `frontend/src/pages/StudentDetail.tsx` — per-student attempt history
- [ ] `frontend/src/components/instructor/StudentRow.tsx`
- [ ] `frontend/src/components/instructor/GapReport.tsx`

## Phase 10: Integration & Deployment

- [ ] Wire all frontend routes in App.tsx
- [ ] Static file mount in FastAPI (must be last)
- [ ] Test Docker build locally
- [ ] Deploy to Hugging Face Spaces
- [ ] End-to-end test: signup → create batch → upload CSV → student joins → interview → report
- [ ] Verify session recovery (tab close + reopen)

---

## Priority Order

If time is tight, ship in this order:
1. **Auth + scaffolding** (Phases 1-2) — foundation
2. **Instructor batch/topic/upload** (Phases 3-4) — data entry
3. **LangGraph engine + interview UI** (Phases 5-6) — core product
4. **Reports** (Phase 7) — completes the student flow
5. **Dashboards** (Phases 8-9) — analytics layer
6. **Deploy** (Phase 10) — ship it