feat: fix deploy

Author: Rieranthony

apps/geoip/README.md

@@ -10,6 +10,7 @@ Private FastAPI service for MaxMind-backed IP geolocation lookups.
 
 ## Endpoints
 
+- `GET /live`
 - `GET /health`
 - `POST /v1/lookup`
 
@@ -60,6 +61,8 @@ Deploy this app as its own Railway service named `geoip`.
 
 The service binds to `::` by default so Railway private networking can reach it in both new dual-stack environments and older IPv6-only ones.
 
+Use `/live` as the Railway deployment healthcheck path. `/health` remains a readiness endpoint and can return `503` until the MaxMind databases have been downloaded and loaded.
+
 The main API should use:
 
 ```env

apps/geoip/src/main.py

@@ -10,7 +10,7 @@
 
 from .config import Settings
 from .database import GeoIPDatabaseManager
-from .models import HealthResponse, LookupRequest, LookupResponse
+from .models import HealthResponse, LiveResponse, LookupRequest, LookupResponse
 
 
 logging.basicConfig(level=logging.INFO)
@@ -48,6 +48,10 @@ async def lifespan(app: FastAPI) -> AsyncIterator[None]:
 
 	app = FastAPI(title="Cossistant GeoIP Service", lifespan=lifespan)
 
+	@app.get("/live", response_model=LiveResponse)
+	async def live() -> LiveResponse:
+		return LiveResponse(status="ok")
+
 	@app.get("/health", response_model=HealthResponse)
 	async def health(response: Response) -> HealthResponse:
 		snapshot = app.state.geoip_manager.health_snapshot()

apps/geoip/src/models.py

@@ -6,6 +6,10 @@
 from pydantic import BaseModel, Field
 
 
+class LiveResponse(BaseModel):
+	status: Literal["ok"]
+
+
 class HealthResponse(BaseModel):
 	status: Literal["healthy", "degraded", "unhealthy"]
 	ready: bool
@@ -35,4 +39,3 @@ class LookupResponse(BaseModel):
 	asn_organization: str | None = None
 	source: str
 	resolved_at: datetime
-

apps/geoip/tests/test_main.py

@@ -65,10 +65,17 @@ def test_health_returns_503_when_not_ready() -> None:
 	assert response.json()["ready"] is False
 
 
+def test_live_returns_200_even_when_not_ready() -> None:
+	with TestClient(create_app(FakeManager(ready=False))) as client:
+		response = client.get("/live")
+
+	assert response.status_code == 200
+	assert response.json() == {"status": "ok"}
+
+
 def test_lookup_returns_payload() -> None:
 	with TestClient(create_app(FakeManager(ready=True))) as client:
 		response = client.post("/v1/lookup", json={"ip": "8.8.8.8"})
 
 	assert response.status_code == 200
 	assert response.json()["city"] == "Mountain View"
-