Sistema de Gestión Digital de Socios

Documentación Técnica del Proyecto · Versión 1.2 · Agosto 2026

ClienteCentro Molisano Monforte · Villa Bosch

MateriaEvaluación de Proyectos

DocenteProf. Pedaci, Lourdes

Ciclo7mo Informática 2026 · Instituto Leonardo Murialdo

1Control de Cambios

Registro de las modificaciones realizadas sobre la documentación y el alcance del proyecto, con fecha, responsable y detalle del cambio.

Versión	Fecha	Autor	Descripción del cambio
1.0	08/2026	Laborde Santiago	Versión inicial. Propósito, alcance, personal involucrado, definiciones, referencias y resumen ejecutivo del sistema.
1.1	08/2026	Laborde Santiago	Incorporación de la sección 3, Descripción General. Reorganización de la primera sección bajo el apartado 2, Introducción, y alta del presente registro de control de cambios.
1.2	08/2026	Laborde Santiago	Actualización del monto acordado del proyecto. Corrección de la duración de la sesión de usuario y de la dirección de acceso al sistema.
1.3	09/2026	Laborde Santiago	Corrección de fechas: entrega definitiva = septiembre 2026, cierre formal = 2/11/2026. Diferenciación de roles (backend / frontend). Hipervínculo a la Carta Gantt. Eliminación de partners . Reclasificación de RF-21 a prioridad Media. Incorporación del Gantt real con datos de etapas.
1.4	09/2026	Laborde Santiago	Agregado de sección 3.4.8 Credibilidad de la aplicación y renumeración de 3.4.9 Seguridad. Incorporación de sección 2.2.11 con exclusiones explícitas del alcance. Anotación de URL de desarrollo. Separación de referencias bibliográficas (APA 7) y documentos internos del proyecto. Incorporación de captura de la Carta Gantt.

2Introducción

Esta sección establece el propósito del documento, delimita el alcance del sistema, identifica a las personas y organizaciones involucradas, define la terminología empleada, consigna las referencias utilizadas y ofrece un resumen ejecutivo del proyecto.

2.1 Propósito

Este documento describe el sistema de gestión digital desarrollado para el Centro Molisano Monforte, estableciendo sus funcionalidades, alcance, usuarios involucrados y lineamientos generales del proyecto.

El sistema fue concebido para modernizar la administración del club, centralizando en una única plataforma web todas las operaciones que hasta ahora se realizaban de forma manual o a través de distintas herramientas no integradas: gestión de socios, cobro de cuotas, mensajería interna, reservas de espacios y comunicación institucional.

El objetivo principal es que tanto la Comisión Directiva como los socios del club cuenten con una herramienta accesible, intuitiva y confiable desde cualquier dispositivo (celular, tablet o computadora), sin necesidad de instalar ninguna aplicación.

2.2 Alcance

El sistema abarca las siguientes áreas funcionales:

2.2.1 Módulo de acceso y autenticación

Ingreso mediante DNI y contraseña encriptada con bcrypt
Sesiones seguras con token de autenticación, vigencia de 30 días renovable
Restauración automática de sesión al recargar la página
Dos perfiles: Socio y Comisión Directiva
Protección contra fuerza bruta (bloqueo tras 10 intentos fallidos por IP)

2.2.2 Carnet digital del socio

Datos personales y estado de cuota del mes en curso
Código QR de control de acceso y verificación de beneficios
Historial de pagos y cambio de contraseña desde el carnet

2.2.3 Panel de administración (Comisión Directiva)

Indicadores clave en tiempo real: socios activos, estado de cuotas, ingresos del mes
Acceso centralizado a todos los módulos de gestión
Contador de solicitudes de nuevos socios pendientes

2.2.4 Base de socios

Listado completo con semáforo de estado de cuota
Buscador y filtros (al día, pendiente (del 1 al 10 del mes), debe 1, moroso (2+) y dados de baja)
Ficha completa con historial de cuotas; alta, edición, baja y eliminación
Reseteo de contraseña

2.2.5 Finanzas y cuotas

Indicadores financieros del mes con comparativa al mes anterior
Gráficos de ingresos (últimos 6 meses) y estado de cuotas
Registro de cobros y de otros ingresos (alquileres, eventos, donaciones)
Generación automática de cuotas al inicio de cada mes

2.2.6 Sistema de reservas

Solicitud de espacios del club por parte de los socios
Verificación de disponibilidad en tiempo real
Flujo de aprobación por la Comisión con definición de seña
Registro automático de la seña en el módulo de finanzas

2.2.7 Mensajería interna

Envío de comunicados a todos los socios, socios al día, socios con deuda o un destinatario particular
Bandeja de entrada con indicador de mensajes no leídos
Notificaciones automáticas del sistema (reservas, solicitudes)

2.2.8 Contenido institucional

Secciones de noticias, eventos, beneficios y encuestas
Calendario de eventos con mini calendario mensual interactivo
Edición de contenido desde la Comisión Directiva con subida de imágenes

2.2.9 Solicitudes de nuevos socios

Formulario público en la ante-página del club
Panel de gestión con pestañas pendientes / aceptadas / rechazadas
Notificación por correo al postulante al resolver
Posibilidad de reconsiderar solicitudes rechazadas
Alta automática del socio al aceptar, dentro de una transacción de base de datos

2.2.10 Ante-página pública

Presentación institucional del club (historia, servicios, beneficios)
Carga dinámica de beneficios vigentes desde la base de datos
Formulario de solicitud de asociación

2.2.11 Qué no incluye esta versión

El alcance de la versión actual excluye explícitamente las siguientes funcionalidades:

Aplicación móvil nativa: el sistema funciona como web app en el navegador del celular. No existe una app descargable en App Store ni Google Play.
Gestión de múltiples sedes: el sistema administra una única sede. No contempla sucursales, filiales ni instituciones asociadas al Centro.
Exportación contable: no genera archivos de contabilidad en formatos como SIAP, Tango o Excel de cuentas. El historial de cobros es consultable en pantalla pero no exportable en esta versión.
Notificaciones push: los mensajes llegan a la bandeja interna del sistema. No hay notificaciones por WhatsApp, SMS ni push nativas del celular.
Gestión de cuotas extraordinarias o categorías diferenciadas: existe un único valor de cuota mensual para todos los socios activos.
Integración bancaria directa: el pago con Mercado Pago está previsto para la siguiente etapa. Por ahora, los cobros en efectivo o transferencia los registra manualmente la Comisión.

