DOC-04: Configuração Funcional e Personalização
Versión: 1.0 Alcance: Configuración de la aplicación Redmine (Post-Despliegue).
Versão: 1.0\r\nÂmbito: Configuração da aplicação Redmine (Pós-Despliegue).
1. Acesso Inicial
Sección titulada «1. Acceso Inicial»- URL:
http://<IP-SERVER-UBUNTU>:5588 - Credenciais por defeito: admin
/ admin - Ação imediata: O sistema solicitará mudança de senha obrigatória.
2. Configuração Visual (Temas)
Sección titulada «2. Configuración Visual (Temas)»-
Baixar/Copiar o tema (ex. circle
) na pasta ~/redmine/themesdo servidor Ubuntu. -
Reiniciar o contêiner se necessário (não costuma ser para temas, mas é recomendável):
docker compose restart redmine -
Ir para Administração → Configuração → Mostrar e selecionar o tema.
3. Gestão de Plugins
Sección titulada «3. Gestión de Plugins»Para instalar plugins (Checklists, Tags, Kanban, etc.):
-
Copiar a pasta do plugin em ~/redmine/plugins
. -
É obrigatório executar a instalação de dependências e a migração da base de dados antes de iniciar o servidor Redmine. Isso pode ser feito executando os seguintes comandos:
# Instalar gemas nuevasdocker compose run --rm redmine bundle install --without development test# Migrar base de datos del plugindocker compose run --rm redmine bundle exec rake redmine:plugins:migrate RAILS_ENV=production# Precompilar assets (iconos, css, js)docker compose run --rm redmine bundle exec rake assets:precompile RAILS_ENV=production -
Reinicie o servidor Redmine executando o comando docker compose restart redmine.
4. Estrutura Organizacional (Papéis e Fluxos)
Sección titulada «4. Estructura Organizativa (Roles y Flujos)»Foram definidos 4 perfis principais para a organização:
4.1. Papéis
Sección titulada «4.1. Roles»- IT (Admin): Acesso total. Visibilidade global.
- Gestor de Projeto: Controle total dentro do seu projeto atribuído (Membros, Versões, Gantt).
- Colaborador: Gestão operativa de tarefas (Mudança de estados, atribuição de tempos), sem acesso a configuração do projeto.
- Empregado: Somente criação de tickets próprios e comentários. Visibilidade restrita a "Meus pedidos".
4.2. Fluxos de Trabalho (Workflows)
Sección titulada «4.2. Flujos de Trabajo (Workflows)»- A matriz de transições é configurada para impedir que papéis inferiores (Funcionário) fechem tickets diretamente.
- A visibilidade dos campos (Somente leitura / Obrigatório) é configurada de acordo com o status (ex. “Motivo de rejeição” obrigatório ao rejeitar).
4.3. Configuração de E-mail
Sección titulada «4.3. Configuración de Correo»- Verifique na Administração → Configuração → Notificações.
- Remetente: Deve coincidir com [email protegido]. (Configurado em DOC-02).
- Prueba: Usar o botão "Enviar e-mail de teste" para um usuário com e-mail válido (não example.com).
5. Checklist de Validação Funcional
Sección titulada «5. Checklist de Validación Funcional»- Integridade de e-mail: Validação de envio de notificações por meio de remetente unificado e autenticação SMTP correta.
- Segurança de papéis: Fluxos de trabalho restringidos de forma que os papéis inferiores não possam alterar estados críticos ou fechar tickets.
- Personalização: Temas visuais e plugins carregados e migrados corretamente na base de dados sem erros de ativos.

