RAD - Automation

"Sério, chega de abrir o portal toda hora!"

Você está em qualquer lugar do computador, quer registrar sua RAD e... lá vai você abrir o navegador, logar no portal, procurar qual foi a última atividade, navegar até a tela de preenchimento (aquela chata)... 😴

Esqueça isso! Com este bot, basta rodar o comando e pronto! Ele te mostra sua última atividade logo de cara, você digita o que fez e BOOM: ele abre o navegador, loga sozinho, vai direto pra URL certa e preenche tudo pra você (com formatação bonitinha e tudo mais).

Simples, rápido e sem dor de cabeça. 🚀

O que é isso?

O RAD - Automation é um bot desenvolvido em Python que utiliza a biblioteca Playwright para automatizar completamente o processo de registro de atividades diárias no Redmine. Ele foi criado para eliminar a fricção de navegar por múltiplas telas e preencher formulários repetitivos.

---

Funcionalidades Principais

• ⚡ Zero Fricção: Inicie o registro de atividades com um duplo clique ou um comando no terminal.
• 🌐 Multi-Navegador: Detecta e utiliza automaticamente seu navegador preferido (Brave, Google Chrome ou Microsoft Edge).
• 🔐 Segurança em Primeiro Lugar: Suas credenciais são criptografadas localmente. Nada é enviado para servidores externos.
• 🤖 Automação Inteligente:
  • Verifica se o navegador já está aberto para não interromper seu fluxo.
  • Realiza login automático (se necessário).
  • Navega diretamente para a tela de nova tarefa.
• 📝 Preenchimento Automático:
  • Preenche Título, Situação ("Em aprovação"), Data e Campos Personalizados.
  • Formata a descrição das atividades automaticamente usando sintaxe Textile (h3. Projeto + * lista).
• 🧠 Memória de Contexto:
  • Lembrou do GPD e Projetos que você usou por último? O bot lembra.
  • Autocomplete Inteligente para agilizar a seleção.
  • Exibe um resumo da sua última execução logo na tela inicial.
• ⚙️ Configuração Simples: Assistente passo-a-passo na primeira execução. Nada de editar arquivos .env na mão.

---

Como Começar

Pré-requisitos

Apenas dois requisitos básicos:

1. Python 3.8+ instalado (Importante: Marque a opção "Add Python to PATH" durante a instalação).
2. Um navegador moderno instalado (Brave, Chrome ou Edge).

Instalação e Uso (Modo Rápido)

Esqueça comandos complexos.

1. Baixe a pasta do projeto.
2. Dê um duplo clique no arquivo iniciar_bot.bat.

O script fará toda a mágica:

• Verifica o Python.
• Cria o ambiente virtual.
• Instala as dependências.
• Inicia o bot.

---

Como Funciona

1. Primeira Execução (Setup)

Na primeira vez, o bot te guiará por uma configuração rápida. Você só precisa responder:

1. Qual navegador usar?
2. Qual a URL do Redmine?
3. Suas credenciais (Usuário/Senha).
4. Seu nome completo (para o título da issue).

Dica: Errou algo? Mudou a senha? Pressione ALT+F1 a qualquer momento na tela inicial para reconfigurar.

2. Uso Diário

Ao iniciar o bot, você verá:

• Um resumo do que você registrou na última vez (para refrescar a memória).
• Um prompt pedindo o GPD Responsável.
• Um loop para adicionar Projetos e Atividades.

Você pode adicionar quantos projetos e atividades quiser. Quando terminar, basta dar Enter em um campo vazio.

3. O "BOOM" (Automação)

Depois de coletar os dados, o bot assume o controle:

1. Abre o navegador.
2. Loga no Redmine.
3. Preenche todos os campos.
4. Formata a descrição perfeitamente.
5. Pausa para você revisar.

Na tela acima, você revisa se está tudo certo e clica em "Salvar". O bot não envia sem sua confirmação visual.

Resultado Final

---

Comandos e Atalhos Úteis

• [↑] / [↓]: Navegar nos menus.
• [Enter]: Confirmar seleção.
• [Ctrl+C]: Cancelar/Sair (funciona em quase qualquer lugar).
• [ALT+F1]: Reconfiguração de Emergência (apaga as configs salvas e inicia o setup novamente).

---

Para Desenvolvedores (Instalação Manual)

Se você quiser contribuir ou prefere ter controle total:

# 1. Clone/Entre na pasta
cd rad-automation

# 2. Crie e ative o venv
python -m venv venv
.\venv\Scripts\activate  # Windows

# 3. Instale dependências
pip install -r requirements.txt
playwright install chromium

# 4. Rode
python main.py

Versionamento e Release

O projeto usa Conventional Commits para versionamento semântico automático. Para gerar uma nova versão:

python release.py

Isso analisa os commits, atualiza o VERSION, gera a tag git e faz o push.

---

Solução de Problemas

• O navegador abre e fecha rápido?
  • Verifique se não há outra instância do navegador "travada" em segundo plano.
• Erro de Login?
  • Sua senha pode ter expirado. Use ALT+F1 para atualizar.
• Logs de Erro:
  • Verifique o arquivo rad_errors.log na raiz do projeto para detalhes técnicos de qualquer falha.

---

RAD - Automation | Simplificando a burocracia, um dia de cada vez.