Segunda etapa — entrega septiembre 2026: integración con Mercado Pago para pago electrónico de cuotas, carga del padrón real de socios, carga de espacios físicos del club, módulo de finanzas completo y migración al hosting definitivo con dominio propio.

2.3 Personal Involucrado

Nombre	Rol	Área
Felipe Carmele	Desarrollador — Backend	PHP, base de datos, APIs REST
Damario Blas	Desarrollador — Frontend	HTML, CSS, JavaScript, interfaz de usuario
Alonso Joaquín	Desarrollador — Frontend	HTML, CSS, JavaScript, interfaz de usuario
Alonso Lautaro	Desarrollador — Base de datos	MySQL, diseño del modelo relacional, arquitectura
Laborde Santiago	Documentación y planificación	Documentación técnica y Carta Gantt

Organización	Rol en el proyecto
Centro Molisano Monforte	Cliente — Comisión Directiva
Equipo de desarrollo	Proveedor del sistema

2.4 Definiciones, acrónimos y abreviaturas

Término	Definición
Socio	Miembro registrado del Centro Molisano Monforte con acceso al sistema.
Comisión / CD	Comisión Directiva del club. Tiene acceso al panel de administración.
DNI	Documento Nacional de Identidad. Se usa como identificador de acceso.
Token	Código de sesión de 64 caracteres hexadecimales generado con `random_bytes(32)`. Vigencia de 30 días, renovable en cada acceso.
bcrypt	Algoritmo de encriptación con sal y factor de trabajo usado para almacenar contraseñas. Costo 12. Reemplaza al SHA-256 legacy de forma gradual.
SHA-256	Algoritmo de hash legacy. Se migra a bcrypt al vuelo cuando el socio inicia sesión.
KPI	Key Performance Indicator — indicador clave de rendimiento (socios al día, ingresos del mes).
QR	Quick Response — código de respuesta rápida para control de acceso y verificación de beneficios.
FNV-1a	Función de hash no criptográfico usada para generar el token del QR. Compatible con HTTP y HTTPS (sin depender de `crypto.subtle`).
API	Application Programming Interface — interfaz REST sobre HTTP que conecta el frontend con el backend.
PDO	PHP Data Objects — capa de acceso a base de datos con prepared statements. Previene inyección SQL.
PHP	Lenguaje de programación del backend. Versión 8.
MySQL	Sistema de gestión de base de datos relacional. Charset utf8mb4.
Frontend	Interfaz visual del sistema (`index.html`, ~360 KB). Sin frameworks ni compilación.
Backend	Lógica del servidor en PHP. Un archivo por módulo bajo `/api/`.
SPA	Single Page Application — la interfaz se carga una sola vez y navega sin recargar la página.
AlwaysData	Proveedor de hosting donde está alojado el sistema de prueba.

2.5 Referencias

El desarrollo se realizó sobre los requerimientos relevados con la Comisión Directiva del Centro Molisano Monforte durante el primer semestre de 2026.

Referencias bibliográficas (APA 7)

Pedaci, L. (2026). Evaluación de Proyectos — Módulo de Documentación. Instituto Técnico Leonardo Murialdo.
Universidad Tecnológica Nacional. (2012). Buenas prácticas para proyectos informáticos. edUTecNe. ISBN 978-987-1896-01-1.

Documentos internos del proyecto

Equipo 02. (2026). Carta Gantt — Equipo02_Gantt_2026. Planilla de planificación del proyecto. Disponible en: Google Sheets.
Laborde Santiago. (2026). Documentación Técnica del Proyecto — versiones 1.0, 1.1, 1.2, 1.3. Documento interno del equipo. Registro de versiones en el apartado 1 del presente documento.
Equipo 02. (2026). Minutas de reuniones con el cliente. Registros de las sesiones de relevamiento con la Comisión Directiva del Centro Molisano Monforte. [Documentos internos].

El sistema puede ser accedido en:

🌐 proyectogrupo123456.alwaysdata.net [URL de desarrollo — se actualizará con el dominio definitivo]

2.6 Resumen Ejecutivo

El Centro Molisano Monforte es una institución con más de 60 años de trayectoria en Villa Bosch, Buenos Aires, que nuclea a la comunidad molisana y sus descendientes. Con el objetivo de modernizar su gestión interna y mejorar la experiencia de sus socios, el club encargó el desarrollo de un sistema digital integral.

El sistema funciona como una aplicación web accesible desde cualquier dispositivo sin instalación previa. Cuenta con dos perfiles de usuario — socio y Comisión Directiva — cada uno con su propia vista y funcionalidades.

Primera etapa — completada

Autenticación segura con bcrypt, carnet digital con QR real, panel de administración con indicadores en tiempo real, base de socios completa, módulo de finanzas, sistema de reservas, mensajería interna, contenido institucional, solicitudes de nuevos socios con mail automático y ante-página pública.

Segunda etapa — entrega septiembre 2026

Integración con Mercado Pago, carga del padrón real, espacios físicos del club, beneficios reales, módulo de finanzas completo y migración al hosting definitivo con dominio propio.

Presupuesto

Concepto	Importe
Total acordado	$ 1.850.000
Seña abonada (30 %)	$ 555.000
Gastos de plataformas incluidos en la seña	$ 150.000
Importe a descontar del precio final	$ 405.000
Saldo contra entrega definitiva	$ 1.445.000

3Descripción General

3.1 Perspectiva del producto

El Sistema de Gestión Digital de Socios es un producto nuevo y autónomo. No constituye la versión de un sistema preexistente: hasta su puesta en marcha, la administración del Centro Molisano Monforte se realizaba mediante planillas de cálculo, registros en papel y comunicación telefónica o por mensajería personal.

El sistema se implementa como una aplicación web de arquitectura cliente-servidor en tres capas:

Presentación: interfaz de página única (index.html) que se ejecuta en el navegador del usuario.
Lógica: servicios en PHP 8 que exponen una interfaz REST sobre HTTP con respuestas JSON.
Datos: base relacional MySQL alojada en el mismo proveedor, accedida con PDO y prepared statements.

