Define los flujos de usuario, estados del ciclo de vida, solicitudes de permisos, comportamiento sin conexión y casos límite específicos de la plataforma para la bandeja de escritorio. Corrige los límites de adopción y la evidencia observable de fallos mientras mantiene configurables los límites específicos del entorno.
Estado del paquete: contexto de referencia listo para revisión humana. El contrato y los escenarios de prueba están completos, pero no se afirma que una implementación adoptante los haya superado.
Decisión
Para la bandeja de escritorio, adoptar un contrato de dominio neutral en cuanto a plataforma con adaptadores nativos explícitos. Definir un recorrido de usuario determinista con estado visible, elecciones reversibles cuando sea posible, entrada preservada y recuperación accesible. Este paquete es un contrato de referencia: el equipo adoptante debe elegir límites numéricos, proveedores, jurisdicciones y responsables operativos basándose en la evidencia de su propio entorno.
Alcance
- Los actores, entradas, salidas, estados, versiones de políticas o esquemas y resultados visibles externamente descritos por este bloque UX de la bandeja de escritorio.
- Interfaces primarias y alternativas, trabajo en segundo plano, cachés, integraciones, rutas de soporte y evidencia que pueda ejercer el mismo límite.
- Configuración específica de adopción, despliegue, recuperación y responsabilidades de verificación necesarias para aplicar la referencia de forma segura.
Fuera de este bloque
- Elegir un proveedor universal, framework, jurisdicción, umbral numérico, periodo de retención u objetivo de nivel de servicio para todos los adoptantes.
- Afirmar que los escenarios empaquetados se han ejecutado contra una implementación descendente o que esta referencia otorga certificación legal, de seguridad o de accesibilidad.
Contrato
- Modelar estados en primer plano, segundo plano, terminados, sin conexión, restaurados, desconectados y con permiso denegado donde la función dependa de ellos.
- Tratar las llamadas de retorno del sistema operativo y los enlaces externos como entradas no confiables y reautorizar la acción de dominio resultante.
- Almacenar claves sensibles solo a través de instalaciones protegidas por la plataforma y minimizar los valores copiados a notificaciones, registros, copias de seguridad y portapapeles.
- Hacer que las operaciones de sincronización sean idempotentes con versiones duraderas o identificadores de operación en lugar de suposiciones basadas en tiempo transcurrido.
- Mostrar progreso solo mientras haya trabajo realmente pendiente y evitar activaciones duplicadas sin ocultar la intención comprometida del usuario.
- Usar mensajes simples y específicos de la acción que distingan validación, permiso, conectividad, conflicto y fallo terminal.
- Exponer el estado y las acciones de la bandeja con nombres accesibles, cuenta actual y estado de sincronización, menús conformes a la plataforma y una clara distinción entre cerrar una ventana y salir de la aplicación.
- Mantener el trabajo en segundo plano limitado y visible, manejar múltiples pantallas y sesiones, restaurar una ventana y estado de enfoque significativos, y eliminar completamente los recursos de la bandeja al salir.
Guía de implementación
- Prototipar los caminos más largos, vacíos, lentos, sin conexión, denegados y con tecnología asistiva antes de fijar el diseño del camino feliz.
- Modelar entradas, salidas, actores, estados, invariantes, efectos secundarios y evidencia de la bandeja de escritorio antes de seleccionar detalles del framework o proveedor.
- Almacenar la versión aplicable del contrato o política de la bandeja de escritorio con el estado material para que las migraciones, reproducciones y decisiones de soporte sean atribuibles.
- Introducir el camino detrás de un despliegue controlado, comparar resultados esperados y observados, y mantener una ruta de recuperación probada hasta que la evidencia de adopción esté completa.
Manejo de fallos y salvaguardas
- El trabajo nativo interrumpido se reanuda desde un punto de control duradero o vuelve a un estado visible seguro sin duplicar efectos secundarios.
- El estado inválido o contradictorio de la bandeja de escritorio se rechaza o pone en cuarentena; la implementación nunca adivina un valor que amplíe la autoridad o duplique un efecto.
- Los reintentos están limitados y usan identidad duradera; tras agotarse, el trabajo alcanza un estado terminal inspeccionable con un responsable accountable.
Verificación y operaciones
- Completar el recorrido con teclado, táctil, lector de pantalla, ventana estrecha, red con retardo y un error recuperable del servidor.
- Monitorizar éxito, denegación, fallo de validación, fallo de dependencia, agotamiento de reintentos y recuperación de la bandeja de escritorio por versión de contrato sin dimensiones sensibles de carga útil.
- Reejecutar conjuntos de pruebas positivas y negativas emparejadas tras cambios en políticas, esquemas, dependencias, migraciones o límites y preservar la evidencia resultante.
Suposiciones de adopción
- Los nombres y valores en el ejemplo son un conjunto concreto, no valores predeterminados universales; los adoptantes los reemplazan mediante evidencia documentada y propiedad.
- El sistema adoptante puede proporcionar identidad autenticada, versiones duraderas de operación o registro, telemetría limitada y una ruta controlada para cambios.
Los ejemplos con apariencia ejecutable en este paquete son conjuntos de pruebas y contratos de aceptación. Ejecute el validador de colección para verificar estructura y metadatos, luego traduzca y ejecute los escenarios en el repositorio objetivo antes de registrar la evidencia de implementación.