Ir al contenido

Incorporación

La primera vez que inicias sesión en app.engram.page, Engram te guía por un breve asistente de incorporación antes de abrir tu bóveda. El asistente existe porque Engram exige la aceptación de los Términos y un estado de suscripción activo antes de que los endpoints de la bóveda sean accesibles.

El asistente tiene dos pasos:

  1. Acuerdo. Acepta los Términos del Servicio y la Política de Privacidad. Se registra en la tabla user_agreements del servidor frente a la versión de los Términos vigente en ese momento. La versión activa se resuelve de forma dinámica desde la tabla terms_versions (con memoización mediante Engram.Legal.VersionCache), no mediante una constante en tiempo de compilación.
  2. Facturación. Elige un plan y completa el pago mediante Paddle (o elige Free, que se salta Paddle por completo). Consulta Facturación → Niveles para ver qué cubre cada nivel.

Cuando ambos pasos están completos, pasas al explorador de la bóveda.

El backend envuelve /api/notes, /api/search y /api/folders tras un plug RequireOnboarding que verifica:

  • Que este usuario ha aceptado los últimos Términos
  • Que la suscripción está al corriente (o que es autoalojamiento, que se salta esta comprobación por completo)

Si alguna comprobación falla, la API devuelve 403 y la aplicación web te redirige de nuevo al asistente. Esto significa que no puedes acabar por accidente en un estado de incorporación a medias; la puerta te deja pasar o te muestra la pantalla que resuelve el paso que falta.

En autoalojamiento, la facturación está desactivada por defecto (sin PADDLE_API_KEY → config :engram, :billing_enabled es false). El asistente se salta el paso de elección de plan. Aun así aceptarás los Términos una vez.

No puedes volver a ejecutarlo manualmente; una vez aceptado, ya lo has superado. Si cambian los Términos, Engram incrementa la versión en el servidor y la siguiente llamada a la API devuelve 403; la aplicación vuelve a mostrar solo el paso de aceptación de los Términos. Los cambios de plan se hacen en la página de Facturación, no en el asistente.