Tauri v2 + Rust + Vite + TypeScript vanilla.- Motivo: mantener la app ligera, con IPC claro y sin meter un framework UI innecesario.
- Backend primero.
- La lógica crítica está en Rust: auth, firma, cliente HTTP, persistencia y normalización.
- Modelo de dominio estable antes de UI.
- La UI trabaja sobre
DeviceyDeviceChannel, no sobre respuestas raw de Tuya.
- La UI trabaja sobre
- Persistencia local simple.
- Archivos JSON/JSONL en el directorio de datos de la app; suficiente para el MVP y fácil de migrar luego.
- Extensibilidad por capas.
commandssólo expone transporte Tauri.services/tuyacontiene la lógica reusable.- Los módulos futuros deben colgarse del mismo servicio, no duplicar lógica HTTP.
idnameonlinecategoryproductIdinferredTypegangCountchannels: DeviceChannel[]rawmetadata
codedisplayNameindexcurrentStatecontrollablealias
codevalueTypevaluesmodesupportnamedescription
codevalue
clientIdclientSecretbaseUrlregionLabel
deviceIdalias
deviceIdchannelCodealias
- Frontend llama
load_bootstrap. - Rust carga config, metadata y action log.
- Si hay config,
TuyaServiceobtiene token y lista dispositivos. - Por cada dispositivo se intenta obtener
details,status,functions,capabilitiesyspecification. normalize_device(...)construye elDevice.infer_device_channels(...)detecta los gangs y produceDeviceChannel[].- El frontend renderiza tarjetas y controles por canal.
Capas:
signing.rs- genera
Content-SHA256 - arma
stringToSign - firma HMAC-SHA256
- genera
http_client.rs- construye requests firmados
- agrega headers
client_id,sign,t,nonce,access_token - parsea envelopes de Tuya
auth.rs- obtiene token
- cachea token en memoria
- refresca cuando expira
service.rs- orquesta endpoints
- aplica retry ante token vencido
- expone métodos de dominio
La detección está centralizada en infer_device_channels(device_id, functions, status, capabilities, metadata).
Reglas:
- Si existen
switch_1..switch_4, esos códigos mandan. - Si no existen, se prueba
switch. - Si tampoco existe, se prueba
switch_led. - Si nada de lo anterior aparece, se buscan códigos booleanos que contengan
switch.
Detalles importantes:
- La detección revisa
functions,statusycapabilities. statusdefine el estado actual.functions/capabilitiesdefinen si el canal es controlable.- Si hay estado sin capacidad/función, el canal se muestra como
read only. - Si existe alias local para un canal, reemplaza el nombre visual.
Ejemplos:
switch_1,switch_2=> 2 gangsswitch_1,switch_2,switch_3=> 3 gangsswitch_1aswitch_4=> 4 gangs- sólo
switch=> 1 canal - sólo
switch_led=> 1 canal
La UI usa un store simple (AppStore) con:
- bootstrap
- config draft
- connection status
- devices
- filtros
- view mode
- busy state por canal
- toasts
- action log
No hay framework de componentes pesado. Se usa renderizado por template string y delegación de eventos.
Archivos:
config.json- credenciales y base URL
metadata.json- alias de dispositivos
- alias de canales
- preferencias UI
actions.jsonl- historial ligero de acciones
Errores cubiertos:
- configuración faltante
- configuración inválida
- fallo HTTP
- error de API Tuya
- token expirado
- respuesta inesperada
- errores de I/O local
Los comandos Tauri devuelven AppErrorPayload serializable para que el frontend muestre mensajes claros sin acoplarse a reqwest o a errores internos de Rust.
- configuración
- test de conexión
- listado
- normalización
- control por canal
- alias locales
- action log
- refresh automático opcional
- mejor telemetría local
- más heurísticas por categorías Tuya
- pruebas con respuestas reales exportadas
schedulerautomationlocal_api- escenas
- integración con Home Assistant / Node-RED
- soportar paginación robusta en todos los endpoints de listado
- capturar y cachear
detailsparciales para mejorar arranque - persistir último snapshot de dispositivos para modo degradado offline
- exponer más metadata útil de producto en la tarjeta
- añadir pruebas de integración con fixtures de respuestas Tuya reales
Responsabilidad futura:
- reglas del tipo
if trigger then action - escenas simples
- acciones encadenadas
Contrato recomendado:
- no llamar a comandos Tauri
- usar el mismo servicio de aplicación que hoy usa el desktop
Responsabilidad futura:
- disparar acciones por horario
- almacenar tareas
- manejar retry y estados de ejecución
Contrato recomendado:
- programar acciones de dominio, no eventos de UI
Responsabilidad futura:
- exponer endpoints HTTP locales para integraciones
Ejemplos:
POST /devices/:id/channels/:channelCode/onPOST /devices/:id/channels/:channelCode/offGET /devices
La clave es mantener el backend actual como un servicio de dominio reutilizable.
Hoy:
frontend -> Tauri commands -> TuyaService
Mañana:
frontend -> Tauri commands -> ApplicationService -> TuyaServicelocal HTTP server -> ApplicationService -> TuyaServicescheduler -> ApplicationService -> TuyaService
Eso evita duplicar:
- auth
- firma
- normalización
- lógica de canales
- manejo de errores Tuya
La recomendación para la siguiente etapa es extraer una capa application o use_cases con operaciones como:
load_devices()toggle_channel(device_id, channel_code, value)rename_device(...)rename_channel(...)
Así Tauri deja de ser el centro y pasa a ser sólo un adaptador de transporte.