Desenvolvimento

Guia para Desenvolvedores

Para subir API, BFF, seeds e app Flutter em poucos passos:

  • Stack: na raiz do repositório, execute .\scripts\run-local-stack.ps1 (PowerShell). O script sobe API (Docker), BFF e aplica os seeds Camburi e Boiçucanga. Use -ResetDatabase para recriar o banco.
  • App: em outro terminal, cd frontend/Arah.app e flutter run.

Documentação completa (getting started, release estável, o que falta no app): STABLE_RELEASE_APP_ONBOARDING.md.

Configuração Inicial

  1. Clone o repositório
  2. Instale dependências:
    dotnet restore
    npm install
    
backend/
  ├── Arah.Api/          # Controllers e endpoints
  ├── Arah.Application/  # Application services
  ├── Arah.Domain/       # Domain models
  ├── Arah.Infrastructure/ # Database e externos
  └── Arah.Tests/        # Testes

frontend/
  ├── wiki/                  # Documentação interativa
  ├── devportal/             # Portal de desenvolvimento
  └── ...                    # Aplicação principal

Build e Testes

# Build
dotnet build Arah.sln

# Testes
dotnet test backend/Arah.Tests/Arah.Tests.csproj

# Wiki local
cd frontend/wiki
npm run dev

Padrões de Código

  • Usar Result<T> para operações que podem falhar
  • Validações via FluentValidation
  • Repositórios para acesso a dados
  • Serviços para lógica de negócio

Contribuindo

Veja CONTRIBUTING.md para detalhes sobre PRs e commits.