Vlink - ERP para Cooperativas de Vivienda (Synapse)

Proyecto Final de Egreso Escuela Superior de Informática Buceo (UTU) - Clase 3°MA

Vlink es un sistema de Gestión Integral (ERP) diseñado para Cooperativas de Vivienda de Ayuda Mutua en Uruguay. Esta solución completa abarca desde el despliegue automatizado de infraestructura hasta la gestión diaria de socios y horas de ayuda mutua.

Equipo "Synapse"

• Ezequiel Revello - Infraestructura Linux y Frontend.
• Kimberly Acosta - Backend (Gestión de Viviendas y Administración), Traducciones.
• Camila Luzardo - Backend (Consultas de Datos y Peticiones), Traducciones.
• Alexandre Oliveri - Diseño de Base de Datos y Modelos Relacionales.

---

Funcionalidades Principales

Módulos de Gestión (Web)

• Gestión de Padrón Social: Altas, bajas y seguimiento de socios.
• Control de Ayuda Mutua: Registro transparente de horas trabajadas (Crítico para cooperativas en obra).
• Finanzas: Control de aportes y gastos comunes.
• Comunicación: Cartelera digital y notificaciones centralizadas.

Infraestructura (SRE Focus)

• Despliegue Automatizado: Script install_server.sh que configura un servidor Rocky Linux 8 desde cero (Zero-to-Prod).
• CLI de Administración: Herramienta interactiva admin_menu.sh para gestionar usuarios, servicios y logs sin tocar comandos complejos.
• Backup Strategy: Política de respaldo automatizada (Diaria, 3:00 AM) con retención de 14 días.
• Seguridad: Configuración automática de firewalld (Puertos SSH, HTTP, HTTPS) y usuarios aislados.

---

Stack Tecnológico

Capa	Tecnología	Detalles
OS	Rocky Linux 8	Servidor Base Enterprise Linux
Contenedores	Docker & Compose	Orquestación de servicios
Base de Datos	MySQL 8.0	Persistencia de datos (Volumen Dockerizado)
Backend	PHP 8.2	Imagen oficial php:8.2-apache
Scripting	Bash	Automatización de tareas y mantenimiento

---

Instalación y Despliegue

Este proyecto incluye un script de autoprovisionamiento. Siguiendo estos pasos en un servidor limpio (Rocky Linux 8 recomendado) tendrás el entorno listo en minutos:

1. Prerrequisitos

• Usuario con permisos sudo.
• Conexión a Internet.
• Configuración de red estática previa.

2. Despliegue Rápido (Quick Start)

# 1. Clonar el repositorio
git clone [https://github.com/Synapse-S-A-S/Vlink.git](https://github.com/Synapse-S-A-S/Vlink.git)
cd Vlink

# 2. Dar permisos de ejecución al instalador
chmod +x install_server.sh

# 3. Ejecutar el despliegue automático
./install_server.sh
El script "install_server.sh" configurará todo el entorno y aplicará los grupos de Docker.

3. Iniciar la Aplicación

cd /home/admin/Vlink
docker compose up -d --build

---

Política de Respaldo y Recuperación (Disaster Recovery)

El sistema implementa una política de backups automatizada mediante Crontab:

• Base de Datos: Dump completo (mysqldump) diario a las 03:00 AM.

• Filesystem: Compresión (tar.gz) del código fuente diario a las 03:05 AM.

• Retención: Los respaldos se almacenan localmente en el volumen seguro /backups/ con una política de rotación de 14 días.

---

Desarrollado para la Escuela Superior de Informática (ESI Buceo) - 2025