DOC-04: Configuración Funcional y Personalización
Versión: 1.0 Alcance: Configuración de la aplicación Redmine (Post-Despliegue).
0lecturas
Versión: 1.0 Alcance: Configuración de la aplicación Redmine (Post-Despliegue).
1. Acceso Inicial
Sección titulada «1. Acceso Inicial»- URL:
http://<IP-SERVER-UBUNTU>:5588 - Credenciales por defecto:
admin/admin - Acción inmediata: El sistema solicitará cambio de contraseña obligatorio.
2. Configuración Visual (Temas)
Sección titulada «2. Configuración Visual (Temas)»-
Descargar/Copiar el tema (ej.
circle) en la carpeta~/redmine/themesdel servidor Ubuntu. -
Reiniciar el contenedor si es necesario (no suele serlo para temas, pero sí recomendable):
docker compose restart redmine -
Ir a Administración → Configuración → Mostrar y seleccionar el tema.
3. Gestión de Plugins
Sección titulada «3. Gestión de Plugins»Para instalar plugins (Checklists, Tags, Kanban, etc.):
-
Copiar la carpeta del plugin en
~/redmine/plugins. -
MANDATORIO: Ejecutar instalación de dependencias y migración de base de datos:
# 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 -
Reiniciar servicio:
docker compose restart redmine.
4. Estructura Organizativa (Roles y Flujos)
Sección titulada «4. Estructura Organizativa (Roles y Flujos)»Se han definido 4 perfiles clave para la organización:
4.1. Roles
Sección titulada «4.1. Roles»- IT (Admin): Acceso total. Visibilidad global.
- Gestor de Proyecto: Control total dentro de su proyecto asignado (Miembros, versiones, Gantt).
- Colaborador: Gestión operativa de tareas (Cambio de estados, asignar tiempos), sin acceso a configuración de proyecto.
- Empleado: Solo creación de tickets propios y comentarios. Visibilidad restringida a “Mis peticiones”.
4.2. Flujos de Trabajo (Workflows)
Sección titulada «4.2. Flujos de Trabajo (Workflows)»- Se configura la matriz de transiciones para impedir que roles bajos (Empleado) cierren tickets directamente.
- Se configura la visibilidad de campos (Sólo lectura / Obligatorio) según el estado (ej. “Motivo de rechazo” obligatorio al rechazar).
4.3. Configuración de Correo
Sección titulada «4.3. Configuración de Correo»- Verificar en Administración → Configuración → Notificaciones.
- Remitente: Debe coincidir con
portel_user@portelcore.local(Configurado en DOC-02). - Prueba: Usar el botón “Enviar correo de prueba” hacia un usuario con email válido (no example.com).
5. Checklist de Validación Funcional
Sección titulada «5. Checklist de Validación Funcional»- ✓ Integridad de Correo: Validación de envío de notificaciones mediante remitente unificado y autenticación SMTP correcta.
- ✓ Seguridad de Roles: Workflows restringidos de forma que los roles inferiores no puedan alterar estados críticos ni cerrar tickets.
- ✓ Personalización: Temas visuales y plugins cargados y migrados correctamente en la base de datos sin errores de assets.

