Asoges

Gestión Integral y Documental de Asociaciones

Asoges es una plataforma web desarrollada para centralizar y modernizar la gestión administrativa de asociaciones y clubes. Su objetivo es sustituir la dispersión de hojas de cálculo y documentos físicos por un sistema unificado que garantice la trazabilidad y la transparencia.

La aplicación permite la gestión coordinada de cinco libros esenciales (Socios, Actas, Documentación, Contabilidad e Inventario) bajo una arquitectura multiasociación, permitiendo que una única instancia gobierne varias entidades con aislamiento de datos.

Origen del Proyecto

Este desarrollo tiene su origen en el Trabajo de Final de Grado (TFG) del Grado de Ingeniería Informática.

La memoria completa del proyecto, que incluye el análisis, diseño y detalles de implementación, se encuentra alojada en el repositorio institucional O2 de la UOC: Consultar Memoria del Proyecto

Características Principales

El sistema cubre el siguiente alcance funcional:

• Libro de Socios: Gestión de altas, bajas y modificaciones con histórico de participación.
• Libro de Actas: Almacenamiento de actas en PDF con repositorio histórico y búsquedas avanzadas.
• Registro Documental: Control de entrada y salida de documentación oficial con trazabilidad.
• Libro de Contabilidad: Registro de ingresos y gastos, con generación de informes y exportación.
• Libro de Inventario: Control del patrimonio material de la asociación.
• Multitenancy: Gestión de múltiples asociaciones con roles y permisos diferenciados (Superadministrador, Presidente, Secretario, Tesorero).
• Exportación: Capacidad de exportar datos a Excel para auditorías o informes externos.

Stack Tecnológico

El proyecto está construido sobre un stack moderno y robusto:

• Backend Framework: Laravel 12.19.3
• Panel Administrativo: Filament
• Lenguaje: PHP 8.4.8
• Base de Datos: MySQL 8.0.42

Instalación y Despliegue

Sigue estos pasos para levantar el proyecto en tu entorno local:

1. Clonar el repositorio:

   git clone https://github.com/domingoruiz/asoges.git
   cd asoges

2. Configurar variables de entorno:

   cp .env.example .env
   # Configura tus credenciales de base de datos en el archivo .env

3. Instalar dependencias:

   composer update

4. Ejecutar migraciones y seeders: Para una instalación limpia con datos de prueba:

   php artisan migrate:fresh --seed

Seguridad

Este proyecto no ofrece garantías de seguridad ni soporte oficial ante incidentes, tal y como se detalla en la licencia de uso. Sin embargo, estamos comprometidos con la integridad del software:

• Reporte de fallos: Si encuentras una vulnerabilidad, por favor comunícala de forma privada.
• Exención de responsabilidad: El uso de esta herramienta es responsabilidad exclusiva del usuario.
• Auditoría: Se recomienda ejecutar composer audit regularmente.

Puedes leer el documento completo en nuestra Política de Seguridad.

Licencia

Este proyecto está sujeto a una licencia Reconocimiento-CompartirIgual 3.0 España de Creative Commons (CC BY-SA 3.0 ES). Consulte el archivo LICENSE para obtener más detalles.

Desarrollo

Aplicación desarrollada por Domingo Ruiz Arroyo <ordenadordomi@gmail.com>