feat: backend scaffold — FastAPI, models, Dockerfile, health endpoint

Dockerfile

@@ -0,0 +1,12 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY app/ ./app/
+
+EXPOSE 7860
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860"]

app/main.py

@@ -0,0 +1,20 @@
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+app = FastAPI(title="Bored CV API", version="0.1.0")
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=[
+        "http://localhost:5173",
+        "https://*.github.io",
+    ],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+@app.get("/api/health")
+async def health():
+    return {"status": "ok"}

app/models.py

@@ -0,0 +1,99 @@
+from pydantic import BaseModel, Field
+
+
+class Experience(BaseModel):
+    title: str
+    company: str
+    dates: str
+    description: str
+    bullets: list[str] = []
+
+
+class Education(BaseModel):
+    degree: str
+    school: str
+    year: str
+
+
+class Profile(BaseModel):
+    name: str
+    title: str
+    location: str = ""
+    email: str = ""
+    summary: str = ""
+    experiences: list[Experience] = []
+    education: list[Education] = []
+    skills: list[str] = []
+
+
+class OfferRequirement(BaseModel):
+    text: str
+    category: str = ""
+
+
+class Offer(BaseModel):
+    title: str
+    company: str
+    location: str = ""
+    description: str
+    requirements: list[OfferRequirement] = []
+    nice_to_have: list[OfferRequirement] = []
+
+
+class GapAnalysis(BaseModel):
+    matched_skills: list[str] = []
+    gaps: list[str] = []
+    questions: list[str] = []
+
+
+class ChatMessage(BaseModel):
+    role: str
+    content: str
+
+
+class ChatRequest(BaseModel):
+    profile: Profile
+    offer: Offer
+    gap_analysis: GapAnalysis
+    messages: list[ChatMessage] = []
+
+
+class ChatResponse(BaseModel):
+    message: str
+    is_complete: bool = False
+
+
+class RewrittenExperience(BaseModel):
+    title: str
+    company: str
+    dates: str
+    bullets: list[str]
+
+
+class CVData(BaseModel):
+    name: str
+    title: str
+    email: str = ""
+    location: str = ""
+    summary: str
+    experiences: list[RewrittenExperience]
+    education: list[Education]
+    skills: list[str]
+    language: str = "en"
+
+
+class GenerateRequest(BaseModel):
+    profile: Profile
+    offer: Offer
+    gap_analysis: GapAnalysis
+    messages: list[ChatMessage]
+
+
+class OfferScrapeRequest(BaseModel):
+    url: str = ""
+    raw_text: str = ""
+
+
+class AnalyzeRequest(BaseModel):
+    profile: Profile
+    offer: Offer

requirements.txt

@@ -0,0 +1,14 @@
+fastapi==0.115.6
+uvicorn[standard]==0.34.0
+python-multipart==0.0.19
+pdfplumber==0.11.4
+beautifulsoup4==4.12.3
+httpx==0.28.1
+google-generativeai==0.8.4
+slowapi==0.1.9
+authlib==1.4.1
+itsdangerous==2.2.0
+pytest==8.3.4
+pytest-asyncio==0.24.0
+httpx[http2]==0.28.1
+reportlab==4.2.5

tests/test_api.py

@@ -0,0 +1,11 @@
+import pytest
+from fastapi.testclient import TestClient
+from app.main import app
+
+client = TestClient(app)
+
+
+def test_health():
+    response = client.get("/api/health")
+    assert response.status_code == 200
+    assert response.json() == {"status": "ok"}