TURIN SPORT

Carpeta del Proyecto · Documentación

Turin Sport: turnero digital y control de stock del kiosco

Documentación técnica, operativa y económica del proyecto. Dos sistemas web para el complejo deportivo Turin Sport: un turnero que muestra las reservas de las canchas en una pantalla y un control de stock para el kiosco de las sedes.

Cliente
Turin Sport, complejo deportivo. Sede 1: San Leonardo Murialdo 909 · Sede 2: La Cautiva 7654
Materia
Evaluación de Proyectos
Docente
Prof. Pedaci, Lourdes
Ciclo
7mo Informática 2026 · Instituto Leonardo Murialdo
Accesos
Turnero: canchasgod-production-a814.up.railway.app · Kiosco: control-de-stock-proyecto-production-e8b6.up.railway.app
GitHub: turnero · control de stock
Módulos
Turnero turnos de canchas · Kiosco control de stock
Sobre este documentoSigue la estructura de la Carpeta del Proyecto definida en el módulo de Documentación de la materia. Los apartados que el módulo marca con página del libro Buenas Prácticas para Proyectos Informáticos (UTN, edUTecNe, 2012) respetan el formato de tabla de esa fuente. El proyecto es solo de software: los apartados pensados para hardware se adaptan y se aclara el motivo en cada caso. Cuando un requisito aplica a un solo sistema, se marca con Turnero o Kiosco.

1. Control de Cambios

Registro de las modificaciones realizadas sobre la documentación y el alcance del proyecto, con fecha, responsable y detalle del cambio. Cada validación con el cliente que derive en un cambio de requerimiento se anota como una fila nueva.

VersiónFechaResponsableDetalle del cambio
0.1PendienteEquipoVersión inicial a partir de la primera entrevista con Turin Sport: turnero para las dos sedes.
1.0PendienteEquipoTurnero Primera versión publicada en Alwaysdata: pantalla del TV, panel con login y roles, API JSON y base MySQL.
1.110/09/2026EquipoKiosco Alta del control de stock para el kiosco de las sedes: 29 productos en 4 categorías, alertas de reposición y sugerencias de compra.
1.2PendienteEquipoTurnero Migración a Railway con Docker y variables de entorno, por la pérdida de acceso a la cuenta de Alwaysdata.
1.322/09/2026EquipoTurnero Pedidos del cliente: formulario en una columna, horarios solo en horas en punto y tipo de cancha (Fútbol 5, 7 y 11) exclusivo de La Cautiva (RF07, RF08, RF09).
1.422/09/2026EquipoNueva base MySQL en Railway, instalador instalar.php y publicación de la documentación, el manual, las FAQ y la landing.
A completar por el equipoLas fechas marcadas como pendientes se cargan con las fechas reales. Mantener una fila por cada cambio de alcance validado con el cliente.

2. Diagnóstico: Árbol de Problemas y Soluciones

Diagnóstico elaborado a partir del relevamiento en Turin Sport. Es la pieza que fundamenta las decisiones de diseño: el problema central y sus causas explican por qué el sistema hace lo que hace, y los medios del árbol de soluciones son el origen directo de los requerimientos.

Cómo se lee el árbolSe lee de abajo hacia arriba: las causas producen el problema central, y el problema central produce los efectos. El árbol de soluciones es su espejo: cada causa se convierte en un medio, y cada efecto en un fin medible.

Problema central

Turin Sport no tiene un registro ordenado ni visible de lo que pasa en el complejo: los turnos de las canchas se manejan a mano y solo los conoce recepción, y el stock del kiosco se controla a ojo, así que los productos se agotan sin aviso.

Causas

CausaQué se observó en el relevamiento
Turnos anotados a mano TurneroLos turnos se registran en papel o mensajes, sin un criterio común entre las dos sedes.
La información queda en recepción TurneroEl jugador no ve qué se juega ni qué horarios quedan libres: tiene que preguntar.
Canchas de distinto tamaño sin identificar TurneroLa Cautiva tiene canchas de Fútbol 5, 7 y 11, y el turno no indicaba cuál se alquilaba.
El stock no se cuenta KioscoNadie lleva la cantidad de cada producto; se nota la falta cuando un cliente lo pide.
Compras sin criterio KioscoSe compra por intuición, sin relacionar lo que se vende en el fin de semana con lo que hay que reponer.

Efectos

EfectoCómo se manifiesta hoy (línea de base)
Consultas repetidas en recepciónA completar: consultas por día sobre horarios y canchas.
Confusión de cancha o de horarioA completar: casos por semana.
Horarios libres que nadie veNo hay forma de saber qué turnos quedan disponibles fuera de recepción.
Ventas perdidas por falta de productoA completar: productos agotados por fin de semana.
Compras de más o de menosSin datos de venta semanal, no se sabe cuántos packs comprar.

