hbox-docs/NUEVOS-1013.md

62 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Archivos nuevos y modificados — 13-oct-2026 (Constructor: WP2–WP5)
Para quien arma la navegación (`mkdocs.yml`) y `scripts/sync-docs.sh`: no toqué ninguno de los dos.
Las rutas son relativas a `docs/`; el título propuesto es el que iría en el `nav`. Los `.html` se
copian tal cual; los `.md` llevan frontmatter con `title` y `date`.
## Páginas nuevas (con título propuesto para el nav)
| Ruta en `docs/` | Título propuesto | Sección sugerida |
|---|---|---|
| `tableros/index.md` | **Tableros** (índice: qué es cada tablero) | 📋 Tableros (pestaña nueva) |
| `tableros/kanban.html` | Pendientes (kanban) | 📋 Tableros |
| `tableros/ingenieria.html` | Ingeniería — ¿dónde está el hardware? | 📋 Tableros |
| `tableros/produccion.html` | Producción — pedido 570 | 📋 Tableros (y enlazar desde Producción) |
| `inventario/index.md` | **Inventario** (política: quién registra, cuándo, mínimos) | 📦 Inventario (o dentro de Producción) |
| `inventario/inventario.html` | Inventario de materiales | 📦 Inventario |
| `sitios/index.md` | **Sitios** (lista viva + cómo dar de alta) | 🚜 Campo |
| `sitios/sitio.html` | Página de un sitio (`?id=icave`) | 🚜 Campo |
| `formularios/instalacion.html` | Acta de instalación en campo | 🚜 Campo → «Instalación en el puerto» (junto al checklist de puesta en marcha) |
| `tableros/equipo.html` | Equipo y accesos (quién es quién; usuarios del sitio, solo admin) — **14-oct** | 📋 Tableros (y enlazar desde ⚙ Cuenta → Administración) |
Archivos de apoyo (no van al nav): `tableros/tablero.css`, `tableros/kanban.js`.
Sugerencia para `actas/index.md` (no lo edité, para no chocar con la reorganización): agregar la fila
«[Instalación en campo](../formularios/instalacion.html) · Una por unidad y vehículo; sitio, alimentación,
antenas, RTK FIX, fotos · [Sitios](../sitios/index.md)» en la tabla **Campo**.
## Páginas existentes modificadas
| Ruta | Cambio |
|---|---|
| `formularios/acta.js` | nuevo tipo de ítem `sitio` (select alimentado por `/api/sitios`; `guardaEn:'sitio'`); `fillFrom` respeta un select cuyas opciones aún no cargan |
| `formularios/envio.html`, `recepcion.html`, `diagnostico.html`, `dano.html` | un ítem `sitio` (opcional) en la sección 0; en daño solo aparece si fue en campo / transporte / no se sabe |
| `unidad.html` | bloque **Trazabilidad**: cadena de producción (tarjeta → módulos → integración → ensamble → configuración) y cadena de campo (envío → recepción → instalación → diagnósticos → daños) con sitio y fechas |
| `tableros/kanban.js`, `tablero.css` (14-oct) | responsables = miembros de `/api/equipo` (chips, varios por pendiente, texto libre opcional, obligatorio al crear); las tarjetas muestran el nombre; filtro por id; `Kanban.nombresResp()` para otras páginas |
| `tableros/kanban.html`, `ingenieria.html`, `produccion.html`, `index.md` (14-oct) | enlace «👥 Equipo»; producción muestra el nombre del responsable en bloqueos |
| `admin.html` (14-oct) | enlace «Usuarios y equipo →» (las funciones existentes no se movieron) |
| `cuenta.html` (14-oct) | una línea: si no tienes acceso, pídeselo a Leo (Administración → Usuarios y equipo) |
## Backend y despliegue
| Ruta | Cambio |
|---|---|
| `backend/app.py` | colecciones `tareas`, `plan`, `inventario` (+ `movimientos`), `sitios`; `/api/actas` y `/api/unidad` exponen `sitio`/`fecha`/`componentes`. **14-oct:** colección `equipo` (`GET/POST /api/equipo`, `PATCH /api/equipo/miembro`), accesos (`POST /api/usuarios`, `DELETE /api/usuario`), `responsable` obligatorio + `responsable_ids`, `resumen.por_responsable` |
| `backend/seed_1013.py` | **nuevo** — siembra idempotente (plan, 4 sitios, 18 ítems, 13 pendientes; `--extra` para importar Notion). **14-oct:** `sembrar_equipo` (9 miembros, sin accesos), pendiente `t-ferreteria-eit-timsa`, completa responsables vacíos y `responsable_ids` |
| `backend/tests-1013.sh`, `backend/TESTS-1013.md` | **nuevos** — pruebas con `curl` (61) y resumen de las pruebas de navegador |
| `backend/tests-1014.sh`, `backend/TESTS-1014.md` | **nuevos (14-oct)** — equipo, accesos con htpasswd temporal, responsables (57) |
| `backend/README.md` | sección 5: colecciones, variables, ejemplos `curl` por endpoint |
| `backend/actas-hbox.service` | variables `TAREAS_DIR`, `INVENTARIO_DIR`, `SITIOS_DIR`, `PLAN_FILE` comentadas (valores por omisión junto a `/actas`) |
| `DESPLIEGUE.md` | sección **A2 · Despliegue 13-oct** (git pull, mkdir, restart, siembra, verificación, respaldo, problemas frecuentes) y filas nuevas en «Qué vive dónde» |
## Enlaces que las páginas nuevas esperan encontrar
Las páginas enlazan a estas rutas del sitio (todas existen hoy; si la reorganización las mueve, hay que
actualizar `tableros/ingenieria.html` (constante `VERSIONES` y lista de decisiones) y `tableros/produccion.html` (constante `FORM`)):
`hardware/v56-layout-pasada-2/`, `hardware/v56-auditoria-layout-13oct/`, `hardware/v56-eco/`, `hardware/v56-datasheet/`,
`hardware/v56-pinout/`, `hardware/v57-eco-fuente/`, `hardware/v57-layout-guia/`, `hardware/v6-proximos-pasos/`,
`hardware/v6-plan-correccion/`, `hardware/v6-revision-lecciones-v55/`, `hardware/EinarBoard-v6_Plan-de-Cobre_ES.html`,
`manuales/manual-tarjeta-V5/`, `manuales/manual-tarjeta-v6/`, `tablero.html`, `unidad.html`, `actas/`,
`diagnostico/tablero-campo.html` y los formularios de `formularios/`.