Critérios e Processo para Validar e Priorizar Funcionalidades
Versão: 1.0 Data: 2025-01-20
🎯 Propósito
Este documento estabelece critérios claros e um processo orgânico para validar e priorizar propostas de funcionalidades no Arah, garantindo que implementações sirvam ao território e respeitem valores do projeto.
✅ Critérios de Validação
Uma Proposta Será Considerada se Atender TODOS os Critérios Obrigatórios:
Não impõe padrões externos ao território
Fortalece autonomia local, não centralização
Respeita formas locais de organização
Considera contexto territorial específico
Pergunta-chave: "Esta funcionalidade serve ao território ou o território que se adapta a ela?"
2. Fortalece Autonomia ✅ OBRIGATÓRIO
Dá controle local, não centraliza
Oferece opções, não impõe escolhas
Respeita decisões comunitárias
Não cria dependências tecnológicas desnecessárias
Pergunta-chave: "Esta funcionalidade fortalece ou enfraquece a autonomia local?"
3. Foi Validada com Comunidade ✅ OBRIGATÓRIO
Conversei com 2+ pessoas do território
Validei que é necessidade comum (não apenas minha)
Entendi contexto e características específicas
Considerei diferentes perspectivas
Pergunta-chave: "Outras pessoas do território também precisam disso?"
4. Está Documentada Claramente ✅ OBRIGATÓRIO
Necessidade observada está descrita
Proposta funcional está clara
Benefícios são explicados
Exemplos do território são fornecidos
Pergunta-chave: "Outra pessoa consegue entender a proposta lendo a Issue?"
5. Alinha com Valores do Projeto ✅ OBRIGATÓRIO
Respeita território como referência
Valoriza autonomia territorial
Serve à vida, não a captura de atenção
Descoloniza padrões digitais
Pergunta-chave: "Esta funcionalidade alinha com os valores do Arah?"
6. É Tecnicamente Viável (Quando Aplicável) ✅ OBRIGATÓRIO
Desenvolvedores avaliaram viabilidade
Não requer mudanças arquiteturais grandes
Pode ser implementado com recursos disponíveis
Alinha com roadmap (29 fases)
Pergunta-chave: "Podemos implementar isso com o que temos?"
📊 Critérios de Priorização
Uma Proposta Será Priorizada se Tiver:
1. Necessidade Territorial Crítica
Impacto direto na organização comunitária
Resolve problema que impede uso da plataforma
Necessidade compartilhada por múltiplos territórios
2. Alinhamento com Roadmap Crítico
Está nas fases 9-11 (MVP Essencial) ou 13-14 (Comunicação)
Bloqueia outras funcionalidades importantes
É pré-requisito para funcionalidades críticas
3. Viabilidade Técnica Alta
Implementação relativamente simples
Usa padrões e infraestrutura existente
Time tem capacidade disponível
4. Validação Forte
Validada com 3+ territórios
Necessidade urgente relatada
Comprovação de impacto positivo
1. Necessidade Territorial Importante
Melhora significativa na experiência
Facilita processos comunitários
Impacta múltiplas pessoas
2. Alinhamento com Roadmap
Está nas 29 fases planejadas
Não bloqueia outras funcionalidades
Pode ser implementada em paralelo
3. Viabilidade Técnica Média
Requer algum trabalho técnico
Pode precisar de ajustes na arquitetura
Time tem capacidade, mas demanda tempo
4. Validação Moderada
Validada com 1-2 territórios
Necessidade importante, mas não urgente
Potencial de impacto positivo
1. Necessidade Territorial Desejável
Melhoria incremental
"Seria bom ter"
Impacto menor ou específico
2. Alinhamento Parcial com Roadmap
Não está explicitamente nas 29 fases
Não bloqueia nada
Pode ser implementada quando houver tempo
3. Viabilidade Técnica Baixa
Requer trabalho técnico significativo
Pode precisar de mudanças arquiteturais
Time limitado ou complexo
4. Validação Inicial
Validada com 1 território
Necessidade interessante, mas não comprovada
Potencial ainda não verificado
🔄 Processo de Priorização
Quando: Proposta é criada (Issue no GitHub)
Quem:
Analista funcional (criador da proposta)
Comunidade (validação no Discord/GitHub)
O que fazer:
Verificar se atende critérios obrigatórios
Marcar Issue com label proposta-funcional
Adicionar informações de validação
Critérios:
Critérios obrigatórios atendidos?
Documentada claramente?
Validada com comunidade?
Resultado:
✅ Se sim: Vai para Passo 2
❌ Se não: Proposta é ajustada ou arquivada
Quando: Proposta validada inicialmente
Onde:
GitHub Issue (comentários)
Discord (#propostas-funcionais)
Quem:
Criador da proposta
Comunidade interessada
Desenvolvedores (avaliação técnica)
O que fazer:
Discutir necessidade: Realmente precisa?
Refinar proposta: Como melhorar?
Avaliar técnica: É viável?
Considerar alternativas: Há forma mais simples?
Duração: 1-2 semanas (orgânico, sem pressa)
Resultado:
✅ Proposta refinada e aprovada → Passo 3
❌ Proposta não atende critérios → Arquivada ou ajustada
Quando: Proposta refinada e aprovada
Quem:
Comunidade (discussão)
Time disponível (capacidade)
Coordenadores (se necessário, sem hierarquia rígida)
O que fazer:
Avaliar prioridade (Alta/Média/Baixa):
Necessidade territorial
Alinhamento com roadmap
Viabilidade técnica
Capacidade do time
Validação
Marcar Issue com label de prioridade:
prioridade-alta 🔴
prioridade-media 🟡
prioridade-baixa 🟢
Adicionar ao backlog (se aplicável)
Critérios de Prioridade:
Usar matriz Necessidade vs Viabilidade
Considerar capacidade do time
Respeitar roadmap estratégico
Resultado: Prioridade definida
Quando: Proposta priorizada e time disponível
Quem:
Desenvolvedores (implementação)
Analista funcional (validação)
O que fazer:
Desenvolvedor escolhe Issue para trabalhar
Implementa seguindo padrões do projeto
Analista testa e valida se atende necessidade
Ajustes se necessário
Merge e deploy
Validação:
Implementação atende necessidade observada?
Funciona como esperado no território?
Alinha com valores do projeto?
📊 Matriz de Priorização
Viabilidade Baixa
Viabilidade Média
Viabilidade Alta
Necessidade Crítica
🟡 Média (reavaliar técnica)
🔴 Alta
🔴 Alta
Necessidade Importante
🟢 Baixa
🟡 Média
🔴 Alta
Necessidade Desejável
🟢 Baixa
🟢 Baixa
🟡 Média
Nota: Necessidade Crítica + Viabilidade Baixa pode ser reavaliada para melhorar viabilidade técnica.
🎯 Fatores Adicionais de Priorização
1. Dependências
Alta Prioridade se:
Bloqueia outras funcionalidades importantes
É pré-requisito para roadmap crítico
Média Prioridade se:
Facilita outras funcionalidades
Não bloqueia nada
Baixa Prioridade se:
Independente
Não afeta roadmap
2. Capacidade do Time
Considerar:
Quantas pessoas disponíveis?
Qual expertise necessária?
Quanto tempo levará?
Outras prioridades no momento?
Ajustar:
Se time limitado: Priorizar Alta apenas
Se time disponível: Considerar Média também
Baixa: Implementar quando houver tempo extra
3. Validação Territorial
Alta Prioridade se:
Validada com 3+ territórios
Múltiplos territórios precisam
Média Prioridade se:
Validada com 2 territórios
Necessidade importante mas específica
Baixa Prioridade se:
Validada com 1 território
Necessidade interessante mas não comprovada
4. Alinhamento com Roadmap
Alta Prioridade se:
Está nas Fases 9-11 ou 13-14 (críticas)
Bloqueia funcionalidades do roadmap
Média Prioridade se:
Está nas 29 fases planejadas
Alinha com roadmap mas não é crítica
Baixa Prioridade se:
Não está explicitamente no roadmap
Não bloqueia roadmap
🔄 Processo Orgânico de Decisão
Princípios:
Discussão colaborativa - não decisão unilateral
Consenso, não voto - preferir acordo sobre maioria
Transparência - decisões documentadas
Revisão - prioridades podem mudar
Processo:
Discussão aberta (Discord/GitHub)
Consideração de fatores (necessidade, viabilidade, capacidade)
Decisão consensual (ou acordo quando não há consenso perfeito)
Documentação (Issue atualizada com decisão)
Revisão (prioridades podem mudar conforme necessidade)
Sem hierarquias rígidas - decisões são orgânicas e colaborativas.
📝 Checklist de Validação
Antes de criar Issue:
Observei necessidade no território
Conversei com 2+ pessoas do território
Validei que é problema comum
Documentei necessidade claramente
Pensei em proposta funcional
Verifiquei alinhamento com valores
Ao criar Issue:
Usei template de "Proposta Funcional"
Preenchi todos os campos
Incluí exemplos do território
Expliquei benefícios
Marquei label proposta-funcional
Para Comunidade (Validador)
Ao avaliar proposta:
Li proposta completamente
Entendi necessidade territorial
Avaliei se serve ao território
Verifiquei alinhamento com valores
Comentei na Issue (se tiver feedback)
Para Desenvolvedores (Avaliador Técnico)
Ao avaliar proposta:
Entendi necessidade territorial
Avaliei viabilidade técnica
Considerei impacto arquitetural
Estimei esforço necessário
Comentei na Issue (se tiver feedback técnico)
🎯 Exemplos de Priorização
Proposta: Sistema de alertas territoriais
Critérios:
✅ Serve ao território (comunicação importante)
✅ Fortalece autonomia (comunidades controlam alertas)
✅ Validada (3 territórios precisam)
✅ Documentada claramente
✅ Alinha com valores
✅ Tecnicamente viável
✅ Está no roadmap (Fase 14)
Prioridade: 🔴 ALTA - Impacto crítico, viabilidade alta, roadmap crítico
Proposta: Tags para produtos orgânicos no marketplace
Critérios:
✅ Serve ao território (facilita economia local)
✅ Fortalece autonomia (vendedores escolhem tags)
✅ Validada (2 territórios manifestaram interesse)
✅ Documentada claramente
✅ Alinha com valores
✅ Tecnicamente viável (simples)
⚠️ Não está explicitamente no roadmap
Prioridade: 🟡 MÉDIA - Importante mas não crítica, pode ser implementada em paralelo