Árbol de soluciones

Objetivo centralDar a Turin Sport un registro digital y visible de los turnos de sus canchas y del stock de su kiosco, que se use desde el celular o la PC sin conocimientos técnicos.
MedioCausa que neutraliza
Panel web de turnos
Carga, edición y borrado por día y por sede.
Turnos anotados a mano.
Pantalla del TV
Turnos del día con colores por estado.
La información queda en recepción.
Campo tipo de cancha
Obligatorio solo en La Cautiva.
Canchas de distinto tamaño sin identificar.
Contador de stock por producto
Botones + y − pensados para el celular.
El stock no se cuenta.
Punto de reposición y sugerencias
Calculados a partir de la venta del fin de semana.
Compras sin criterio.
FinMeta verificablePunto de partida
Menos consultas en recepciónA definir con el cliente.A completar
Turnos visibles al instanteUn turno cargado se ve en el TV en menos de 2 minutos.No existía
Cero productos agotados sin avisoTodo producto con venta semanal avisa antes de quedar en 0.A completar
Compras con cantidad sugeridaCada sugerencia indica cuántos packs comprar.Compra por intuición
A validar con el clienteLos valores de línea de base (consultas por día, productos agotados) se completan con los datos de la entrevista.

3. Introducción

3.1. Propósito

El propósito del proyecto es ordenar dos tareas diarias de Turin Sport que hoy se hacen a mano. El turnero permite que recepción cargue los turnos de las canchas y que los jugadores los vean en una pantalla del complejo, sin tener que preguntar. El control de stock permite que quien atiende el kiosco lleve la cantidad de cada producto desde el celular y sepa qué y cuánto comprar antes de quedarse sin mercadería.

3.2. Alcance

El proyecto incluye: la pantalla pública de turnos para el TV, el panel de administración con login y roles, la API de turnos, el control de stock del kiosco con sugerencias de compra, la publicación online de ambos sistemas en Railway y esta documentación.

El proyecto no incluye: reservas o pagos hechos por los jugadores, registro de ventas o precios del kiosco, stock compartido entre varios dispositivos ni facturación. El detalle está en las Limitaciones (dentro de 5.1) y se formaliza en el Contrato (sección 9).

3.3. Personal Involucrado

RolResponsabilidad principalIntegrante
Project Manager (PM)Planificación (GANTT), control de alcance y relación con el cliente.A completar
Backend / BDPHP, API REST, MySQL y migraciones del turnero.A completar
Frontend / UX-UIPantalla del TV, panel de turnos y app de stock en React.A completar
InfraestructuraGitHub, Docker, Railway y dominios.A completar
ClienteValida requerimientos, prioriza y firma el contrato.Turin Sport

3.4. Definiciones, acrónimos y abreviaturas

TérminoDefinición
TurnoReserva de una cancha en una sede, un día y una franja horaria en punto.
SedeCada ubicación del complejo: Murialdo (Sede 1) y La Cautiva (Sede 2).
Tipo de canchaModalidad de la cancha: Fútbol 5, 7 u 11. Solo en La Cautiva.
En juegoTurno reservado cuya hora de inicio coincide con la hora actual.
Venta semanalUnidades de un producto que el kiosco vende en un fin de semana típico (“Vende ~X/finde”).
Punto de reposiciónCantidad a partir de la cual hay que reponer: el doble de la venta semanal.
PackUnidad de compra al proveedor (por ejemplo, 6 botellas o 12 alfajores).
API RESTInterfaz HTTP que devuelve datos en JSON; la usa la pantalla del TV.
SPASingle Page Application: aplicación web que funciona en una sola página, como la app de stock.
localStorageEspacio de guardado del navegador. La app de stock guarda ahí los datos.
RailwayPlataforma en la nube donde se publican ambos sistemas.
DockerHerramienta que empaqueta el turnero con PHP y Apache.
RF / RNFRequerimiento Funcional / Requerimiento No Funcional.
ISW / LIMInterfaz de Software (componente) / Limitación del alcance.

3.5. Referencias

Formato APA 7ª edición.

3.6. Resumen Ejecutivo

Turin Sport es un complejo deportivo con dos sedes, canchas de Fútbol 5, 7 y 11 y un kiosco. El proyecto le entrega dos herramientas web que se usan desde el navegador. El turnero reemplaza la planilla de turnos por un panel y una pantalla en el complejo que muestra, en tiempo casi real, qué cancha está reservada, cuál está libre y qué se está jugando. El control de stock le da al kiosco un contador por producto que avisa cuándo reponer y cuántos packs comprar según lo que se vende el fin de semana.

