chore: add install, schema, clean-db make commands

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Makefile

@@ -1,4 +1,10 @@
-.PHONY: dev frontend test build docker-run
+.PHONY: dev frontend test build docker-run schema clean-db install
+
+# ── Local dev ────────────────────────────────────────────────────────────────
+
+install:
+	uv sync
+	cd frontend && npm install
 
 dev:
 	uv run uvicorn backend.main:app --reload --port 7860
@@ -6,6 +12,17 @@ dev:
 frontend:
 	cd frontend && npm run dev
 
+# ── Database ─────────────────────────────────────────────────────────────────
+
+schema:
+	uv run python backend/db/apply_schema.py
+
+clean-db:
+	uv run python backend/db/clean_db.py
+	uv run python backend/db/apply_schema.py
+
+# ── Tests & build ────────────────────────────────────────────────────────────
+
 test:
 	uv run pytest tests/ -v
 
@@ -13,5 +30,7 @@ build:
 	cd frontend && npm run build
 	docker build -t ai-interviewmentor .
 
+# ── Docker ───────────────────────────────────────────────────────────────────
+
 docker-run:
 	docker run --name ai-interviewmentor --env-file .env -p 7860:7860 --rm ai-interviewmentor

README.md

@@ -56,27 +56,21 @@ Set these as secrets in HF Spaces → Settings → Variables and secrets:
 ## Local Development
 
 ```bash
-# Install backend deps
-uv sync
-
-# Apply DB schema (first time only)
-uv run python backend/db/apply_schema.py
-
-# Start backend (port 7860)
-uv run uvicorn backend.main:app --host 0.0.0.0 --port 7860 --reload
-
-# Start frontend dev server (port 5173, proxies /api and /interview to :7860)
-cd frontend && npm install && npm run dev
+make install      # install all backend + frontend deps
+make schema       # apply DB schema (run once on fresh DB)
+make dev          # start backend on :7860 with auto-reload
+make frontend     # start frontend dev server on :5173
+make test         # run pytest suite
 ```
 
 ## Docker
 
 ```bash
-# Build and run locally
-make build
-make docker-run
+make build        # build frontend + Docker image
+make docker-run   # run container with .env on localhost:7860
 
-# Reset all data (wipes DB + LangGraph checkpoints)
-uv run python backend/db/clean_db.py
-uv run python backend/db/apply_schema.py
+# Reset DB and re-apply schema (wipes all data + checkpoints)
+make clean-db
 ```
+
+> **CSV upload** — use the Instructor portal → Upload page. Format: `question_text,difficulty` (difficulty: easy / medium / hard). A sample file is at `docs/question_bank/linear_regression.csv`.