feat: upgrade to full-stack deployment (React + FastAPI)

.dockerignore

@@ -0,0 +1,28 @@
+# Exclude version control
+.git
+.gitignore
+
+# Exclude local dependencies
+node_modules/
+web/node_modules/
+__pycache__/
+*.pyc
+
+# Exclude data (will be downloaded or mounted)
+data/
+!data/.gitkeep
+
+# Exclude local environment
+.env
+.venv
+venv/
+
+# Exclude VSCode
+.vscode/
+
+# Exclude existing builds
+web/dist/
+build/
+dist/
+eggs/
+.eggs/

Dockerfile

@@ -1,3 +1,13 @@
+# --- Stage 1: Build Frontend ---
+FROM node:18-alpine as frontend-builder
+
+WORKDIR /app/web
+COPY web/package*.json ./
+RUN npm ci
+COPY web/ .
+RUN npm run build
+
+# --- Stage 2: Final Backend Image ---
 FROM python:3.10-slim
 
 WORKDIR /app
@@ -12,14 +22,17 @@ COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt
 RUN pip install "uvicorn[standard]"
 
-# Copy application code
+# Copy backend code
 COPY . .
 
+# Copy built frontend assets from Stage 1
+# We allow the copy to fail if web dir isn't perfect, but here we expect success
+COPY --from=frontend-builder /app/web/dist /app/web/dist
+
 # Create a non-root user (Standard for HF Spaces)
 RUN useradd -m -u 1000 user
 
 # Create data directory and set permissions
-# This ensures local fallback works and persistent storage mountpoint is accessible
 RUN mkdir -p /app/data && chown -R user:user /app
 
 # Switch to non-root user

src/main.py

@@ -37,8 +37,33 @@ app = FastAPI(
 # Include Routers
 app.include_router(chat_router)
 
-# 挂载静态目录，确保前端能访问 /assets/cover-not-found.jpg
-app.mount("/assets", StaticFiles(directory="assets"), name="assets")
+# --- Frontend Serving (SPA) ---
+import os
+from fastapi.responses import FileResponse
+
+# 1. Mount React Assets (JS/CSS)
+if os.path.exists("web/dist/assets"):
+    app.mount("/assets", StaticFiles(directory="web/dist/assets"), name="assets")
+
+# 2. Mount Local Content Assets (Book Covers)
+app.mount("/content", StaticFiles(directory="assets"), name="content")
+
+# 3. Serve React App (Catch-All for Client-Side Routing)
+@app.get("/{full_path:path}")
+async def serve_react_app(full_path: str):
+    # API requests pass through (FastAPI matches specific routes first)
+    if full_path.startswith("api") or full_path.startswith("docs") or full_path.startswith("openapi"):
+        raise HTTPException(status_code=404, detail="Not Found")
+        
+    # Serve index.html for all other routes (SPA)
+    if os.path.exists("web/dist/index.html"):
+        return FileResponse("web/dist/index.html")
+    
+    # Fallback if frontend isn't built
+    return {
+        "message": "Backend is running. Frontend not found (did you run npm build?)",
+        "docs_url": "/docs"
+    }