Público objetivo: complejos deportivos chicos y medianos que gestionan turnos y un kiosco sin personal técnico. Resultados esperados: que los turnos se vean en el TV en menos de 2 minutos, que ningún producto con venta habitual se agote sin aviso y que las compras del kiosco sigan una cantidad sugerida.

4. Descripción General

4.1. Perspectiva del producto

Son dos sistemas nuevos: el complejo no tenía herramientas digitales para turnos ni para stock. No reemplazan otro software y funcionan de forma independiente, publicados en el mismo proyecto de Railway.

Turnero Navegador Pantalla TV · Panel PHP 8.2 + Apache Docker en Railway MySQL sedes · turnos · usuarios HTTPS PDO Kiosco Celular del kiosco App React (SPA) serve (Node.js) Archivos estáticos en Railway localStorage en el mismo celular descarga guarda el stock
Figura 1. Arquitectura de los dos módulos. El kiosco descarga la app una vez y guarda los datos en el propio celular.

4.2. Funcionalidad del producto

4.3. Características de los Usuarios Buenas Prácticas UTN p.56/57

Tipo de usuarioFormaciónActividades
AdministradorDueño o encargado del complejo. Uso básico de PC y celular.Turnero Acceso total al panel de turnos de ambas sedes.
RecepciónPersonal de atención. Uso básico de PC.Turnero Carga, edita y borra turnos durante el día.
Encargado del kioscoPersonal del kiosco. Usa el celular a diario.Kiosco Descuenta lo que se vende, ajusta el stock y revisa las sugerencias de compra.
Jugadores y públicoSin requisitos.Turnero Solo miran la pantalla del TV.

4.4. Restricciones Buenas Prácticas UTN p.57

4.4.1. Políticas reguladoras

Todo el proyecto usa software libre (PHP, Apache, MySQL, React, Vite, Node.js). No hay costo de licencias. El único gasto recurrente es el alojamiento en Railway. El código se publica en GitHub.

4.4.2. Limitaciones de hardware

El turnero necesita un TV o monitor con navegador por sede e Internet. El kiosco necesita un celular o tablet con navegador. No hay hardware a medida.

4.4.3. Interfaces con otras aplicaciones

Los sistemas no se integran con software externo (facturación, pagos, proveedores). Entre ellos tampoco comparten datos.

4.4.4. Función de control

Turnero El panel exige usuario y contraseña con dos roles, admin y recepcion; el servidor verifica el rol antes de guardar o borrar. Kiosco No tiene login: se protege por el acceso físico al celular del kiosco.

4.4.5. Requisitos del lenguaje

Toda la interfaz está en español y usa el vocabulario del complejo: turno, cancha, sede, reponer, pack. Los estados se comunican con palabras y colores (“Reservado”, “En juego”, “3 a reponer”, “Todo ok”).

4.4.6. Protocolos señalados

HTTPS entre el navegador y Railway. El turnero expone una API REST en JSON y se conecta a MySQL por PDO dentro de la red privada de Railway.

4.4.7. Requisitos de fiabilidad

Turnero Si la pantalla pierde conexión, muestra datos de ejemplo en lugar de quedar en blanco y reintenta cada 2 minutos. Kiosco Los datos se guardan en el celular después de cada cambio, así que no se pierden al cerrar la app.

4.4.8. Credibilidad de la aplicación

La pantalla del turnero se recalcula sola cada 20 segundos para que “En juego” coincida con el reloj. En el kiosco, el número de stock se anima al sumar o restar, para confirmar que el toque se registró.

4.4.9. Consideraciones de seguridad

Contraseñas guardadas con hash bcrypt, consultas preparadas contra inyección SQL, salida escapada con htmlspecialchars y conexión a la base configurada por variables de entorno, sin datos sensibles en el código.

4.5. Suposiciones y dependencias

4.6. Evolución previsible del sistema

5. Requisitos Específicos

5.1. Requerimientos funcionales Buenas Prácticas UTN p.59/60

