Spaces:

Soumsa
/

geminiguard-support-backend

Running

App Files Files Community

Soumsa commited on Oct 13, 2025

Commit

af57694

verified ·

1 Parent(s): fc00e47

Project Goal:

Browse files

Build a production-ready backend for an AI Customer Support Bot that connects to a Next.js 15 frontend (already deployed on Vercel).

Framework & Language:

Python 3.11

FastAPI (async)

Core Features:

/chat/stream (WebSocket)

Accepts incoming JSON messages { "type": "user_message", "content": "..." }

Streams responses in JSON { "type": "assistant_chunk", "chunk": "..." }

Sends { "type": "assistant_done", "content": "..." } when complete.

Uses Gemini API for LLM responses (google.generativeai package).

Uses FAISS for retrieval (RAG pipeline).

Stores session state in Redis.

/faq/upload

Accepts multipart/form-data with file.

Parses .csv or .md files.

Generates embeddings with Gemini embeddings API.

Stores vectors in FAISS.

/escalate

Creates a ticket record in PostgreSQL.

Sends email via SendGrid if configured.

/escalate/list

Returns list of open/closed escalations from Postgres.

/health

Returns { "ok": true }.

Environment Variables:

GEMINI_API_KEY=your_gemini_key
REDIS_URL=redis://default:password@localhost:6379
POSTGRES_URL=postgresql://user:password@localhost:5432/supportdb
SENDGRID_KEY=your_sendgrid_key
CORS_ORIGINS=https://ai-customer-support-bot.vercel.app,http://localhost:3000

Other Requirements:

Include Dockerfile and requirements.txt.

Use uvicorn main:app --host 0.0.0.0 --port 8000 as default CMD.

Return complete folder structure:

backend/
main.py
routes/
services/
models/
database/
requirements.txt
Dockerfile

Add comments explaining where Gemini calls and FAISS indexing happen.

Must deploy cleanly to Railway using requirements.txt.

Expected Output:
Ready-to-run backend folder named backend/ compatible with frontend endpoints /chat/stream, /faq/upload, /escalate, and /escalate/list.

Files changed (3) hide show

README.md +8 -5
backend-structure.html +283 -0
index.html +189 -18

README.md CHANGED Viewed

@@ -1,10 +1,13 @@
 ---
-title: Geminiguard Support Backend
-emoji: ⚡
-colorFrom: red
-colorTo: pink
 sdk: static
 pinned: false
 ---
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

 ---
+title: GeminiGuard Support Backend 🚀
+colorFrom: pink
+colorTo: yellow
+emoji: 🐳
 sdk: static
 pinned: false
+tags:
+  - deepsite-v3
 ---
