📊 Priorização de Propostas Funcionais - Arah

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:

  1. Verificar se atende critérios obrigatórios
  2. Marcar Issue com label proposta-funcional
  3. 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:

  1. Discutir necessidade: Realmente precisa?
  2. Refinar proposta: Como melhorar?
  3. Avaliar técnica: É viável?
  4. 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:

  1. Avaliar prioridade (Alta/Média/Baixa):

    • Necessidade territorial
    • Alinhamento com roadmap
    • Viabilidade técnica
    • Capacidade do time
    • Validação
  2. Marcar Issue com label de prioridade:

    • prioridade-alta 🔴
    • prioridade-media 🟡
    • prioridade-baixa 🟢
  3. 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:

  1. Desenvolvedor escolhe Issue para trabalhar
  2. Implementa seguindo padrões do projeto
  3. Analista testa e valida se atende necessidade
  4. Ajustes se necessário
  5. 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:

  1. Discussão aberta (Discord/GitHub)
  2. Consideração de fatores (necessidade, viabilidade, capacidade)
  3. Decisão consensual (ou acordo quando não há consenso perfeito)
  4. Documentação (Issue atualizada com decisão)
  5. 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


Proposta: Temas customizáveis para territórios

Critérios:

  • ✅ Serve ao território (identidade visual)
  • ✅ Fortalece autonomia (territórios escolhem tema)
  • ⚠️ Validada (1 território mencionou interesse)
  • ✅ Documentada claramente
  • ✅ Alinha com valores
  • ❌ Tecnicamente complexa (requer mudanças significativas)
  • ❌ Não está no roadmap

Prioridade: 🟢 BAIXA - Interessante mas complexa, não crítica, pode aguardar


🚨 Casos Especiais

Proposta Não Atende Critérios Obrigatórios

Ação:

  1. Comunicar respeitosamente na Issue
  2. Explicar o que falta
  3. Oferecer ajuda para ajustar proposta
  4. Aguardar refinamento antes de arquivar

Nunca:

  • ❌ Rejeitar sem explicação
  • ❌ Ser desrespeitoso
  • ❌ Desencorajar pessoa de propor

Conflito de Prioridades

Quando: Duas propostas têm prioridade alta mas time limitado

Ação:

  1. Discutir colaborativamente (Discord/GitHub)
  2. Considerar fatores:
    • Qual tem maior impacto territorial?
    • Qual bloqueia mais coisas?
    • Qual tem maior validação?
  3. Decidir consensualmente
  4. Documentar decisão

Proposta Muito Grande

Quando: Proposta é complexa e requer muito trabalho

Ação:

  1. Dividir em partes menores
  2. Priorizar partes críticas primeiro
  3. Implementar incrementalmente
  4. Validar cada parte

📊 Acompanhamento de Prioridades

Quando: Trimestralmente ou quando necessário

O que fazer:

  1. Revisar prioridades:

    • Ainda são relevantes?
    • Validação mudou?
    • Roadmap mudou?
  2. Ajustar se necessário:

    • Mudar prioridade (Alta → Média, etc.)
    • Reavaliar viabilidade
    • Atualizar Issue
  3. Comunicar mudanças:

    • Atualizar Issue
    • Mencionar no Discord se relevante

🌍 Princípios de Priorização

Orgânico

  • Sem burocracia excessiva - processo simples
  • Flexível - pode mudar conforme necessidade
  • Colaborativo - decisões em conjunto

Consciente

  • Respeita território - necessidade territorial é base
  • Valoriza saberes - análise funcional é expertise
  • Considera capacidade - respeita limites do time

Transparente

  • Decisões documentadas - Issues atualizadas
  • Criação aberta - comunidade participa
  • Revisão periódica - prioridades podem mudar

🔗 Recursos Relacionados


Priorização no Arah é sobre servir ao território de forma consciente e orgânica.

Não é sobre:

  • ❌ Satisfazer o maior número de pessoas
  • ❌ Implementar tudo que é pedido
  • ❌ Competição entre propostas

É sobre:

  • ✅ Necessidade territorial real
  • ✅ Impacto positivo na vida local
  • ✅ Alinhamento com valores
  • ✅ Sustentabilidade e autonomia

Priorizamos com consciência, servimos ao território.


Última Atualização: 2025-01-20
Versão: 1.0

Dúvidas sobre priorização? Discuta no Discord ou crie Issue com label question!