hbox-docs/docs/guia-ingeniero.md

3.6 KiB

title project date version tags
Guía del ingeniero Project Drogheda 2026-09-29 1.1
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.

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.

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
# 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.

Versiones anteriores en git.