IDRequerimientoPrioridadOrigen
RF01 TPantalla de turnos del día
Ambas sedes, reloj, fecha, leyenda, carrusel de promociones y texto corrido.
Alta“Los jugadores preguntan siempre a qué hora juegan”
RF02 TColores por estado
Rojo reservado, verde disponible, dorado en juego (calculado con el reloj).
AltaPantalla legible a distancia
RF03 TActualización automática
La pantalla recarga los turnos cada 2 minutos.
AltaRecepción no puede tocar el TV
RF04 TLogin con dos roles
Admin y recepción.
AltaSolo personal autorizado carga turnos
RF05 TAlta, edición y baja de turnos por día y por sede.AltaReemplazo de la planilla
RF06 TTurnos libres
Horarios ofrecidos como disponibles, sin cliente.
MediaMostrar qué se puede reservar
RF07 THorarios en horas en punto
13 a 14, 15 a 16; “Hasta” siempre posterior a “Desde”.
AltaPedido del cliente (v1.3)
RF08 TTipo de cancha en La Cautiva
Fútbol 5, 7 u 11, obligatorio solo en esa sede.
AltaPedido del cliente (v1.3)
RF09 TFormulario en una columna.MediaPedido del cliente (v1.3)
RF10 KStock por producto
Botones + y −, y cantidad exacta tocando el número.
Alta“No sabemos cuánto nos queda”
RF11 KBúsqueda y filtro por categoría
Bebidas, Snacks y golosinas, Cerveza, Helados.
Media29 productos en una lista
RF12 KAlerta de reposición
Cuando el stock llega al doble de la venta semanal o menos.
AltaProductos que se agotan sin aviso
RF13 KSugerencias de compra
Packs necesarios para cubrir tres fines de semana.
AltaCompras por intuición
RF14 KMarcar sugerencias
Pendiente, anotada, o comprada (suma al stock).
MediaSeguimiento de la compra
RF15 KVenta semanal editable por producto.MediaLa demanda cambia por temporada
RF16 KReiniciar stock a 0 con confirmación.BajaRecuento completo

Requerimientos no funcionales (RNF)

IDRequerimientoCategoría
RNF01Un turno cargado aparece en el TV en menos de 2 minutos.Rendimiento
RNF02Se usan desde el navegador en PC, celular o TV, sin instalar nada.Usabilidad
RNF03El kiosco se maneja con una mano: botones de al menos 44 px y barra de sugerencias fija abajo.Usabilidad / HCI
RNF04Sin jerga técnica: estados con palabras y colores.Usabilidad / HCI
RNF05Contraseñas con hash y consultas preparadas.Seguridad
RNF06Configuración por variables de entorno y migración automática de la base.Mantenimiento
RNF07Publicación continua: cada cambio en GitHub se despliega solo en Railway.Mantenimiento

Limitaciones del alcance

Definen qué no hace el sistema en esta entrega. No son debilidades: son un contrato de honestidad con el cliente. Cada una puede convertirse en una versión futura (4.6).

IDQué NO hace en esta entregaPor qué¿Versión futura?
LIM01 KEl stock no se comparte entre dispositivos. Cada celular tiene su propio stock.Los datos se guardan en el navegador, sin servidor.Sí. v2 con base en la nube.
LIM02 KSi se borran los datos del navegador, se pierde el stock.Misma causa que LIM01.Sí. v2.
LIM03 KNo registra ventas, precios ni ganancias.El pedido fue controlar cantidades.Sí. v3.
LIM04 KLos productos se agregan en el código, no desde la app.El catálogo cambia poco.Sí.
LIM05 TNo avisa superposiciones de turnos en la misma cancha.La validación actual controla solo el horario.Sí. v2.
LIM06 TNo permite cambiar la contraseña desde el panel.Los usuarios se crean con el instalador.Sí. v2.
LIM07 TNo toma reservas ni cobros de los jugadores.Fuera del alcance pedido.Sí. v3.
LIM08 TLos turnos de la versión en Alwaysdata no se migraron.Se perdió el acceso a esa cuenta.No aplica.

5.2. Interfaces de usuario Buenas Prácticas UTN p.58

Las interfaces se diseñaron por usabilidad, pensando en quién las usa y dónde. La pantalla del TV se lee a distancia: turnos grandes a la izquierda con colores por estado, carrusel de promociones a la derecha y texto corrido abajo. El panel de turnos se usa en la PC de recepción: selector de día, formulario en una columna y una tabla por sede. La app del kiosco se usa en el celular, parado y con una mano: cada producto tiene su emoji, botones grandes de + y −, alerta roja cuando hay que reponer y un botón fijo abajo con las sugerencias de compra.

5.2.1. Diseño de interfaz (Figma)

Entregable del equipoInsertar las imágenes del mockup de Figma con el hipervínculo al prototipo dentro del texto explicativo.

5.3. Interfaces de hardware Buenas Prácticas UTN p.59

El proyecto no desarrolla hardware propio. Este apartado se adapta para listar el equipamiento que el complejo necesita para usar los sistemas.

