build: add docker

Author: adiffpirate

.claude/agents/devops-hardened-engineer.md

@@ -0,0 +1,30 @@
+name: Tests
+
+on:
+  push:
+    branches: [main, develop, feature/*]
+  pull_request:
+    branches: [main]
+
+jobs:
+  unit-test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Run unit tests
+        run: make test-unit
+
+  integration-test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Run integration tests
+        run: make test-integration

.github/workflows/tests.yml

@@ -2,66 +2,10 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
-## Project Structure Overview
+## About the Project
 
-The application is organized in a modular monolith with clear separation:
-
-- `app/main.py`: Entry point with FastAPI app creation
-- `app/api/router.py`: REST router endpoints
-- `app/core`: Core utilities
-- `app.db.session`: Database session management
-- `app.modules.orders`: Complete order module with models, schemas, repository, service, routes
-- `alembic`: Database migration tool
-- `tests/unit`: Unit tests (SQLite in-memory)
-- `tests/integration`: Integration tests (PostgreSQL)
-
-## Key Development Commands
-
-**Setup and Run**
-```bash
-# Create virtual environment
-python -m venv .venv
-source .venv/bin/activate  # Windows: .venv\Scripts\Activate.ps1
-
-# Install dependencies
-pip install --upgrade pip
-pip install -e '.[dev]'
-
-# Run fresh database
-docker stop postgres-dev || true
-docker rm postgres-dev || true
-docker run -d \
-  --name postgres-dev \
-  -e POSTGRES_USER=postgres \
-  -e POSTGRES_PASSWORD=postgres \
-  -e POSTGRES_DB=app \
-  -p 5432:5432 \
-  postgres:15
-
-# Run API in background
-uvicorn app.main:app --reload &
-```
-
-**Testing**
-```bash
-pytest  # Uses in-memory SQLite, no database setup needed
-```
-
-**Database Migrations**
-```bash
-python -m alembic revision --autogenerate -m "init"
-python -m alembic upgrade head
-```
-
-## Architecture Notes
-
-- The project uses a feature-based modular structure
-- `modules/orders` contains end-to-end functionality
-- `repository.py` → database access layer
-- `service.py` → business logic
-- `routes.py` → API layer
-
-This structure supports future evolution into microservices if needed.
+Read the `README.md` file for information about the project, its architecture,
+how to run it and how to test it.
 
 ## Current State
 

.github/workflows/unit-tests.yml

@@ -0,0 +1,21 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    gcc \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements and install Python dependencies
+COPY pyproject.toml .
+RUN pip install --upgrade pip && pip install -e '.[dev]'
+
+# Copy application code
+COPY . .
+
+# Expose port
+EXPOSE 8000
+
+# Run the application
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

CLAUDE.md

@@ -0,0 +1,44 @@
+.PHONY: help run run-dev test-unit test-integration clean stop
+
+help:
+	@echo "Available commands:"
+	@echo "  build            - Build the docker container"
+	@echo "  run              - Run the application (development with auto-reload, debug mode)"
+	@echo "  test-unit        - Run unit tests"
+	@echo "  test-integration - Run integration tests with fresh database"
+	@echo "  stop             - Stop the application"
+	@echo "  clean            - Clean up Docker containers and volumes"
+
+build:
+	docker build -t python-fastapi-example-oms:dev .
+
+run:
+	$(MAKE) build
+	docker compose up -d
+	@echo "Waiting for database to be ready..."
+	until nc -zv localhost 5432; do sleep 1; done
+	@echo "Running migrations..."
+	docker compose run --rm app python -m alembic upgrade head
+	@echo "Application running at http://localhost:8000"
+	@echo "Swagger UI is available at http://localhost:8000/docs"
+
+stop:
+	@echo "Stopping the application..."
+	docker compose stop
+
+test-unit:
+	$(MAKE) build
+	@echo "Running unit tests..."
+	docker compose run --rm app python -m pytest tests/unit/ -v
+
+test-integration:
+	$(MAKE) clean
+	$(MAKE) run
+	@echo "Running integration tests..."
+	docker compose run --rm app python -m pytest tests/integration/ -v
+	$(MAKE) clean
+
+clean:
+	$(MAKE) stop
+	@echo "Cleaning all data..."
+	docker compose down -v