Su única integración externa prevista es con Mercado Pago. Su ausencia no impide el funcionamiento del resto de los módulos: el registro manual de cobros permanece disponible como alternativa.

3.2 Funcionalidad del producto

A alto nivel, el sistema provee las siguientes funciones:

Autenticación con DNI y contraseña, gestión de sesiones y protección contra fuerza bruta.
Emisión y consulta del carnet digital con QR de control de acceso.
Administración del padrón: alta, consulta, edición, baja y eliminación.
Gestión financiera: cobros, otros ingresos, generación automática de cuotas e indicadores.
Reservas de espacios con circuito de aprobación y registro de seña.
Mensajería interna con envío segmentado.
Publicación y edición de contenido: noticias, eventos, beneficios.
Verificación de carnet por QR, accesible sin sesión para el portero o comercio adherido.
Presentación pública del club y recepción de solicitudes de asociación.
Limpieza automática diaria de datos: sesiones expiradas, mensajes viejos, imágenes huérfanas.

3.3 Características de los usuarios

Perfil	Descripción	Acceso
Socio	Miembro del club. Nivel técnico heterogéneo — la base societaria abarca desde adultos jóvenes hasta personas mayores de 70 años. Accede mayoritariamente desde celular.	Carnet, cuotas propias, reservas, mensajes, contenido institucional.
Comisión Directiva	Integrantes del órgano de conducción. Uso semanal o diario para registrar cobros, aprobar reservas, gestionar socios y emitir comunicados.	Todo lo anterior más padrón, finanzas, solicitudes y edición de contenido.
Visitante	Persona no asociada que accede a la página pública de presentación.	Ante-página y formulario de solicitud de asociación.
Verificador	Portero o comercio adherido que escanea el QR del carnet para verificar el estado del socio y sus beneficios.	Pantalla de verificación pública (sin sesión).

3.4 Restricciones

3.4.1 Políticas reguladoras

El sistema almacena datos personales de los socios (nombre, documento, fecha de nacimiento, domicilio, teléfono, correo y situación de pago), por lo que queda alcanzado por la Ley N.° 25.326 de Protección de los Datos Personales. Los datos se recolectan con finalidad determinada y el acceso al padrón queda restringido a los integrantes de la Comisión Directiva. Las solicitudes de asociación rechazadas se eliminan automáticamente al año de su resolución.

3.4.2 Limitaciones de hardware

El sistema se ejecuta sobre un servicio de alojamiento compartido con límites de espacio en disco, memoria y tiempo de procesamiento. No se dispone de cron jobs: la limpieza automática y la generación de cuotas se disparan con el primer acceso del día.

3.4.3 Interfaces con otras aplicaciones

Mercado Pago: plataforma de cobro electrónico. Requiere Access Token de producción del club.
MySQL: accedido mediante PDO con prepared statements.
Correo saliente: PHP mail() para notificaciones de solicitudes y reservas.

3.4.4 Función de control

Toda operación distinta del acceso público exige una sesión válida. El token se verifica en el servidor. Las funciones administrativas se verifican con comisionRequired() que devuelve 403 si el perfil no es comisión.

3.4.5 Requisitos del lenguaje

Backend en PHP 8. Frontend con HTML5, CSS3 y JavaScript ES2015+ sin frameworks. Base de datos MySQL. Todos los textos se redactan en español rioplatense.

3.4.6 Protocolos

HTTPS con TLS entre el navegador y el servidor. REST sobre HTTP con JSON. Token de sesión en la cabecera X-Token. FTP cifrado para el despliegue.

3.4.7 Requisitos de fiabilidad

Las operaciones críticas (alta de socio al aceptar solicitud, eliminación de socio) se ejecutan dentro de transacciones con rollback. Si falla algo, no queda ningún registro parcial.

3.4.8 Credibilidad de la aplicación

El sistema contempla mecanismos de credibilidad en tres niveles. A nivel de disponibilidad, el servicio depende del proveedor de alojamiento AlwaysData, cuyo acuerdo de servicio garantiza una disponibilidad del 99,9 % mensual. A nivel de integridad de los datos, todas las operaciones críticas (alta de socio, eliminación, pago de cuota) se ejecutan dentro de transacciones con rollback, de modo que un fallo en cualquier paso no deja registros parciales. A nivel de trazabilidad, cada cobro registra el identificador del miembro de la Comisión que lo cargó y la fecha exacta, lo que permite auditar cualquier movimiento financiero.

3.4.9 Consideraciones de seguridad

Contraseñas almacenadas con bcrypt (cost 12). Migración gradual al vuelo desde SHA-256 legacy.
Consultas SQL exclusivamente con prepared statements. Sin interpolación de variables.
Validación MIME real en subida de imágenes (finfo + getimagesize).
CORS restringido al dominio del club.
Protección contra fuerza bruta: bloqueo de 15 minutos tras 10 intentos fallidos por IP.
Headers de seguridad: X-Content-Type-Options: nosniff, X-Frame-Options: DENY.
Token QR generado con FNV-1a (id + DNI). Compatible con HTTP y HTTPS.

3.5 Suposiciones y dependencias

El club mantiene vigente la contratación del servicio de alojamiento y del dominio.
El club provee las credenciales de producción de Mercado Pago para habilitar el cobro electrónico.
La Comisión Directiva suministra el padrón real de socios y el valor vigente de la cuota social.
Los socios disponen de un dispositivo con navegador actualizado y conexión a internet.

3.6 Evolución previsible del sistema

Corto plazo — septiembre 2026

Integración con Mercado Pago (QR dinámico + webhook de confirmación de pago).
Carga del padrón real y migración al hosting definitivo con dominio propio.
Configuración de SPF/DKIM/DMARC para que los mails no vayan a spam.

Mediano plazo

Exportación de datos financieros en planilla de cálculo.
Notificaciones por mail de vencimientos de cuota.
Inscripción a eventos y actividades del club.

Largo plazo

Aplicación móvil nativa con notificaciones instantáneas.
Gestión diferenciada de las distintas sedes e instituciones del centro.

4Requisitos Específicos

