---

Este documento organiza toda a documentação do projeto Arah de forma estruturada e fácil de navegar.

Reorganização federal: Foi criada uma estrutura por domínios (produto, arquitetura, API, BFF, app Flutter, operações, governança, backlog, wiki, técnico) e arquivados PRs/temporários. Ver Plano de Reorganização Federal para a estrutura completa e pastas 01-produto/ … 11-tecnico-especial/, archive/.

Documentos sobre a visão do produto, roadmap e funcionalidades.

• Visão do Produto ⭐ - Visão geral, princípios e evolução estratégica do Arah
• Roadmap Estratégico ⭐ - Planejamento completo de funcionalidades e épicos, reorganizado estrategicamente
• Backlog - Lista de funcionalidades e prioridades
• User Stories - Histórias de usuário consolidadas (MVP e pós-MVP)
• Glossário - Termos e conceitos do projeto

Documentos técnicos sobre arquitetura, decisões e design.

• Decisões Arquiteturais (ADRs) - Decisões arquiteturais importantes (ADR-001 a ADR-009)
• Arquitetura de Services - Documentação dos services da camada de aplicação
• Modelo de Domínio (MER) - Modelo de entidades e relacionamentos
• Domain Routing - Roteamento e organização de domínios

Documentos sobre desenvolvimento, testes e implementação.

• Plano de Implementação - Prioridades e dependências de implementação
• Revisão de Código - Análise de gaps, inconsistências e melhorias
• Análise de Coesão e Testes - Avaliação de coesão e cobertura de testes
• Implementação de Recomendações - Status das recomendações implementadas
• Planejamento do Frontend Flutter - Planejamento completo do app mobile Flutter (arquitetura, stack, funcionalidades, UX/UI)
• Roadmap de Implementação do Frontend Flutter ⭐ - Roadmap extensivo detalhado por fases, sincronizado com API até Fase 28 (jornadas, funcionalidades, papéis, padrões elevados)
• Diretrizes de Design do App Flutter 🎨 ⭐ - Diretrizes high-end profissionais de design (cores, formas, transições, efeitos, estratégias de conversão preservando identidade visual)

Documentos sobre moderação, observabilidade e operações.

• Moderação e Reports - Sistema de moderação e reports
• Admin e Observabilidade - Administração e observabilidade do sistema
• Logs e Monitoramento - Arquitetura 📊 ⭐ - Documentação completa sobre logs e monitoramento considerando arquitetura monolito e evolução para multicluster, incluindo interface web para produção
• Monitoramento - Dashboards e alertas configurados
• Métricas - Lista completa de métricas coletadas
• Troubleshooting - Soluções para problemas comuns
• Runbook - Runbook de operações
• Rastreabilidade - Rastreabilidade de requisitos e funcionalidades
• System Config, Work Queue e Evidências - Configurações globais, fila genérica e evidências documentais (P0)
• API - Lógica de Negócio e Usabilidade - Documento índice (reorganizado em 22 subdocumentos - ver índice completo)
• Chat: documentado em 60_API_LÓGICA_NEGÓCIO.md (seção "Chat") e no DevPortal/OpenAPI (backend/Arah.Api/wwwroot/devportal/openapi.json)
• Mídias em Conteúdo - Documentação completa da integração de mídias em Posts, Eventos, Marketplace e Chat
• Sistema de Mídia - Documentação técnica do sistema de mídia (armazenamento, processamento, APIs)
• Planejamento: Preferências de Usuário - Planejamento completo da funcionalidade de preferências de privacidade e configurações do usuário

Documentação técnica das fases de implementação: Instalador, Modularização, BFF e Frontend.

• Índice de Documentação Técnica ⭐ - Índice completo de todas as fases técnicas
• Instalador Visual 🛠️ - Sistema de instalação e configuração visual (15 passos, Monolito/Multi-Cluster, módulos, feature flags)
• Modularização 🧩 - Arquitetura modular e organização por domínios (15 módulos, feature flags, dependências)

Documentação da API BFF que expõe operações em forma de jornadas (user journeys), criando uma camada de abstração entre interfaces visuais e o backend.