+# Welcome to your new DeepSite project!
+This project was created with [DeepSite](https://deepsite.hf.co).

backend-structure.html ADDED Viewed

	@@ -0,0 +1,283 @@

+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Backend Structure | GeminiGuard</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <script src="https://cdn.jsdelivr.net/npm/feather-icons/dist/feather.min.js"></script>
+    <style>
+        .tree-node {
+            position: relative;
+            padding-left: 1.5rem;
+        }
+        .tree-node::before {
+            content: "";
+            position: absolute;
+            left: 0.5rem;
+            top: 0;
+            bottom: 0;
+            width: 2px;
+            background-color: #E5E7EB;
+        }
+        .tree-item::before {
+            content: "";
+            position: absolute;
+            left: 0.25rem;
+            top: 0.75rem;
+            width: 0.5rem;
+            height: 0.5rem;
+            border-radius: 50%;
+            background-color: #3B82F6;
+        }
+        .animate-float {
+            animation: float 3s ease-in-out infinite;
+        }
+        @keyframes float {
+            0%, 100% { transform: translateY(0); }
+            50% { transform: translateY(-10px); }
+        }
+    </style>
+</head>
+<body class="bg-gray-50">
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12">
+        <div class="text-center mb-12">
+            <h1 class="text-4xl font-bold text-gray-900 mb-4">GeminiGuard Backend Architecture</h1>
+            <p class="text-xl text-gray-600 max-w-3xl mx-auto">Production-ready Python 3.11 + FastAPI structure with Redis, PostgreSQL and FAISS integration</p>
+        </div>
+        <div class="grid grid-cols-1 lg:grid-cols-3 gap-8 mb-12">
+            <!-- File Tree -->
+            <div class="bg-white rounded-xl shadow-md overflow-hidden lg:col-span-1">
+                <div class="p-6 border-b border-gray-200">
+                    <h2 class="text-xl font-semibold text-gray-800">Directory Structure</h2>
+                </div>
+                <div class="p-6">
+                    <div class="space-y-1 font-mono text-sm">
+                        <div class="tree-node">
+                            <div class="tree-item relative pl-4 py-1 text-blue-600 font-bold">backend/</div>
+                            <div class="tree-node">
+                                <div class="tree-item relative pl-4 py-1">main.py</div>
+                                <div class="tree-item relative pl-4 py-1">routes/</div>
+                                <div class="tree-node">
+                                    <div class="tree-item relative pl-4 py-1">chat.py</div>
+                                    <div class="tree-item relative pl-4 py-1">faq.py</div>
+                                    <div class="tree-item relative pl-4 py-1">escalate.py</div>
+                                </div>
+                                <div class="tree-item relative pl-4 py-1">services/</div>
+                                <div class="tree-node">
+                                    <div class="tree-item relative pl-4 py-1">gemini_service.py</div>
+                                    <div class="tree-item relative pl-4 py-1">faiss_service.py</div>
+                                    <div class="tree-item relative pl-4 py-1">redis_service.py</div>
+                                </div>
+                                <div class="tree-item relative pl-4 py-1">models/</div>
+                                <div class="tree-node">
+                                    <div class="tree-item relative pl-4 py-1">chat_models.py</div>
+                                    <div class="tree-item relative pl-4 py-1">escalation_models.py</div>
+                                </div>
+                                <div class="tree-item relative pl-4 py-1">database/</div>
+                                <div class="tree-node">
+                                    <div class="tree-item relative pl-4 py-1">postgres.py</div>
+                                    <div class="tree-item relative pl-4 py-1">redis.py</div>
+                                </div>
+                                <div class="tree-item relative pl-4 py-1">requirements.txt</div>
+                                <div class="tree-item relative pl-4 py-1">Dockerfile</div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            <!-- Key Components -->
+            <div class="lg:col-span-2">
+                <div class="bg-white rounded-xl shadow-md overflow-hidden mb-6">
+                    <div class="p-6 border-b border-gray-200">
+                        <h2 class="text-xl font-semibold text-gray-800">Core Components</h2>
+                    </div>
+                    <div class="p-6">
+                        <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
+                            <!-- Gemini Service -->
+                            <div class="bg-blue-50 rounded-lg p-4">
+                                <div class="flex items-center mb-3">
+                                    <div class="bg-blue-100 p-2 rounded-full mr-3">
+                                        <i data-feather="cpu" class="text-blue-600"></i>
+                                    </div>
+                                    <h3 class="font-semibold text-gray-800">Gemini Service</h3>
+                                </div>
+                                <p class="text-sm text-gray-600 mb-2">Handles all Gemini API interactions:</p>
+                                <ul class="text-xs text-gray-700 space-y-1">
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>Streaming chat completions</span>
+                                    </li>
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>Embedding generation</span>
+                                    </li>
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>Token counting and rate limiting</span>
+                                    </li>
+                                </ul>
+                            </div>
+                            <!-- FAISS Service -->
+                            <div class="bg-green-50 rounded-lg p-4">
+                                <div class="flex items-center mb-3">
+                                    <div class="bg-green-100 p-2 rounded-full mr-3">
+                                        <i data-feather="database" class="text-green-600"></i>
+                                    </div>
+                                    <h3 class="font-semibold text-gray-800">FAISS Service</h3>
+                                </div>
+                                <p class="text-sm text-gray-600 mb-2">Manages vector operations:</p>
+                                <ul class="text-xs text-gray-700 space-y-1">
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>Index creation from FAQs</span>
+                                    </li>
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>Nearest neighbor search</span>
+                                    </li>
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>Index persistence to disk</span>
+                                    </li>
+                                </ul>
+                            </div>
+                            <!-- Redis Service -->
+                            <div class="bg-red-50 rounded-lg p-4">
+                                <div class="flex items-center mb-3">
+                                    <div class="bg-red-100 p-2 rounded-full mr-3">
+                                        <i data-feather="hard-drive" class="text-red-600"></i>
+                                    </div>
+                                    <h3 class="font-semibold text-gray-800">Redis Service</h3>
+                                </div>
+                                <p class="text-sm text-gray-600 mb-2">Session state management:</p>
+                                <ul class="text-xs text-gray-700 space-y-1">
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>WebSocket session storage</span>
+                                    </li>
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>Rate limiting counters</span>
+                                    </li>
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>Cache for frequent queries</span>
+                                    </li>
+                                </ul>
+                            </div>
+                            <!-- PostgreSQL Service -->
+                            <div class="bg-purple-50 rounded-lg p-4">
+                                <div class="flex items-center mb-3">
+                                    <div class="bg-purple-100 p-2 rounded-full mr-3">
+                                        <i data-feather="archive" class="text-purple-600"></i>
+                                    </div>
+                                    <h3 class="font-semibold text-gray-800">PostgreSQL Service</h3>
+                                </div>
+                                <p class="text-sm text-gray-600 mb-2">Ticket persistence:</p>
+                                <ul class="text-xs text-gray-700 space-y-1">
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>Escalation ticket storage</span>
+                                    </li>
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>Status tracking</span>
+                                    </li>
+                                    <li class="flex items-start">
+                                        <i data-feather="check" class="w-4 h-4 mr-2 text-green-500 mt-0.5"></i>
+                                        <span>Audit logging</span>
+                                    </li>
+                                </ul>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                <!-- Code Samples -->
+                <div class="bg-white rounded-xl shadow-md overflow-hidden">
+                    <div class="p-6 border-b border-gray-200">
+                        <h2 class="text-xl font-semibold text-gray-800">Code Highlights</h2>
+                    </div>
+                    <div class="p-6">
+                        <div class="mb-6">
+                            <h3 class="font-medium text-gray-800 mb-2">WebSocket Chat Endpoint (routes/chat.py)</h3>
+                            <div class="bg-gray-900 rounded-lg p-4 text-xs text-gray-300 overflow-x-auto">
+                                <pre><code>@router.websocket("/chat/stream")
+async def websocket_chat(websocket: WebSocket):
+    await websocket.accept()
+    session_id = str(uuid.uuid4())
+    try:
+        while True:
+            data = await websocket.receive_json()
+            if data["type"] == "user_message":
+                # Generate stream from Gemini with RAG context
+                async for chunk in gemini_service.stream_response(
+                    message=data["content"],
+                    session_id=session_id
+                ):
+                    await websocket.send_json({
+                        "type": "assistant_chunk",
+                        "chunk": chunk
+                    })
+                await websocket.send_json({
+                    "type": "assistant_done",
+                    "content": "Stream complete"
+                })
+    except WebSocketDisconnect:
+        await redis_service.clear_session(session_id)</code></pre>
+                            </div>
+                        </div>
+                        <div>
+                            <h3 class="font-medium text-gray-800 mb-2">FAISS Index Creation (services/faiss_service.py)</h3>
+                            <div class="bg-gray-900 rounded-lg p-4 text-xs text-gray-300 overflow-x-auto">
+                                <pre><code>async def create_index_from_documents(docs: List[str]):
+    # Generate embeddings using Gemini
+    embeddings = await gemini_service.generate_embeddings(docs)
+    # Convert to numpy array
+    vectors = np.array(embeddings).astype('float32')
+    # Create FAISS index
+    dimension = vectors.shape[1]
+    index = faiss.IndexFlatL2(dimension)
+    index.add(vectors)
+    # Save index to disk
+    faiss.write_index(index, "faiss_index.index")
+    # Store document metadata in Redis
+    await redis_service.store_documents(
+        [{"id": str(uuid.uuid4()), "text": doc} for doc in docs]
+    )</code></pre>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+        <div class="bg-blue-50 rounded-xl p-6 text-center">
+            <h3 class="text-2xl font-bold text-gray-800 mb-4">Ready to Implement?</h3>
+            <p class="text-gray-600 mb-6">This architecture is optimized for high-performance AI support with minimal latency.</p>
+            <button class="inline-flex items-center px-6 py-3 bg-blue-600 text-white rounded-lg font-semibold hover:bg-blue-700 transition">
+                <i data-feather="download" class="w-5 h-5 mr-2"></i>
+                Download Complete Backend
+            </button>
+        </div>
+    </div>
+    <script>
+        feather.replace();
+    </script>
+</body>
+</html>

index.html CHANGED Viewed

@@ -1,19 +1,190 @@
-<!doctype html>
-<html>
-	<head>
-		<meta charset="utf-8" />
-		<meta name="viewport" content="width=device-width" />
-		<title>My static Space</title>
-		<link rel="stylesheet" href="style.css" />
-	</head>
-	<body>
-		<div class="card">
-			<h1>Welcome to your static Space!</h1>
-			<p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
-			<p>
-				Also don't forget to check the
-				<a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
-			</p>
-		</div>
-	</body>
 </html>

+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>GeminiGuard Backend Docs</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <style>
+        .gradient-bg {
+            background: linear-gradient(135deg, #6B73FF 0%, #000DFF 100%);
+        }
+        .code-block {
+            font-family: 'Courier New', monospace;
+            background-color: #1E293B;
+            border-radius: 0.5rem;
+        }
+        .endpoint-card:hover {
+            transform: translateY(-5px);
+            box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.1);
+        }
+    </style>
+</head>
+<body class="bg-gray-100">
+    <div class="gradient-bg text-white py-16 px-4 sm:px-6 lg:px-8">
+        <div class="max-w-7xl mx-auto text-center">
+            <h1 class="text-4xl md:text-5xl font-bold mb-6">GeminiGuard Support Backend</h1>
+            <p class="text-xl md:text-2xl mb-8">Powering AI customer support with Gemini, FastAPI & Redis</p>
+            <div class="flex justify-center space-x-4">
+                <a href="#endpoints" class="px-6 py-3 bg-white text-blue-600 rounded-lg font-semibold hover:bg-gray-100 transition">API Endpoints</a>
+                <a href="#setup" class="px-6 py-3 bg-blue-800 text-white rounded-lg font-semibold hover:bg-blue-900 transition">Setup Guide</a>
+            </div>
+        </div>
+    </div>
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12">
+        <div id="endpoints" class="mb-16">
+            <h2 class="text-3xl font-bold text-gray-800 mb-8">API Endpoints</h2>
+            <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
+                <!-- WebSocket Chat -->
+                <div class="endpoint-card bg-white rounded-xl shadow-md p-6 transition duration-300">
+                    <div class="flex items-center mb-4">
+                        <div class="bg-blue-100 p-2 rounded-full mr-4">
+                            <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6 text-blue-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z" />
+                            </svg>
+                        </div>
+                        <h3 class="text-xl font-semibold text-gray-800">Real-time Chat</h3>
+                    </div>
+                    <div class="mb-4">
+                        <span class="inline-block bg-blue-100 text-blue-800 text-xs px-2 py-1 rounded font-mono">WebSocket</span>
+                        <span class="inline-block ml-2 bg-gray-100 text-gray-800 text-xs px-2 py-1 rounded font-mono">/chat/stream</span>
+                    </div>
+                    <p class="text-gray-600 mb-4">Stream AI responses using Gemini API with RAG from FAISS vectors.</p>
+                    <div class="code-block p-4 text-white mb-4">
+                        <code>{
+  "type": "user_message",
+  "content": "How do I reset my password?"
+}</code>
+                    </div>
+                </div>
+                <!-- FAQ Upload -->
+                <div class="endpoint-card bg-white rounded-xl shadow-md p-6 transition duration-300">
+                    <div class="flex items-center mb-4">
+                        <div class="bg-green-100 p-2 rounded-full mr-4">
+                            <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6 text-green-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12" />
+                            </svg>
+                        </div>
+                        <h3 class="text-xl font-semibold text-gray-800">FAQ Upload</h3>
+                    </div>
+                    <div class="mb-4">
+                        <span class="inline-block bg-green-100 text-green-800 text-xs px-2 py-1 rounded font-mono">POST</span>
+                        <span class="inline-block ml-2 bg-gray-100 text-gray-800 text-xs px-2 py-1 rounded font-mono">/faq/upload</span>
+                    </div>
+                    <p class="text-gray-600 mb-4">Upload CSV/Markdown files to generate embeddings for RAG pipeline.</p>
+                    <div class="code-block p-4 text-white mb-4">
+                        <code>curl -X POST -F "file=@faqs.csv" http://localhost:8000/faq/upload</code>
+                    </div>
+                </div>
+                <!-- Escalation -->
+                <div class="endpoint-card bg-white rounded-xl shadow-md p-6 transition duration-300">
+                    <div class="flex items-center mb-4">
+                        <div class="bg-red-100 p-2 rounded-full mr-4">
+                            <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6 text-red-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
+                            </svg>
+                        </div>
+                        <h3 class="text-xl font-semibold text-gray-800">Escalation</h3>
+                    </div>
+                    <div class="mb-4">
+                        <span class="inline-block bg-red-100 text-red-800 text-xs px-2 py-1 rounded font-mono">POST</span>
+                        <span class="inline-block ml-2 bg-gray-100 text-gray-800 text-xs px-2 py-1 rounded font-mono">/escalate</span>
+                    </div>
+                    <p class="text-gray-600 mb-4">Create support tickets stored in PostgreSQL with optional SendGrid email.</p>
+                    <div class="code-block p-4 text-white mb-4">
+                        <code>{
+  "issue": "Payment failed",
+  "description": "Card declined despite sufficient funds",
+  "customer_email": "user@example.com"
+}</code>
+                    </div>
+                </div>
+                <!-- Escalation List -->
+                <div class="endpoint-card bg-white rounded-xl shadow-md p-6 transition duration-300">
+                    <div class="flex items-center mb-4">
+                        <div class="bg-purple-100 p-2 rounded-full mr-4">
+                            <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6 text-purple-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
+                            </svg>
+                        </div>
+                        <h3 class="text-xl font-semibold text-gray-800">Escalation List</h3>
+                    </div>
+                    <div class="mb-4">
+                        <span class="inline-block bg-purple-100 text-purple-800 text-xs px-2 py-1 rounded font-mono">GET</span>
+                        <span class="inline-block ml-2 bg-gray-100 text-gray-800 text-xs px-2 py-1 rounded font-mono">/escalate/list</span>
+                    </div>
+                    <p class="text-gray-600 mb-4">Retrieve all support tickets with filtering options.</p>
+                    <div class="code-block p-4 text-white mb-4">
+                        <code>[
+  {
+    "id": 1,
+    "status": "open",
+    "created_at": "2023-07-15T09:30:00Z",
+    "customer_email": "user@example.com"
+  }
+]</code>
+                    </div>
+                </div>
+            </div>
+        </div>
+        <div id="setup" class="mb-16">
+            <h2 class="text-3xl font-bold text-gray-800 mb-8">Setup Guide</h2>
+            <div class="bg-white rounded-xl shadow-md overflow-hidden">
+                <div class="p-6">
+                    <h3 class="text-xl font-semibold text-gray-800 mb-4">Environment Variables</h3>
+                    <div class="code-block p-4 text-white mb-6">
+                        <code>GEMINI_API_KEY=your_gemini_key
+REDIS_URL=redis://default:password@localhost:6379
+POSTGRES_URL=postgresql://user:password@localhost:5432/supportdb
+SENDGRID_KEY=your_sendgrid_key
+CORS_ORIGINS=https://your-frontend.vercel.app,http://localhost:3000</code>
+                    </div>
+                    <h3 class="text-xl font-semibold text-gray-800 mb-4">Running with Docker</h3>
+                    <div class="code-block p-4 text-white mb-6">
+                        <code># Build the image
+docker build -t geminiguard-backend .
+# Run the container
+docker run -p 8000:8000 --env-file .env geminiguard-backend</code>
+                    </div>
+                    <h3 class="text-xl font-semibold text-gray-800 mb-4">Directory Structure</h3>
+                    <div class="code-block p-4 text-white">
+                        <code>backend/
+├── main.py                # FastAPI app entrypoint
+├── routes/                # API endpoint definitions
+│   ├── chat.py            # WebSocket chat endpoint
+│   ├── faq.py            # FAQ upload endpoint
+│   └── escalate.py       # Ticket endpoints
+├── services/             # Business logic
+│   ├── gemini_service.py # Gemini API calls
+│   └── faiss_service.py # FAISS vector operations
+├── models/               # Pydantic models
+├── database/             # DB connections
+├── requirements.txt      # Python dependencies
+└── Dockerfile            # Container configuration</code>
+                    </div>
+                </div>
+            </div>
+        </div>
+        <div class="text-center py-8">
+            <h3 class="text-2xl font-bold text-gray-800 mb-4">Ready to Deploy?</h3>
+            <p class="text-gray-600 mb-6">This backend is production-ready for Railway deployment with all required endpoints.</p>
+            <a href="#" class="inline-block px-8 py-3 bg-blue-600 text-white rounded-lg font-semibold hover:bg-blue-700 transition">Download Complete Code</a>
+        </div>
+    </div>
+    <footer class="gradient-bg text-white py-8">
+        <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 text-center">
+            <p>© 2023 GeminiGuard Support Backend. All rights reserved.</p>
+        </div>
+    </footer>
+</body>
 </html>