Spaces:
Sleeping
Sleeping
| # 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 | |