msip - Motor para Sistemas de Información estilo Pasos de Jesús

Motor Ruby on Rails que proporciona una base segura y actualizada para desarrollar sistemas de información. Incluye componentes estándar, interfaces automatizadas y mejores prácticas de seguridad.

🚀 Características Principales

📊 Vistas Automatizadas

• Administración automática de modelos: Generación de vistas y controladores sin código adicional
• Filtros y paginación: Listados con filtros configurables y paginación con will_paginate
• Interfaz adaptable: Diseño responsive con Bootstrap y Stimulus
• Componentes modernos: tom-select para selecciones, controles nativos para fechas

🏗️ Componentes Preconstruidos

• Geolocalización: Países, departamentos, municipios y centros poblados
  • Datos completos para Colombia, Venezuela y Honduras
  • Mapas SVG de departamentos y municipios de Colombia
  • Validaciones geográficas y jerarquías territoriales
• Gestión de Personas: Personas, documentos, y relaciones entre personas
  • Validaciones de documentos por país
  • Sistema de familiares y relaciones
  • Etiquetado para categorización flexible
• Organizaciones: Grupos, organizaciones sociales y sectores
  • Gestión de grupos con personas asociadas
  • Roles y cargos organizacionales
• Sistema de archivos: Anexos con almacenamiento seguro

🔐 Seguridad y Control de Acceso

• Autenticación: Integración con Devise y bcrypt
• Autorización flexible: Sistema de roles y grupos con Cancancan
• Respaldos seguros: Exportación cifrada y comprimida con 7z

📊 Calidad y Confiabilidad

• Cobertura de pruebas minitest a modelos, controladores y helpers: Superior al 70%
• Pruebas End-to-End con Puppeteer: Optimizadas para OpenBSD 7.7+
• CI/CD robusto: GitHub Actions y GitLab CI

🛠️ Desarrollo y Configuración

• Configuración centralizada: Variables de ambiente con .env y dotenv
• Migraciones automáticas: Inclusión automática de migraciones de motores
• Tareas Rake: Utilidades para mantenimiento de base de datos
• Pruebas robustas: Suite de pruebas con Minitest

📋 Requisitos

Consultalos en requisitos del sistema.

🏁 Comenzar Rápido

Aplicación de Demostración

msip incluye una aplicación completa en test/dummy que puedes ejecutar inmediatamente:

# Crea un usuario y base de datos en PostgreSQL
# Clona el repositorio
git clone https://gitlab.com/pasosdeJesus/msip.git
cd msip

# Configura y ejecuta la aplicación de prueba
bundle install
cd test/dummy
cp .env.plantilla .env
# Edita .env y pon base de datos y usuario
rails db:setup
rails server

Sigue la guía completa de la aplicación de prueba para más detalles.

Crear un Nuevo Proyecto

Consulta instrucciones detalladas en la guía completa de nuevas aplicaciones.

📚 Documentación

• Guías de uso: Documentación principal
• Vistas automáticas: Configuración y uso
• Actualizaciones: Wiki del proyecto
• Historial de publicaciones: Versiones y publicaciones

🐛 Reportar Problemas y Contribuir

Encontraste un error?

Abre un nuevo issue con:

• Una descripción clara del problema
• Pasos para reproducirlo
• Versiones relevantes (Ruby, Rails, MSIP)

¿Quieres contribuir?

Consulta nuestras guías de contribución para:

• Reportar bugs
• Sugerir nuevas características
• Enviar pull requests

🔄 Mantenimiento y Actualizaciones

msip se mantiene actualizado mediante:

• Publicación de nuevas versiones más o menos cada 3 meses
• Actualizaciones semestrales al sistema base (distribución adJ) en sincronía con OpenBSD
• Gemas actualizadas semanalmente para garantizar seguridad y funcionalidad
• Pruebas continuas via GitHub Actions y Linux via GitLab CI
• Pruebas end-to-end automatizadas con Puppeteer en OpenBSD
• Actualización periódica de datos geográficos según DIVIPOLA colombiano