O que é: Conceitos centrais do domínio (territory, posts, events, etc.)

O que contém:

• Entidades (Entities/): Territory, Post, Event, Membership, etc.
• Value Objects (ValueObjects/): GeoAnchor, Address, etc.
• Interfaces de Repositórios (Interfaces/): ITerritoryRepository, IFeedRepository, etc.
• Exceções de Domínio (Exceptions/): TerritoryNotFoundException, etc.

Características:

• ✅ Não depende de nada - camada mais interna
• ✅ Não tem lógica de persistência - apenas conceitos
• ✅ Puro C# - sem frameworks externos

Exemplo de navegação:

Arah.Domain/
├── Entities/
│   ├── Territory.cs          # Entidade Territory
│   ├── Post.cs               # Entidade Post
│   └── Membership.cs         # Entidade Membership
├── ValueObjects/
│   ├── GeoAnchor.cs          # Ponto georreferenciado
│   └── Address.cs            # Endereço
└── Interfaces/
    └── Repositories/         # Interfaces de repositórios

---

O que é: Lógica de negócio e casos de uso

O que contém:

• Services (Services/): TerritoryService, FeedService, EventsService, etc.
• DTOs (DTOs/): CreatePostRequest, PostResponse, etc.
• Interfaces de Serviços Externos (Interfaces/): IMediaStorageService, etc.
• Result Pattern (Results/): Result<T> para operações que podem falhar

Características:

• ✅ Depende apenas de Domain - não conhece HTTP ou banco
• ✅ Contém regras de negócio - validações, lógica
• ✅ Orquestra operações - coordena repositórios e serviços

Exemplo de navegação:

Arah.Application/
├── Services/
│   ├── TerritoryService.cs   # Lógica de territórios
│   ├── FeedService.cs        # Lógica de feed
│   └── EventsService.cs      # Lógica de eventos
├── DTOs/
│   ├── CreatePostRequest.cs
│   └── PostResponse.cs
└── Interfaces/
    └── Media/                # Interfaces de serviços externos

---

O que é: Persistência e integrações externas

O que contém:

• Repositórios (Repositories/): Implementações de ITerritoryRepository, etc.
• DbContext (Postgres/ ou InMemory/): Acesso ao banco de dados
• Serviços Externos (Services/): S3MediaStorageService, etc.
• Configurações (Configurations/): ServiceCollectionExtensions, etc.

Características:

• ✅ Depende de Domain e Application - implementa interfaces
• ✅ Lógica técnica - banco, APIs externas, storage
• ✅ Não tem lógica de negócio - apenas implementação

Exemplo de navegação:

Arah.Infrastructure/
├── Repositories/
│   ├── PostgresTerritoryRepository.cs
│   └── InMemoryTerritoryRepository.cs
├── Postgres/
│   └── ArapongaDbContext.cs
└── InMemory/
    └── InMemoryDataStore.cs

---

O que é: Interface HTTP (endpoints, controllers)

O que contém:

• Controllers (Controllers/): TerritoriesController, FeedController, etc.
• Middlewares (Middlewares/): AuthenticationMiddleware, ErrorHandlingMiddleware
• Configuração (Program.cs, Startup.cs): Setup da API
• DevPortal (wwwroot/devportal/): Site do desenvolvedor

Características:

• ✅ Depende de todas as camadas - orquestra tudo
• ✅ Lógica HTTP - routing, autenticação, validação de entrada
• ✅ Não tem lógica de negócio - delega para Application

Exemplo de navegação:

Arah.Api/
├── Controllers/
│   ├── TerritoriesController.cs
│   ├── FeedController.cs
│   └── EventsController.cs
├── Middlewares/
│   └── AuthenticationMiddleware.cs
├── wwwroot/
│   └── devportal/          # Portal do desenvolvedor
└── Program.cs              # Configuração principal

---

O que é: Testes automatizados

O que contém:

• Domain Tests (Domain/): Testes de entidades e value objects
• Application Tests (Application/): Testes de services
• Infrastructure Tests (Infrastructure/): Testes de repositórios
• API Tests (Api/): Testes end-to-end

Características:

• ✅ Cobertura >90% - objetivo de alta cobertura
• ✅ Isolados - usam InMemoryDataStore quando possível
• ✅ E2E - testes de integração completos

Exemplo de navegação:

Arah.Tests/
├── Domain/
│   └── TerritoryTests.cs
├── Application/
│   └── TerritoryServiceTests.cs
└── Api/
    └── TerritoriesControllerTests.cs

---

Passo 1: Procure pelo endpoint

• Vá para Arah.Api/Controllers/FeedController.cs
• Encontre POST /api/v1/feed ou método CreatePost

Passo 2: Entenda o controller

• Controller recebe CreatePostRequest (DTO)
• Chama FeedService.CreatePostAsync()

Passo 3: Entenda o service

• Vá para Arah.Application/Services/FeedService.cs
• Encontre método CreatePostAsync()
• Veja regras de negócio e validações

Passo 4: Entenda a entidade

• Vá para Arah.Domain/Entities/Post.cs
• Veja estrutura e validações da entidade

Passo 5: Entenda persistência

• Vá para Arah.Infrastructure/Repositories/PostgresFeedRepository.cs
• Veja como é salvo no banco

Dica: Use o Cursor! Pergunte: "Como funciona a criação de posts?" e ele te mostra o fluxo completo.

---

Passo 1: Defina a entidade (se nova)

• Crie em Arah.Domain/Entities/

Passo 2: Defina interface do repositório

• Crie em Arah.Domain/Interfaces/Repositories/

Passo 3: Implemente repositório

• Crie em Arah.Infrastructure/Repositories/

Passo 4: Crie service

• Crie em Arah.Application/Services/

Passo 5: Crie controller

• Crie em Arah.Api/Controllers/

Passo 6: Adicione testes

• Crie em Arah.Tests/

Dica: Use o Cursor! Ele sabe seguir essa estrutura automaticamente.

---