IDRequerimientoPrioridadUso
RHW01TV o monitor con navegador por sede (Smart TV, TV box o PC por HDMI).AltaTurnero Pantalla pública.
RHW02PC o celular en recepción.AltaTurnero Panel de turnos.
RHW03Celular o tablet fijo del kiosco.AltaKiosco Control de stock (ver LIM01).
RHW04Conexión a Internet en cada sede.AltaAmbos módulos.

5.3.1. Visualización 3D del producto: no aplica, porque no hay un dispositivo físico a fabricar.

5.4. Interfaces de software Buenas Prácticas UTN p.59

IDComponenteTecnología / StackRol en el sistema
ISW01 TPantalla del TV
pantalla/index.html
HTML, CSS y JavaScriptLee la API cada 2 minutos y dibuja los turnos.
ISW02 TPanel de turnos
admin/
PHP 8.2Login, formulario y listado por sede.
ISW03 TAPI REST
api/
PHP 8.2, JSONLectura pública; escritura con sesión y rol.
ISW04 TBase de datosMySQL en RailwaySedes, turnos y usuarios. Modelo en 5.6.
ISW05 TContenedor
Dockerfile
php:8.2-apache, pdo_mysqlEjecuta el turnero en el puerto 8080.
ISW06 KApp de stock
App.jsx
React 18, Vite 5, Tailwind (CDN), lucide-reactToda la lógica de stock y sugerencias.
ISW07 KPersistencia locallocalStorage, clave kiosco:stock:v1Guarda stock, ventas semanales y sugerencias anotadas.
ISW08 KServidor estáticoserve 14 (Node.js)Publica la carpeta dist en Railway.

5.5. Interfaces de comunicación Buenas Prácticas UTN p.59

InterfazProtocolo / FormatoDetalle
Pantalla → API THTTPS / REST (JSON)GET /api/turnos.php?fecha=hoy. Público, sin login.
Panel → API THTTPS / formulario POSTPOST /api/guardar.php y POST /api/eliminar.php, con sesión de rol admin o recepción.
Backend → Base de datos TTCP / SQL (MySQL)PDO a mysql.railway.internal:3306, tomado de MYSQL_URL.
Celular → Railway KHTTPSSolo para descargar la app; después no se comunica con ningún servidor.

Respuesta de ejemplo de la API de turnos:

{ "fecha": "2026-09-22",
  "sedes": [ { "nombre": "Sede 2", "direccion": "La Cautiva 7654",
      "turnos": [ { "inicio": "18:00", "fin": "19:00", "cancha": "Cancha 1",
                    "tipo": "Fútbol 11", "cliente": "Torneo Interno",
                    "estado": "reservado" } ] } ] }

5.6. Modelo Entidad-Relación de la base de datos

El turnero usa una base relacional MySQL con tres tablas. El kiosco no usa base de datos: guarda un documento JSON en el navegador, que se describe al final de este apartado.

Normalización

FormaQué exigeCómo se cumple
1FNValores atómicos, sin grupos repetidos.Cada turno guarda una sola cancha, un solo horario y un solo cliente. La excepción consciente es sedes.tipos_cancha, una lista corta separada por comas (ver abajo).
2FNSin dependencias parciales de la clave.Todas las tablas usan clave primaria simple (id).
3FNSin dependencias transitivas.La dirección de la sede no se repite en cada turno: el turno referencia a la sede por sede_id.
Desnormalización conscientesedes.tipos_cancha guarda “Fútbol 5,Fútbol 7,Fútbol 11” en una sola columna. Una tabla aparte sería lo normalizado, pero la lista es fija, pequeña y solo la usa una sede. Si en el futuro cada cancha tiene su tipo fijo, se crea la tabla canchas (ver 4.6).

Tablas de hechos y dimensiones

TURNOS es la tabla de hechos: cada fila es algo que pasa (una reserva) con fecha y hora, y crece todo el tiempo. SEDES es una dimensión: describe dónde. USUARIOS es independiente: controla el acceso y no se relaciona con los turnos.

SEDES · DIM id PKnombredireccionordentipos_cancha TURNOS · HECHO id PKsede_id FKfechahora_iniciohora_fincanchatipo_canchaclienteestado USUARIOS id PKusuarioclave_hashrol 1Ntiene
Figura 2. Diagrama entidad-relación del turnero. Cardinalidad 1 : N entre sedes y turnos.

Relaciones

EntidadCard.EntidadSignificado
SEDES1 : NTURNOSUna sede tiene muchos turnos; cada turno pertenece a una sede. Si se borra la sede, se borran sus turnos (ON DELETE CASCADE).

Esquema relacional (MySQL)

