add GET /resorts/{id} endpoint and migrate backend to Poetry

- Add GET /resorts/{id} returning full Resort model, 404 on unknown UUID
- Replace requirements.txt with pyproject.toml + poetry.lock for isolated backend env
- Update Dockerfile to install via Poetry
- Add planning/ to root .gitignore, scope poetry.lock ignore to root only

Closes #60

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: jonathanstelman

.gitignore

@@ -164,8 +164,8 @@ cython_debug/
 # Mac
 .DS_Store
 
-# Poetry
-poetry.lock
+# Poetry (root-level only; submodule lockfiles are committed for reproducibility)
+/poetry.lock
 
 # Streamlit
 .streamlit/secrets.toml
@@ -184,6 +184,9 @@ dist/
 .env.*.local
 *.tsbuildinfo
 
+# Planning / design docs
+planning/
+
 # AI coding assistants
 CLAUDE.md
 .claude/

backend/.gitignore

@@ -0,0 +1,2 @@
+.venv/
+__pycache__/

backend/Dockerfile

@@ -2,8 +2,11 @@ FROM python:3.12-slim
 
 WORKDIR /app
 
-COPY requirements.txt .
-RUN pip install --no-cache-dir -r requirements.txt
+RUN pip install --no-cache-dir poetry==2.1.3 && \
+    poetry config virtualenvs.create false
+
+COPY pyproject.toml poetry.lock ./
+RUN poetry install --only main --no-interaction
 
 COPY . .
 

backend/main.py

@@ -1,6 +1,6 @@
 import json
 from contextlib import asynccontextmanager
-from fastapi import FastAPI, Query
+from fastapi import FastAPI, HTTPException, Query
 from typing import Optional
 
 from data import load_resorts
@@ -34,6 +34,14 @@ def _parse_date_list(value: Optional[str]) -> set[str]:
         return set()
 
 
+@app.get("/resorts/{resort_id}", response_model=Resort)
+def get_resort(resort_id: str):
+    for r in _resorts:
+        if r.resort_id == resort_id:
+            return r
+    raise HTTPException(status_code=404, detail="Resort not found")
+
+
 @app.get("/resorts", response_model=list[ResortSummary])
 def get_resorts(
     search: Optional[str] = Query(default=None),

backend/poetry.lock

@@ -0,0 +1,25 @@
+[tool.poetry]
+name = "indy-explorer-backend"
+version = "0.1.0"
+description = "Indy Explorer FastAPI backend"
+authors = ["Jon Stelman <jon@jonstelman.com>"]
+package-mode = false
+
+[tool.poetry.dependencies]
+python = "^3.12"
+fastapi = "^0.115.12"
+uvicorn = {extras = ["standard"], version = "^0.34.0"}
+pandas = "^2.2.3"
+pydantic = "^2.12.5"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.3.5"
+httpx = "^0.28.1"
+
+[tool.black]
+skip-string-normalization = true
+line-length = 100
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

backend/pyproject.toml

@@ -0,0 +1,59 @@
+import sys
+import os
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..'))
+
+from fastapi.testclient import TestClient
+from unittest.mock import patch
+
+from main import app
+from models import Resort
+
+FAKE_RESORTS = [
+    Resort(
+        resort_id='abc-123',
+        name='Vail',
+        region='West',
+        city='Vail',
+        state='CO',
+        country='USA',
+        reservation_status='required',
+        indy_page='https://example.com/vail',
+    ),
+    Resort(
+        resort_id='def-456',
+        name='Stowe',
+        region='Northeast',
+        city='Stowe',
+        state='VT',
+        country='USA',
+        reservation_status='none',
+        indy_page='https://example.com/stowe',
+    ),
+]
+
+client = TestClient(app)
+
+
+def test_get_resort_by_id_returns_resort():
+    with patch('main._resorts', FAKE_RESORTS):
+        response = client.get('/resorts/abc-123')
+    assert response.status_code == 200
+    data = response.json()
+    assert data['resort_id'] == 'abc-123'
+    assert data['name'] == 'Vail'
+
+
+def test_get_resort_by_id_returns_full_model():
+    with patch('main._resorts', FAKE_RESORTS):
+        response = client.get('/resorts/def-456')
+    assert response.status_code == 200
+    data = response.json()
+    assert data['resort_id'] == 'def-456'
+    assert data['state'] == 'VT'
+
+
+def test_get_resort_by_id_not_found():
+    with patch('main._resorts', FAKE_RESORTS):
+        response = client.get('/resorts/nonexistent-uuid')
+    assert response.status_code == 404