• Avaliação BFF - Documento Completo ⭐ - Avaliação estratégica completa da criação do BFF com análise de viabilidade, arquitetura e implementação
• Avaliação BFF - Resumo Executivo 📋 - Resumo executivo para decisão rápida sobre implementação do BFF
• Contrato OpenAPI BFF 📄 - Contrato OpenAPI 3.0.3 completo com todos os endpoints, schemas e exemplos
• Resumo de Contratos BFF 📝 - Referência rápida dos contratos e endpoints principais
• Guia de Implementação Frontend 💻 - Guia completo para implementação do frontend com exemplos práticos
• Exemplo Flutter Completo 📱 - Exemplo completo e funcional em Flutter/Dart com modelos, serviços e widgets
• Quick Start Flutter 🚀 - Exemplo mínimo para começar rapidamente com Flutter
• Coleção Postman 🧪 - Coleção completa do Postman com todos os endpoints prontos para teste
• Ambientes Postman ⚙️ - Ambientes Postman (Production, Staging, Local) pré-configurados
• Guia de Uso Postman 📖 - Guia completo de uso da coleção Postman

Documentos sobre segurança, configuração e implementação de medidas de segurança.

• Configuração de Segurança - Guia completo de configuração de segurança (JWT, Rate Limiting, CORS, HTTPS)
• Security Audit e Penetration Testing - Checklist de segurança e guia de penetration testing
• Fase 1: Implementação de Segurança - Resumo da implementação da Fase 1 (Segurança Crítica)
• Fase 5: Segurança Avançada - Resumo da implementação da Fase 5 (2FA, Sanitização, CSRF, Secrets Management, Security Headers, Auditoria)

Documentos sobre histórico e mudanças do projeto.

• Changelog - Histórico de mudanças e versões (documento unificado)
• Onboarding Público 🌟 - Página pública de entrada para conhecer o projeto e escolher seu caminho
• Cartilha Completa 📘 - Guia detalhado para todos os papéis no projeto
• Onboarding para Desenvolvedores 🌱 - Guia completo para novos desenvolvedores usando Cursor
• Onboarding para Analistas Funcionais 👁️ - Guia para analistas funcionais que observam territórios e propõem melhorias
• FAQ - Perguntas Frequentes ❓ - Respostas para dúvidas comuns sobre onboarding e contribuição
• Sistema de Mentoria 🤝 - Guia para mentores e quem busca orientação
• Priorização de Propostas 📊 - Critérios e processo para validar funcionalidades
• Estrutura do Projeto 📁 - Guia para navegar o código
• Estratégia de Consolidação do Ecossistema 🌱 - Plano estratégico completo
• Checklist de Implementação ✅ - Checklist detalhado da estratégia
• Configuração do Discord 💬 - Guia para configurar e usar o Discord do time
• Contribuindo - Guia para contribuidores

Documentos de planejamento e recomendações de implementação.

• Backlog API - Backlog completo da API com fases organizadas estrategicamente (número de fases calculado dinamicamente - ver PROJECT_PHASES_CONFIG.md)
• Status das Fases - Status detalhado das fases (número calculado dinamicamente - ver PROJECT_PHASES_CONFIG.md)
• Recomendações de Segurança - Recomendações de segurança e próximos passos
• Plano de Refatoração - Recomendações Pendentes - Plano de implementação de recomendações pendentes
• Planejamento: Preferências de Usuário - Planejamento completo da funcionalidade de preferências de privacidade e configurações do usuário

Documentos de estratégia de convergência de mercado e análise comparativa.

• Mapa de Funcionalidades - Mercado 📊 ⭐⭐⭐ - Mapeamento completo de funcionalidades implementadas, planejadas e previstas para atingir níveis de mercado, comparação com Closer.earth e plataformas líderes
• Estratégia de Convergência de Mercado 🎯 ⭐⭐⭐ - Plano estratégico completo de convergência com padrões de mercado, análise competitiva, roadmap de adequação e mudanças organizacionais

Produto e Funcionalidades:

• Visão do Produto → 01_PRODUCT_VISION.md
• User Stories → 04_USER_STORIES.md
• Roadmap → 02_ROADMAP.md
• Mapa de Funcionalidades → 38_MAPA_FUNCIONALIDADES_MERCADO.md
• Estratégia de Convergência → 39_ESTRATEGIA_CONVERGENCIA_MERCADO.md

Arquitetura:

• Decisões Arquiteturais → 10_ARCHITECTURE_DECISIONS.md
• Arquitetura de Services → 11_ARCHITECTURE_SERVICES.md
• Modelo de Domínio → 12_DOMAIN_MODEL.md

Fases Técnicas:

• Índice de Documentação Técnica → TECNICO_INDEX.md
• Instalador Visual → TECNICO_INSTALADOR_VISUAL.md
• Modularização → TECNICO_MODULARIZACAO.md
• Backend for Frontend (BFF) → AVALIACAO_BFF_BACKEND_FOR_FRONTEND.md
• Frontend Flutter → 24_FLUTTER_FRONTEND_PLAN.md

Desenvolvimento:

