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.
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ón | Fecha | Responsable | Detalle del cambio |
|---|---|---|---|
| 0.1 | Pendiente | Equipo | Versión inicial a partir de la primera entrevista con Turin Sport: turnero para las dos sedes. |
| 1.0 | Pendiente | Equipo | Turnero Primera versión publicada en Alwaysdata: pantalla del TV, panel con login y roles, API JSON y base MySQL. |
| 1.1 | 10/09/2026 | Equipo | Kiosco 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.2 | Pendiente | Equipo | Turnero Migración a Railway con Docker y variables de entorno, por la pérdida de acceso a la cuenta de Alwaysdata. |
| 1.3 | 22/09/2026 | Equipo | Turnero 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.4 | 22/09/2026 | Equipo | Nueva base MySQL en Railway, instalador instalar.php y publicación de la documentación, el manual, las FAQ y la landing. |
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.
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
| Causa | Qué se observó en el relevamiento |
|---|---|
| Turnos anotados a mano Turnero | Los turnos se registran en papel o mensajes, sin un criterio común entre las dos sedes. |
| La información queda en recepción Turnero | El jugador no ve qué se juega ni qué horarios quedan libres: tiene que preguntar. |
| Canchas de distinto tamaño sin identificar Turnero | La Cautiva tiene canchas de Fútbol 5, 7 y 11, y el turno no indicaba cuál se alquilaba. |
| El stock no se cuenta Kiosco | Nadie lleva la cantidad de cada producto; se nota la falta cuando un cliente lo pide. |
| Compras sin criterio Kiosco | Se compra por intuición, sin relacionar lo que se vende en el fin de semana con lo que hay que reponer. |
Efectos
| Efecto | Cómo se manifiesta hoy (línea de base) |
|---|---|
| Consultas repetidas en recepción | A completar: consultas por día sobre horarios y canchas. |
| Confusión de cancha o de horario | A completar: casos por semana. |
| Horarios libres que nadie ve | No hay forma de saber qué turnos quedan disponibles fuera de recepción. |
| Ventas perdidas por falta de producto | A completar: productos agotados por fin de semana. |
| Compras de más o de menos | Sin datos de venta semanal, no se sabe cuántos packs comprar. |
Árbol de soluciones
| Medio | Causa 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. |
| Fin | Meta verificable | Punto de partida |
|---|---|---|
| Menos consultas en recepción | A definir con el cliente. | A completar |
| Turnos visibles al instante | Un turno cargado se ve en el TV en menos de 2 minutos. | No existía |
| Cero productos agotados sin aviso | Todo producto con venta semanal avisa antes de quedar en 0. | A completar |
| Compras con cantidad sugerida | Cada sugerencia indica cuántos packs comprar. | Compra por intuición |
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
| Rol | Responsabilidad principal | Integrante |
|---|---|---|
| Project Manager (PM) | Planificación (GANTT), control de alcance y relación con el cliente. | A completar |
| Backend / BD | PHP, API REST, MySQL y migraciones del turnero. | A completar |
| Frontend / UX-UI | Pantalla del TV, panel de turnos y app de stock en React. | A completar |
| Infraestructura | GitHub, Docker, Railway y dominios. | A completar |
| Cliente | Valida requerimientos, prioriza y firma el contrato. | Turin Sport |
3.4. Definiciones, acrónimos y abreviaturas
| Término | Definición |
|---|---|
| Turno | Reserva de una cancha en una sede, un día y una franja horaria en punto. |
| Sede | Cada ubicación del complejo: Murialdo (Sede 1) y La Cautiva (Sede 2). |
| Tipo de cancha | Modalidad de la cancha: Fútbol 5, 7 u 11. Solo en La Cautiva. |
| En juego | Turno reservado cuya hora de inicio coincide con la hora actual. |
| Venta semanal | Unidades de un producto que el kiosco vende en un fin de semana típico (“Vende ~X/finde”). |
| Punto de reposición | Cantidad a partir de la cual hay que reponer: el doble de la venta semanal. |
| Pack | Unidad de compra al proveedor (por ejemplo, 6 botellas o 12 alfajores). |
| API REST | Interfaz HTTP que devuelve datos en JSON; la usa la pantalla del TV. |
| SPA | Single Page Application: aplicación web que funciona en una sola página, como la app de stock. |
| localStorage | Espacio de guardado del navegador. La app de stock guarda ahí los datos. |
| Railway | Plataforma en la nube donde se publican ambos sistemas. |
| Docker | Herramienta que empaqueta el turnero con PHP y Apache. |
| RF / RNF | Requerimiento Funcional / Requerimiento No Funcional. |
| ISW / LIM | Interfaz de Software (componente) / Limitación del alcance. |
3.5. Referencias
Formato APA 7ª edición.
- Pedaci, L. (2026). Evaluación de Proyectos - Módulo 01: El Proyecto y sus generalidades. Instituto Leonardo Murialdo.
- Pedaci, L. (2026). Evaluación de Proyectos - Módulo 02: Fases de un Proyecto. Instituto Leonardo Murialdo.
- Pedaci, L. (2026). Evaluación de Proyectos - Módulo de Documentación. Instituto Leonardo Murialdo.
- Pedaci, L. (2026). Lineamientos y Metodologías de Trabajo - Proyecto Tecnológico Interdisciplinario. Instituto Leonardo Murialdo.
- Universidad Tecnológica Nacional. (2012). Buenas Prácticas para Proyectos Informáticos. edUTecNe. ISBN 978-987-1896-01-1.
- Railway Corp. (2026). Railway Docs. https://docs.railway.com
- Meta Open Source. (2026). React. https://react.dev
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.
4.2. Funcionalidad del producto
- Turnero Mostrar en el TV los turnos del día de las dos sedes, con reloj y colores por estado.
- Turnero Cargar, editar y borrar turnos de cualquier día desde un panel con contraseña.
- Turnero Indicar el tipo de cancha en La Cautiva.
- Kiosco Llevar el stock de 29 productos en 4 categorías, con búsqueda y filtro.
- Kiosco Avisar qué productos hay que reponer y sugerir cuántos packs comprar.
- Kiosco Sumar al stock lo comprado con un solo toque.
4.3. Características de los Usuarios Buenas Prácticas UTN p.56/57
| Tipo de usuario | Formación | Actividades |
|---|---|---|
| Administrador | Dueño o encargado del complejo. Uso básico de PC y celular. | Turnero Acceso total al panel de turnos de ambas sedes. |
| Recepción | Personal de atención. Uso básico de PC. | Turnero Carga, edita y borra turnos durante el día. |
| Encargado del kiosco | Personal 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úblico | Sin 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
- Se asume Internet estable en ambas sedes y un TV encendido con la pantalla abierta.
- El sistema depende de que el plan de Railway esté activo (ver 7.1).
- Se asume que el kiosco usa siempre el mismo celular, porque el stock queda guardado en ese dispositivo.
- Las ventas semanales iniciales de cada producto las informó el cliente y se ajustan desde la app.
4.6. Evolución previsible del sistema
- v2 · Stock en la nube Kiosco para compartirlo entre celulares y entre sedes, con login.
- v2 · Aviso de superposición Turnero al cargar dos turnos en la misma cancha y horario.
- v2 · Cambio de contraseña y gestión de usuarios desde el panel.
- v2 · Turnos fijos semanales para equipos que juegan siempre el mismo día.
- v3 · Registro de ventas y precios en el kiosco, con reporte mensual.
- v3 · Reservas online por parte de los jugadores.
- v3 · Panel unificado que reúna turnero y kiosco.
5. Requisitos Específicos
5.1. Requerimientos funcionales Buenas Prácticas UTN p.59/60
| ID | Requerimiento | Prioridad | Origen |
|---|---|---|---|
| RF01 T | Pantalla 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 T | Colores por estado Rojo reservado, verde disponible, dorado en juego (calculado con el reloj). | Alta | Pantalla legible a distancia |
| RF03 T | Actualización automática La pantalla recarga los turnos cada 2 minutos. | Alta | Recepción no puede tocar el TV |
| RF04 T | Login con dos roles Admin y recepción. | Alta | Solo personal autorizado carga turnos |
| RF05 T | Alta, edición y baja de turnos por día y por sede. | Alta | Reemplazo de la planilla |
| RF06 T | Turnos libres Horarios ofrecidos como disponibles, sin cliente. | Media | Mostrar qué se puede reservar |
| RF07 T | Horarios en horas en punto 13 a 14, 15 a 16; “Hasta” siempre posterior a “Desde”. | Alta | Pedido del cliente (v1.3) |
| RF08 T | Tipo de cancha en La Cautiva Fútbol 5, 7 u 11, obligatorio solo en esa sede. | Alta | Pedido del cliente (v1.3) |
| RF09 T | Formulario en una columna. | Media | Pedido del cliente (v1.3) |
| RF10 K | Stock por producto Botones + y −, y cantidad exacta tocando el número. | Alta | “No sabemos cuánto nos queda” |
| RF11 K | Búsqueda y filtro por categoría Bebidas, Snacks y golosinas, Cerveza, Helados. | Media | 29 productos en una lista |
| RF12 K | Alerta de reposición Cuando el stock llega al doble de la venta semanal o menos. | Alta | Productos que se agotan sin aviso |
| RF13 K | Sugerencias de compra Packs necesarios para cubrir tres fines de semana. | Alta | Compras por intuición |
| RF14 K | Marcar sugerencias Pendiente, anotada, o comprada (suma al stock). | Media | Seguimiento de la compra |
| RF15 K | Venta semanal editable por producto. | Media | La demanda cambia por temporada |
| RF16 K | Reiniciar stock a 0 con confirmación. | Baja | Recuento completo |
Requerimientos no funcionales (RNF)
| ID | Requerimiento | Categoría |
|---|---|---|
| RNF01 | Un turno cargado aparece en el TV en menos de 2 minutos. | Rendimiento |
| RNF02 | Se usan desde el navegador en PC, celular o TV, sin instalar nada. | Usabilidad |
| RNF03 | El kiosco se maneja con una mano: botones de al menos 44 px y barra de sugerencias fija abajo. | Usabilidad / HCI |
| RNF04 | Sin jerga técnica: estados con palabras y colores. | Usabilidad / HCI |
| RNF05 | Contraseñas con hash y consultas preparadas. | Seguridad |
| RNF06 | Configuración por variables de entorno y migración automática de la base. | Mantenimiento |
| RNF07 | Publicació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).
| ID | Qué NO hace en esta entrega | Por qué | ¿Versión futura? |
|---|---|---|---|
| LIM01 K | El 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 K | Si se borran los datos del navegador, se pierde el stock. | Misma causa que LIM01. | Sí. v2. |
| LIM03 K | No registra ventas, precios ni ganancias. | El pedido fue controlar cantidades. | Sí. v3. |
| LIM04 K | Los productos se agregan en el código, no desde la app. | El catálogo cambia poco. | Sí. |
| LIM05 T | No avisa superposiciones de turnos en la misma cancha. | La validación actual controla solo el horario. | Sí. v2. |
| LIM06 T | No permite cambiar la contraseña desde el panel. | Los usuarios se crean con el instalador. | Sí. v2. |
| LIM07 T | No toma reservas ni cobros de los jugadores. | Fuera del alcance pedido. | Sí. v3. |
| LIM08 T | Los 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)
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.
| ID | Requerimiento | Prioridad | Uso |
|---|---|---|---|
| RHW01 | TV o monitor con navegador por sede (Smart TV, TV box o PC por HDMI). | Alta | Turnero Pantalla pública. |
| RHW02 | PC o celular en recepción. | Alta | Turnero Panel de turnos. |
| RHW03 | Celular o tablet fijo del kiosco. | Alta | Kiosco Control de stock (ver LIM01). |
| RHW04 | Conexión a Internet en cada sede. | Alta | Ambos 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
| ID | Componente | Tecnología / Stack | Rol en el sistema |
|---|---|---|---|
| ISW01 T | Pantalla del TVpantalla/index.html | HTML, CSS y JavaScript | Lee la API cada 2 minutos y dibuja los turnos. |
| ISW02 T | Panel de turnosadmin/ | PHP 8.2 | Login, formulario y listado por sede. |
| ISW03 T | API RESTapi/ | PHP 8.2, JSON | Lectura pública; escritura con sesión y rol. |
| ISW04 T | Base de datos | MySQL en Railway | Sedes, turnos y usuarios. Modelo en 5.6. |
| ISW05 T | ContenedorDockerfile | php:8.2-apache, pdo_mysql | Ejecuta el turnero en el puerto 8080. |
| ISW06 K | App de stockApp.jsx | React 18, Vite 5, Tailwind (CDN), lucide-react | Toda la lógica de stock y sugerencias. |
| ISW07 K | Persistencia local | localStorage, clave kiosco:stock:v1 | Guarda stock, ventas semanales y sugerencias anotadas. |
| ISW08 K | Servidor estático | serve 14 (Node.js) | Publica la carpeta dist en Railway. |
5.5. Interfaces de comunicación Buenas Prácticas UTN p.59
| Interfaz | Protocolo / Formato | Detalle |
|---|---|---|
| Pantalla → API T | HTTPS / REST (JSON) | GET /api/turnos.php?fecha=hoy. Público, sin login. |
| Panel → API T | HTTPS / formulario POST | POST /api/guardar.php y POST /api/eliminar.php, con sesión de rol admin o recepción. |
| Backend → Base de datos T | TCP / SQL (MySQL) | PDO a mysql.railway.internal:3306, tomado de MYSQL_URL. |
| Celular → Railway K | HTTPS | Solo 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
| Forma | Qué exige | Cómo se cumple |
|---|---|---|
| 1FN | Valores 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). |
| 2FN | Sin dependencias parciales de la clave. | Todas las tablas usan clave primaria simple (id). |
| 3FN | Sin dependencias transitivas. | La dirección de la sede no se repite en cada turno: el turno referencia a la sede por sede_id. |
sedes.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.
Relaciones
| Entidad | Card. | Entidad | Significado |
|---|---|---|---|
| SEDES | 1 : N | TURNOS | Una 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:
| Campo | Dónde vive | Descripción |
|---|---|---|
| id, cat, name, emoji, pack | Código | Identificador, categoría, nombre, ícono y unidades por pack. |
| weekly | Código (valor inicial) y navegador | Venta estimada por fin de semana. Editable. |
| stock | Navegador | Unidades actuales. Nunca menor que 0. |
| done | Navegador | Lista de sugerencias marcadas como anotadas. |
| version | Navegador | Versió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.
6. Oferta de Gestión
6.1. GANTT
| Etapa | Tareas principales | Entregable |
|---|---|---|
| E01 | Entrevista con Turin Sport. Relevamiento de las dos sedes, las canchas y el kiosco. | Definición del problema y línea de base. |
| E02 | Factibilidad técnica, económica y de gestión. Elección de tecnologías y hosting. | Estudio de factibilidad. |
| E03 | RF, RNF, arquitectura y modelo de datos. | Especificación + ER. |
| E04 | Mockups y validación con el cliente. | Mockup validado. |
| E05 | Desarrollo del turnero y del kiosco, publicación, migración a Railway y documentación. | Sistemas online + documentación. |
| E06 | Presentación profesional, defensa y pitch. | Presentación + landing. |
6.2. Infraestructura administrativa Buenas Prácticas UTN p.62
| Grupo | Rol | Función |
|---|---|---|
| Dirección y Gestión | Director / PM | Coordinación, recursos y relación con el cliente. |
| Líder de proyecto | Asignación de tareas; planificación temporal y económica. | |
| Desarrollo | Backend / BD | PHP, API, MySQL. |
| Frontend / UX-UI | Pantalla del TV, panel y app del kiosco. | |
| Infraestructura | GitHub, Docker y Railway. |
El equipo
<span class="m-photo"></span> por <img class="m-photo" src="img/integrante-01.jpg" alt="Foto de Nombre Apellido">. Eliminar las tarjetas sobrantes.Planilla de cálculo: GANTT, tareas y costos.
Este sitio en GitHub Pages; README en cada repositorio.
Grupo de mensajería del equipo y reuniones con el cliente.
GitHub, con despliegue automático en Railway.
Figma para las interfaces.
7. Oferta Económica
7.1. Proveedores de conectividad y hosting
| Ítem | Opción | Costo |
|---|---|---|
| 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 MySQL | Servicio 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 landing | GitHub Pages. | Sin costo |
7.2. Proveedores de insumos electrónicos
| Componente | Cant. | Costo unit. | Subtotal |
|---|---|---|---|
| TV box o Smart TV (si la sede no tiene) | 1 por sede | A cotizar | Pendiente |
| Celular o tablet para el kiosco | 1 por kiosco | A cotizar | Pendiente |
7.3. Proveedores de insumos varios
| Ítem | Detalle | Costo |
|---|---|---|
| Soporte de pared para el TV | Si hace falta instalarlo en la sede. | A cotizar |
8. Estimación Económica
| Rubro | Detalle | Monto |
|---|---|---|
| Hosting | Railway Hobby, 12 meses (7.1). | US$60 / año |
| Equipamiento | TV box y celular, si el cliente no los tiene (7.2). | A completar |
| Insumos varios | Soporte de TV (7.3). | A completar |
| Horas hombre | Desarrollo, diseño, despliegue y documentación, por categoría y costo/hora. | A completar |
| Total estimado | Suma de los rubros anteriores. | A completar |
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).
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.
Equipo desarrollador (3.3) y Turin Sport, representado por su responsable.
Lo definido en 3.2 y 5. Queda fuera lo listado en LIM01 a LIM08.
Según el GANTT (6.1). A completar con las fechas reales.
Equipo: desarrollo, publicación y documentación. Cliente: validar, proveer TV, celular e Internet, y mantener activo el plan de Railway.
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.
Todo cambio se registra en el Control de Cambios (1) y se evalúa su impacto en plazos y costos antes de aceptarse.
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
| Fecha | Con quién | Objetivo | Modalidad |
|---|---|---|---|
| A completar | Responsable de Turin Sport | Entrevista 1. Cómo se manejan hoy los turnos de las dos sedes. | Presencial |
| A completar | Encargado del kiosco | Entrevista 2. Productos, ventas del fin de semana y forma de comprar. | Presencial |
| A completar | Responsable de Turin Sport | Validació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ón | A completar. |
| Participantes | Turin Sport y el equipo de proyecto. |
| Objetivo | Revisar el panel de turnos en uso. |
| Temas tratados | Comodidad del formulario, forma de cargar horarios y canchas de La Cautiva. |
| Decisiones y acuerdos | Desde 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 pasos | Implementar los cambios (v1.3) y publicarlos en Railway. |
10.3. Registro de Cambios del Mockup
| Componente | Qué se modificó | Por qué |
|---|---|---|
| Formulario de turno | Pasó de dos columnas a una sola. | Desde y Hasta quedaban separados y la carga era incómoda (RF09). |
| Campos de horario | De campo de hora con minutos a lista de horas en punto. | Las canchas se alquilan por hora completa (RF07). |
| Tipo de cancha | Campo 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
| Etapa | Hitos registrados | Fecha de cierre |
|---|---|---|
| E05 | Turnero v1.0 online en Alwaysdata. | A completar |
| E05 | Control de stock del kiosco (React + Vite) publicado en Railway. | 10/09/2026 |
| E05 | Pérdida de la cuenta de Alwaysdata; el código se conserva en GitHub. Dockerización y migración a Railway. | A completar |
| E05 | Cambios del cliente en el panel (v1.3). | 22/09/2026 |
| E05 | Nuevo repositorio canchasgod, servicio MySQL, variable MYSQL_URL e instalación. | 22/09/2026 |
| E05 | Documentación, manual, FAQ y landing en GitHub Pages. | 22/09/2026 |
| E06 | Presentació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.
Entrar al panel de turnos
Admin y recepciónAbrir el panel e ingresar usuario y contraseña.
Cargar un turno
Admin y recepciónElegir 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”.
Editar o borrar
Admin y recepciónEn la tabla de la sede, tocar “Editar” o “Borrar” en la fila del turno.
Dejar la pantalla en el TV
AdminAbrir la pantalla en el navegador del TV y ponerla en pantalla completa. Se actualiza sola.
Descontar una venta en el kiosco
Encargado del kioscoAbrir el control de stock y tocar “−” en el producto vendido.
Reponer
Encargado del kioscoTocar “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.