CREATE TABLE sedes (
  id           INT AUTO_INCREMENT PRIMARY KEY,
  nombre       VARCHAR(60)  NOT NULL,          -- "Sede 1"
  direccion    VARCHAR(160) NOT NULL,          -- "La Cautiva 7654"
  orden        INT NOT NULL DEFAULT 0,         -- orden en pantalla
  tipos_cancha VARCHAR(160) NULL               -- "Fútbol 5,Fútbol 7,Fútbol 11"
);

CREATE TABLE turnos (
  id          INT AUTO_INCREMENT PRIMARY KEY,
  sede_id     INT  NOT NULL,
  fecha       DATE NOT NULL,
  hora_inicio TIME NOT NULL,                   -- siempre en punto
  hora_fin    TIME NOT NULL,                   -- puede ser 24:00
  cancha      VARCHAR(40) NOT NULL DEFAULT 'Cancha 1',
  tipo_cancha VARCHAR(30) NULL,                -- solo sedes con tipos
  cliente     VARCHAR(80) NULL,                -- NULL si está libre
  estado      ENUM('reservado','libre') NOT NULL DEFAULT 'reservado',
  FOREIGN KEY (sede_id) REFERENCES sedes(id) ON DELETE CASCADE
);

CREATE TABLE usuarios (
  id         INT AUTO_INCREMENT PRIMARY KEY,
  usuario    VARCHAR(40)  NOT NULL UNIQUE,
  clave_hash VARCHAR(255) NOT NULL,            -- bcrypt
  rol        ENUM('admin','recepcion') NOT NULL DEFAULT 'recepcion'
);

Modelo de datos del kiosco Kiosco

El catálogo de productos está fijo en el código (SEED) y en el navegador se guarda solo lo que cambia:

CampoDónde viveDescripción
id, cat, name, emoji, packCódigoIdentificador, categoría, nombre, ícono y unidades por pack.
weeklyCódigo (valor inicial) y navegadorVenta estimada por fin de semana. Editable.
stockNavegadorUnidades actuales. Nunca menor que 0.
doneNavegadorLista de sugerencias marcadas como anotadas.
versionNavegadorVersión del catálogo (3) para migrar datos viejos.
// localStorage["kiosco:stock:v1"]
{ "version": 3,
  "products": [ { "id": "agua500", "stock": 14, "weekly": 20 }, ... ],
  "done": ["alfa"] }

Reglas de cálculo: punto de reposición = weekly × 2; hay que reponer si stock ≤ weekly × 2 y weekly > 0; packs sugeridos = ⌈(weekly × 3 − stock) ÷ pack⌉, con un mínimo de 1. Los helados empiezan con venta semanal 0, así que no generan sugerencias hasta que se les carga una.

5.7. Diagrama de flujo del sistema

Mientras el modelo entidad-relación describe qué guarda el sistema, el diagrama de flujo describe qué hace, con carriles por responsable.

RECEPCIÓN · PANEL SERVIDOR · RAILWAY PANTALLA · TV Inicia sesión Elige día, sede, horario,cancha y estado ¿Sede contipos? Elige Fútbol 5, 7 u 11 Guardar turno ¿Datosválidos? Guarda en MySQL(guardar.php) Entrega el JSON(turnos.php) Pide los turnoscada 2 minutos Pinta por estado ymarca “En juego” Turno visible Sí No Sí No: muestra el error
Figura 3. Turnero: desde la carga de un turno hasta que aparece en el TV.
ENCARGADO DEL KIOSCO APP EN EL CELULAR Vende un producto Toca “−” en el producto Resta 1 y lo guarda ¿stock ≤ 2 ×venta semanal? Alerta roja y sumaa Sugerencias Abre Sugerencias y vecuántos packs comprar Compra y toca “A” Suma al stock Sí No
Figura 4. Kiosco: desde una venta hasta la reposición del producto.
Qué decide el sistema y qué decide la personaEl turnero decide solo qué turno está “En juego”; qué se carga lo decide recepción. El kiosco calcula cuándo reponer y cuánto comprar, pero la compra la hace y la confirma el encargado.

6. Oferta de Gestión

6.1. GANTT

EtapaTareas principalesEntregable
E01Entrevista con Turin Sport. Relevamiento de las dos sedes, las canchas y el kiosco.Definición del problema y línea de base.
E02Factibilidad técnica, económica y de gestión. Elección de tecnologías y hosting.Estudio de factibilidad.
E03RF, RNF, arquitectura y modelo de datos.Especificación + ER.
E04Mockups y validación con el cliente.Mockup validado.
E05Desarrollo del turnero y del kiosco, publicación, migración a Railway y documentación.Sistemas online + documentación.
E06Presentación profesional, defensa y pitch.Presentación + landing.
Entregable del equipoAgregar el link o el embed de la planilla de GANTT del equipo, con fechas y responsables reales.

