Documentación · Entender

Cómo funciona la app

Arquitectura sin servidor propio de STALMAS y relación entre Portainer, SSH, el asistente híbrido de IA y Google Drive.

STALMAS está diseñada bajo una regla sencilla: ningún servidor nuestro participa cuando administras tu infraestructura. Toda la lógica corre dentro de tu dispositivo Android.

Conexiones directas desde el teléfono

[Tu Android + STALMAS]
   ├── HTTPS / HTTP local ──────────▶ [Tu Portainer CE / BE]
   ├── SSH TCP + TOFU ──────────────▶ [Tu servidor Linux / Docker]
   ├── LiteRT-LM en local ──────────▶ [Sin red · Gemma 4 .litertlm]
   ├── Opcional (con tu clave) ─────▶ [Google Gemini API]
   └── Opcional (AES-256) ──────────▶ [Tu Google Drive (appDataFolder)]

Cómo se protegen los secretos en reposo

  • Base de datos cifrada: la información estructurada local usa SQLCipher v8 (android-database-sqlcipher).
  • Preferencias cifradas: tokens, claves API de Gemini y secretos viven en almacenamiento cifrado por hardware mediante Android Jetpack Security (EncryptedSharedPreferences / Keystore).
  • Sin copias del sistema (allowBackup="false"): el manifiesto Android bloquea la extracción automática hacia backups genéricos del sistema operativo.

Portero de Privacidad entre la app y la nube

Cuando envías logs, salidas de terminal o archivos Compose al asistente en la nube (Gemini con tu clave):

  1. PrivateInfoDetector detecta patrones sensibles: direcciones IPv4/IPv6, dominios, URLs, contraseñas, claves, tokens y cadenas de conexión.
  2. En Free (y hacia la nube), el portero aplica «ocultar y enviar»: sustituye cada dato sensible por [REDACTED], envía la consulta y muestra un aviso con la cantidad ocultada y la opción de ver qué se ocultó.
  3. En Pro, PseudonymMap sustituye IPs y hosts por etiquetas reversibles ([IP_1], [HOST_1]) en la petición y restaura esos valores localmente cuando la IA responde; las contraseñas, claves y tokens nunca vuelven. En modo Auto con modelo local instalado, la consulta se desvía directamente al teléfono.

Qué ocurre con Google Play

Las compras (Pro con pago único y propinas) y la verificación de integridad pasan por Google Play Billing / Play Integrity. STALMAS no gestiona tarjetas de crédito ni crea perfiles de usuario.