Add example FastAPI service following DDD and Hexagonal Architecture rules

[bardiakhosravi]

Summary

Create a practical example FastAPI service that demonstrates all 24 rules from the domain-driven design and hexagonal architecture standards. This will serve as a reference implementation for AI agents and developers.

Requirements

• Implement a complete FastAPI service using DDD and Hexagonal Architecture
• Follow all 24 rules from domain_driven_design_hexagonal_arhictecture_python_rules.md
• Include examples of:
  • Entities, Value Objects, and Aggregates
  • Domain Services and Events
  • Repository pattern implementation
  • Primary and Secondary Ports/Adapters
  • Application services and use cases
  • Proper project structure
• Add comprehensive tests (unit, integration, contract)
• Include documentation explaining how each rule is applied
• Use modern Python practices (FastAPI, Pydantic, dependency injection)

Acceptance Criteria

• Service demonstrates practical application of all documented rules
• Code is well-commented explaining DDD/Hexagonal patterns
• Tests cover domain logic, adapters, and boundaries
• README explains the architecture decisions
• Can serve as a template for new projects

Benefits

• Provides concrete examples alongside abstract rules
• Helps AI agents understand practical implementation
• Serves as validation that the rules are complete and practical
• Creates a reference for developers learning these patterns

🤖 Generated with Claude Code