📒Expecificación Funcional plataforma

Versión: V2
Fecha: 10 de abril de 2026
Propósito: consolidar en un solo lugar la definición funcional actual de Plataforma Tekus para Kioscos Autoservicio, integrando lo previamente documentado y los nuevos hallazgos provenientes de recorridos grabados y pruebas QA.
Uso principal: claridad funcional interna para producto, soporte, comercial y equipo técnico.

1. Cómo debe leerse este documento

Este documento ya no asume que todo lo visible en plataforma está funcionalmente consolidado. A partir de esta iteración, cada módulo o capacidad se clasifica con uno de estos estados:

• Consolidada: existe, su propósito es claro y no se encontró en estos insumos una señal fuerte de inestabilidad funcional.

• Parcial: existe y su propósito es entendible, pero todavía hay vacíos de validación, cobertura incompleta o claridad insuficiente para tratarla como totalmente consolidada.

• No consolidada: existe en interfaz, documentación o discurso operativo, pero los insumos de QA muestran bugs, ambigüedades o comportamientos que impiden tratarla como capacidad estable.

• Pendiente de validación: aparece mencionada o visible, pero estos insumos no permiten afirmar con suficiente seguridad su comportamiento real de punta a punta.

Regla de esta versión

Si una capacidad aparece en plataforma, pero en pruebas se comporta con errores, no se considerará funcionalidad consolidada.

2. Alcance funcional consolidado en esta iteración

Este documento integra información de:

• Manual funcional previo de kioscos.

• Guía operativa tipo Scribe de funcionalidades del kiosco.

• Nuevos recorridos grabados por módulos dentro de plataforma.

• Pruebas QA transcritas, tratadas como evidencia funcional de comportamiento real.

Módulos incluidos

• Panel de inicio

• Acciones rápidas

• Kioscos

  • Pantalla inicial y creación

  • Información básica

  • Módulos

  • Configuración

  • Mantenimiento

• Catálogos

• Productos dentro de catálogo

• Categorías

• Lugares

• Multimedia

• Plantillas

• Hallazgos transversales que impactan kioscos

• Apartado de bugs detectados

3. Contexto funcional del producto

Plataforma Tekus es el sistema administrativo desde el cual se crea, configura y monitorea un kiosco autoservicio. Dentro del ecosistema actual, la operación del kiosco depende de la relación entre estas piezas:

1. Plataforma Tekus, donde se crea y administra el kiosco.

2. AKF, que corre en el equipo físico del kiosco y lo conecta con la plataforma.

3. Código de emparejamiento, que vincula el equipo físico con el kiosco creado en plataforma.

4. Contenido operativo, como catálogos, productos, estilos, formularios, medios de pago y demás módulos configurables.

Esto significa que el producto no debe entenderse solo como “un kiosco creado en plataforma”, sino como una combinación entre configuración administrativa, despliegue técnico y contenido funcional.

4. Resumen ejecutivo por módulo

5. Documento maestro por módulo

5.1 Panel de inicio

Estado: Consolidada

Qué es

Es la vista resumen del producto Kioscos dentro de Plataforma Tekus. Permite observar el estado general de la operación antes de entrar al detalle de cada kiosco.

Qué muestra

• Total de kioscos

• Kioscos activos

• Kioscos inactivos

• Indicadores visuales por estado

• Vista general para priorizar seguimiento o soporte

Para qué sirve

• Monitorear rápidamente el estado general de la cuenta

• Detectar kioscos en mantenimiento, activos o inactivos

• Tener una lectura ejecutiva antes de profundizar en módulos específicos

Qué no debe asumirse

No debe entenderse como un centro completo de operación ni como reemplazo del módulo Kioscos. Su valor principal es de lectura y contexto.

5.2 Acciones rápidas

Estado: Consolidada

Qué es

Es una zona de accesos directos para iniciar flujos frecuentes sin entrar primero al módulo completo.

Acciones observadas

• Crear kiosco

• Crear catálogo

• Crear categoría

• Subir archivo a multimedia

Para qué sirve

• Reducir pasos para tareas de creación frecuentes

• Acelerar la operación administrativa del día a día

Lectura funcional correcta

Acciones rápidas no es un módulo nuevo. Es un atajo hacia capacidades ya existentes en otros módulos.

Impacto en kioscos

Mejora eficiencia operativa interna, pero no cambia la lógica funcional del kiosco frente al usuario final.

5.3 Kioscos — pantalla inicial y creación de kiosco

Estado: Consolidada

