Leopoldo Rodríguez
a91580e1af
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QCy5VHMVLkAmftYM6swWmx
84 lines
5.5 KiB
Markdown
84 lines
5.5 KiB
Markdown
---
|
|
title: "Guía del ingeniero"
|
|
project: Project Drogheda
|
|
date: 2026-09-29
|
|
version: "1.2"
|
|
tags: [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](cuenta.html). El sitio es interno: no compartas ligas ni descargas fuera de Helgen.
|
|
|
|
## Reglas
|
|
|
|
1. Antes de tocar una unidad, abre su [expediente](unidad.html) (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](actas/index.md)).
|
|
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 { #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](produccion/index.md): de la tarjeta nueva a la unidad lista para embarcar.
|
|
- [Taller](taller/index.md): unidad o tarjeta en la mesa.
|
|
- [Campo](campo/index.md): unidad en la máquina, envíos, recepciones y daños.
|
|
- [Tarjetas y hardware](hardware/index.md): pinout, hoja de datos, manuales por tarjeta.
|
|
- [Descargas](descargas/index.md): firmware por tarjeta y SHA-256.
|
|
- [Tableros](tableros/index.md): pendientes del equipo (kanban), estado por versión de tarjeta, plan 570 vs. avance.
|
|
- [Inventario](inventario/index.md): existencias y movimientos de tarjetas, módulos, gabinetes y packs.
|
|
- [Sitios](sitios/index.md): unidades instaladas por puerto y actas de instalación.
|
|
- [Historia del proyecto](historia/index.md): 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](descargas/index.md#firmware-del-hbox-que-binario-va-en-que-tarjeta).
|
|
- SHA-256 antes de flashear: [Descargas](descargas/index.md#verifica-el-sha-256).
|
|
- Credenciales del módem (APN, caster) nunca en un acta ni en el sitio: [Descargas](descargas/index.md#parametros-del-modem-4g-ntrip-master).
|
|
- Química del paquete = JP2: [Ensamble §2](procedimientos/v5-ensamble.md#2-tarjeta-sin-energia).
|
|
- JP5 solo en los extremos del bus RS-485: [Ethernet y serie](procedimientos/v5-prueba-ethernet-serie.md#conexion-en-la-instalacion).
|
|
- En banco, 5 V ≥ 5.2 V o paquete conectado: [Reglas de banco](procedimientos/diagnostico-banco.md#reglas-de-banco).
|
|
- En campo, nada se reinicia antes de capturar la evidencia: [Diagnóstico en campo](diagnostico/procedimiento-diagnostico-campo.md).
|
|
- 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](procedimientos/prueba-bateria-modem.md#3-hallazgos-2527-sep)).
|
|
|
|
## Anexo — publicar el sitio (Leo)
|
|
|
|
```bash
|
|
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.
|