Autor: Iker Acevedo¶

Fecha creacion: 2026-10-17 Estado: propuesta (pendiente de aprobación) Tipo: plan de implementación

Plan de implementación¶

Plan para construir la base del Sistema de Experiencias y migrar la primera vista. No se migra todo de una vez: cada fase deja la plataforma funcionando igual que antes y se puede detener sin dejar nada a medias.

Criterios¶

• Sin cambio visual hasta que exista una segunda experiencia y el usuario la elija.
• Seguro desde el inicio: todo lo nuevo cumple Seguridad por diseño.
• Reutilizar lo que existe: paleta --logigho-*, patrón Repository + Store, módulo Terraform datos-reportes-analytics, authorizers Cognito.
• No construir lo que todavía no se necesita (ver el final).
• Todo pasa por PreProd. Producción solo con instrucción explícita de Iker.

Relación con la línea de seguridad¶

La corrección de la seguridad existente (rutas sin autorización, CRUD genérico, roles IAM) se trabaja en otra línea de trabajo. Este plan solo exige que lo nuevo nazca seguro. Cuando la línea de seguridad cambie un endpoint que usa una vista migrada, el cambio toca solo el repository de esa vista.

Fases¶

flowchart LR
    F0["F0 Aprobación
del estándar"] --> F1["F1 Herramientas
ESLint, Stylelint"]
    F1 --> F2["F2 Motor de
experiencias"]
    F2 --> F3["F3 Shell clásico
sobre el motor"]
    F3 --> F4["F4 Preferencias
(backend seguro)"]
    F3 --> F6["F6 Pedidos
al estándar"]
    F4 --> F5["F5 Selector de
experiencia"]
    F5 --> F7["F7 Primera experiencia
nueva"]
    F6 --> F7

F0. Aprobación del estándar¶

F1. Herramientas que hacen cumplir las reglas¶

Listo cuando: el pipeline corre lint y pruebas, y el código actual pasa (las reglas nuevas solo aplican a carpetas nuevas).

F2. Motor de experiencias¶

Incluye una prueba de concepto temprana: un <router-outlet> dentro de un shell montado de forma dinámica, y el cambio de shell manteniendo la URL. Si la prueba falla, se ajusta el diseño antes de seguir.

Listo cuando: el motor tiene pruebas y la plataforma se ve igual.

F3. Shell clásico sobre el motor¶

Listo cuando: pantallazos idénticos del shell en escritorio y celular; menú, buscador, alertas y accesos funcionan igual.

F4. Preferencias del usuario (backend seguro)¶

El store de la F2 cambia de localStorage al API sin que ninguna vista se entere.

Actualización 2026-11-10 (backend F4 construido): el contrato final, los códigos de error y la receta de consumo están en API de Preferencias. Diferencias respecto a esta tabla: la identidad también se verifica dentro de la Lambda (no solo en el gateway), beta la ven los usuarios con el rol Experiencia, y las rutas se publican por el mismo mecanismo que las demás APIs (ver ADR-001 del backend).

Listo cuando: en PreProd un usuario guarda su experiencia y la encuentra en otro navegador; las pruebas de seguridad pasan.

F5. Selector de experiencia¶

F6. tienda/pedidos al estándar¶

PRs 1 a 5 del ejemplo. Puede avanzar en paralelo con F4 y F5.

F7. Primera experiencia nueva¶

Después de F7, cada experiencia y cada vista nueva siguen el mismo camino, y las vistas viejas se migran según la tabla de cobertura.

Qué no se hace (por ahora)¶

Decisiones pendientes¶

Historial de cambios¶