chore: scaffold backend venv, health check, systemd unit

.env.example

@@ -0,0 +1,4 @@
+DATABASE_URL=postgresql+asyncpg://quantumancy:quantumancy@localhost:5432/quantumancy
+OLLAMA_BASE_URL=http://10.30.20.107:11434
+SESSION_SECRET=change-me-to-a-random-64-char-string
+PORT=7777

.gitignore

@@ -1 +1,6 @@
-.worktrees/
+backend/venv/
+__pycache__/
+*.pyc
+.env
+frontend/node_modules/
+frontend/dist/

backend/app/main.py

@@ -0,0 +1,8 @@
+from fastapi import FastAPI
+
+app = FastAPI(title="Quantumancy")
+
+
+@app.get("/healthz")
+async def healthz():
+    return {"status": "ok"}

backend/pytest.ini

@@ -0,0 +1,2 @@
+[pytest]
+asyncio_mode = auto

backend/requirements.txt

@@ -0,0 +1,10 @@
+fastapi==0.115.0
+uvicorn[standard]==0.32.0
+sqlalchemy[asyncio]==2.0.36
+asyncpg==0.30.0
+pydantic-settings==2.6.1
+argon2-cffi==23.1.0
+httpx==0.27.2
+numpy==2.1.3
+pytest==8.3.3
+pytest-asyncio==0.24.0

backend/tests/test_health.py

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

deploy/quantumancy.service

@@ -0,0 +1,14 @@
+[Unit]
+Description=Quantumancy web app
+After=network.target postgresql.service
+
+[Service]
+Type=simple
+WorkingDirectory=/root/quantumancy/backend
+EnvironmentFile=/root/quantumancy/.env
+ExecStart=/root/quantumancy/backend/venv/bin/uvicorn app.main:app --host 0.0.0.0 --port 7777
+Restart=on-failure
+RestartSec=3
+
+[Install]
+WantedBy=multi-user.target