• Autenticação: login com e-mail (check-email → senha ou criar conta), signup com nome e senha; login com Google na UI (botão "Entrar com Google" no fluxo de login — requer GOOGLE_SIGN_IN_CLIENT_ID e config Firebase para funcionar end-to-end).
• Onboarding: tela de seleção de território após login/cadastro quando não há território salvo.
  • Lista “Próximos a você” (sugeridos por lat/lng).
  • Busca de território por nome/cidade (jornada territories/search): permite encontrar e selecionar um território e concluir o onboarding sem depender de geolocalização.
  • Seleção na lista só altera o mapa e o destaque; o botão Continuar é o único que conclui o onboarding e leva ao feed.
  • Contorno do território e pin no mapa em verde floresta.
  • Botão Voltar (logout e retorno à tela de login/cadastro).
• Feed: listagem do feed do território selecionado, com paginação e pull-to-refresh. Toque num post abre a tela de detalhe (conteúdo completo, mídias, autor, contadores e ações).
• Explorar: troca de território (lista paginada) com busca por nome/cidade (jornada territories/search); ao “entrar” em outro território, o feed e o mapa refletem o escolhido.
• Mapa: pins do território, contorno (polígono/círculo) em verde floresta, marcador do usuário.
• Eventos: lista de eventos do território, criação de evento (título, descrição, início/término com seletores de data/hora, local), interesse e confirmação de presença.
• Governança: tela de votações do território (jornada governance) — lista com filtro de status (Todas/Abertas/Fechadas), votar inline, ver resultados (barras) e criar votação (tipo, visibilidade, opções).
• Mapa (deep-links): tocar num pin abre uma folha com "Ver detalhes" que navega para o conteúdo correspondente (evento → Eventos, asset → Assets, alerta → Alertas, post → feed).
• Perfil: exibição e edição de nome e bio; preferências de notificação (estrutura). Ações "Meu território" (seletor de território), "Notificações" (aba) e atalho "Governança" no menu de configurações.
• Publicar: criação de post (título, conteúdo, tipo, visibilidade) no território ativo.

• API: autenticação (check-email, login, signup), jornadas (onboarding, feed, territórios, eventos, perfil, notificações), migração única Postgres com extensão pgcrypto e DEFAULTs para RowVersion.
• BFF: proxy para a API por jornadas (/api/v2/journeys/*), tratamento de 502 com mensagem clara quando a API fecha a conexão prematuramente.

• Stack local: scripts/run-local-stack.ps1 sobe API (Docker), BFF (dotnet) e opcionalmente o app Flutter; aplica migrações e executa seeds (Camburi + Boiçucanga) com encoding UTF-8.
• Seed: ingestão via SQL (scripts/seed/seed-camburi.sql, seed-boicucanga.sql) com docker cp + psql -f para preservar acentos.

1. Subir API + BFF (e seed)
   Na raiz do repositório:

   .\scripts\run-local-stack.ps1
   

   • Na primeira execução, a API aplica a migração única no Postgres e o script roda os seeds Camburi e Boiçucanga.
   • Para recriar o banco do zero (útil após mudanças de schema):

   .\scripts\run-local-stack.ps1 -ResetDatabase
   

2. Rodar o app Flutter
   Em outro terminal:

   cd frontend\Arah.app
   flutter run
   

   Ou use o script do projeto que define BFF_BASE_URL (ex.: http://localhost:5001).

3. Fluxo típico no app
   Abrir o app → informar e-mail (check-email) → criar conta ou entrar com senha → onboarding: escolher território na lista (mapa atualiza), tocar em Continuar → feed do território. Em Explorar é possível trocar de território.

Detalhes dos seeds e variáveis de ambiente: scripts/seed/README.md.

• Migração única
  Toda a criação de schema e ajustes ficam em uma única migração (UnifiedInitialCreate), incluindo:
  • Extensão pgcrypto (CREATE EXTENSION IF NOT EXISTS pgcrypto) para uso de gen_random_bytes().
  • Índice único em territory_memberships: um Resident por usuário (filtro Role = 2), permitindo vários Visitor por usuário.
  • DEFAULT gen_random_bytes(8) para as colunas RowVersion em territory_memberships e community_posts, evitando NOT NULL violation no INSERT.
• DbContext (EF)
  Configuração de RowVersion com HasDefaultValueSql("gen_random_bytes(8)").ValueGeneratedOnAdd() em SharedDbContext e ArapongaDbContext para membership; em ArapongaDbContext para community_posts, para o EF não enviar o valor no INSERT.
• SharedDbContext
  Índice único parcial de membership corrigido para filtro Role = 2 (Resident), alinhado à migração.

• Onboarding
  • Seleção na lista apenas atualiza o território exibido no mapa e o destaque do card; apenas o botão Continuar conclui o onboarding.
  • Mapa usa o território selecionado (ou o mais próximo como padrão).
  • Botão Voltar faz logout e limpa território, retornando à tela de login/cadastro (com addPostFrameCallback para evitar conflito com o redirect do router).
• Visual
  • Contorno do polígono/círculo do território e pin do território em verde floresta (#228B22) na tela de onboarding e no mapa.

• Encoding UTF-8
  Seeds executados com docker cp + psql -f e PGCLIENTENCODING=UTF8; arquivos SQL com SET client_encoding = 'UTF8'; para preservar acentos (ex.: Boiçucanga, São).
• Seed
  Execução automática de seed-camburi.sql e seed-boicucanga.sql pelo run-local-stack.ps1 após subir os containers.