6.2. Infraestructura administrativa Buenas Prácticas UTN p.62

GrupoRolFunción
Dirección y GestiónDirector / PMCoordinación, recursos y relación con el cliente.
Líder de proyectoAsignación de tareas; planificación temporal y económica.
DesarrolloBackend / BDPHP, API, MySQL.
Frontend / UX-UIPantalla del TV, panel y app del kiosco.
InfraestructuraGitHub, Docker y Railway.

El equipo

Nombre y ApellidoDirector / PM
Nombre y ApellidoLíder de proyecto
Nombre y ApellidoBackend / BD
Nombre y ApellidoFrontend / UX-UI
Nombre y ApellidoInfraestructura
Entregable del equipoCompletar nombre y apellido y reemplazar cada <span class="m-photo"></span> por <img class="m-photo" src="img/integrante-01.jpg" alt="Foto de Nombre Apellido">. Eliminar las tarjetas sobrantes.
Gestión de tareas

Planilla de cálculo: GANTT, tareas y costos.

Documentación

Este sitio en GitHub Pages; README en cada repositorio.

Comunicación

Grupo de mensajería del equipo y reuniones con el cliente.

Repositorio

GitHub, con despliegue automático en Railway.

Diseño

Figma para las interfaces.

7. Oferta Económica

7.1. Proveedores de conectividad y hosting

ÍtemOpciónCosto
Hosting de ambos sistemas (24/7)Railway, plan Hobby. Incluye US$5 de uso por mes; el período de prueba dura 30 días o US$5.US$5 / mes
Base de datos MySQLServicio MySQL de Railway, dentro del mismo plan.Incluido en el uso
Dominio propio (opcional)Hoy se usa el subdominio gratuito de Railway.A cotizar
Documentación y landingGitHub Pages.Sin costo

7.2. Proveedores de insumos electrónicos

ComponenteCant.Costo unit.Subtotal
TV box o Smart TV (si la sede no tiene)1 por sedeA cotizarPendiente
Celular o tablet para el kiosco1 por kioscoA cotizarPendiente

7.3. Proveedores de insumos varios

ÍtemDetalleCosto
Soporte de pared para el TVSi hace falta instalarlo en la sede.A cotizar
PreciosLos precios de Railway pueden cambiar: confirmarlos en railway.com/pricing al armar el presupuesto.

8. Estimación Económica

RubroDetalleMonto
HostingRailway Hobby, 12 meses (7.1).US$60 / año
EquipamientoTV box y celular, si el cliente no los tiene (7.2).A completar
Insumos variosSoporte de TV (7.3).A completar
Horas hombreDesarrollo, diseño, despliegue y documentación, por categoría y costo/hora.A completar
Total estimadoSuma de los rubros anteriores.A completar
Entregable del equipoInsertar la imagen de la planilla de estimación con el hipervínculo de Google Sheets y los montos reales.

9. Contrato

Documento que explicita el acuerdo entre el equipo y Turin Sport. Se firma en la reunión de validación, habiendo leído las limitaciones (5.1).

9.1. Objetivo del proyecto

Desarrollar y publicar el turnero de canchas de las dos sedes y el control de stock del kiosco, para ordenar los turnos y evitar que se agoten productos sin aviso.

9.2. Partes involucradas

Equipo desarrollador (3.3) y Turin Sport, representado por su responsable.

9.3. Alcance

Lo definido en 3.2 y 5. Queda fuera lo listado en LIM01 a LIM08.

9.4. Plazos

Según el GANTT (6.1). A completar con las fechas reales.

9.5. Responsabilidades

Equipo: desarrollo, publicación y documentación. Cliente: validar, proveer TV, celular e Internet, y mantener activo el plan de Railway.

9.6. Criterios de aceptación

Turnos visibles en el TV en menos de 2 minutos; tipo de cancha en La Cautiva; alerta y sugerencia de compra funcionando en el celular del kiosco.

9.7. Condiciones de modificación

Todo cambio se registra en el Control de Cambios (1) y se evalúa su impacto en plazos y costos antes de aceptarse.

9.8. Firmas

Equipo desarrollador y Turin Sport (simbólica, en la validación).

10. Bitácora del Proyecto

Registra el proceso: entrevistas, reuniones, cambios de diseño y avances técnicos.

10.1. Registro de Entrevistas

