Construa a democracia
participativa conosco
A Parlamentaria é um projeto open-source, apartidário e da comunidade. Existem muitas formas de participar — desenvolvedores, ONGs, pesquisadores, patrocinadores e cidadãos.
Desenvolvedores
Python, FastAPI, IA, bots, DevOps — contribua com código, testes, reviews. Stack moderna com Google ADK, Celery, SQLAlchemy async e mais.
- ✓Clone o repositório e rode testes em minutos
- ✓591+ testes, 94% de cobertura — base sólida para contribuir
- ✓Issues etiquetadas com 'good first issue' para começar
Voluntários e Ativistas
Teste o bot, reporte bugs, sugira melhorias, traduza conteúdo, ajude na curadoria de análises legislativas.
- ✓Use o bot e dê feedback sobre a experiência
- ✓Ajude a validar análises de proposições
- ✓Sugira melhorias na linguagem e acessibilidade
ONGs e Institutos
Organizações da sociedade civil podem integrar a Parlamentaria em programas de educação cívica, engajamento político e controle social.
- ✓API aberta para integração com seus sistemas
- ✓Dados de votação popular para pesquisa e advocacy
- ✓Parceria para alcançar comunidades vulneráveis
Universidades e Pesquisadores
Pesquisadores podem usar os dados abertos, contribuir com NLP em português e estudar democracia digital e participativa.
- ✓Dados estruturados da API Câmara + votação popular
- ✓NLP em português: análise de textos legislativos
- ✓Estudos sobre democracia participativa digital
Patrocinadores e Apoiadores
Órgãos públicos, fundações, entidades e empresas que acreditam em transparência legislativa podem patrocinar o desenvolvimento.
- ✓Custeio de infraestrutura (servidores, APIs de IA)
- ✓Financiamento de features específicas (WhatsApp, Senado)
- ✓Apoio à manutenção e operação contínua
Cidadãos
A contribuição mais poderosa é usar e compartilhar. Quanto mais gente participa, mais forte fica a voz popular.
- ✓Use o bot e vote nas proposições
- ✓Compartilhe com amigos, família e colegas
- ✓Quanto mais vozes, mais representativo o resultado
Áreas que precisam de contribuição
O core está construído (8 fases, 591+ testes). Essas são as áreas de expansão e refinamento abertas para a comunidade.
Homologação do adapter com a API real da Meta
Senado Federal
Expandir para API do Senado, novos agentes
Testes E2E
Testes end-to-end com agentes reais
CI/CD
GitHub Actions completo, deploy automatizado
Documentação
Guias, tradução para inglês, onboarding
Auditoria e LGPD
Logs de auditoria, compliance e privacidade
Acessibilidade
Áudio, linguagem simples, inclusão digital
Performance
Queries SQL, cache Redis avançado, paginação
Como contribuir com código
Leia o AGENTS.md
O guia completo do projeto — arquitetura, padrões, convenções, estrutura de diretórios.
Escolha uma issue
Procure por labels "good first issue" ou "help wanted" no GitHub. Se tiver uma ideia nova, abra uma discussion.
Fork + Branch
Crie uma branch seguindo a convenção: feat/, fix/, docs/. Exemplo: feat/senado-integration.
Implemente com testes
Todo código novo deve vir com testes. Meta: manter cobertura ≥75%. Módulos críticos: ≥85%.
Abra um PR
Descreva o que fez, referencie a issue. Commits no padrão Conventional Commits (feat:, fix:, docs:).
Quick start
git clone https://github.com/glauberportella/parlamentaria.git cd parlamentaria/backend python -m venv .venv && source .venv/bin/activate pip install -e ".[dev]" pytest tests/ -v --cov=app
Quer patrocinar ou
apoiar institucionalmente?
Órgãos da União, fundações, entidades de classe e empresas podem apoiar a Parlamentaria financeiramente ou com recursos técnicos. Todo patrocínio é público e transparente.