This folder contains architecture documentation for AI assistants working on this codebase.

1. Identify the Bounded Context - Does it belong to client_bc or reservation_bc?
2. Create Value Objects - Use @dataclass(frozen=True) with validation in __post_init__
3. Create Entity - Use @dataclass with create() and reconstitute() factory methods
4. Create Domain Events - Use @dataclass(frozen=True) with from_entity() method
5. Create Repository Interface - ABC in domain/interfaces/
6. Create Command/Query - Dataclass + Handler in application/
7. Create DTO - Dataclass with from_entity() in application/dtos/
8. Create SQLAlchemy Model - In infrastructure/models/
9. Create Repository Implementation - In infrastructure/repositories/
10. Create HTTP Layer - Schema, Controller, Router in adapters/http/api/

# Value Object
@dataclass(frozen=True)
class BookingId:
    value: str
    def __post_init__(self): ...
    @classmethod
    def generate(cls): ...

# Entity
@dataclass
class Booking(BaseEntity):
    @classmethod
    def create(cls, ...): ...  # Records events
    @classmethod
    def reconstitute(cls, ...): ...  # No events

# Repository Interface
class BookingRepositoryInterface(ABC):
    @abstractmethod
    def save(self, booking: Booking) -> None: ...

# Command + Handler
@dataclass(frozen=True)
class CreateBookingCommand:
    id: str
    ...

class CreateBookingHandler:
    def handle(self, command: CreateBookingCommand) -> BookingDto: ...