Qué es

Es el módulo principal donde se listan los kioscos existentes y desde donde se crea un nuevo kiosco.

Qué se observa en la pantalla inicial

• Listado de kioscos creados

• Estado de conexión

• Filtros y búsqueda

• Acceso al detalle del kiosco

• Acción para crear un kiosco nuevo

Flujo funcional de creación

1. Ingresar nombre del kiosco

2. Seleccionar licencia

3. Elegir categoría o tipo de implementación disponible en plataforma

4. Ingresar código de emparejamiento o posponer la vinculación

5. Continuar con configuración posterior del kiosco

Elementos relevantes de creación

• Nombre del kiosco: identificador operativo del punto

• Licencia: define el alcance comercial o de uso del kiosco

• Categoría: orienta el tipo de implementación disponible en esa instancia

• Código de emparejamiento: puente entre plataforma y el equipo con AKF

Estado de esta capacidad

El flujo base está suficientemente claro y consistente entre documentación previa y recorrido grabado.

5.4 Kioscos — información básica

Estado: Consolidada

Qué es

Es la sección de lectura principal del kiosco una vez se entra al detalle.

Qué muestra

• Nombre del kiosco

• Estado actual

• Categoría

• Cantidad de catálogos asociados

• Cantidad de categorías asociadas

• Cantidad de productos asociados

• Lugar, cuando aplica

• Plantilla, cuando aplica

• Versión de AKF / KDF, según visualización disponible

• Alertas activas

Para qué sirve

• Entender rápidamente cómo está configurado el kiosco

• Validar si el kiosco tiene contenido asociado

• Detectar si le faltan relaciones clave para operar

Lectura funcional correcta

Esta vista sirve como diagnóstico administrativo del kiosco. No reemplaza el detalle de los submódulos, pero sí concentra la lectura general del estado del recurso.

5.5 Kioscos — módulos

Estado: Parcial

Qué es

Es la sección donde se agrupan configuraciones funcionales que afectan la experiencia del usuario final y la operación del kiosco.

Submódulos observados

• Formulario

• Checkbox

• Medios de pago

• Tipo de entrega

• Catálogos y productos

• Estilos

• Localizadores

• Cupones

Lectura general

Es uno de los núcleos del producto. Sin embargo, no todos los submódulos tienen en esta iteración el mismo nivel de validación funcional integral.

5.5.1 Formulario

Estado: Consolidada

Qué permite configurar

• Campos visibles para el usuario final

• Campos obligatorios

• Campos editables

• Habilitar o deshabilitar campos existentes

• Crear campos nuevos

• Definir tipo de campo, según variantes observadas

Lectura funcional correcta

El formulario gobierna qué datos personales o transaccionales debe diligenciar el cliente durante el flujo de compra.

Impacto en kioscos

Afecta directamente el nivel de fricción de la compra y el dato que se captura en el proceso.

5.5.2 Checkbox

Estado: Consolidada

Qué permite configurar

• Activación de casillas de aceptación

• Texto de términos y condiciones

• Visibilidad de dicha aceptación dentro del flujo de compra

Lectura funcional correcta

Se usa principalmente para formalizar la aceptación de términos y condiciones u otras validaciones obligatorias.

5.5.3 Medios de pago

Estado: Parcial

Medios observados

• Efectivo

• Tarjeta

• Pago con QR

• Otros

Qué permite configurar

• Habilitar o deshabilitar medios de pago visibles en el kiosco

• Asociar íconos o recursos visuales al método de pago

Lectura funcional correcta

No todos los métodos implican necesariamente procesamiento directo desde el kiosco. Por ejemplo, efectivo puede significar remisión a caja y no recepción física en el dispositivo.

Razón del estado parcial

La existencia del módulo está clara, pero algunos comportamientos dependen de integraciones o configuraciones más profundas que no quedaron completamente validadas en estos insumos.

5.5.4 Tipo de entrega

Estado: Consolidada

Opciones observadas

• Para comer aquí

• Para llevar

• Domicilio

• Recoger en tienda

Qué permite configurar

• Habilitar o deshabilitar opciones visibles al usuario

• Servir como regla para condicionar catálogos

Impacto en kioscos

Es una pieza clave porque afecta tanto la experiencia del usuario como la lógica de visibilidad del contenido.

5.5.5 Catálogos y productos dentro del kiosco

Estado: Consolidada

Qué permite

• Ver catálogos asociados al kiosco

• Ver categorías y productos que componen el contenido del kiosco

