docs: actualizar documentacion tecnica, arquitectura y manuales de herramientas y QR

README.md

@@ -41,6 +41,35 @@ Integrado bidireccionalmente con **`tareas.telcotronics.com`**:
 
 ---
 
+## 🧰 Módulo de Inventario de Herramientas, Sets y Manifiesto QR
+
+Permite la administración integral del parque de herramientas, maletines de trabajo y control de custodia de los técnicos en campo:
+
+- **Catálogo de Herramientas & Sets Temáticos:**
+  - Alta de herramientas individuales con código patrimonial, marca, modelo, número de serie, estado operativo (`disponible`, `en_uso`, `en_reparacion`, `baja`) y foto.
+  - Creación de **Sets / Kits de Herramientas** (ej. *Maletín de Fusión de Fibra Óptica*, *Kit de Redes Cobre*, *Caja Básica de Cuadrilla*) agrupando múltiples herramientas con cantidades definidas y fotografía referencial del maletín.
+- **Asignación y Custodia a Técnicos:**
+  - Asignación de custodia a técnicos de campo (sincronizados desde el Hub FSM o usuarios locales).
+  - Modalidad dual: **Dotación fija de bodega** o vinculación directa a un **Ticket de Visita Técnica FSM**.
+  - Registro de condición de entrega y condición de retorno a bodega.
+- **Evidencia Fotográfica y Auditoría Visual:**
+  - Subida segura de imágenes (`config/uploader.js`) para herramientas individuales, maletines completos, foto del estado al momento del despacho/entrega y foto de retorno al almacén.
+- **Generación e Impresión de Etiquetas QR:**
+  - Generación de códigos QR vectoriales de alta resolución para pegar en las cajas y maletines físicos.
+  - Vista de impresión optimizada (`/admin/herramientas/sets/:id/etiqueta`) con CSS `@media print` diseñado a **95mm** para impresoras térmicas de etiquetas adhesivas o impresión en papel estándar.
+  - Incluye código del set, nombre, lista de herramientas empaquetadas, código QR y enlace directo.
+- **Manifiesto Móvil Web Responsivo (`/qr/set/:token` y `/qr/asignacion/:token`):**
+  - Cualquier operador, técnico o auditor puede escanear el código QR con la cámara de su teléfono inteligente **sin requerir inicio de sesión previo** gracias a tokens criptográficos seguros (`crypto.randomBytes(12)`).
+  - Despliega en tiempo real:
+    - Estado de custodia en vivo (badge distintivo: **EN BODEGA / DISPONIBLE** vs **EN CUSTODIA TÉCNICA**).
+    - Fotografía referencial del set.
+    - Técnico responsable y ticket FSM relacionado si se encuentra asignado.
+    - **Checklist interactivo de verificación:** Permite marcar casilla por casilla las herramientas presentes dentro de la caja para inventarios rápidos en almacén o cuadrilla.
+- **API Externa M2M (`/api/external/herramientas/sets`):**
+  - Endpoint seguro autenticado vía `x-api-key` para consulta de sets y stock disponible desde aplicaciones hermanas (`app_tareas`, bots o dashboards).
+
+---
+
 ## 🛠️ Stack Tecnológico
 
 - **Backend:** Node.js 20+ con Express 5.2.
@@ -145,9 +174,15 @@ El proyecto está preparado para desplegarse de manera automatizada conforme a l
 ## 🧪 Pruebas y Auditoría
 
 ```bash
-# Verificar flujo completo de visitas técnicas contra el Hub
+# Verificar flujo completo de visitas técnicas contra el Hub FSM
 node scripts/test_visita_flow.js
 
+# Verificar flujo de inventario, subida de fotos y asignaciones de custodia
+node scripts/test_foto_flow.js
+
+# Verificar generación de tokens, códigos QR y manifiestos móviles
+node scripts/test_qr_flow.js
+
 # Consultar la bitácora centralizada de errores (API-SIGMA-WEBCONTROL)
 npm run check:errors
 ```