fix(FN-002): address Dockerfile build order, base images, .dockerignore, docs

apps/api/.dockerignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.venv/
+venv/
+ENV/
+env/
+*.egg-info/
+dist/
+build/
+.git/
+.env
+.env.local
+*.log

apps/api/Dockerfile

@@ -1,15 +1,14 @@
-FROM python:3.14-slim
+FROM python:3.12-slim
 
 WORKDIR /app
 
 ENV PYTHONDONTWRITEBYTECODE=1
 ENV PYTHONUNBUFFERED=1
 
+COPY app/ ./app/
 COPY pyproject.toml ./
 RUN pip install --no-cache-dir -e ".[dev]"
 
-COPY app/ ./app/
-
 EXPOSE 8000
 
 CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

apps/web/.dockerignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+.git/
+.env
+.env.local
+*.log

apps/web/Dockerfile

@@ -1,4 +1,4 @@
-FROM node:25-alpine AS builder
+FROM node:22-alpine AS builder
 
 WORKDIR /app
 COPY package.json ./

docker-compose.yml

@@ -12,6 +12,12 @@ services:
     depends_on:
       db:
         condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "python -c \"import urllib.request; urllib.request.urlopen('http://localhost:8000/health')\""]
+      interval: 10s
+      timeout: 5s
+      retries: 3
+      start_period: 5s
     volumes:
       - api-data:/data
     restart: unless-stopped
@@ -22,8 +28,6 @@ services:
       dockerfile: Dockerfile
     ports:
       - "5173:80"
-    env_file:
-      - .env
     depends_on:
       - api
     restart: unless-stopped

docs/README.md

@@ -11,5 +11,5 @@ This directory contains architecture, development, and deployment documentation
 ## Quick Links
 
 - Root README — to be added in Step 6
-- Deploy Skeleton — to be added in Step 5
+- [Deploy Skeleton](../deploy/README.md)
 - [Project Brief](project-brief.md) — Original product brief and confirmed stack *(FN-001)*

docs/development.md

@@ -55,11 +55,9 @@ pnpm dev        # Runs frontend and backend in parallel
 
 ### With Docker Compose
 
-> Docker Compose files will be added in Step 5. Once created, run:
+```bash
->
+docker compose up --build -d
-> ```bash
+```
-> docker compose up --build -d
-> ```
 
 ## Testing
 
@@ -129,8 +127,8 @@ pnpm build
 │   ├── web/          # Vite React TypeScript frontend
 │   └── api/          # FastAPI Python backend
 ├── docs/             # Documentation
-├── deploy/           # Deployment skeleton files (added in Step 5)
+├── deploy/           # Deployment skeleton files
-├── docker-compose.yml (added in Step 5)
+├── docker-compose.yml
 └── package.json      # Root monorepo scripts
 ```