Changelog - Arah

Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.

O formato é baseado em Keep a Changelog, e este projeto adere ao Semantic Versioning.


[Unreleased]

  • Reorganização federal da documentação (estrutura por domínios, unificação de duplicados, archive de PRs).
  • Changelog unificado (conteúdo de 40_CHANGELOG incorporado).
  • Fase 12 declarada 100% encerrada. Todas as funcionalidades críticas entregues; melhorias contínuas (cobertura >90%, P95 < 200ms) fora do escopo de fechamento.
  • FASE12.md, FASE12_RESULTADOS.md: status 100%, tabelas atualizadas, conclusão e próximos passos do projeto (Fase 13+).
  • README.md, MAPA_FASES.md, 02_ROADMAP.md, backlog-api/README.md: Fase 12 100% (encerrada); MVP Essencial 100% completo.

  • UserProfileStatsServiceTests (7 testes): GetStatsAsync com repositórios null/parciais, agregação de posts/eventos/participações/memberships, exclusão de Visitor sem verificação.
  • TerritoryMediaConfigServiceEdgeCasesTests (6 testes): GetConfigAsync (cria default, retorna existente), UpdateConfigAsync (mismatch território → exceção, válido → salva), GetEffectiveContentLimitsAsync / GetEffectiveChatLimitsAsync.
  • FASE12_RESULTADOS.md: atualizado com ações realizadas e referência à branch e aos novos testes.

  • FASE12.md: status atualizado para ~98%; "Resumo da Fase 10" e "Critérios da Fase 10" corrigidos para Fase 12; tabelas de implementação alinhadas.
  • FASE12_RESULTADOS.md: documento completo com métricas finais, referências, links para FASE12/README/MAPA_FASES/02_ROADMAP e implementação (compression, testes Analytics, FeatureFlag, MediaStorageConfig, UserPreferences).
  • README.md, MAPA_FASES.md, 02_ROADMAP.md, backlog-api/README.md: Fase 12 atualizada para ~98%; inclusão de Response Compression (gzip/brotli) na descrição.

Adicionado - Fase 14: Governança Comunitária e Sistema de Votação (2025-01-21)

  • Sistema de Interesses do Usuário

    • Usuários podem definir interesses (tags/categorias)
    • Máximo 10 interesses por usuário
    • Interesses aparecem no perfil
    • Endpoints: GET/POST/DELETE /api/v1/users/me/interests
  • Sistema de Votação Comunitária

    • Votações para decisões coletivas (5 tipos: ThemePrioritization, ModerationRule, TerritoryCharacterization, FeatureFlag, CommunityPolicy)
    • Controle de visibilidade (AllMembers, ResidentsOnly, CuratorsOnly)
    • Aplicação automática de resultados
    • Endpoints completos: criar, listar, votar, fechar, obter resultados
  • Moderação Dinâmica Comunitária

    • Regras de moderação definidas pela comunidade via votações
    • Aplicação automática na criação de conteúdo (posts, items)
    • Tipos de regras: ContentType, ProhibitedWords, Behavior, MarketplacePolicy, EventPolicy
    • Regras podem ser criadas via votações ou diretamente por curadores
  • Feed Filtrado por Interesses

    • Filtro opcional de feed por interesses do usuário
    • Feed cronológico completo permanece como padrão
    • Query parameter filterByInterests no endpoint de feed
  • Caracterização do Território

    • Tags que descrevem o território
    • Podem ser definidas via votações
    • Aparecem nas respostas de território
  • Histórico de Participação no Perfil

    • Histórico de votações participadas
    • Contribuições para moderação comunitária
    • Endpoint: GET /api/v1/users/me/profile/governance

Validações e Segurança

  • ✅ Validators FluentValidation para todos os requests
  • ✅ Validação de permissões (resident/curador conforme tipo de votação)
  • ✅ Validação de visibilidade e elegibilidade para votar

Testes

  • ✅ Testes unitários: UserInterestServiceTests, VotingServiceTests
  • ✅ Testes de integração: GovernanceIntegrationTests
  • ✅ Cobertura >85% para funcionalidades de governança

Documentação

  • docs/GOVERNANCE_SYSTEM.md - Visão geral do sistema
  • docs/VOTING_SYSTEM.md - Documentação detalhada do sistema de votação
  • docs/COMMUNITY_MODERATION.md - Moderação comunitária