• Asociar catálogos a un kiosco

• Revisar la estructura del contenido visible

Regla importante

Un kiosco puede tener más de un catálogo asociado, y la visualización final puede depender del tipo de entrega configurado.

5.5.6 Estilos

Estado: Parcial

Qué permite configurar

• Logotipo

• Aspecto general

• Colores

• Tipografía

• Botones

• Tarjetas

Lectura funcional correcta

Es el módulo de personalización visual del kiosco para acercarlo a la identidad de la marca.

Razón del estado parcial

Existe y es usable, pero QA introdujo dudas transversales sobre flexibilidad real de color y restricciones de marca. Por ahora debe tratarse como una capacidad válida, pero no totalmente libre ni totalmente cerrada.

5.5.7 Localizadores

Estado: Parcial

Qué permite

• Definir la cantidad de localizadores disponibles

• Gestionar la lógica asociada al número de localizadores

Observación

La existencia del módulo y su propósito básico son visibles, pero esta iteración todavía no permite afirmar el comportamiento completo de punta a punta dentro del kiosco.

5.5.8 Cupones

Estado: Consolidada

Qué permite configurar

• Nombre del cupón

• Código de validación

• Valor mínimo de compra

• Tipo de descuento

• Valor o porcentaje del descuento

• Parámetros adicionales visibles en la interfaz

Lectura funcional correcta

Permite construir promociones o incentivos transaccionales dentro del kiosco.

5.6 Kioscos — configuración

Estado: Parcial

Qué es

Sección del kiosco donde se ajustan parámetros básicos y avanzados del recurso ya creado.

Configuración básica observada

• Nombre del kiosco

• Descripción

• Licencia

• Identificadores o versiones visibles según la cuenta

Configuración avanzada observada

• Actualizaciones automáticas

• Habilitar estado de mantenimiento

• Deshabilitar kiosco

• Modo sandbox

• Habilitar pago con datáfono por integración API

• ID del terminal de pago

Lectura funcional correcta

La configuración básica sí puede considerarse entendida. La configuración avanzada existe en interfaz y debe reconocerse como parte del producto, pero todavía no debe presentarse como un frente completamente validado a nivel funcional integral.

Regla para esta versión

Todo lo que sea visible en configuración avanzada, pero no haya sido suficientemente validado en comportamiento de punta a punta, se tratará como Parcial y no como totalmente consolidado.

5.7 Kioscos — mantenimiento

Estado: Parcial

Qué es

Área de acciones operativas sobre un kiosco ya creado.

Acciones observadas

• Reiniciar kiosco

• Reiniciar aplicación

• Obtener logs o acciones equivalentes visibles de soporte

Diferencia funcional importante

• Reiniciar kiosco: reinicia el sistema operativo del equipo

• Reiniciar aplicación: reinicia solo la aplicación del kiosco, no el sistema operativo

Lectura funcional correcta

Es una capacidad operativa valiosa, especialmente para soporte. Sin embargo, debe mantenerse alineada con la línea de producto que ya venía discutiendo tareas administrativas y mantenimiento remoto como una capacidad que necesita madurez y consistencia.

5.8 Catálogos

Estado: Consolidada

Qué es

Módulo donde se listan, crean, editan, clonan, vinculan y eliminan catálogos.

Acciones observadas

• Crear catálogo

• Editar

• Clonar

• Vincular a kiosco

• Eliminar

• Selección múltiple para operaciones en lote

Flujo de creación observado

1. Nombre del catálogo

2. Descripción

3. Datos requeridos

4. Impuestos como opción adicional

5. Crear nuevo campo personalizado

6. Etiquetas

7. Guardar

Qué impacta en kioscos

El catálogo es la estructura principal del contenido que el kiosco puede mostrar.

Regla importante

Los catálogos pueden vincularse directamente a kioscos y, según configuración, pueden mostrarse de forma condicionada por tipo de entrega.

5.9 Productos dentro de catálogo

Estado: Parcial

Qué es

Es la administración del contenido transaccional que vive dentro de un catálogo.

Qué permite

• Crear productos uno a uno

• Cargar productos de forma masiva por Excel

• Definir nombre, PLU, descripción, precio y descuento

• Asignar imagen

• Asignar categoría

• Activar o desactivar productos

• Trabajar alertas sobre productos sin categoría

• Gestionar pasos de personalización, según documentación previa

• Gestionar productos relacionados o venta cruzada, según documentación previa

Restricciones observadas