Este apartado detalla los requisitos que el sistema debe satisfacer y las interfaces por las que se relaciona con sus usuarios, el equipamiento y otros programas.

4.1 Requerimientos funcionales

La prioridad alta corresponde a funciones sin las cuales el sistema no cumple su propósito. La prioridad media, a funciones que mejoran la operación pero admiten un procedimiento alternativo.

Código	Requerimiento	Prioridad
RF-01	Autenticar al usuario mediante DNI y contraseña con protección contra fuerza bruta.	Alta
RF-02	Mantener la sesión activa 30 días y permitir cerrarla con confirmación.	Alta
RF-03	Diferenciar los perfiles de socio y Comisión Directiva con control en el servidor.	Alta
RF-04	Mostrar el carnet digital con datos del socio, estado de cuota y QR de acceso.	Alta
RF-05	Generar un código QR que apunte a la pantalla de verificación pública.	Alta
RF-06	Verificar el carnet sin sesión: nombre, estado de cuota y beneficios vigentes.	Alta
RF-07	Registrar, consultar, editar y dar de alta/baja socios en el padrón.	Alta
RF-08	Filtrar el padrón por estado de cuenta y condición de baja.	Media
RF-09	Dar de baja a un socio conservando su historial, y reactivarlo.	Alta
RF-10	Eliminar definitivamente a un socio con confirmación por número de socio.	Media
RF-11	Registrar cobros de cuota y otros ingresos.	Alta
RF-12	Generar automáticamente las cuotas del mes en curso.	Alta
RF-13	Presentar indicadores y gráficos de la situación financiera.	Media
RF-14	Gestionar reservas con circuito de aprobación y registro de seña.	Alta
RF-15	Enviar comunicados segmentados a socios y/o comisión.	Media
RF-16	Publicar y editar noticias, eventos y beneficios con subida de imágenes.	Media
RF-17	Mostrar la página pública del club sin requerir sesión.	Alta
RF-18	Recibir solicitudes de asociación y gestionarlas desde el panel de comisión.	Alta
RF-19	Notificar al postulante por correo al aceptar o rechazar su solicitud.	Alta
RF-20	Reconsiderar una solicitud rechazada y aceptarla posteriormente.	Media
RF-21	Habilitar el pago electrónico de la cuota social vía Mercado Pago.	Media
RF-22	Ejecutar limpieza automática diaria de sesiones, mensajes y datos obsoletos.	Media

RF-21 depende de que el club provea las credenciales de producción de Mercado Pago. Es el único requerimiento de prioridad alta que permanece pendiente.

4.2 Interfaces de usuario

La interfaz se resuelve como una SPA que se adapta al ancho del dispositivo. En pantallas angostas, menú lateral colapsable; en pantallas amplias, desplegado permanente. Las acciones irreversibles se confirman mediante modales propios de la app, no ventanas del navegador.

Dado que la base societaria abarca adultos mayores, se privilegió la legibilidad: tipografía amplia, contraste alto, áreas de toque generosas y pasos reducidos por tarea.

4.2.1 Diseño visual

La identidad retoma los colores institucionales del club: verde inglés #1A3D2B como color de autoridad, dorado #C9A84C para acentos y acciones principales, crema para superficies claras y rojo para alertas. Tipografías: Lora (serif, títulos) e Inter (cuerpo). La bandera italiana aparece como franja tricolor entre secciones.

Capturas de las pantallas principales del sistema accesible en proyectogrupo123456.alwaysdata.net.

Pantalla de inicio de sesión

Carnet digital del socio con código QR

4.3 Interfaces de hardware

El sistema no requiere equipamiento especial. Funciona sobre cualquier dispositivo con navegador actualizado. La cámara se usa para escanear el QR de control de acceso. El almacenamiento local del navegador conserva el token de sesión entre visitas.

4.4 Interfaces de software

Componente	Tecnología	Rol en el sistema
Frontend	HTML5 + CSS3 + JavaScript ES2015. Un único `index.html` sin frameworks.	Capa de presentación. Maneja toda la UI y llama a la API.
Backend	PHP 8. Un archivo por módulo bajo `/api/`. Respuestas JSON REST.	Lógica de negocio y validaciones.
Base de datos	MySQL vía PDO con prepared statements. utf8mb4.	Persistencia de todos los datos del club.
Autenticación	Token binario (`random_bytes(32)`) en cabecera `X-Token`.	Control de acceso stateless.
Mercado Pago	SDK oficial PHP + webhook `notificacion_mp.php`.	Cobro electrónico. Pendiente de Access Token del club.
Correo saliente	PHP `mail()` con cabeceras MIME.	Notificaciones de solicitudes y reservas.

4.5 Interfaces de comunicación

Interfaz	Protocolo	Detalle
Navegador → Servidor	HTTPS / REST (JSON)	Token en cabecera `X-Token`. CORS restringido al dominio del club.
Backend → Base de datos	TCP / MySQL (PDO)	Prepared statements. Sin interpolación de variables en SQL.
Servidor → Correo	SMTP (PHP mail)	Notificaciones de solicitudes, reservas y bienvenida al nuevo socio.
QR → Verificación	HTTPS	URL firmada con FNV-1a(id:dni). El token se valida en el servidor.
Backend → Mercado Pago	HTTPS / REST	QR dinámico + webhook IPN. Pendiente de Access Token.
Despliegue	FTP cifrado	Transferencia de archivos al servidor de AlwaysData con FileZilla.

5Oferta de Gestión

5.1 Planificación temporal (Carta Gantt)

El desarrollo se planificó en cinco iteraciones (ver carta Gantt), con 57 tareas y 346 horas estimadas. La primera etapa se ejecutó entre junio y agosto de 2026; la entrega definitiva está prevista para septiembre de 2026 y el cierre formal para el 2 de noviembre de 2026.

Inicio: 20 de abril de 2026 · Entrega definitiva: septiembre de 2026 · Cierre formal: 2 de noviembre de 2026 · Duración total: 197 días

→ Ver carta Gantt completa en Google Sheets

