Araponga Logo

Wiki Araponga

Documentação Completa

Analistas Funcionais

Você chegou aqui porque observa o território e entende que tecnologia pode servir às necessidades reais das comunidades.

Este documento é para você que:

  • Conhece seu território e identifica necessidades práticas
  • Observa como pessoas se relacionam com o lugar onde vivem
  • Quer propor melhorias baseadas em necessidades reais
  • Entende processos e fluxos de organização comunitária
  • Acredita que tecnologia deve servir ao território, não o contrário

Não precisa ser desenvolvedor ou técnico. Se você observa seu território e identifica necessidades, está no lugar certo.

O que é Análise Funcional?

Análise funcional é o processo de:

  1. Observar como pessoas usam (ou precisariam usar) uma aplicação
  2. Identificar necessidades e problemas
  3. Descrever funcionalidades que atendem essas necessidades
  4. Propor melhorias de negócio

No Contexto do Arah

Analisar funcionalidades significa:

  • Entender como o território realmente funciona
  • Identificar o que a comunidade precisa digitalmente
  • Propor funcionalidades que servem à vida local
  • Garantir que tecnologia respeita autonomia territorial

Como Começar?

O primeiro passo é observar:

  • Como pessoas se comunicam no território hoje?
  • Que informações circulam e como?
  • Quais problemas de organização existem?
  • Como decisões comunitárias são tomadas?
  • O que funciona bem? O que não funciona?

Exemplo prático:

"Vejo que na minha comunidade temos dificuldade para organizar mutirões. Pessoas querem participar mas não sabem quando são, onde são, ou o que precisam levar. Seria útil ter um sistema para organizar isso."

Identificar Padrões

Observe:

  • Problemas que se repetem
  • Necessidades compartilhadas por várias pessoas
  • Fluxos que poderiam ser mais eficientes
  • Informações que circulam de forma precária

Entender o Contexto

Considere:

  • Características específicas do território
  • Cultura local e formas de organização
  • Limitações e recursos disponíveis
  • O que já funciona bem e deve ser preservado

Propondo Funcionalidades

1. Descreva o Problema

Formato sugerido:

  • O que acontece hoje?
  • Onde acontece? (território específico)
  • Quem é afetado?
  • Por que é um problema?
  • Como isso afeta a vida no território?

2. Proponha uma Solução Funcional

Descreva:

  • O que a funcionalidade faria?
  • Como funcionaria?
  • Quem usaria?
  • Quando seria útil?
  • Por que resolveria o problema?

3. Pense em Requisitos de Negócio

Considere:

  • Regras de negócio: Quem pode fazer o quê?
  • Visibilidade: Público ou apenas para moradores?
  • Notificações: Como pessoas saberiam?
  • Integração: Como se conecta com outras funcionalidades?

Ferramentas para Análise Funcional

User Stories (Histórias de Usuário)

Formato simples:

Como [tipo de usuário],
eu quero [ação/funcionalidade],
para que [benefício/motivo].

Exemplo:

Como morador do território,
eu quero criar eventos comunitários no app,
para que outras pessoas possam saber e participar.

Casos de Uso

Descreva cenários:

  • Cenário normal: O que acontece quando tudo funciona bem
  • Cenários alternativos: O que acontece em situações especiais
  • Cenários de erro: O que acontece quando algo dá errado

Valores na Análise Funcional

Tecnologia Decolonizadora

Quando você propõe funcionalidades:

  • ✅ Considere como isso serve às comunidades
  • ✅ Respeite formas locais de organização
  • ✅ Valorize saberes territoriais
  • ❌ Evite impor soluções externas sem entender contexto

Autonomia Territorial

Quando você analisa necessidades:

  • ✅ Priorize controle local sobre centralização
  • ✅ Dê opções, não imponha escolhas
  • ✅ Respeite decisões comunitárias
  • ❌ Evite criar dependências tecnológicas

Digital ao Serviço do Social

Quando você observa o território:

  • ✅ Pense em facilitar o que já existe
  • ✅ Conecte pessoas e lugares
  • ✅ Fortaleça vínculos territoriais
  • ❌ Evite substituir relações presenciais

Documentando Propostas

## Proposta: [Nome da Funcionalidade]

### Contexto Territorial
- **Território**: [Nome do território]
- **Necessidade observada**: [Descrição do problema/necessidade]
- **Quem é afetado**: [Pessoas impactadas]

### Proposta Funcional

#### O que faz
[Descrição clara e simples do que a funcionalidade faria]

#### Como funciona
[Passo a passo do fluxo de uso]

#### Regras de Negócio
- [Regra 1]
- [Regra 2]

#### Integrações
[Como se conecta com outras funcionalidades do Arah]

### Benefícios
- [Benefício 1 para o território]
- [Benefício 2 para a comunidade]

Onde Documentar

  1. GitHub Issues: Crie uma issue descrevendo a proposta
  2. Discussions: Use Discussions para debater funcionalidades
  3. Documentos: Propostas complexas podem virar documentos em docs/

Analisando o Arah

Funcionalidades Existentes

Feed Comunitário

  • Linha do tempo de posts do território
  • Comunicação, compartilhamento de informações, organização

Marketplace

  • Produtos e serviços do território
  • Economia local, trocas territoriais

Eventos

  • Organização de eventos comunitários
  • Mutirões, festas, reuniões

Chat Territorial

  • Comunicação entre pessoas do território
  • Canais e grupos por território
  1. Use a funcionalidade ou observe alguém usando
  2. Identifique o que funciona bem - preservar é importante
  3. Identifique o que pode melhorar - baseado em necessidade real
  4. Proponha solução funcional - não precisa saber código
  5. Documente a proposta - use template acima
  6. Compartilhe com comunidade - valide necessidade
  7. Crie Issue no GitHub - desenvolvedores podem implementar

Para detalhes técnicos sobre como explorar a API e interagir com o Arah usando comandos e exemplos práticos, consulte o guia técnico completo no DevPortal:

👉 Onboarding para Analistas Funcionais - DevPortal

O guia técnico inclui:

  • Passo a passo detalhado de configuração do ambiente
  • Exemplos práticos de requisições/respostas da API (curl)
  • Exercícios de análise funcional usando a API
  • Guia para documentar propostas de melhoria
  • Template completo de Issue no GitHub

Recursos e Referências

Documentação do Projeto

Para Propor Melhorias

  • GitHub Issues - Crie issues para propor funcionalidades
  • GitHub Discussions - Participe de discussões

Bem-vindo como Analista Funcional do Arah.

Aqui, análise funcional vem do território, não de escritórios distantes.

Aqui, sua observação guia o desenvolvimento.

Aqui, saberes territoriais são reconhecidos como expertise.

Observe. Documente. Proponha. Valide. Contribua.

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

Perguntas? Abra uma Issue, participe de Discussions ou consulte o guia técnico completo no DevPortal!

← Voltar às Boas-VindasVer Todos os Docs →