• Plano de Implementação → 20_IMPLEMENTATION_PLAN.md
• Revisão de Código → 21_CODE_REVIEW.md
• Análise de Coesão → 22_COHESION_AND_TESTS.md
• Planejamento do Frontend Flutter → 24_FLUTTER_FRONTEND_PLAN.md

Operações:

• Moderação → 30_MODERATION.md
• Observabilidade → 31_ADMIN_OBSERVABILITY.md
• Logs e Monitoramento → LOGS_MONITORAMENTO_ARQUITETURA.md
• Monitoramento → MONITORING.md
• Métricas → METRICS.md
• Troubleshooting → TROUBLESHOOTING.md
• Runbook → RUNBOOK.md
• API BFF → AVALIACAO_BFF_BACKEND_FOR_FRONTEND.md
• Contrato BFF → BFF_API_CONTRACT.yaml
• Exemplo Flutter → BFF_FLUTTER_EXAMPLE.md

Todos os arquivos na raiz seguem o padrão:

• NN_NOME_DESCRITIVO.md onde NN é um número sequencial para ordenação
• Nomes em inglês para consistência
• Hífens substituídos por underscores para melhor ordenação
• Categorias por prefixo numérico:
• 00-09: Índices e guias
• 10-19: Arquitetura e Design
• 20-29: Desenvolvimento e Implementação
• 30-39: Operações, Governança e Estratégia
• 40-49: Histórico e Mudanças
• 50-59: Produção e Deploy
• 60-69: API e Funcionalidades
• TECNICO_*: Fases Técnicas (Instalador, Modularização, BFF, Frontend)

Documentos adicionais são organizados em pastas:

• refactoring/ - Documentação de refatorações realizadas
• validation/ - Validações técnicas (REST, segurança, estrutura)
• recommendations/ - Recomendações e planos futuros
• analysis/ - Análises técnicas do projeto
• prs/ - Documentação detalhada de Pull Requests

• Avaliação Estratégica: Documentação completa da avaliação e proposta de implementação do BFF
• Contratos OpenAPI: Contrato OpenAPI 3.0.3 completo com todos os endpoints de jornadas
• Guias de Implementação: Guias completos para frontend (Flutter) com exemplos práticos
• Ferramentas de Teste: Coleção Postman completa com ambientes pré-configurados
• Desenvolvimento Paralelo: Documentação permite desenvolvimento paralelo do frontend enquanto backend é implementado
• Ver detalhes em: Avaliação BFF | Contrato OpenAPI | Exemplo Flutter

• Análise Comparativa: Análise profunda do Closer.earth e padrões de mercado estabelecidos
• Novas Fases Estratégicas: 15 novas fases identificadas (Fase 30 documentada + Fases 31-44 conceituais) para convergência com padrões de investimento
• Priorização Atualizada: Reorganização completa de prioridades baseada em gaps críticos vs. mercado
• Roadmap Revisado: Roadmap estratégico reorganizado em 9 ondas com foco em valor entregue
• Mapa de Funcionalidades: Mapeamento completo de funcionalidades implementadas, planejadas e previstas
• Ver detalhes em: Estratégia de Convergência de Mercado | Mapa de Funcionalidades

• Fase 30: Proof of Sweat (Tradicional) - Sistema de registro de atividades territoriais
• Fase 31: Dashboard de Métricas Comunitárias - Transparência e visualização de impacto
• Fase 32: Subscriptions & Recurring Payments - Sustentabilidade financeira
• Fase 33: Ticketing para Eventos - Monetização de eventos
• Fases 34-37: Preparação Web3 - Blockchain, wallets, smart contracts
• Fases 38-40: DAO e Tokenização - Tokens on-chain, governança tokenizada
• Fases 41-44: Diferenciação - Learning Hub, Rental System, Agente IA

• SystemAdmin implícito: SystemAdmin tem todas as MembershipCapabilities em todos os territórios
• Operações de configuração: GrantAsync/RevokeAsync implementados com auditoria completa
• Auditoria completa: Todos os eventos de grant/revoke são registrados
• Invalidação automática de cache: Via eventos de domínio
• Ver detalhes em: Hierarquia de Permissões

• Reorganização de Domínio: Criada pasta Membership/ em Domain
• UserTerritory removido: Substituído por TerritoryMembership
• SystemPermission: Permissões globais (Admin, SystemOperator) separadas de roles territoriais
• AuthProvider: Renomeado de Provider para AuthProvider no User
• Renomeação listing → item: API e contratos atualizados (/api/v1/listings → /api/v1/items)
• Documentação XML: Adicionada em todas as entidades principais
• Ver detalhes em: Refatoração User-Centric