PHPackages argus-cs/redmine-message - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. argus-cs/redmine-message ActiveLibrary[Utility & Helpers](/categories/utility) argus-cs/redmine-message ======================== Pacote Laravel para enviar mensagens ao Redmine. 0.1.1(6mo ago)02MITPHPPHP ^8.0 Since Oct 31Pushed 6mo agoCompare [ Source](https://github.com/argus-cs/gen-redmine-message)[ Packagist](https://packagist.org/packages/argus-cs/redmine-message)[ RSS](/packages/argus-cs-redmine-message/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)Dependencies (6)Versions (4)Used By (0) Redmine Message Generator ========================= [](#redmine-message-generator) Pacote Laravel para auxiliar na criação e envio de mensagens para tarefas no Redmine, com geração de texto via Gemini usando o diff do Git e diretrizes personalizadas. Recursos -------- [](#recursos) - Command interativo `gen:redmine-message` que: - Busca detalhes da tarefa no Redmine (assunto, descrição e comentários anteriores); - Coleta o `git diff` (por padrão, `--staged`; você pode informar um sufixo/range via argumento); - Carrega um arquivo de diretrizes (guideline) para formatar a mensagem; - Gera o texto via API do Gemini; - Opcionalmente envia a mensagem como nota para a tarefa no Redmine. - Cliente HTTP para Redmine (`ArgusCS\RedmineMessage\Services\RedmineClient`). - Cliente para executar comandos Git (`ArgusCS\RedmineMessage\Services\GitClient`). - Cliente para integração com o Gemini (`ArgusCS\RedmineMessage\Services\GeminiClient`). - Publicação de config em `config/messages.php`. > Nota: A Facade `RedmineMessage` existe, mas atualmente não há binding registrado para o accessor `messages`. Portanto, o uso via Facade pode não funcionar até o binding ser ajustado. Requisitos ---------- [](#requisitos) - PHP ^8.0 - Laravel 10 ou 11 - symfony/process ^5.4 | ^6.0 | ^7.0 Instalação ---------- [](#instalação) Instale via Composer: ``` composer require argus-cs/redmine-message ``` Durante desenvolvimento local (path repository), adicione ao `composer.json` do seu app: ``` { "repositories": [ { "type": "path", "url": "../laravel/redmine-message", "options": { "symlink": true } } ] } ``` E então: ``` composer require argus-cs/redmine-message:dev-main ``` Este pacote possui auto-discovery: o `ArgusCS\\RedmineMessage\\RedmineMessageServiceProvider` é registrado automaticamente. Publicar e configurar --------------------- [](#publicar-e-configurar) Publique o arquivo de configuração: ``` php artisan vendor:publish --tag=messages ``` Isso criará `config/messages.php` no seu app. Configure as variáveis de ambiente conforme abaixo: ``` # Gemini GEMINI_URL="https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-pro:generateContent" # exemplo GEMINI_API_KEY="sua_chave_gemini" # Redmine REDMINE_URL="https://redmine.seudominio.com" REDMINE_API_KEY="sua_chave_redmine" REDMINE_GUIDELINE="/caminho/para/guideline.md" # arquivo com diretrizes para formatação ``` > Notas: > > - As chaves de configuração residem em `config/messages.php` e são mescladas sob a key `messages`. > - A tag de publicação é `messages`. Uso --- [](#uso) ### 1) Via Command (recomendado) [](#1-via-command-recomendado) ``` php artisan gen:redmine-message ``` Argumento opcional: `diff` - O comando aceita um argumento opcional `diff` para personalizar o sufixo/range passado ao `git diff`. - Se omitido, será usado `--staged`. Exemplos: ``` # Padrão (usa --staged) php artisan gen:redmine-message # Usando um sufixo alternativo php artisan gen:redmine-message "--cached" # Usando um range específico php artisan gen:redmine-message "HEAD~1..HEAD" # Diff de um arquivo específico php artisan gen:redmine-message "README.md" ``` Fluxo do comando: 1. Solicita o número do ticket do Redmine; 2. Busca detalhes da tarefa no Redmine (incluindo journals/comentários); 3. Mostra os detalhes e pede confirmação para continuar; 4. Coleta o `git diff` usando o sufixo/range informado no argumento (ou `--staged` por padrão); se estiver vazio, o processo é interrompido; 5. Lê o arquivo de guideline indicado em `REDMINE_GUIDELINE`; 6. Monta um prompt contendo: diff, guideline, ticket, detalhes da tarefa, comentários anteriores e nome da branch; 7. Envia o prompt para o Gemini e exibe a mensagem gerada; 8. Pergunta se deseja enviar a mensagem como nota na tarefa do Redmine; se sim, envia via API. > Dica: use `git add` para preparar (staged) as alterações que deseja considerar no diff antes de executar o comando. ### 2) Uso programático (clientes de serviço) [](#2-uso-programático-clientes-de-serviço) - Buscar detalhes de uma tarefa: ``` use ArgusCS\RedmineMessage\Services\RedmineClient; $redmine = new RedmineClient(); $task = $redmine->task('12345', 'issue'); // retorna a chave 'issue' do JSON ``` - Adicionar uma nota em uma tarefa: ``` $redmine->addTaskNote('12345', "Mensagem gerada automaticamente..."); ``` - Obter diff e branch via Git: ``` use ArgusCS\RedmineMessage\Services\GitClient; $git = new GitClient(); $diff = $git->diff(); // por padrão '--staged' $branch = trim($git->nameBranch()); ``` - Gerar conteúdo via Gemini: ``` use ArgusCS\RedmineMessage\Services\GeminiClient; $gemini = new GeminiClient(); $response = $gemini->generate($prompt); $text = $response->json('candidates.0.content.parts.0.text'); ``` Como funciona (arquitetura) --------------------------- [](#como-funciona-arquitetura) - `RedmineMessageServiceProvider`: - Faz merge da config `config/messages.php` para a key `messages`; - Publica a config via tag `messages`; - Registra o comando `gen:redmine-message` quando em console. - `GenMessage` (Command): orquestra a interação com Redmine, Git e Gemini, permite injeção de dependências (DI) para `RedmineClient`, `GitClient` e `GeminiClient` e oferece a opção de enviar a nota para o Redmine. - `RedmineClient`: - GET `REDMINE_URL/issues/{ticket}.json?include=journals` para buscar tarefa; - PUT `REDMINE_URL/issues/{ticket}.json` com body `{ issue: { notes: "..." } }` para adicionar nota. - `GeminiClient`: POST para `GEMINI_URL` com header `x-goog-api-key` e payload esperado pelo endpoint `generateContent`. - `GitClient`: executa processos locais `git diff` e `git rev-parse`. Testes ------ [](#testes) ``` composer install vendor/bin/phpunit ``` - Há testes de unidade para `RedmineClient` e testes E2E para o comando `gen:redmine-message`. - Os testes E2E usam DI para substituir `GitClient` e `GeminiClient` por fakes e `Http::fake()` para simular chamadas externas. Troubleshooting --------------- [](#troubleshooting) - Mensagem: "Sem alterações encontradas." — certifique-se de ter arquivos staged (`git add ...`). - Erro ao ler guideline — verifique se `REDMINE_GUIDELINE` aponta para um arquivo existente e acessível. - Erro ao conectar no Gemini — confirme `GEMINI_URL` e `GEMINI_API_KEY` e se o endpoint usado é compatível (ex.: `generateContent`). - Erro ao conectar no Redmine — confirme `REDMINE_URL` e `REDMINE_API_KEY` e se o usuário possui permissão para adicionar notas. Roadmap / Itens para avaliação ------------------------------ [](#roadmap--itens-para-avaliação) - Registrar binding para a Facade `RedmineMessage` (accessor `messages`). - Remover import não utilizado no ServiceProvider (ex.: `SendRedmineMessage`). - Padronizar nomes e chaves de config sob `messages`. - Tratar timeouts/retries nas chamadas HTTP (Gemini e Redmine) e permitir configurar. - Opcional: permitir escolher o projeto do Redmine e outros campos no envio da nota. Licença ------- [](#licença) Distribuído sob a licença MIT. Consulte o arquivo `LICENSE`. ### Health Score 28 — LowBetter than 54% of packages Maintenance68 Regular maintenance activity Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity32 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~7 days Total 2 Last Release 184d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/1ae22029928a9eb88980a8c2a7f855eeff9c1df8346e6059e6f41e440d83b92c?d=identicon)[argus-cs](/maintainers/argus-cs) --- Top Contributors [![argus-cs](https://avatars.githubusercontent.com/u/8759877?v=4)](https://github.com/argus-cs "argus-cs (27 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/argus-cs-redmine-message/health.svg) ``` [![Health](https://phpackages.com/badges/argus-cs-redmine-message/health.svg)](https://phpackages.com/packages/argus-cs-redmine-message) ``` ### Alternatives [barryvdh/laravel-ide-helper Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion. 14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[wnx/laravel-stats Get insights about your Laravel Project 1.8k1.8M7](/packages/wnx-laravel-stats)[spatie/laravel-enum Laravel Enum support 3655.4M31](/packages/spatie-laravel-enum)[orchestra/canvas Code Generators for Laravel Applications and Packages 21017.2M157](/packages/orchestra-canvas)[spatie/laravel-export Create a static site bundle from a Laravel app 646127.9k5](/packages/spatie-laravel-export)[laragear/preload Effortlessly make a Preload script for your Laravel application. 119363.5k](/packages/laragear-preload) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)