docs: the manual shows the real suite, and the unused screenshots go

CHANGELOG.md

@@ -73,9 +73,8 @@ Versioning: [Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.0.html).
   Spanish audience trees (`usuario/`, `administracion/`, `desarrollo/`,
   `proyecto/`), `aviso.md`, `catalogo.yml` (15 repos) with generated catalog
   and per-app reference pages, graphify module maps, README quickstart
-  includes, tracker pages, `build.yml` (CI + Pages), weekly `capturas.yml`,
-  `about-sync.yml`, and the governance set (COPYING CC BY 3.0, AGPL, REUSE,
-  canon files).
+  includes, tracker pages, `build.yml` (CI + Pages), `about-sync.yml`, and
+  the governance set (COPYING CC BY 3.0, AGPL, REUSE, canon files).
 - Per-app release notes (scribe S2a): `proyecto/novedades/` holds one page per
   catalog row whose `kind` is suite, distribution-fork or nextcloud-app, listed in
   that row's `manuals`. `gen-catalogo.py` fails the build when such a row lacks its
@@ -122,7 +121,7 @@ Versioning: [Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.0.html).
 
 ### Changed
 
-- `tools/gen-catalogo.py` reads the `OWN_APPS` parity registry from `instalador` (`provisioning/phases/12-apps.sh`) instead of `gestion`, which is about to delete its frozen copy of the executor (gestion #245); the missing-registry error names the instalador path, and `--selftest` pins the lookup. `build.yml` needs no change: `instalador` is already a roster row, so it is cloned beside `gestion`. Prose in `tools/capturas/captura.py`, `desarrollo/documentation.md` and `desarrollo/repo-docs.md` follows.
+- `tools/gen-catalogo.py` reads the `OWN_APPS` parity registry from `instalador` (`provisioning/phases/12-apps.sh`) instead of `gestion`, which is about to delete its frozen copy of the executor (gestion #245); the missing-registry error names the instalador path, and `--selftest` pins the lookup. `build.yml` needs no change: `instalador` is already a roster row, so it is cloned beside `gestion`. Prose in `desarrollo/documentation.md` and `desarrollo/repo-docs.md` follows.
 - `tools/gen-inicio-rapido.py` pins (`--selftest`) re-verified against the live org (2026-10-18): six READMEs now carry the quickstart section (repo-docs, aps-common, Databases, epidemiologia, estadistica, farmacia); `instalador` replaces `rpiv-artifacts` among the repos without a root `README.md`.
 - `README.md` status brought current (site built and published on Pages, four audience trees populated).
 - APS-Conecta/AIO is gone from the catalogue (roster 15 → 14) and from the generators' pins; `desarrollo/aio.md`, `desarrollo/instalador.md` and `administracion/aio.md` now say the repository was deleted after instalador absorbed it, with its full commit history. The two `aio` pages stay: they document the fork, which instalador now holds.

Makefile

@@ -66,14 +66,3 @@ check-site: html
 	python3 tools/check-site.py
 
 .PHONY: check-site
-
-# Phase 11 — weekly screenshots pipeline. Single entry point shared by CI and
-# local runs; tools/capturas/compose.yaml + captura.py own everything else.
-# --compare sizeclass is the r8 outcome (risk r8, OQ7): two fresh-stack local
-# runs (2026-10-08) produced byte-different PNGs on all five apps (−5.8%…+2.9%)
-# — canvas chart/map timing noise — so the weekly gate is the pre-built 5%
-# size-class fallback, per the plan's recorded r8 branch. Byte equality stays
-# the driver default; flip back by dropping the flag.
-.PHONY: capturas
-capturas:
-	python3 tools/capturas/captura.py capture --compare sizeclass

REUSE.toml

@@ -1,6 +1,6 @@
 version = 1
 
-# Site prose (+ future capturas/) — CC BY 3.0 per COPYING
+# Site prose and capturas/ — CC BY 3.0 per COPYING
 [[annotations]]
 path = ["index.md", "aviso.md", "usuario/**", "administracion/**", "desarrollo/**", "proyecto/**", "capturas/**"]
 SPDX-License-Identifier = "CC-BY-3.0"

administracion/instalar-gestion-aio.md

@@ -83,6 +83,12 @@ El navegador que abre el enlace conserva su sesión hasta «Listo». El asistent
 
 ### 3. Centro
 
+:::{figure} ../capturas/asistente-centro.png
+:alt: Paso «Centro» del asistente: filtros de región, comuna, tipo y nombre, la lista de establecimientos del registro DEIS y el mapa.
+
+«Centro» al abrirse, antes de elegir el establecimiento.
+:::
+
 1. Buscar el establecimiento en el registro DEIS con «Región», «Comuna», «Tipo» y «Nombre».
 2. Elegir el establecimiento en la lista. El mapa muestra su punto oficial.
 3. Si el marcador no está sobre el establecimiento, hacer clic en el lugar correcto o arrastrarlo. «Volver al punto oficial» lo devuelve a su lugar.
@@ -94,6 +100,12 @@ La zona horaria se deduce de la ubicación: `Pacific/Easter` en Isla de Pascua,
 
 «Dirección» obtiene por sí sola, del servicio de nombres de APS Conecta, el nombre de la suite: `<centro>.gestion.apsconecta.cl`. No pide ningún dato.
 
+:::{figure} ../capturas/asistente-direccion.png
+:alt: Paso «Dirección» del asistente con el nombre de la suite asignado y el botón «Continuar».
+
+«Dirección» con el nombre que obtuvo para la suite; en esta instalación de prueba, bajo `ci.gestion.apsconecta.cl`.
+:::
+
 - El nombre se forma con el nombre corto del establecimiento, en minúsculas, sin tildes, con «ñ» como «n» y con guiones. Si dos establecimientos comparten el nombre corto, se agrega la comuna.
 - Cada código DEIS tiene un solo nombre, que no se edita.
 - El nombre apunta a la dirección del servidor dentro de la red del establecimiento. El servidor publica esa dirección cada 10 minutos, así que el nombre sigue al servidor si su dirección cambia.
@@ -134,6 +146,12 @@ Si el mensaje sigue después de la excepción en el router, compruebe que el com
 4. Revisar la lista. Para quitar a alguien que dejó el establecimiento, usar «Retirar».
 5. Presionar «Continuar».
 
+:::{figure} ../capturas/asistente-equipos.png
+:alt: Paso «Equipos» del asistente: dos sectores y un programa con sus carpetas, y la lista del personal de la planilla subida.
+
+«Equipos» con los sectores, los programas y el personal de la planilla.
+:::
+
 Cada sector tiene además su cuenta de jefatura. Los sectores y los programas quedan fijos al presionar «Instalar».
 
 #### La planilla del personal
@@ -193,6 +211,12 @@ Una planilla corregida actualiza el nombre, el correo y el cargo de cada persona
 
 «Revisar» resume lo que se instalará: el centro, la dirección, los equipos, las personas, las cuentas de cargo, los componentes, las aplicaciones, la IA local y las copias de seguridad.
 
+:::{figure} ../capturas/asistente-revisar.png
+:alt: Paso «Revisar» completo: centro, dirección, equipos, personas, cuentas de cargo, componentes, aplicaciones, aplicaciones opcionales, IA local, copias de seguridad y el botón «Instalar».
+
+«Revisar» completo, antes de presionar «Instalar».
+:::
+
 1. Revisar el resumen.
 2. En «Aplicaciones opcionales», marcar las que usará el establecimiento: Farmacia, Estadística o Tótem. La elección del primer «Instalar» queda fija.
 3. En «IA local», marcarla si el establecimiento la usará. Sin marcar, queda desactivada.
@@ -213,6 +237,12 @@ La IA local es un modelo de lenguaje que corre en el propio servidor, en el cont
 
 La página muestra el avance de cada paso de la instalación y de cada contenedor. Descargar e iniciar los contenedores puede tardar varios minutos. La instalación sigue en el servidor aunque se cierre la página.
 
+:::{figure} ../capturas/asistente-progreso.png
+:alt: Avance de la instalación: el estado de cada contenedor, de «En espera» a «En ejecución», y el registro de la instalación.
+
+El avance de la instalación mientras AIO descarga e inicia los contenedores.
+:::
+
 Un paso que falla no detiene a los que no dependen de él. Sus dependientes quedan «En espera», y la página dice «Algunos pasos no se completaron; su motivo está en rojo. …».
 
 1. Leer el motivo en rojo de cada paso y corregir lo que indique.
@@ -224,6 +254,12 @@ Con todos los pasos completados, la instalación compara la suite en marcha con
 
 «Listo» muestra «APS Conecta Gestión quedó instalada. El personal del establecimiento la abre en esta dirección:» y la dirección. Al llegar a «Listo», el asistente se cierra y su enlace deja de funcionar.
 
+:::{figure} ../capturas/asistente-listo.png
+:alt: Paso «Listo»: la dirección de la suite, el botón «Descargar el archivo de contraseñas» y el aviso de que el enlace del asistente ya no funciona.
+
+«Listo», con la dirección de la suite y el archivo de contraseñas.
+:::
+
 1. Presionar «Descargar el archivo de contraseñas» y guardar el archivo en un lugar seguro. El botón funciona mientras la página sigue abierta.
 2. Leer el mensaje bajo la dirección. Si dice que el computador no abre la dirección, seguir [Si un computador no abre la dirección](#instalar-gestion-aio-router).
 3. Compartir la dirección con el personal y entregar a cada persona su usuario y su primera contraseña.

desarrollo/documentation.md

@@ -96,13 +96,14 @@ El flujo `build` corre en cada pull request, en cada push a `main` y a diario, p
 
 El flujo `docs` corre `make structure` —la estructura de las páginas: encabezado tipado y esqueleto de secciones— y, mientras el escaneo nativo de secretos de GitHub no esté activado en este repositorio, el barrido `gitleaks` del rango de commits del pull request. El título del pull request, en inglés, es regla de esta página: la sección «Idioma y registro» la fija.
 
-Tres flujos más completan el repositorio: `about-sync` replica los roles de `catalogo.yml` en las descripciones de los repositorios cuando cambia el catálogo, `capturas` toma cada lunes las capturas de las cinco aplicaciones y abre un borrador de pull request solo si cambian, e `ia-check` comprueba cada lunes que ningún modelo ni bot escriba en los repositorios sin estar declarado en `ia.yml`.
+Dos flujos más completan el repositorio: `about-sync` replica los roles de `catalogo.yml` en las descripciones de los repositorios cuando cambia el catálogo, e `ia-check` comprueba cada lunes que ningún modelo ni bot escriba en los repositorios sin estar declarado en `ia.yml`.
+
+Las capturas de pantalla del manual (el inicio de sesión, «Inicio» y los pasos del asistente de instalación) se guardan en `capturas/` y vienen del artefacto `acceptance-screenshots` de la ejecución que publica cada versión de APS Conecta Gestión. La actualización del manual de cada versión las renueva a mano; nada lo automatiza.
 
 ## Compromisos y límites
 
 - **Enlaces que `linkcheck` omite.** Las URL que solo aparecen dentro de bloques tejidos no se comprueban: mantenerlas vivas es tarea del original. Tampoco se comprueban las URL de repositorios privados, las anclas de GitHub, que se arman con JavaScript, ni dos hosts que fallan de forma intermitente desde los runners de GitHub (deis.minsal.cl y gitnet.fr).
 - **Traducción mayoritariamente automática.** Los catálogos oficiales en español cubren cerca del 20 % del texto vigente; el resto lo traduce un flujo con inteligencia artificial, acotado por `upstream-fidelity`.
-- **Capturas comparadas por tamaño.** Dos ejecuciones locales sobre una pila nueva produjeron PNG distintos byte a byte en las cinco aplicaciones por el ruido de tiempo de gráficos y mapas en canvas, así que la compuerta semanal compara por clase de tamaño con un 5 % de tolerancia en lugar de exigir igualdad de bytes.
 - **Solo modo claro.** El tema fija el modo claro; las variables oscuras repiten las claras.
 - **Sin URL canónica.** `html_baseurl` falta a propósito: emitiría etiquetas canónicas con un host externo, que la regla de aislamiento del sitio prohíbe.
 - **La hoja de ruta fuera de CI.** `tools/hoja-de-ruta.sh` usa la sesión de GitHub del responsable, porque el token de CI no alcanza para crear ni actualizar el proyecto de la organización; por eso no es un objetivo de `make` ni corre en CI.