Skip to content

fix(admin): el borrador ya no oculta los cambios de /data - #39

Merged
PabloCastroCastro merged 1 commit into
developfrom
feature/GH-21
Nov 4, 2026
Merged

PabloCastroCastro merged 1 commit into
developfrom
feature/GH-21

Conversation

@PabloCastroCastro

Copy link
Copy Markdown
Owner

Qué cambia y por qué

Con un borrador en localStorage, init() de js/admin.js no volvía a leer /data. Y el borrador se creaba con solo abrir el admin: cualquier cambio posterior en el repo quedaba oculto para siempre en ese navegador, con un único toast como pista. Además, si no había borrador y fallaba /data, la página quedaba en blanco.

Detección de cambios (borrador v2)

  • El borrador guarda una huella (FNV-1a de 32 bits sobre el JSON) del contenido de /data de cada fichero cuando entra al borrador.
  • Al abrir el admin se vuelve a leer /data y se compara fichero a fichero:
/data cambió Edité ese fichero en el borrador Resultado
no — Se mantiene el borrador
sí no Se actualiza solo + toast con los ficheros actualizados
sí sí Aviso de conflicto (role="alert") con la lista de ficheros
  • En un conflicto:
    • "Usar la versión de /data" sustituye solo esos ficheros. El resto del borrador, por ejemplo game-config.json editado, se conserva.
    • "Mantener mi borrador" conserva las ediciones y toma como referencia el /data actual, así que solo vuelve a avisar si /data cambia otra vez.
  • Tipo eliminado en /data y sin ediciones → sale del borrador. Tipo que sigue listado pero no carga (fallo puntual) → queda sin comprobar, no se borra.
  • Borradores antiguos (sin huellas): aviso "Borrador de una versión anterior" con las mismas opciones. "Usar /data" empieza de cero.

Errores de carga

  • Sin borrador y /data caído → pantalla de error con el fichero que falló y "Reintentar" (antes, página en blanco).
  • Con borrador y /data caído → se trabaja sobre el borrador, con un aviso "No se pudo comprobar /data" y opción de reintentar.
  • Si un tipo concreto no carga, un toast explica el motivo (antes se mostraba vacío sin más).

Docs: PROJECT.md §6 (cómo se comporta el borrador) y CHANGELOG.md.

Rama base

develop

Issue relacionada

Closes #21

Pruebas

  • node --test: 51/51.
  • E2E en Chrome headless contra un servidor que cambia el contenido de /data entre recargas (28 comprobaciones, todas ✅):
    • sin borrador + /data 500 → error con el fichero; "Reintentar" con /data arreglado carga el admin
    • primera carga → borrador v2 con huellas de los 5 ficheros cargados
    • reabrir sin cambios → sin aviso
    • nueva receta en /data sin ediciones locales → se actualiza solo y se informa del fichero
    • conflicto (Mozzarella editada aquí + Tomate cambiado en /data):
      • el aviso lista solo pizza/ingredients.json (no game-config, editado solo aquí)
      • Mantener: conserva la edición, el foco va a la pestaña activa y no vuelve a avisar al reabrir
      • nuevo cambio en /data → vuelve a avisar; Usar /data: Mozzarella/Tomate v2, y maxPlayers 6 local se conserva
    • ensalada eliminada en /data sin ediciones → fuera del borrador, sin aviso
    • borrador + /data 500 → aviso "sin comprobar" y el admin funciona; "Seguir con el borrador" lo cierra
    • borrador antiguo → aviso específico; "Usar /data" → borrador v2 nuevo con el contenido de /data
    • axe-core sin violaciones en la pantalla de error y en el aviso de conflicto
    • sin excepciones JS
  • Regresión: los E2E de Admin: no se pueden definir topes para categorías nuevas #20 (Reglas) y Accesibilidad: navegación por teclado en las tarjetas de swipe #4 (accesibilidad del juego y del admin) siguen en verde.

Checklist

  • Probado en local
  • node --test pasa
  • No toqué js/shared.js
  • Documentación actualizada

🤖 Generated with Claude Code

Antes, con un borrador en localStorage, init() no volvía a leer /data, y
el borrador se creaba con solo abrir el admin: cualquier cambio posterior
en el repo quedaba oculto en ese navegador. Si no había borrador y
fallaba /data, la página quedaba en blanco.

- El borrador (v2) guarda una huella FNV-1a del contenido de /data de
  cada fichero al entrar al borrador.
- Al abrir, se relee /data y se compara fichero a fichero: sin cambios en
  /data → se mantiene; cambiado en /data y sin ediciones locales → se
  actualiza solo (toast); cambiado en ambos → aviso role=alert con los
  ficheros y "Usar la versión de /data" (solo esos ficheros) o "Mantener
  mi borrador" (la referencia pasa al /data actual).
- Tipos eliminados en /data sin ediciones salen del borrador; tipos que
  siguen listados pero no cargan quedan sin comprobar (no se borran).
- Borradores antiguos sin huellas: aviso específico con las mismas
  opciones.
- /data caído: sin borrador → pantalla de error con Reintentar; con
  borrador → se trabaja sobre él con aviso.
- Si un tipo no carga, se avisa del motivo en vez de mostrarlo vacío sin
  más.

Docs: PROJECT.md §6 y CHANGELOG.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@PabloCastroCastro
PabloCastroCastro merged commit 9c3cc6f into develop Nov 4, 2026
1 check passed
@PabloCastroCastro
PabloCastroCastro deleted the feature/GH-21 branch November 4, 2026 19:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant