ClaudeTest

A clean architecture web application built with FastAPI, following hexagonal architecture principles.

Setup

1. Install dependencies:

   poetry install
   

2. Activate the virtual environment:

   poetry shell
   

Development

• Run tests: poetry run pytest
• Run tests with coverage: poetry run pytest --cov
• Format code: poetry run black src tests
• Lint code: poetry run ruff check src tests
• Type check: poetry run mypy src
• Run development server: poetry run uvicorn src.main:app --reload

Architecture

This project follows Clean Architecture (Hexagonal Architecture) principles:

• Domain Layer: Core business logic, entities, and domain services
• Application Layer: Use cases and application services
• Ports: Interfaces that define contracts between layers
• Adapters: Implementations of ports (web API, database, external services)

See CLAUDE.md for more details.