Etapa	Contenido	Período	Hs estimadas	Completado
Etapa 1	Definición del proyecto — análisis de mercado, entrevistas con el cliente, definición de la idea, presentación	22/4 → 8/5/2026	21	100 %
Etapa 2	Mockup — entrevistas, análisis, armado de prototipo, revisiones con el cliente, cierre de MVP y 2da presentación	16/6 → 3/7/2026	22	100 %
Etapa 3	Proyecto Alfa — entrega Beta, integración Mercado Pago, módulo de finanzas, QR de socios, entrega Alfa, correcciones y entrega final	1/8 → 2/11/2026	88	Parcial
Etapa 4	[ ___________________________ ]	—	62	5 %
Etapa 5	[ ___________________________ ]	—	59	3 %
Etapa 6	[ ___________________________ ]	—	39	3 %
Total			386

5.2 Infraestructura administrativa

Integrante	Rol	Horas	Participación
Carmele Felipe	Desarrollo backend (PHP, APIs)	143,1	41,3 %
Blas Damario	Desarrollo frontend (HTML/CSS/JS)	102,6	29,6 %
Laborde Santiago	Dirección y documentación	38,4	11,1 %
Alonso Joaquín	Desarrollo frontend (HTML/CSS/JS)	33,5	9,7 %
Alonso Lautaro	Base de datos y arquitectura (MySQL)	28,4	8,2 %
Total		346,0	100 %

La coordinación se realiza mediante reuniones periódicas y comunicación por mensajería. El vínculo con el cliente se mantiene de forma directa con la Comisión Directiva del club.

6Oferta Económica

Los importes de este apartado son estimaciones de referencia y deben confirmarse con cotización formal antes de la entrega definitiva. Los precios de plaza varían con frecuencia.

6.1 Proveedores de conectividad y alojamiento

Alojamiento web

Proveedor	Prestación	Costo mensual est.
AlwaysData	Plan compartido con PHP, MySQL, dominio y correo. Proveedor actual.	$ 12.000
Hostinger	Plan compartido equivalente con panel de administración propio.	$ 15.000
DonWeb	Plan compartido con soporte local y facturación en pesos.	$ 18.000

Conectividad de la sede

Proveedor	Servicio	Abono mensual est.
Telecentro	Fibra óptica, 300 Mb simétricos.	$ 38.000
Fibertel	Fibra óptica, 300 Mb.	$ 42.000
Movistar	Fibra óptica, 300 Mb.	$ 40.000

6.2 Proveedores de equipamiento informático

Proveedor	Equipamiento	Precio est.
Fravega	Computadora de escritorio de gama media con monitor.	$ 850.000
Garbarino	Computadora de escritorio de gama media con monitor.	$ 890.000
Compra Gamer	Equipo de configuración equivalente, armado a pedido.	$ 780.000
Fravega	Tableta de gama de acceso para el control de ingreso.	$ 320.000

6.3 Proveedores de insumos varios

Insumo	Destino	Costo anual est.
Dominio web	Dirección de acceso al sistema.	$ 25.000
Certificado de seguridad	Cifrado TLS. Incluido por el proveedor de alojamiento.	Sin costo
Credenciales impresas	Carnet físico para socios sin teléfono con cámara.	$ 60.000
Papelería y consumibles	Comprobantes y documentación administrativa.	$ 45.000

7Estimación Económica

7.1 Composición del precio

Concepto	Detalle	Importe
Desarrollo	346 horas de trabajo del equipo.	$ 1.700.000
Plataformas y herramientas	Alojamiento, dominio y servicios del período de desarrollo.	$ 150.000
Total del proyecto		$ 1.850.000

El valor hora resultante asciende a $ 4.913 ($ 1.700.000 / 346 horas).

7.2 Distribución por rol

Rol	Horas	Importe
Desarrollo backend — Carmele Felipe	143,1	$ 703.000
Desarrollo frontend — Blas Damario y Alonso Joaquín	136,1	$ 669.200
Dirección y documentación	38,4	$ 188.700
Base de datos — Alonso Lautaro	28,4	$ 139.100
Total	346,0	$ 1.700.000

7.3 Forma de pago

Concepto	Importe
Total acordado	$ 1.850.000
Seña abonada (30 %)	$ 555.000
Gastos de plataformas incluidos en la seña	$ 150.000
Importe a descontar del precio final	$ 405.000
Saldo contra entrega definitiva	$ 1.445.000

7.1.1 Imagen de referencia — Planilla de estimación

Planilla de estimación económica · Ver en Google Sheets →

7.4 Costos de operación posteriores

Concepto	Periodicidad	Importe estimado
Alojamiento y base de datos	Mensual	$ 12.000
Dominio web	Anual	$ 25.000
Comisión de la plataforma de pagos	Por transacción	Según convenio

8Contrato

Se consignan las cláusulas que rigen la relación entre las partes.

8.1 Partes

Por una parte, el Centro Molisano Monforte, asociación civil con sede en la calle Marco Polo, Villa Bosch, Provincia de Buenos Aires, representada por su Comisión Directiva, en adelante el Comitente. Por la otra, el equipo de desarrollo integrado por Laborde Santiago, Carmele Felipe, Blas Damario, Alonso Joaquín y Alonso Lautaro, en adelante el Proveedor.

8.2 Objeto

El Proveedor se obliga a desarrollar, poner en funcionamiento y entregar el Sistema de Gestión Digital de Socios, con el alcance descripto en el apartado 2.2 y los requerimientos enumerados en el apartado 4.1 del presente documento.

8.3 Plazo

La primera etapa está concluida y en funcionamiento. La entrega definitiva se conviene para septiembre de 2026, y el cierre formal del proyecto para el 2 de noviembre de 2026.

8.4 Precio y forma de pago

El precio total asciende a un millón ochocientos cincuenta mil pesos, pagadero según lo establecido en el apartado 7.3. La mora en el pago del saldo faculta al Proveedor a suspender las tareas de mantenimiento hasta su regularización.

8.5 Obligaciones del Comitente

Proveer el padrón real de socios y el valor vigente de la cuota social.
Entregar las credenciales de producción de Mercado Pago.
Designar a los responsables de operar el sistema y garantizar su participación en la capacitación.
Mantener vigente la contratación del alojamiento y del dominio.
Abonar el precio en las condiciones convenidas.

8.6 Obligaciones del Proveedor

