Documentación de Historia de Usuario¶

1. Información General¶

2. Historia de Usuario¶

Como técnico de servicio, quiero cargar diagnóstico, tareas y solución directamente en el sistema con la menor cantidad de clicks posible, para que toda la información del servicio quede registrada en un solo lugar y no la tenga que duplicar en Google Chat o WhatsApp.

3. Descripción¶

El MVP busca que el técnico adopte el sistema como herramienta principal para registrar la información del servicio: diagnóstico, partes necesarias (de forma descriptiva), solución aplicada y tareas realizadas. Hoy esta información circula por Google Chat y de manera verbal.

El cambio se concentra en reducir la fricción del alta de tareas y en mejorar la visibilidad de las secciones que el técnico usa durante la llamada (comentarios siempre visibles, orden de pestañas según los estados del servicio).

Es un MVP exploratorio: el objetivo es observar el uso real de la herramienta para alimentar las decisiones siguientes de v2.

4. Actores Involucrados¶

Actor	Rol
Técnico de servicio	Carga diagnóstico, tareas y solución durante la atención de un servicio asignado
Sistema OMS	Registra la información en la llamada de servicio

5. Criterios de Aceptación¶

Alta de tareas¶

[ ] CA-01: El técnico ingresa el ítem labor en un selector con búsqueda
[ ] CA-02: Cada selección agrega el ítem a una lista a confirmar
[ ] CA-03: Si el ítem labor no existe, el técnico lo crea en línea desde el mismo selector
[ ] CA-04: El asunto de la tarea queda preconfigurado en "Ejecución"
[ ] CA-05: En el alta no se pide nota, ni cantidad, ni asignado
[ ] CA-06: Antes de confirmar, el técnico puede quitar ítems de la lista a confirmar
[ ] CA-07: Con un solo botón se confirman todas las tareas de la lista
[ ] CA-08: Una tarea ya agregada al servicio puede eliminarse

Captura del trabajo¶

[ ] CA-09: El técnico carga el diagnóstico técnico en el sistema
[ ] CA-10: Dentro del diagnóstico, el técnico lista las partes necesarias en términos descriptivos (ej. "SSD 250 GB")
[ ] CA-11: El técnico carga la solución aplicada al servicio

Comentarios¶

[ ] CA-12: La sección de comentarios está siempre visible al abrir la llamada de servicio (no en una pestaña)

Orden de pestañas¶

[ ] CA-13: Las pestañas siguen el orden de estados: Diagnóstico → Presupuesto → Tareas → Soluciones → Documentos

Filtros en la lista de servicios¶

[ ] CA-14: En la vista de lista de servicios hay un campo de búsqueda único que filtra por número de recepción o nombre del equipo
[ ] CA-15: Si el técnico ingresa un número (ej. "6304"), la lista muestra los servicios cuyo número de recepción coincide
[ ] CA-16: Si el técnico ingresa un nombre de equipo (ej. "EPSON L5990"), la lista muestra los servicios cuyo equipo coincide
[ ] CA-17: Por defecto, la vista de lista de servicios solo muestra servicios en estados abiertos (los cerrados no aparecen en el tablero)
[ ] CA-18: El técnico puede habilitar explícitamente la búsqueda sobre los servicios cerrados; al hacerlo, el filtro por número de recepción o nombre del equipo aplica también a esos servicios

Información mostrada en la tarjeta del tablero¶

[ ] CA-19: La tarjeta del servicio en el tablero no muestra el texto "EQUIPO SERVICIO TÉCNICO"

6. Escenarios (Gherkin / BDD)¶

Escenario: Alta rápida de tareas con selector de búsqueda
  Dado que el técnico está viendo una llamada de servicio asignada
  Cuando abre el selector de tareas
  Y escribe el nombre de un ítem labor
  Y selecciona un ítem de los resultados
  Entonces el ítem queda agregado a una lista a confirmar
  Y el asunto de la tarea queda preconfigurado en "Ejecución"
  Y no se le piden notas, cantidad ni asignado

Escenario: Confirmar múltiples tareas en un solo paso
  Dado que el técnico tiene varios ítems en la lista a confirmar
  Cuando presiona el botón de confirmar
  Entonces todas las tareas se agregan a la llamada de servicio

Escenario: Quitar un ítem antes de confirmar
  Dado que el técnico tiene varios ítems en la lista a confirmar
  Cuando quita un ítem de la lista
  Entonces el ítem deja de aparecer en la lista a confirmar
  Y al confirmar no se crea una tarea para ese ítem

Escenario: Crear ítem labor en línea cuando no existe
  Dado que el técnico está buscando un ítem labor en el selector
  Y el ítem no existe en el sistema
  Cuando crea el ítem en línea desde el selector
  Entonces el ítem queda creado y agregado a la lista a confirmar

Escenario: Eliminar una tarea ya agregada al servicio
  Dado que la llamada de servicio tiene tareas ya agregadas
  Cuando el técnico elimina una tarea
  Entonces la tarea deja de figurar en la llamada

Escenario: Carga del diagnóstico técnico
  Dado que el técnico está viendo una llamada de servicio
  Cuando carga el diagnóstico técnico
  Entonces el diagnóstico queda registrado en la llamada

Escenario: Listar partes necesarias dentro del diagnóstico
  Dado que el técnico está cargando el diagnóstico
  Cuando lista una parte necesaria con descripción libre (ej. "SSD 250 GB")
  Entonces la parte queda registrada como texto descriptivo
  Y no requiere selección de ítem SAP, ni precio, ni stock

