hbox-docs/mkdocs.yml

site_name: HBOX — Documentación técnica (Helgen)
site_description: Procedimientos de producción, taller, campo y hardware del HBOX (EinarBoard) — Helgen Technologies
site_url: https://drogheda.helgen.online/
copyright: "© Helgen Technologies — uso interno"

theme:
  name: material
  language: es
  logo: img/helgen-logo-white.png
  favicon: img/favicon.png
  font: false
  palette:
    - scheme: default
      primary: custom
      accent: custom
      toggle:
        icon: material/weather-night
        name: Modo oscuro
    - scheme: slate
      primary: custom
      accent: custom
      toggle:
        icon: material/weather-sunny
        name: Modo claro
  features:
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.indexes
    - navigation.top
    - navigation.footer
    - navigation.tracking
    - search.suggest
    - search.highlight
    - content.code.copy
    - toc.follow

extra_css:
  - stylesheets/extra.css

plugins:
  - search:
      lang: [es, en]
      separator: '[\s\-\.,:/]+'

markdown_extensions:
  - admonition
  - tables
  - attr_list
  - md_in_html
  - pymdownx.details
  - pymdownx.superfences
  - pymdownx.tasklist:
      custom_checkbox: true
  - toc:
      permalink: true

nav:
  - "🏠 Inicio":
      - index.md
      - "Guía del ingeniero": guia-ingeniero.md
      - "⚙ Cuenta":
          - "Mi cuenta (cambiar contraseña)": cuenta.html
          - "Administración (Leo)": admin.html
          - "Salir": salir.html

  - "📋 Tableros":
      - tableros/index.md
      - "Kanban — tareas del equipo": tableros/kanban.html
      - "Equipo — miembros, responsables y accesos": tableros/equipo.html
      - "Ingeniería — estado por versión de tarjeta": tableros/ingenieria.html
      - "Producción — plan 570 vs. avance real": tableros/produccion.html
      - "Estado de actas (tarjetas, módulos, unidades)": tablero.html
      - "Tablero de campo (visitas de diagnóstico)": diagnostico/tablero-campo.html
      - "Expediente de una unidad": unidad.html

  - "🏭 Producción":
      - produccion/index.md
      - "1 · Prueba y flasheo de tarjetas":
          - procedimientos/v5-prueba-y-flasheo.md
          - "Acta de tarjeta V5": formularios/v5.html
      - "2 · Módulos RTK y 4G":
          - procedimientos/v5-modulos-integracion.md
          - "Acta ArduSimple": formularios/ardusimple.html
          - "Acta módem 4G": formularios/modem4g.html
          - "Acta de integración": formularios/integracion.html
      - "3 · Ensamble de la unidad":
          - procedimientos/v5-ensamble.md
          - "Acta de ensamble": formularios/ensamble.html
      - "4 · Prueba final antes de embarcar": procedimientos/v5-prueba-final-unidad.md
      - "5 · Configuración de la unidad": procedimientos/v5-configuracion-unidad.md
      - "📦 Inventario":
          - inventario/index.md
          - "Inventario — existencias y movimientos": inventario/inventario.html

  - "🔬 Taller":
      - taller/index.md
      - "Diagnóstico en banco":
          - procedimientos/diagnostico-banco.md
          - "Acta de diagnóstico en banco": formularios/banco.html
      - "Reflasheo de unidades":
          - procedimientos/reflasheo-unidades.md
          - "Acta de reflasheo y configuración": formularios/reflasheo.html
      - "Prueba: módem 4G en batería":
          - procedimientos/prueba-bateria-modem.md
          - "Acta: módem en batería": formularios/prueba-bateria.html
      - "Prueba: Ethernet y puertos serie":
          - procedimientos/v5-prueba-ethernet-serie.md
          - "Acta: Ethernet y puertos serie": formularios/ethernet-serie.html
      - "V4 — preparación y prueba con 0.6.0":
          - procedimientos/v4-prueba-fw-0.5.6.md
          - "Acta de prueba V4": formularios/v4.html
      - "V4 — riel SW_5V y arranque del F9P (sin NMEA)": procedimientos/v4-prueba-riel-sw5v-f9p.md

  - "🚜 Campo":
      - campo/index.md
      - "Diagnóstico en campo":
          - diagnostico/procedimiento-diagnostico-campo.md
          - "Acta de diagnóstico en campo": formularios/diagnostico.html
      - "Instalación en el puerto":
          - "Checklist de puesta en marcha (imprimir)": procedimientos/v5-checklist-puesta-en-marcha.md
          - "Acta de instalación en campo": formularios/instalacion.html
      - "Envío, recepción y daños":
          - procedimientos/ciclo-de-vida.md
          - "Acta de envío": formularios/envio.html
          - "Acta de recepción e inspección": formularios/recepcion.html
          - "Acta de daño o incidente": formularios/dano.html
      - "📍 Sitios":
          - sitios/index.md
          - "Sitio — unidades instaladas y actas": sitios/sitio.html
      - "Actas — índice y cómo se usan": actas/index.md

  - "🔩 Tarjetas y hardware":
      - hardware/index.md
      - "Manuales por tarjeta": manuales/index.md
      - "V5.5 en campo · V5.6 en layout → pedido 113":
          - "Manual de la tarjeta V5 (V5.5 y V5.6)": manuales/manual-tarjeta-V5.md
          - "Hoja de datos V5.6 (1-oct)": hardware/v56-datasheet.md
          - "Pinout de conectores V5.6 (29-sep)": hardware/v56-pinout.md
          - "ECO V5.6 — requisitos R1–R5 (27-sep)": hardware/v56-eco.md
          - "Cambios al esquemático V5.5 → V5.6 (28-sep)": hardware/v56-cambios-esquematico.md
          - "Reglas de layout: esquemático → PCB (29-sep)": hardware/v56-layout-instrucciones.md
          - "▶ Layout pasada 2 — correcciones antes del pedido (Michelle, 13-oct)": hardware/v56-layout-pasada-2.md
          - "Auditoría del layout 13-oct — NO LISTA (inglés)": hardware/v56-auditoria-layout-13oct.md
      - "V5.7 fuente a bordo → pedido 327 (en diseño)":
          - "ECO V5.7 — fuente 24 V → 5 V a bordo (v0.2, 13-oct)": hardware/v57-eco-fuente.md
          - "▶ Guía de layout V5.7 — colocar la fuente (Leo, 13-oct)": hardware/v57-layout-guia.md
      - "v6 GNSS + 4G a bordo → pedido 130 (en diseño)":
          - "Manual de la tarjeta v6 (marcador)": manuales/manual-tarjeta-v6.md
          - "▶ Próximos pasos para ordenar (29-sep)": hardware/v6-proximos-pasos.md
          - "Plan de corrección y lista de liberación (28-sep)": hardware/v6-plan-correccion.md
          - "Esquemático final — resumen de las 3 pasadas (28-sep)": hardware/v6-cambios-resumen.md
          - "Mapa de pines MCU para board_v6.h (28-sep)": hardware/v6-pinmap.md
          - "Plan de cobre y colocación EMC (5-sep)": hardware/EinarBoard-v6_Plan-de-Cobre_ES.html
          - "Plan de cobre y colocación EMC (inglés)": hardware/EinarBoard-v6_Copper-Plan_EN.html
      - "v6 — auditoría del 28-sep y sus pasadas (detalle)":
          - "Auditoría completa v6 (28-sep)": hardware/v6-auditoria-completa.md
          - "Auditoría completa v6 (inglés, original)": hardware/v6-full-audit.md
          - "Pasada 1 — cambios al esquemático (28-sep)": hardware/v6-cambios-esquematico.md
          - "Pasada 2 — puertos y sin nueva versión (inglés)": hardware/v6-puertos-sin-nueva-version.md
          - "Pasada 3 — revisión final independiente (inglés)": hardware/v6-revision-final.md
          - "Revisión v6 contra lecciones V5.5 (28-sep, superada)": hardware/v6-revision-lecciones-v55.md
      - "V4 y V3 — tarjetas anteriores aún en campo":
          - "Manual de la tarjeta V4": manuales/manual-tarjeta-V4.md
          - "Manual de la tarjeta V3": manuales/manual-tarjeta-V3.md
          - "Pinout V3 (arneses y conectores, jul-2026)": montaje/pinout-arneses.md

  - "📕 Manuales y descargas":
      - "Manual del cliente (instalación y operación)": manuales/manual-cliente.md
      - "Manual de instalación y operación v2.0 (PDF)": manuales/Drogheda-Manual-Instalacion-Operacion_v2.0.pdf
      - "Ficha técnica HBOX v2.0 (PDF)": manuales/Drogheda-HBOX-Datasheet_v2.0.pdf
      - "Descargas (firmware por tarjeta)":
          - descargas/index.md
          - "Notas de versión del firmware V4 / V5": descargas/notas-de-version.md
          - "README firmware hbox_v5_bringup (inglés)": descargas/hbox-v5-bringup-README.md
      - "Git y archivos de diseño (KiCad)":
          - "Guía Git para colaboradores": git/guia-git-es.md
          - "Guía Git (inglés)": git/git-guide-en.md

  - "📚 Referencia e histórico":
      - historia/index.md
      - "Procedimientos anteriores (superados)":
          - "Protocolo de diagnóstico remoto — unidades v1 (jun-2026)": diagnostico/protocolo-diagnostico-remoto.md
          - "EinarBoard 1.0 — puesta en marcha (jul-2026)": procedimientos/einarboard-1.0-bringup.md
          - "FW v3.0.3 — prueba de banco del ventilador (ago-2026)": procedimientos/fan-policy-bench-test.md
          - "Prototipo v3 en protoboard — bring-up (jun-2026)": procedimientos/historico-proto-bench-v3.md
          - "Prototipo v3 en protoboard — lista de compras (jun-2026)": procedimientos/historico-protoboard.md
      - "V3 — producción de jul-2026 (superado)":
          - "BOM V3 dividido para ensamble (jul-2026)": montaje/bom-split.md
          - "Guía de ensamble y QC — borrador V3 (sep-2026)": montaje/guia-ensamble-qc.md
          - "Guía de ensamble del gabinete 0007-1000 (PDF)": montaje/assembly-guide.md
      - "Tarjetas — documentos superados":
          - "V5.6 layout pasada 1 (Michelle, 12-oct) — superada por la pasada 2": hardware/v56-layout-pasada-1.md
          - "v6 auditoría pre-fabricación (25-sep) — superada por la del 28-sep": hardware/v6-auditoria-prefab.md
          - "v6 auditoría pre-fabricación (25-sep, inglés)": hardware/v6-prefab-audit.md