Entregar el sistema en funcionamiento con la totalidad de los requerimientos de prioridad alta satisfechos.
Capacitar a los miembros de la Comisión Directiva en el uso del sistema.
Entregar la documentación técnica y el código fuente.
Subsanar sin cargo los defectos detectados durante el período de garantía.

8.7 Propiedad intelectual

Cancelado el precio en su totalidad, la titularidad del código fuente y de la documentación se transfiere al Comitente. El Proveedor conserva el derecho de exhibir el trabajo con fines académicos y de portafolio, sin divulgar datos de los socios ni información reservada del club.

8.8 Garantía y mantenimiento

El Proveedor garantiza el correcto funcionamiento del sistema durante los noventa días corridos posteriores a la entrega definitiva. La corrección de defectos no genera costo dentro de ese plazo. Las nuevas funcionalidades y modificaciones de alcance se cotizan por separado.

8.9 Confidencialidad y protección de datos

Ambas partes guardan reserva sobre la información a la que accedan con motivo del proyecto. El tratamiento de los datos personales de los socios se ajusta a la Ley N.° 25.326. El Proveedor no conserva copia de los datos productivos una vez concluido el proyecto, salvo autorización expresa del Comitente.

8.10 Rescisión

Cualquiera de las partes podrá rescindir el contrato mediando incumplimiento grave de la otra, previa intimación a subsanarlo dentro de los quince días corridos. Rescindido el contrato, el Comitente abonará las tareas efectivamente cumplidas y el Proveedor entregará el trabajo realizado.

8.11 Jurisdicción

Para toda controversia, las partes se someten a los tribunales ordinarios del Departamento Judicial de San Martín, Provincia de Buenos Aires.

8.12 Conformidad

En prueba de conformidad, las partes suscriben el presente en la localidad de Villa Bosch.

Comisión Directiva
Centro Molisano Monforte

Equipo de desarrollo
Proveedor

9Guía de Inicio Rápido

Todo lo que necesitás para empezar a usar el sistema en menos de cinco minutos. No hace falta instalar nada ni conocer el sistema de antemano.

Antes de empezar: el equipo de comisión ya tiene creado tu usuario. Solo necesitás el número de DNI y la contraseña que te enviaron, y un navegador actualizado en el celular o la computadora.

9.1 Primer acceso — todos los usuarios

Ingresar al sistema Socio y Comisión

Abrí el navegador y entrá a proyectogrupo123456.alwaysdata.net. En la pantalla de inicio ingresá tu DNI (sin puntos) y tu contraseña. La primera vez te recomendamos cambiarla desde el carnet.
Si te equivocás la contraseña más de 10 veces consecutivas, la cuenta se bloquea por 15 minutos.

Ver tu carnet digital Socio

Al iniciar sesión como socio, lo primero que ves es tu carnet digital. Ahí encontrás tu nombre, número de socio, categoría, estado de cuota del mes y el código QR para mostrar en el ingreso al club o en comercios adheridos.

Ver el panel de administración Comisión

Al iniciar sesión como miembro de comisión, entrás directamente al panel de administración. Desde ahí podés acceder a todos los módulos usando el menú de la izquierda: base de socios, finanzas, mensajes, reservas, contenido y solicitudes.

9.2 Las tres acciones clave — Socios

Mostrar el QR en el ingreso

En la pantalla del carnet, el código QR ya está listo para escanear. No hace falta hacer nada más. Si no tenés señal, la imagen del QR se guarda en caché y sigue disponible offline.

Ver mis cuotas

Desde la sección Mi carnet podés ver el estado de tu cuota del mes actual y el historial de los últimos meses. Si aparece en rojo, significa que tenés una o más cuotas impagas.

Cambiar tu contraseña

Entrá al carnet y tocá Cambiar contraseña. Ingresá la contraseña actual y la nueva dos veces. La nueva contraseña tiene que tener al menos 6 caracteres.

9.3 Las tres acciones clave — Comisión Directiva

Registrar el pago de una cuota

Andá a Finanzas → sección Cuotas sociales. Buscá el socio por nombre o número, seleccionalo, elegí el mes que paga, confirmá el monto y la forma de pago, y tocá Registrar cobro manual. El estado del socio se actualiza automáticamente en toda la plataforma.

Enviar un comunicado a los socios

Andá a Enviar mensajes. Elegí el destinatario (todos, al día, con deuda o un socio en particular), completá el asunto y el mensaje, y tocá Enviar mensaje. El mensaje aparece en la bandeja de entrada de cada destinatario la próxima vez que inicie sesión.

Aceptar una solicitud de nuevo socio

Cuando alguien completa el formulario de la página pública, aparece un número en el menú Solicitudes. Entrá, revisá los datos del postulante y tocá Aceptar. El sistema crea el socio automáticamente y le envía un mail de bienvenida con su contraseña provisoria.

10Manual de Uso

Documentación completa de todas las funciones del sistema, organizada por perfil de usuario. Consultá esta sección cuando necesitás profundidad sobre una función específica.

10.1 Perfil Socio

🪪

Mi carnet digital

Identidad, QR y estado de cuenta

Datos del carnet: nombre completo, número de socio, categoría y estado de cuota del mes en curso.
Código QR: generado con tus datos y un token de seguridad. Funciona sin internet gracias al caché del navegador. Mostralo en el ingreso al club o en comercios adheridos para validar tu membresía.
Estado de cuota: cuatro estados posibles según el cuadro unificado a continuación.

Estado	Color	Condición	Aparece en
Al día	Verde	Sin cuotas impagas.	Carnet, base de socios, finanzas
Pendiente	Amarillo	La cuota del mes fue generada pero aún no está vencida (días 1 al 10 del mes).	Carnet, base de socios (filtro "Pendiente")
Debe 1	Naranja	Exactamente 1 cuota vencida sin pagar (a partir del día 11 del mes).	Carnet, base de socios (filtro "Debe 1"), finanzas
Moroso	Rojo	2 o más cuotas vencidas sin pagar. Equivale a "Debe 2+" en los filtros del padrón.	Carnet, base de socios (filtro "Debe 2+"), finanzas

El término "Vencida" se usa internamente en la base de datos para denominar una cuota individual sin pagar a partir del día 11. El estado visible al usuario siempre es Al día / Pendiente / Debe 1 / Moroso. Los filtros del padrón usan Debe 1 y Debe 2+ como equivalentes a "1 cuota morosa" y "moroso (2+)".

