agregar regla de observabilidad: loguear [Alpha] + accion + datos + errores en toda funcion

This commit is contained in:
2026-05-27 20:42:55 -05:00
parent 98d6d608a6
commit 1e3ed6ac02
2 changed files with 3 additions and 1 deletions
+1
View File
@@ -24,6 +24,7 @@
2. **KAPPA retorna tipos mixtos**: strings, números y booleanos para el mismo campo (ej: `status` puede ser `"active"`, `true`, o `3`). Siempre usar `String(valor)` o `safeStr()` antes de operar.
3. **No usar `.catch(() => {})`** sin loguear el error. Siempre `console.error()`.
4. **Los nombres de funciones y archivos van en español** cuando son semánticos del dominio (ej: `syncHUsToTurso` → OK, pero labels visibles van en i18n).
5. **Toda función debe tener observabilidad**: loguear entrada con `[Alpha]` + acción + datos clave, loguear errores con `[Alpha]` + descripción + error completo. Sin logs no se puede diagnosticar.
## Sincronización entre máquinas (Mac Mini ↔ MacBook Air)
+2 -1
View File
@@ -86,7 +86,8 @@ kappa-hub/
1. **No hardcodear texto** — usar `t('clave')` de vue-i18n
2. **KAPPA retorna tipos mixtos** — usar `String()` siempre
3. **No silenciar errores** — siempre `console.error()`
4. **Build verde siempre**`bun run build` + `cargo build` sin errores
4. **Observabilidad obligatoria** — toda función debe loguear `[Alpha]` + acción + datos clave + errores completos
5. **Build verde siempre**`bun run build` + `cargo build` sin errores
## Documentos clave