FechaCon quiénObjetivoModalidad
A completarResponsable de Turin SportEntrevista 1. Cómo se manejan hoy los turnos de las dos sedes.Presencial
A completarEncargado del kioscoEntrevista 2. Productos, ventas del fin de semana y forma de comprar.Presencial
A completarResponsable de Turin SportValidación. Pedidos de cambio: horas en punto, formulario en una columna y tipos de cancha.A completar

10.2. Minutas de Reunión

Minuta 01 · Pedidos de cambio del cliente

Fecha y duraciónA completar.
ParticipantesTurin Sport y el equipo de proyecto.
ObjetivoRevisar el panel de turnos en uso.
Temas tratadosComodidad del formulario, forma de cargar horarios y canchas de La Cautiva.
Decisiones y acuerdosDesde y Hasta uno abajo del otro; turnos solo en horas en punto; tipo de cancha Fútbol 5, 7 y 11 solo en La Cautiva.
Próximos pasosImplementar los cambios (v1.3) y publicarlos en Railway.
A completar por el equipoSumar una minuta por cada reunión con los mismos seis campos.

10.3. Registro de Cambios del Mockup

ComponenteQué se modificóPor qué
Formulario de turnoPasó de dos columnas a una sola.Desde y Hasta quedaban separados y la carga era incómoda (RF09).
Campos de horarioDe campo de hora con minutos a lista de horas en punto.Las canchas se alquilan por hora completa (RF07).
Tipo de canchaCampo nuevo que aparece solo en La Cautiva.Esa sede tiene canchas de 5, 7 y 11 (RF08).

10.4. Bitácora de Avances Técnicos

EtapaHitos registradosFecha de cierre
E05Turnero v1.0 online en Alwaysdata.A completar
E05Control de stock del kiosco (React + Vite) publicado en Railway.10/09/2026
E05Pérdida de la cuenta de Alwaysdata; el código se conserva en GitHub. Dockerización y migración a Railway.A completar
E05Cambios del cliente en el panel (v1.3).22/09/2026
E05Nuevo repositorio canchasgod, servicio MySQL, variable MYSQL_URL e instalación.22/09/2026
E05Documentación, manual, FAQ y landing en GitHub Pages.22/09/2026
E06Presentación final.A completar

11. Guía de Inicio Rápido

Las operaciones del uso diario, sin jerga técnica. El paso a paso completo, con los mensajes de error, está en el Manual de usuario.

Antes de empezarHace falta un navegador actualizado, Internet, el usuario del panel entregado por el equipo y, en cada sede, un TV con la pantalla abierta. No se instala ninguna aplicación.
  1. Entrar al panel de turnos

    Admin y recepción

    Abrir el panel e ingresar usuario y contraseña.

  2. Cargar un turno

    Admin y recepción

    Elegir sede, hora de inicio (la de fin se completa sola), cancha, estado y quién reservó. En La Cautiva, también el tipo de cancha. Tocar “Guardar turno”.

  3. Editar o borrar

    Admin y recepción

    En la tabla de la sede, tocar “Editar” o “Borrar” en la fila del turno.

  4. Dejar la pantalla en el TV

    Admin

    Abrir la pantalla en el navegador del TV y ponerla en pantalla completa. Se actualiza sola.

  5. Descontar una venta en el kiosco

    Encargado del kiosco

    Abrir el control de stock y tocar “−” en el producto vendido.

  6. Reponer

    Encargado del kiosco

    Tocar “Sugerencias de compras”, ver cuántos packs comprar y, al comprarlos, tocar “A” para sumarlos al stock.

12. Preguntas Frecuentes

Las preguntas que más se repiten. La lista completa, por tema, está en Preguntas frecuentes.

¿Puedo cargar un turno de 13:30 a 14:30?
No. Los turnos van en horas en punto porque así se alquilan las canchas (RF07).
¿Por qué el tipo de cancha aparece solo en La Cautiva?
Porque es la única sede con canchas de Fútbol 5, 7 y 11 (RF08).
Cargué un turno y no aparece en el TV
La pantalla se actualiza cada 2 minutos y muestra solo los turnos de hoy (RF03).
¿El stock del kiosco se ve desde otro celular?
No. Queda guardado en el celular donde se carga (LIM01). Usen siempre el mismo dispositivo.
¿Cómo decide la app cuándo reponer?
Cuando el stock llega al doble de lo que se vende en un fin de semana, o menos (RF12). Sugiere comprar lo necesario para cubrir tres fines de semana (RF13).
¿Hay que instalar algo?
No. Los dos sistemas funcionan desde el navegador (RNF02).
Cómo se mantieneCada pregunta nueva que surge en una reunión se suma acá y en la minuta correspondiente (10.2). Si cambia el alcance, se registra también en el Control de Cambios (1).