Historial de pagos: los últimos 24 meses con fecha, monto y forma de pago.
Cambiar contraseña: desde el botón en el carnet. Requiere ingresar la contraseña actual.

💡 Si olvidaste tu contraseña, pedile a la Comisión Directiva que la resetee desde la base de socios. Recibirás una nueva provisoria.

📰

Noticias

Novedades del club

Accedé desde el menú lateral → Noticias.
Las noticias más recientes aparecen primero. El carrusel superior muestra las destacadas.
Tocá cualquier noticia para leer el contenido completo.

📅

Eventos

Calendario del club

El calendario muestra los eventos del mes actual. Navegá entre meses con las flechas.
Los días con evento tienen un punto dorado. Tocá el día para ver el detalle.
Debajo del calendario aparece la lista completa de eventos próximos.

🎁

Beneficios

Convenios y descuentos para socios

Lista de comercios y servicios adheridos con el porcentaje de descuento y cómo acceder.
Para acceder al beneficio, mostrá el QR de tu carnet en el comercio.

📬

Mensajes

Bandeja de entrada

Recibís mensajes de la Comisión Directiva (comunicados, recordatorios, bienvenidas).
Los mensajes no leídos aparecen con un punto indicador en el menú.
Al abrir un mensaje queda marcado como leído automáticamente.

💡 Los mensajes se borran automáticamente a los 6 meses de leídos para mantener la bandeja ordenada.

🏛️

Reservas

Solicitar un espacio del club

Elegí el espacio, la fecha y el horario. Verificá la disponibilidad antes de enviar.
La solicitud queda en estado Pendiente hasta que la Comisión la apruebe o rechace.
Al aprobarla, se te notifica y se registra automáticamente la seña en el módulo de finanzas.
Si la reserva es rechazada, la Comisión puede incluir un motivo en la notificación.

⚠️ Las reservas canceladas después de confirmadas pueden implicar la pérdida de la seña. Consultá con la Comisión.

10.2 Perfil Comisión Directiva

📊

Panel de administración

Vista general del club

Indicadores en tiempo real: socios activos, socios al día, socios con deuda y alerta de morosidad.
Accesos rápidos: desde las tarjetas del panel podés ir directamente a cualquier módulo.
Los indicadores se actualizan automáticamente cada vez que entrás al panel.

👥

Base de socios

Padrón completo

Buscador: buscá por nombre, apellido, DNI o número de socio. Los resultados se destacan con el texto buscado resaltado en dorado.
Filtros: Todos / Al día / Pendiente / Debe 1 / Moroso (2+) / Dados de baja.
Ficha del socio: hacé click en cualquier socio para ver su ficha completa con datos personales y historial de cuotas.
Nuevo socio: completá el formulario con los datos del nuevo miembro.
Editar: desde la ficha podés modificar datos de contacto, dirección y observaciones.
Baja: da de baja a un socio conservando su historial. La baja es reversible.
Eliminar: eliminación definitiva. Requiere confirmar el número de socio. No se puede deshacer.
Resetear contraseña: genera una contraseña provisoria y la muestra en pantalla para comunicársela al socio.

💰

Finanzas

Cuotas, señas e ingresos

Indicadores: ingresos del mes, cuotas cobradas, señas recibidas y porcentaje de morosidad.
Registrar cobro manual: buscá el socio, seleccioná el mes, confirmá el monto y la forma de pago. El sistema pre-selecciona el mes más antiguo sin pagar.
Señas de reservas: se registran automáticamente al confirmar una reserva. No requieren carga manual.
Valor de cuota: podés cambiar el monto mensual desde la sección correspondiente. El nuevo valor se aplica a las cuotas impagas del mes en curso y a todos los meses siguientes.
Historial: todos los movimientos filtrados por tipo (Todos / Cuotas / Señas / Mercado Pago).

💡 Las cuotas del mes se generan automáticamente el día 1. Los estados de cuota siguen la taxonomía unificada: Pendiente (días 1–10), Debe 1 (1 cuota vencida) o Moroso (2+ cuotas vencidas). Ver cuadro de estados en la sección 10.1.

✉️

Mensajes

Comunicados y mensajes automáticos

Envío manual: elegí los destinatarios (todos, al día, con deuda o un socio particular), completá asunto y mensaje, y enviá.
Segmentación: podés enviar a todos, a los que están al día, a los que tienen deuda, o a un socio específico buscándolo por nombre o número.
Mensajes automáticos: creá mensajes programados que se envían solos el 1° de cada mes, un día fijo del mes, o una vez por día. Cada automatización tiene un toggle para activar/desactivar y un botón de ejecución manual.

🗓️

Reservas

Gestión de espacios

Las solicitudes de reserva llegan con estado Pendiente.
Aprobar: confirmá la reserva y fijá el monto de la seña. La seña se registra automáticamente en el módulo de finanzas.
Rechazar: podés incluir un motivo que le llega al socio por mensaje.
Las reservas canceladas o rechazadas con más de 6 meses se eliminan automáticamente.

📝

Editar contenido

Noticias, eventos y beneficios

Noticias: creá y publicá noticias con título, foto, epígrafe y contenido. Podés ocultarlas sin eliminarlas.
Eventos: cargá eventos con fecha, hora, lugar, descripción e imagen.
Beneficios: administrá la lista de comercios adheridos con descripción, logo, descuento y cómo acceder.
Las imágenes se validan automáticamente (JPG, PNG o WEBP, máx. 5 MB).
Las noticias desactivadas por más de 1 año y sus imágenes se eliminan automáticamente.

🙋

Solicitudes de nuevos socios

Gestión de admisiones

Las solicitudes llegan desde el formulario público de la página de presentación del club.
Se organizan en tres pestañas: Pendientes, Aceptadas y Rechazadas.
Aceptar: el sistema crea el socio automáticamente dentro de una transacción y le envía un mail de bienvenida con sus credenciales de acceso.
Rechazar: el postulante recibe un mail informando la decisión.
Reevaluar: una solicitud rechazada puede volver a tratarse. Si se acepta en una segunda instancia, el sistema la procesa igual que una aceptación nueva.
Las solicitudes rechazadas con más de 1 año se eliminan automáticamente (Ley N.° 25.326).

