hbox-docs/docs/guia-ingeniero.md

title	project	date	version	tags
Guía del ingeniero	Project Drogheda	2026-09-29	1.2	project-drogheda procedimientos sitio ingeniero

Guía del ingeniero

Acceso: usuario y contraseña te los da Leo; cámbiala la primera vez en Mi cuenta. El sitio es interno: no compartas ligas ni descargas fuera de Helgen.

Reglas

1. Antes de tocar una unidad, abre su expediente (H00xx o serie) y lee las actas anteriores.
2. Sigue el procedimiento completo y en orden. Una tarjeta o unidad que falla un paso no avanza al siguiente.
3. Al terminar, llena el acta del procedimiento. Sin acta, el trabajo no existe (cómo se usan).
4. Anota toda medición fuera de rango con su valor, no solo "FALLA".
5. Si algo no cuadra con el documento (valor fuera de rango, paso imposible, la tarjeta no coincide), no improvises: detente, anótalo en Observaciones y avisa a Leo.
6. No edites procedimientos. Si un paso está mal, escríbele a Leo con la página, el número de paso, qué esperabas y qué encontraste. Las páginas se corrigen en el repositorio Drogheda; tú no tocas Git.

El sitio es el centro de mando

Si no está en el sitio, no pasó. Todo el proyecto se coordina aquí: los pendientes, los documentos, las actas y la ruta a producción. Una tarea está terminada cuando el sitio lo dice, no antes.

Al terminar una tarea:

1. El pendiente. Muévelo a Hecho, o a Bloqueado con la razón en un comentario, y abre los que siguen, con responsable y fecha. Si la tarea no tenía pendiente, créalo y ciérralo: así queda en la Actividad.
2. El documento. Si la tarea cambió un procedimiento, una tarjeta o una decisión, el documento se corrige el mismo día. Lo hacen Leo o Claude en el repositorio; tú avísales qué cambió (regla 6).
3. El acta. Si tocaste una tarjeta o una unidad, llena su acta (regla 3).
4. La mejora. Si el sitio te estorbó (una liga rota, un dato viejo, algo que no encontraste), abre un pendiente para Leo con la página y lo que esperabas encontrar.

Claude trabaja igual: cada tarea suya termina con sus cambios al tablero (en un lote que Leo revisa y aplica), sus documentos y la ruta a producción al día. Lo ves en la Actividad de la página de inicio, con su nombre.

Qué abrir

• Producción: de la tarjeta nueva a la unidad lista para embarcar.
• Taller: unidad o tarjeta en la mesa.
• Campo: unidad en la máquina, envíos, recepciones y daños.
• Tarjetas y hardware: pinout, hoja de datos, manuales por tarjeta.
• Descargas: firmware por tarjeta y SHA-256.
• Tableros: pendientes del equipo (kanban), estado por versión de tarjeta, plan 570 vs. avance.
• Inventario: existencias y movimientos de tarjetas, módulos, gabinetes y packs.
• Sitios: unidades instaladas por puerto y actas de instalación.
• Historia del proyecto: jun → oct 2026, con ligas a cada documento.

Reglas que se rompen seguido

Cada una vive en la página donde se aplica:

• Firmware por tarjeta, nunca por número de versión; superseded/ no se instala: Descargas.
• SHA-256 antes de flashear: Descargas.
• Credenciales del módem (APN, caster) nunca en un acta ni en el sitio: Descargas.
• Química del paquete = JP2: Ensamble §2.
• JP5 solo en los extremos del bus RS-485: Ethernet y serie.
• En banco, 5 V ≥ 5.2 V o paquete conectado: Reglas de banco.
• En campo, nada se reinicia antes de capturar la evidencia: Diagnóstico en campo.
• En V5.5 no se apaga y prende la etapa RTK en batería "para ver si vuelve": el módem queda oscuro hasta RESET 4G o 24 V (Módem en batería).

Anexo — publicar el sitio (Leo)

cd ~/Documents/Claude/Projects/Drogheda/hbox-docs
./scripts/sync-docs.sh          # copia desde el repo lo que está en la lista MAP (política de publicación)
mkdocs build --strict           # tiene que terminar sin WARNING
./scripts/deploy.sh             # rsync del sitio + backend al servidor; baja la foto del tablero a _estado/
./scripts/tablero.sh revisar    # lotes de Claude: qué cambiaría cada uno en el tablero (no escribe)
./scripts/tablero.sh aplicar    # los aplica (lo ya aplicado se salta) y baja la foto nueva
# nuevos tipos de acta: actualizar ACTAS_REPETIBLES en /etc/systemd/system/actas-hbox.service
# (ya incluye prueba-ethernet-serie en backend/actas-hbox.service y DESPLIEGUE.md), luego
# sudo systemctl daemon-reload && sudo systemctl restart actas-hbox
git add -A && git commit -m "docs: ..." && git push

Historial de revisiones

Versión	Fecha	Cambios
1.0	2026-09-29	Primera versión.
1.1	2026-09-29	Edición breve; recibe las reglas de la portada; la tabla por situación queda en las portadas de sección.
1.2	2026-10-21	«El sitio es el centro de mando»: cómo se cierra una tarea (pendiente, documento, acta y mejora); lotes del tablero en el anexo.

Versiones anteriores en git.