EVENTUAL v1.0

Sistema para la gestión integral de eventos sociales del Club de Suboficiales.

---

Tabla de Contenidos

• Descripción
• Características
• Arquitectura
• Tecnologías
• Estructura del Proyecto
• Instalación
• Ejecución
• Pruebas
• Documentación
• Estado del Proyecto
• Autores
• Licencia

---

Descripción

EVENTUAL es un sistema cliente-servidor desarrollado para administrar el ciclo de vida completo de eventos sociales organizados por el Club de Suboficiales.

El sistema permite administrar desde la propuesta inicial del evento hasta su cierre, incluyendo la gestión de participantes, proveedores, presupuesto, gastos, aportes económicos y generación de reportes.

El proyecto fue desarrollado utilizando Flutter para el frontend, Node.js con Express para el backend y PostgreSQL mediante Supabase como sistema gestor de base de datos.

---

Características

• Gestión de miembros
• Gestión de roles
• Gestión de eventos
• Propuesta de eventos
• Aprobación y planificación
• Registro de proveedores
• Gestión de cotizaciones
• Confirmación de asistencia
• Registro de asistencia
• Administración de gastos
• Registro de aportes económicos
• Notificaciones
• Reportes estadísticos
• Autenticación mediante JWT
• Arquitectura Cliente-Servidor
• API REST

---

Arquitectura

Flutter
      │
 HTTP REST
      │
Node.js + Express
      │
Supabase
      │
PostgreSQL

La aplicación sigue una arquitectura cliente-servidor basada en servicios REST.

El frontend consume la API desarrollada en Express mediante peticiones HTTP autenticadas utilizando JWT.

---

Tecnologías

Frontend

• Flutter
• Dart
• flutter_bloc
• get_it
• http
• shared_preferences

Backend

• Node.js
• Express
• Supabase
• JWT
• bcrypt
• express-validator

Base de datos

• PostgreSQL
• Supabase

Testing

• Jest
• Supertest
• bloc_test
• mocktail

---

Estructura del Proyecto

EVENTUAL/

│
├── backend/
│
├── frontend/
│
├── database/
│
├── docs/
│
├── images/
│
└── README.md

---

Instalación

Clonar repositorio

git clone https://github.com/usuario/EVENTUAL.git

Backend

cd backend

npm install

Crear archivo

.env

SUPABASE_URL=

SUPABASE_SERVICE_KEY=

JWT_SECRET=

PORT=3000

Ejecutar

npm run dev

---

Frontend

cd frontend

flutter pub get

flutter run

---

Ejecutar pruebas

Backend

npm test

Frontend

flutter test

---

Estado del Proyecto

Versión actual

v1.0

Estado

• Implementado
• 13 requisitos funcionales
• 137 pruebas exitosas
• 100% de pruebas aprobadas

---

Roadmap

v1.1

• Mejoras en interfaz
• Optimización de rendimiento

v2.0

• Aplicación Web
• Dashboard Administrativo
• Integración con QR
• Notificaciones Push

---

Contribuciones

Las contribuciones son bienvenidas mediante Pull Requests.

Para cambios importantes, abra primero un Issue para discutir la propuesta.

---

Licencia

Este proyecto fue desarrollado con fines académicos.

Todos los derechos reservados © 2026.