10.3 Resolución de problemas comunes

Problema	Causa probable	Solución
No puedo iniciar sesión	Contraseña incorrecta o cuenta bloqueada	Esperá 15 minutos o pedile a la Comisión que resetee tu contraseña.
El QR no se escanea	Brillo de pantalla bajo o el escáner está muy lejos	Subí el brillo al máximo y acercá el QR al escáner.
"Error de conexión" en base de socios	Token de sesión expirado	Cerrá sesión y volvé a iniciarla.
La cuota aparece como pendiente pero ya pagué	El pago no fue registrado por la Comisión	Avisale a la Comisión para que registre el cobro manualmente.
No me llegan mensajes	El socio no tiene email cargado en el sistema	Pedile a la Comisión que actualice tu email en la ficha.
La página en blanco al entrar	Caché del navegador desactualizado	Apretá Ctrl+Shift+R (o Cmd+Shift+R en Mac) para forzar la recarga.
No puedo enviar una solicitud de asociación	El formulario se usa desde un archivo descargado	Abrí la URL del servidor, no el archivo descargado.

11Preguntas Frecuentes

Respuestas puntuales a las dudas más comunes. No hace falta leer todo: encontrá tu pregunta y leé solo esa.

Acceso y cuenta

¿Con qué datos inicio sesión?

Con tu número de DNI (sin puntos) y la contraseña que te asignó la Comisión. Si es la primera vez, te la habrán enviado por mail o en mano.

¿Qué hago si olvidé mi contraseña?

Avisale a cualquier miembro de la Comisión Directiva. Desde la base de socios pueden resetear tu contraseña y darte una nueva provisoria. No hay opción de recuperación automática por mail todavía.

Me bloquearon la cuenta, ¿qué hago?

Si ingresás mal la contraseña 10 veces seguidas, la cuenta se bloquea 15 minutos automáticamente por seguridad. Esperá ese tiempo y volvé a intentarlo. Si el problema persiste, contactá a la Comisión.

¿Puedo iniciar sesión desde el celular?

Sí. El sistema funciona en cualquier navegador actualizado (Chrome, Firefox, Safari) en celular, tablet o computadora. No hace falta instalar ninguna aplicación.

Cuotas y estado de cuenta

¿Qué significa el estado "Pendiente" en mi cuota?

Del día 1 al 10 de cada mes, la cuota aparece como Pendiente (amarillo). Significa que todavía estás en el período de gracia para pagar. A partir del día 11, si no pagaste, pasa a Vencida y aparecés como moroso.

Pagué la cuota en efectivo, ¿cuándo se actualiza el sistema?

El sistema se actualiza cuando la Comisión registra tu pago manualmente desde el módulo de Finanzas. Una vez registrado, el cambio es inmediato en toda la plataforma: en tu carnet, en la base de socios y en los indicadores del panel.

¿Cuánto vale la cuota este mes?

El valor lo fija la Comisión Directiva desde el módulo de Finanzas → Valor de cuota. El monto aparece pre-cargado cuando la Comisión registra un cobro.

Carnet y QR

¿El QR funciona sin internet?

Sí. El carnet y el QR se guardan en la caché del navegador la primera vez que los abrís. Si no tenés señal, el carnet sigue mostrándose. Eso no pasa con el resto del sistema, que requiere conexión.

¿El QR muestra si soy moroso?

Sí. Al escanear el QR, la pantalla de verificación muestra el nombre del socio y su estado de cuota en tiempo real. Si el estado es moroso, el portero o el comercio adherido lo ve al instante.

¿Puedo imprimir el carnet?

El carnet es digital y está pensado para mostrar desde el celular. Si necesitás un carnet físico, consultá con la Comisión Directiva.

Reservas

¿Cómo sé si mi reserva fue aprobada?

Recibís un mensaje en tu bandeja de entrada del sistema cuando la Comisión resuelve la solicitud. También podés ver el estado actual de tu reserva desde la sección Reservas.

¿La seña se paga dentro del sistema?

Por ahora la seña se abona en efectivo o por transferencia directamente al club. La Comisión la registra manualmente en el módulo de Finanzas. La integración con Mercado Pago está prevista para una etapa siguiente.

Para la Comisión Directiva

¿Cómo agrego un nuevo socio manualmente (sin que haya hecho la solicitud)?

Desde Base de socios → botón + Nuevo socio. Completá los datos del formulario y guardá. El sistema le asigna un número de socio automáticamente y genera una contraseña provisoria.

¿Qué pasa si el mantenimiento automático no corrió este mes?

El mantenimiento se dispara automáticamente la primera vez que alguien entra al sistema cada día. Si el día 1 nadie usó el sistema, las cuotas del mes nuevo no se generaron. En ese caso, la Comisión puede forzar la generación entrando a Finanzas: el sistema las genera al cargar la pantalla.

¿Puedo crear un mensaje automático mensual para recordar la cuota?

Sí. Desde Enviar mensajes → sección Mensajes automáticos → botón Nuevo. Elegí el disparador "El 1° de cada mes", los destinatarios "Solo socios con deuda", completá el asunto y el mensaje, y guardá. Se envía solo cada mes a quienes tengan cuotas impagas.

¿Cómo elimino a un socio definitivamente?

Desde la ficha del socio → Eliminar. El sistema te pide que confirmes escribiendo el número de socio exacto. Esta acción no se puede deshacer. Si solo querés que el socio deje de tener acceso sin perder su historial, usá Dar de baja en su lugar.

¿Los datos de los socios están protegidos?

Sí. Las contraseñas se almacenan encriptadas con bcrypt (nunca en texto plano). El acceso al padrón está restringido al perfil de Comisión Directiva. El sistema cumple con los lineamientos de la Ley N.° 25.326 de Protección de Datos Personales: las solicitudes rechazadas se eliminan automáticamente al año y los datos se recolectan con finalidad determinada.

Centro Molisano Monforte · Sistema de Gestión Digital de Socios
Documentación Técnica · Versión 1.2 · Agosto 2026 · Instituto Leonardo Murialdo · Prof. Pedaci, Lourdes