Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

203 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Version Status GitHub API



Planora

Transforme documentação em backlogs estruturados.

Planora é uma plataforma inteligente que processa documentos de requisitos via IA e gera, de forma autônoma, issues completas e sincronizadas diretamente no seu repositório GitHub — eliminando o trabalho manual entre gestores e desenvolvedores.


📖 Documentação · ✨ Funcionalidades · 🛠 Stack · 🤝 Contribuição


📋 Índice


💡 Sobre o Projeto

O mercado de tecnologia enfrenta um gap crítico: a gestão de projetos e o desenvolvimento técnico raramente se comunicam de forma automatizada. Gestores perdem horas digitando tarefas repetitivas, e desenvolvedores recebem issues incompletas ou mal descritas.

IssueForge AI resolve esse problema combinando:

  • 📄 Processamento inteligente de documentos — Analisa arquivos .txt com requisitos funcionais, não-funcionais e regras de negócio
  • 🧠 Geração automatizada de backlog — A IA converte requisitos brutos em issues com título, descrição técnica e critérios de aceitação
  • 🔗 Integração nativa com GitHub — Sincroniza tudo diretamente no repositório via API, sem copiar e colar

"O gestor deixa de ser um digitador de tarefas e passa a ser um tomador de decisão estratégica."

O problema que resolvemos

Antes Depois
Horas criando issues manualmente Issues geradas em segundos
Requisitos perdidos em documentos Backlog estruturado e rastreável
Gap entre negócio e técnico Tradução automática e precisa
Planejamento de sprint empírico Estimativas baseadas em dados
Inconsistências entre documentos Alertas proativos de integridade

✨ Funcionalidades

🔄 Automação de Ingestão de Dados

Converte arquivos .txt brutos em issues completas, contendo:

  • Título objetivo e descritivo
  • Descrição técnica detalhada
  • Critérios de aceitação padronizados (Gherkin / checklist)
  • Labels, milestones e assignees sugeridos

📅 Otimização de Planejamento

  • Estimativas de tempo total de produção baseadas na densidade do backlog
  • Sugestões automáticas de divisão de Sprints
  • Priorização inteligente de issues por complexidade e dependência

📐 Engenharia de Requisitos Autônoma

Extrai e documenta automaticamente:

  • Requisitos funcionais
  • Requisitos não-funcionais
  • Regras de negócio
  • Restrições técnicas

🔍 Monitoramento de Integridade

  • Detecção proativa de inconsistências entre documentos
  • Sugestões de melhorias de arquitetura
  • Relatórios executivos on-demand

🌉 Eliminação do Gap de Comunicação

  • Tradução automática entre necessidades de negócio e linguagem técnica
  • Issues que refletem fielmente os objetivos comerciais
  • Histórico rastreável de decisões

🛠 Stack Tecnológica

Camada Tecnologia
Back-end Java Spring Boot
IA / LLM Fine-Tuning
Integração GitHub REST API v3
Autenticação GitHub OAuth · Personal Access Token
Processamento Parsing de .txt · NLP Pipeline
Infraestrutura

Rondando o projeto

Criando chave pública e privada

# 1. Generate PKCS#8 private key 
openssl genpkey -algorithm RSA -out app.key -pkeyopt rsa_keygen_bits:2048 

# 2. Extract the public key 
openssl rsa -pubout -in app.key -out app.pub

Variáveis de ambiente

DB_PASSWORD=MinhaSenh@Segura123
DB_URL=jdbc:postgresql://localhost:5432/meu_banco
DB_USERNAME=postgres
GITHUB_CLIENT_ID=Ov23liABCDEF1234567
GITHUB_CLIENT_SECRET=a1b2c3d4e5f6789012345678901234567890abcd

🤝 Contribuindo

Contribuições são muito bem-vindas! Siga os passos abaixo:

  1. Fork o repositório
  2. Crie uma branch para sua feature:
    git checkout -b feature/minha-feature
  3. Faça seus commits com mensagens claras:
    git commit -m "feat: adiciona suporte a arquivos PDF"
  4. Envie para sua branch:
    git push origin feature/minha-feature
  5. Abra um Pull Request descrevendo suas mudanças

Por favor, leia o CONTRIBUTING.md para mais detalhes sobre nosso código de conduta e processo de revisão.

Padrão de Commits

Seguimos o Conventional Commits:

Prefixo Uso
feat: Nova funcionalidade
fix: Correção de bug
docs: Alteração na documentação
refactor: Refatoração de código
test: Adição ou correção de testes

📄 Licença

Distribuído sob a licença GNU GENERAL PUBLIC. Veja o arquivo LICENSE para mais detalhes.


📬 Contato

Dúvidas, sugestões ou problemas? Abra uma issue ou entre em contato:

  • 📧 Email: seu-email@exemplo.com
  • 🌐 LinkedIn: LinkedIn

npx cloudflared tunnel --url http://127.0.0.1:8080

About

Planora é uma plataforma de geração de backlog baseada em Inteligência Artificial que converte requisitos de projetos em issues estruturadas no GitHub, critérios de aceitação e tarefas prontas para sprint, permitindo um planejamento de software mais rápido e organizado.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages