# Centro Integrado de Gestión Social

Aplicación Laravel privada, multiusuario y responsive para gestionar las responsabilidades sociales de Rotaract Maracaibo, Rotary Maracaibo y Payasos Humanitarios Maracaibo.

## Alcance incluido

- Centro de Control personal multi-organización.
- Organizaciones con branding configurable y módulos activables.
- Proyectos, fases, tareas y subtareas, asignación colaborativa y vencimientos.
- Agenda y arquitectura de integración individual con Google Calendar.
- Rotaract: Secretaría/Cumplimiento 4380, Membresía, Imagen Pública y Tesorería.
- Tesorería Rotaract: cuotas, deuda, morosidad, pagos, validación, recibos PDF, solvencias y finanzas por proyecto.
- Rotary y Payasos: proyectos, tareas/subtareas, calendario, recordatorios y colaboración entre usuarios; sin módulos administrativos/financieros por defecto.
- Login privado, rate limiting, sesiones cifradas, 2FA TOTP, security headers y auditoría preparada.
- Instalador CLI que intenta crear la base de datos cuando el usuario SQL tiene permisos.

## Instalación rápida

1. Lea `PREINSTALACION.docx` antes de subir el sistema.
2. Configure el document root del dominio/subdominio hacia `public/`.
3. Ejecute `./install.sh` o `php installer/install.php` desde SSH.
4. Configure cron: `* * * * * cd /ruta/app && php artisan schedule:run >/dev/null 2>&1`
5. Configure un worker persistente para colas o Supervisor/systemd.

## Seguridad

Producción exige HTTPS, `APP_DEBUG=false`, una cuenta DB de mínimos privilegios, 2FA para administradores, backups fuera del servidor y actualizaciones periódicas. Ningún software conectado a Internet puede garantizar invulnerabilidad absoluta; este proyecto usa defensa por capas y debe acompañarse de hardening del hosting.

## Referencias incluidas

`docs/references/` contiene las guías suministradas por el usuario para Secretaría Distrito 4380 e Imagen Pública Rotaract. `docs/mockups/` contiene los diseños responsive aprobados como referencia visual.
