feat: complete pending roadmap items with doctor, hardening, and code quality

docs/troubleshooting.md

@@ -0,0 +1,27 @@
+# Troubleshooting
+
+## `No existe la carpeta NodeCG`
+
+- Verifica que exista `lib/nodecg`.
+- Asegúrate de que el proyecto contiene una instalación completa de NodeCG.
+
+## `Sin permisos de lectura/escritura sobre NodeCG`
+
+- Ajusta permisos de `lib/nodecg` para el usuario que ejecuta Electron.
+- En Linux/macOS: `chmod -R u+rw lib/nodecg` (según tu política local).
+
+## `El puerto <PORT> ya está en uso`
+
+- Libera el puerto o define `NODECG_PORT` en `.env`.
+- Usa `npm run doctor` para validar disponibilidad antes de arrancar.
+
+## `Timeout esperando NodeCG`
+
+- Revisa logs de NodeCG en la salida estándar.
+- Incrementa `NODECG_STARTUP_TIMEOUT_MS` si el entorno es lento.
+- Verifica dependencias de NodeCG (`cd lib/nodecg && npm install`).
+
+## Build macOS falla por icono
+
+- La configuración espera `static/icons/icon.icns`.
+- Crea ese archivo antes de ejecutar empaquetado para macOS.