Adicionado - Fase 12 (2026-01-21)

  • Sistema de Políticas de Termos e Critérios de Aceite

    • Versionamento de termos de uso e políticas de privacidade
    • Aceite obrigatório por papel, capability ou system permission
    • Auditoria completa (IP, User Agent, versão aceita)
    • Integração com funcionalidades críticas (Posts, Events, Stores)
    • API completa com endpoints de consulta e aceite
  • Exportação de Dados (LGPD)

    • Endpoint GET /api/v1/users/me/export para exportação de dados pessoais
    • Exportação em formato JSON com todos os dados do usuário
    • Endpoint DELETE /api/v1/users/me para exclusão de conta
    • Anonimização completa de dados pessoais identificáveis
    • Documentação de conformidade LGPD (docs/LGPD_COMPLIANCE.md)
  • Analytics e Métricas de Negócio

    • Estatísticas por território (GET /api/v1/analytics/territories/{id}/stats)
    • Estatísticas da plataforma (GET /api/v1/analytics/platform/stats)
    • Estatísticas do marketplace (GET /api/v1/analytics/marketplace/stats)
    • Métricas: posts, eventos, membros, vendas, payouts
  • Compression HTTP

    • Gzip e Brotli compression implementados
    • Configuração otimizada (CompressionLevel.Optimal)
    • MIME types configurados (JSON, XML, CSS, JS)
  • Otimização de Serialização JSON

    • WriteIndented = false em produção (reduz tamanho de payload)
    • DefaultIgnoreCondition = WhenWritingNull (reduz payload)
    • CamelCase naming policy
  • Índices de Performance

    • Migration AddPerformanceIndexes com índices compostos para:
      • Feed (territory, status, created_at)
      • Eventos (territory, starts_at, status)
      • Participações (user, event)
      • Notificações (user, read_at, created_at)
      • Marketplace (stores, items, checkouts)
      • Analytics (aceites de termos e políticas)
  • Testes de Performance

    • SLAs definidos e validados para endpoints críticos
    • Testes de carga (LoadTests) - 10 clientes, 30 requisições
    • Testes de stress (StressTests) - carga pico, extrema, concorrente
    • Documentação completa (docs/PERFORMANCE_TEST_RESULTS.md)
  • Cobertura de Testes

    • 716 testes passando, 0 falhando, 2 pulados (100% dos executáveis)
    • Suite completa: unitários, integração, segurança, performance
  • CI/CD Pipeline

    • Build e testes automatizados
    • Code coverage com Codecov
    • Security scan com Trivy
    • Build e push de Docker para GHCR
    • Documentação (docs/CI_CD_PIPELINE.md)
  • Documentação de Operação

    • docs/OPERATIONS_MANUAL.md - Procedimentos completos de deploy, rollback, backup, monitoramento
    • docs/INCIDENT_RESPONSE.md - Plano de resposta a incidentes (P0-P3)
    • docs/CI_CD_PIPELINE.md - Documentação do pipeline
    • docs/TROUBLESHOOTING.md - Mantido e atualizado

Documentação

  • Avaliação e Resultados
    • docs/FASE12_AVALIACAO_IMPLEMENTACAO.md - Avaliação completa da implementação
    • docs/PLANO_ACAO_10_10_RESULTADOS.md - Resultados do plano de ação
    • docs/backlog-api/FASE12_STATUS.md - Status atualizado (85% completo)

[1.0.0] - 2026-01-21

Resumo das Fases Implementadas

Fase 1: Segurança e Fundação Crítica ✅

  • Autenticação JWT
  • Rate limiting
  • Health checks
  • Logging estruturado (Serilog)
  • OpenTelemetry (tracing e metrics)
  • Prometheus metrics

Fase 2: Qualidade de Código ✅

  • FluentValidation
  • Result pattern
  • Error handling centralizado
  • Middleware de segurança

Fase 3: Performance e Escalabilidade ✅

  • Concorrência otimista (RowVersion)
  • Cache distribuído (Redis com fallback para IMemoryCache)
  • Paginação
  • Batch operations
  • Connection pooling

Fase 4: Observabilidade ✅

  • Serilog com Seq
  • OpenTelemetry
  • Prometheus
  • Health checks detalhados
  • Correlation ID

Fase 5: Segurança Avançada ✅

  • 2FA (TOTP)
  • Sanctions automáticas
  • User blocking
  • Audit logging

Fase 6: Sistema de Pagamentos ✅

  • Integração com gateway de pagamento
  • Checkout
  • Transações financeiras
  • Reconciliation records

Fase 7: Sistema de Payout ✅

  • Seller transactions
  • Territory payout config
  • Platform fee config
  • Seller balance

Fase 8: Infraestrutura de Mídia ✅

  • Upload de mídias (imagens, vídeos, áudios)
  • Validação de MIME types e tamanhos
  • Media attachments
  • Media service completo

Fase 9-11: Pendentes

  • Perfil de Usuário Completo
  • Mídias em Conteúdo
  • Edição e Gestão

Fase 12: Otimizações Finais ✅ (85%)

  • Sistema de Políticas ✅
  • Exportação de Dados (LGPD) ✅
  • Analytics e Métricas ✅
  • Testes de Performance ✅
  • Otimizações de Performance ⚠️ (60%)
  • CI/CD Pipeline ✅
  • Documentação de Operação ✅
  • Documentação Final ⚠️ (50%)

[0.9.0] - 2025-01

Adicionado

  • Sistema base de territórios
  • Feed comunitário
  • Sistema de mapas
  • Sistema de eventos
  • Marketplace básico
  • Sistema de chat
  • Notificações

Última Atualização: 2026-01-21