Self AR Admin: Panel de control para quiosco AR
Self AR Admin es una aplicación de escritorio especializada en Electron, diseñada para configurar y gestionar cabinas de fotos interactivas de RA (AR). La herramienta reemplaza la edición manual de complejos archivos JSON con una interfaz visual intuitiva.
| Métrica | Valor |
|---|---|
| Type | Desktop App (Windows/Portable) |
| Runtime | Electron + Node.js |
| Connection | Embedded REST API (Localhost) |
| UI | Material UI (Dark Theme) |
Resumen (TL;DR)
Desarrollo de un “panel de administración para modo offline”. Creación de una herramienta fiable para operadores de cabinas de fotos, que incluye formularios profundamente anidados, gestión del sistema de archivos y lanzamiento de procesos externos de Unity.
Soluciones de ingeniería clave
🏗️ Arquitectura híbrida (Electron + Express)
En lugar de usar IPC (Inter-Process Communication) estándar, implementé una solución no convencional pero muy efectiva:
- Embedded Express Server: Se ejecuta un servidor Express ligero dentro del proceso Main de Electron.
- REST API en localhost: El proceso Renderer (React) se comunica con las funciones del sistema mediante peticiones HTTP estándar. Esto garantizó la limpieza del código, la fácil capacidad de prueba y la eliminación de la necesidad de
nodeIntegration.
📝 Gestión de datos complejos
- Anidamiento profundo: Implementé un formulario con 3 niveles de anidamiento (Libraries -> Scenes -> Characters) utilizando
react-final-formyFieldArray. - Parsing y validación: Sistema automático de parsing y generación de archivos JSON con un esquema de nomenclatura de archivos complejo y soporte para la compatibilidad con formatos antiguos.
- Puertos dinámicos: Implementé un mecanismo de búsqueda automática de puertos libres para el servidor embebido, lo que permite ejecutar múltiples copias del panel de administración.
⚙️ Integración de sistema
- Gestión de procesos: Implementé el lanzamiento de una aplicación externa de Unity (
selfar.exe) con la capacidad de pasar parámetros de configuración actualizados con un solo clic. - Hardware Config: Interfaz para configurar puertos COM de cámaras y impresoras, servidores SMTP y parámetros de flujo de video.
Detalles técnicos
- Material UI: Uso de un tema oscuro para garantizar la comodidad de los operadores en las instalaciones con poca luz.
- Portable Mode: Optimización del build mediante
electron-builderpara que la aplicación funcione desde medios portátiles. - Testing: Integración de Jest para la lógica y TestCafe para las pruebas de extremo a extremo de la interfaz.