• La actualización masiva no resuelve de forma completa la asignación de imágenes

• Hay una dependencia operativa importante entre producto, multimedia y categorías

Razón del estado parcial

El núcleo de creación existe y es claro, pero los hallazgos QA muestran fricciones en reutilización de multimedia y eso reduce la madurez operativa real del módulo.

5.10 Categorías

Estado: Consolidada

Qué es

Módulo de organización estructural de productos dentro de los catálogos.

Qué permite

• Listar categorías

• Crear categoría

• Editar

• Eliminar

• Asignar imagen a categoría

• Ver cuántos productos tiene asociada una categoría

Impacto en kioscos

Determina cómo se agrupa el menú y mejora la navegación del usuario final.

Lectura funcional correcta

Es una capacidad estable y esencial para ordenar la experiencia de compra.

5.11 Lugares

Estado: No consolidada

Qué es

Módulo para organizar operación por sedes o ubicaciones y relacionar kioscos, usuarios y otros recursos con un lugar específico.

Qué se venía entendiendo como funcionalidad

• Crear lugares

• Gestionar ubicación y horarios

• Vincular kioscos a un lugar

• Vincular usuarios a un lugar

• Usar el lugar como criterio organizacional y operativo

Qué mantiene valor funcional

El concepto es correcto y útil para la plataforma. Sigue siendo una pieza importante para segmentación operativa y control por sede.

Por qué no está consolidado

Los hallazgos de QA muestran que hoy esta área tiene comportamientos que impiden tratarla como totalmente estable. Entre ellos:

• problemas al vincular kioscos

• refrescos que repiten acciones previas

• falta de preselección clara de kioscos ya vinculados

• comportamientos erráticos en horarios e intervalos

• posibles problemas de navegación o administración en listas relacionadas

Regla para esta versión

Lugares sigue existiendo como módulo con propósito válido, pero no debe venderse ni documentarse internamente como una capacidad totalmente consolidada.

5.12 Multimedia

Estado: No consolidada

Qué es

Biblioteca central de imágenes y videos usados por el resto de la plataforma.

Qué permite según interfaz y documentación

• Subir archivos

• Filtrar por tipo

• Buscar

• Ordenar

• Refrescar

• Editar archivo

• Descargar

• Vincular a lugares

• Eliminar

• Selección múltiple

Valor funcional esperado

Es el repositorio visual que alimenta productos, categorías y otros activos de la experiencia.

Por qué no está consolidado

QA evidenció problemas importantes, especialmente en:

• eliminación masiva inconsistente

• comportamiento errático al cambiar el número de ítems por página

• selección múltiple inestable

• vinculación repetida a lugares sin claridad de estado previo

• falta de visibilidad de lugares ya vinculados

Lectura funcional correcta

Multimedia existe y es central para el producto, pero hoy debe tratarse como una capacidad con valor claro y estabilidad insuficiente.

5.13 Plantillas

Estado: Parcial

Qué es

Módulo para crear preconfiguraciones reutilizables que luego pueden asociarse a uno o varios kioscos.

Qué permite

• Crear plantilla

• Nombrarla

• Asociarla a una categoría de kiosco

• Configurar logo, aspecto, colores, tipografía, botones y tarjetas

• Asociar kioscos a la plantilla

• Visualizar estado general de kioscos con esa plantilla

• Asociar también contenido o módulos relacionados, según el flujo observado

Valor funcional

Es una capacidad altamente útil para escalabilidad operativa, especialmente cuando varios kioscos comparten la misma marca o configuración.

Razón del estado parcial

La dirección del módulo es clara y poderosa, pero en esta iteración todavía no hay suficiente evidencia para declararlo totalmente consolidado en todas sus relaciones y escenarios.

5.14 Permisos, usuarios y comportamientos transversales

Estado: No consolidada

Qué se observó en QA

Aunque no fue el foco principal del recorrido funcional, sí aparecieron señales que impactan la confiabilidad general de la plataforma para operar kioscos, por ejemplo:

• riesgo de quitar permisos críticos a usuarios

• necesidad de reactivar ciertos accesos por fuera de la plataforma

• dudas sobre persistencia real de permisos al cerrar sesión

• relaciones entre usuarios, lugares y vistas administrativas con comportamiento poco claro

Lectura funcional correcta

Esto no invalida el valor del modelo de permisos, pero sí impide tratarlo en este momento como una capa totalmente madura para operaciones sensibles.

6. Reglas funcionales clave del producto

6.1 Catálogo visible condicionado por tipo de entrega

Un kiosco puede tener varios catálogos, pero no necesariamente muestra todos al mismo tiempo. La visibilidad puede depender del tipo de entrega seleccionado.

6.2 La categoría organiza la navegación

El producto se visualiza dentro de un catálogo y ese catálogo se organiza mediante categorías. Por eso una mala administración de categorías afecta directamente la lectura del menú.

6.3 Multimedia no es un módulo aislado

Aunque existe como biblioteca central, su valor real depende de qué tan bien pueda ser reutilizada en productos, categorías y otras vistas. Por eso sus fallas operativas impactan varios módulos al mismo tiempo.

6.4 Plantillas apuntan a escalabilidad

Las plantillas no son solo una configuración visual. Son una apuesta de eficiencia operativa para evitar configurar kioscos uno por uno cuando comparten marca, contenido o estructura.

6.5 Mantenimiento y configuración no son lo mismo

Configurar un kiosco define cómo opera; mantenimiento ejecuta acciones sobre un kiosco ya existente.

7. Inventario funcional actualizado

8. Apartado de bugs detectados

Este apartado no redefine el producto, pero sí condiciona qué puede considerarse estable en esta versión.

8.1 Bugs y hallazgos en Lugares

• La búsqueda o selección de ubicación no tiene un comportamiento claro para dirección exacta.

• La gestión de intervalos en horarios presenta inconsistencias al agregar o quitar franjas.

• Al desmarcar días o quitar intervalos, el resultado no siempre refleja correctamente la acción esperada.

• La vinculación de kioscos al lugar puede ejecutar de nuevo la última acción al refrescarse la vista.

• La lista de kioscos ya vinculados no siempre aparece marcada o preseleccionada.

• Esto puede inducir al usuario a intentar asociar de nuevo un kiosco ya vinculado.

• Hay señales de doble ejecución de acciones en el flujo de agregar kioscos a lugares.

• Se detectaron inconsistencias en vistas de administración relacionadas con listas de lugares.

8.2 Bugs y hallazgos en Multimedia

• La selección múltiple no se comporta de forma consistente en todos los contextos.

• Al cambiar la cantidad de ítems por página, la selección puede perderse o alterarse.

• En algunos casos la eliminación masiva solo elimina parte de lo seleccionado.

• La vinculación a lugares permite repetir asociaciones sin mostrar con claridad qué ya está vinculado.

• La pantalla no deja claro el estado previo de asociación de una imagen a lugares.

8.3 Bugs y hallazgos en Productos / Catálogos

• En creación de nuevos productos dentro de catálogos, se reportó la necesidad de volver a subir imágenes aunque ya existan en multimedia.

• Esto rompe la expectativa de reutilización centralizada de recursos y afecta eficiencia operativa.

• Existen productos sin categoría como hallazgo operativo visible, lo cual no es un bug en sí mismo, pero sí una deuda de administración que afecta navegación y coherencia.

8.4 Bugs y hallazgos transversales de componentes

• Comportamientos similares de selección, refresco o conservación de estado parecen repetirse en varias tablas o vistas.

• Hay indicios de que ciertos componentes compartidos de la plataforma no se comportan igual en todos los módulos.

• Esto afecta la confiabilidad transversal del producto.

8.5 Hallazgos en permisos y acceso

• Riesgo de pérdida de permisos críticos por autoadministración incorrecta.

• Dependencia de reactivación externa en algunos casos.

• Persistencia y control de permisos no completamente claros en los recorridos QA.

9. Lectura final de esta versión

La plataforma ya tiene una base funcional amplia para administrar kioscos autoservicio. Sin embargo, esta iteración deja una conclusión importante: tener una capacidad visible en interfaz no basta para tratarla como funcionalidad consolidada.

A partir de los insumos revisados, la plataforma hoy puede leerse así:

• Base funcional sólida: panel de inicio, acciones rápidas, creación de kioscos, información básica, catálogos, categorías, tipo de entrega, cupones y gran parte del flujo administrativo principal.

• Capacidades valiosas pero todavía parciales: módulos internos del kiosco como estilos, configuración avanzada, mantenimiento, medios de pago, localizadores, productos y plantillas.

• Capacidades existentes pero no consolidadas por comportamiento real: lugares, multimedia y varios flujos transversales relacionados con permisos, selección múltiple o refrescos de estado.

Esta lectura hace que el documento quede más cerca de una fuente de verdad funcional realista y útil para producto que de una lista optimista de capacidades disponibles.