Notas

Primera actualización real y documentación pública

La primera actualización desde el panel, con rollback de verdad por el camino.

2 min de lectura

Noche de release: la cadena de instalación y actualización ha pasado su primera prueba real, y el proyecto estrena documentación pública.

Paquete limpio e instalación desde el catálogo firmado

El paquete de instalación ahora sale de git archive: el anterior arrastraba __pycache__ y metadatos locales. El núcleo se instala desde los digests firmados del catálogo y la versión se registra desde el primer arranque. En la primera limpieza completa, fclean eliminó contenedores y volumen pero se detuvo al intentar borrar un directorio; corregido el borrado, una nueva instalación ha acabado limpia, sin los datos de prueba anteriores. Verificado: 47 tests de API, migración Alembic vigente, actualizador activo y páginas pública y administrativa sanas en escritorio y móvil.

Primera actualización real: 0.1.8 → 0.1.9

La release v0.1.9 añade Web v… al pie de la imagen pública; el panel conserva la versión del núcleo aparte. Desde el panel, el administrador ha iniciado la transición de 0.1.8 a 0.1.9: el trabajo ha terminado en done, API y panel saludables con los digests firmados y la imagen pública anterior intacta.

No todo ha salido a la primera: la comprobación de la imagen pública conectaba por localhost (IPv6) y el gateway escuchaba solo IPv4. El rollback restauró la imagen previa sin tocar DB ni medios; con el chequeo apuntando a 127.0.0.1, el reintento ha instalado el digest v0.1.9. De hecho, el sistema de rollback se ha probado solo, sin querer.

Wiki y logs públicos, con el diario interno protegido

Antes de publicar nada, la decisión: wiki y logs de desarrollo sí, diario interno en crudo no. Contiene topología y direcciones privadas; el material sensible se oculta con marcadores y los cuerpos completos quedan privados. La wiki reúne 14 guías (instalación, web pública, panel, API, IA, operación y dos recetas para agentes) y los logs exportan fecha, hora, tipo, título y un extracto corto, con los identificadores sensibles enmascarados. npm run check y npm run build pasan, y 25 rutas responden 200 sin desbordes a 390 y 1440 px. Un test visual detectó anchura sobrante en la página de instalación en móvil; minmax(0, 1fr) y a probar de nuevo.

El producto ya se instala, se actualiza y se explica solo. Solo queda la publicación remota de la release.

Otras entradas del diario