Escenario: Carga de la solución aplicada
  Dado que el técnico finalizó el trabajo en el equipo
  Cuando carga la solución aplicada en la llamada
  Entonces la solución queda registrada en el servicio

Escenario: Comentarios visibles permanentemente
  Dado que el técnico abre una llamada de servicio
  Cuando se carga la vista de la llamada
  Entonces la sección de comentarios está visible sin abrir ninguna pestaña

Escenario: Orden de pestañas según estados del servicio
  Dado que el técnico abre una llamada de servicio
  Cuando ve las pestañas
  Entonces aparecen en el orden Diagnóstico, Presupuesto, Tareas, Soluciones, Documentos

Escenario: Filtrar la lista de servicios por número de recepción
  Dado que el técnico está en la vista de lista de servicios
  Cuando ingresa "6304" en el campo de búsqueda
  Entonces la lista muestra solo los servicios cuyo número de recepción coincide con "6304"

Escenario: Filtrar la lista de servicios por nombre del equipo
  Dado que el técnico está en la vista de lista de servicios
  Cuando ingresa "EPSON L5990" en el campo de búsqueda
  Entonces la lista muestra solo los servicios cuyo equipo coincide con "EPSON L5990"

Escenario: Encontrar un servicio cerrado
  Dado que el técnico está en la vista de lista de servicios
  Y por defecto la lista solo muestra servicios en estados abiertos
  Cuando habilita la opción para incluir servicios cerrados
  E ingresa "6304" en el campo de búsqueda
  Entonces la lista muestra también los servicios cerrados cuyo número de recepción coincide

Escenario: La tarjeta del tablero no muestra el texto "EQUIPO SERVICIO TÉCNICO"
  Dado que el técnico está viendo el tablero de servicios
  Cuando se renderiza una tarjeta de servicio
  Entonces la tarjeta no muestra el texto "EQUIPO SERVICIO TÉCNICO"

7. Wireframes / Mockups¶

Pendiente. El diseño visual no es parte del análisis cubierto en esta historia; se definirá en una etapa posterior.

8. Flujo de Usuario¶

El técnico abre la lista de servicios y, si necesita encontrar uno específico, usa el campo de búsqueda por número de recepción o nombre del equipo. Por defecto solo se buscan servicios en estados abiertos; si el servicio podría estar cerrado, habilita explícitamente la búsqueda sobre cerrados.
Abre una llamada de servicio asignada.
Visualiza la información del servicio con las pestañas en orden Diagnóstico → Presupuesto → Tareas → Soluciones → Documentos. Los comentarios están siempre visibles.
Carga el diagnóstico técnico, incluyendo la lista descriptiva de partes necesarias.
Abre el selector de tareas y agrega ítems labor a la lista a confirmar.
Si algún ítem labor no existe, lo crea en línea desde el selector.
Quita de la lista a confirmar los ítems mal agregados.
Confirma todas las tareas con un solo botón.
Si más adelante necesita dar de baja alguna tarea ya agregada, la elimina.
Carga la solución aplicada al cerrar el trabajo en el equipo.

9. Reglas de Negocio¶

RN-01: El alta rápida de tareas se hace sobre ítems tipo labor.
RN-02: El asunto de las tareas creadas desde el alta rápida queda en "Ejecución" por defecto.
RN-03: La lista de partes necesarias dentro del diagnóstico es descriptiva. (puede agregarse un formato tipo lista)
RN-04: Los técnicos no pueden asignar tareas a otros técnicos. La asignación es responsabilidad del encargado.
RN-05: Los técnicos solo pueden ver los servicios que les fueron asignados.
RN-06: El cambio de estado de la llamada de servicio sigue siendo manual; en el alcance de este MVP no hay automatización ni inferencia de estados.
RN-07: El campo de búsqueda en la vista de lista de servicios filtra de manera indistinta por número de recepción o nombre del equipo.
RN-08: Por defecto, la vista de lista de servicios solo muestra servicios en estados abiertos. La inclusión de servicios cerrados en la búsqueda se habilita explícitamente.

10. Requisitos Técnicos / Notas de Implementación¶

Pendiente. El detalle técnico (endpoints, modelos, integración con SAP Service Layer) se definirá en la etapa de diseño técnico, posterior a la validación de esta historia. Esta historia se enfoca en el comportamiento observable.

11. Dependencias¶

ID Historia	Título	Tipo de dependencia
-	-	-

12. Definición de Hecho (DoD)¶

[ ] Código desarrollado y revisado (PR aprobado)
[ ] Pruebas unitarias escritas y aprobadas
[ ] Pruebas de integración pasadas
[ ] Criterios de aceptación validados
[ ] Documentación actualizada
[ ] Desplegado en ambiente de QA

13. Estimación¶

Métrica	Valor
Story Points	-
Esfuerzo estimado (horas)	-
Sprint asignado	-

14. Historial de Cambios¶

Fecha	Autor	Cambio realizado
2026-04-28	-	Versión inicial
2026-04-28	-	Agregados filtros en la vista de lista de servicios (CA-14..CA-16, RN-07)
2026-04-28	-	Búsqueda sobre servicios cerrados (CA-17, CA-18, RN-08)
2026-04-28	-	Limpieza de información en la tarjeta del tablero: quitar texto "EQUIPO SERVICIO TÉCNICO" (CA-19)