Primeros pasos

Crear una cuenta

Los usuarios nuevos se registran desde /register. La pantalla se divide en un panel promocional a la izquierda (un encabezado animado de "Bienvenido a Apps Kit SDK", una descripción del producto en una línea y tres tarjetas animadas de estadísticas: Mayores ingresos, Tasas de coincidencia y Cierres inesperados y ANR; estos son textos promocionales decorativos, no datos de tu cuenta) y un formulario de registro a la derecha.

El formulario de registro solicita:

• Nombre completo: obligatorio.
• Correo electrónico: obligatorio; debe ser una dirección de correo electrónico válida.
• Contraseña: obligatoria; debe tener al menos 8 caracteres e incluir al menos una letra mayúscula, una letra minúscula y un carácter especial (p. ej., !@#$%^&*).

Al hacer clic en Crear cuenta, se crea una cuenta de Firebase con correo electrónico y contraseña, se envía de inmediato un correo de verificación de Firebase y, a continuación, se registra al usuario en el backend de Apps Kit SDK (POST /oauth/login con oauthProvider: "email"). Después, se te redirige a /login: el registro no inicia sesión automáticamente y no puedes iniciar sesión hasta que hayas verificado tu correo electrónico (consulta Iniciar sesión más abajo).

Como alternativa, Registrarse con Google utiliza una ventana emergente de Google de Firebase (signInWithPopup) y registra la cuenta con oauthProvider: "gmail". Los registros con Google no requieren una verificación de correo electrónico adicional y te llevan directamente a / (Mis aplicaciones) o a /users, según el tipo de cuenta.

El enlace "¿Ya tienes una cuenta? INICIA SESIÓN AQUÍ" te lleva de vuelta a /login.

Iniciar sesión

La pantalla de inicio de sesión (/login) utiliza el mismo diseño de dos paneles que la de registro: un panel promocional a la izquierda y la tarjeta de inicio de sesión a la derecha.

LOGIN_SCREEN_IMAGE

El formulario de inicio de sesión incluye:

• Correo electrónico: obligatorio, con un formato de correo electrónico válido.
• Contraseña: obligatoria.
• Un control para mostrar u ocultar la contraseña (icono de ojo) en el campo de contraseña.
• Continuar: el botón de envío, deshabilitado hasta que el formulario sea válido.
• Recordarme: una casilla que, al marcarla, guarda tu dirección de correo electrónico (no tu contraseña) en el navegador para que se rellene automáticamente en tu próxima visita.
• ¿Olvidaste tu contraseña?: enlaza a /forget-password.
• Un botón "Iniciar sesión con Google": utiliza el mismo flujo con ventana emergente de Firebase que el registro con Google, pero para cuentas existentes.
• "¿Eres un usuario nuevo? REGÍSTRATE AQUÍ": enlaza a /register.

Al iniciar sesión con correo electrónico y contraseña, también se comprueba que el correo electrónico de tu cuenta de Firebase esté verificado; si no lo está, verás el mensaje "Primero verifica tu correo electrónico." y no se iniciará la sesión. Tras iniciar sesión correctamente (con cualquiera de los dos métodos), se te dirige a / (Mis aplicaciones) si tu cuenta es de usuario estándar, o a /users si es una cuenta interna o de administrador.

Recuperar la contraseña

/forget-password es un formulario de un solo campo (tu dirección de correo electrónico). Al enviarlo, se llama a sendPasswordResetEmail de Firebase: no hay un flujo de restablecimiento de contraseña dentro del portal. Recibes un enlace de restablecimiento por correo electrónico y una notificación emergente confirma "Se ha enviado el correo para restablecer la contraseña. Revisa tu bandeja de entrada."; después, se te devuelve a /login. La página también incluye un enlace "¿Volver al inicio de sesión?".

La barra de navegación superior

Una vez que hayas iniciado sesión, todas las páginas (excepto las pantallas de autenticación) muestran una barra de navegación superior con el menú de tu cuenta a la derecha y, solo en la página Mis aplicaciones, una campana de notificaciones a su lado.

Menú de la cuenta. Al hacer clic en tu avatar, nombre o correo electrónico en la esquina superior derecha, se abre un menú desplegable con:

• Una fila "Mi cuenta" que representa tu propia cuenta (un punto azul la marca como contexto activo cuando está seleccionada).
• Una sección "Compartido conmigo": solo aparece si has aceptado al menos una invitación de otro equipo para compartir el acceso. Muestra el nombre, el correo electrónico y el avatar de cada persona que te ha invitado. Al hacer clic en una de ellas, todo el contexto del portal cambia a esa cuenta (técnicamente, se ejecuta switchAccount()), por lo que todo lo que veas a partir de ese momento —Mis aplicaciones, Marcas, Campañas, etc.— corresponde a sus recursos, filtrados según los permisos que te haya concedido.
• Un pie de menú que cambia según el contexto: si estás viendo tu propia cuenta, muestra un enlace "Perfil". Si estás viendo una cuenta compartida a la que has cambiado, muestra en su lugar un botón rojo "Salir → Compartido conmigo", que te devuelve a tu propia cuenta y te lleva a la página Compartido conmigo.

Cuando estás viendo otra cuenta, la barra de navegación también muestra una pequeña insignia "Compartida" junto al nombre mostrado, para que siempre puedas identificar a quién pertenecen los datos que estás consultando.

Campana de notificaciones. Solo aparece en las rutas / y /apps (es decir, en el panel de Mis aplicaciones); no está presente en ninguna otra parte del portal. El contador de su insignia indica el número total de notificaciones de todos los grupos. Al hacer clic en ella, se abre un menú desplegable titulado "Notificaciones", con entradas agrupadas por tipo, cada una con un mensaje breve.

Al hacer clic en una notificación individual, el comportamiento varía según su tipo:

• Si el tipo de notificación es upatedSdkVersion (una alerta de "Versión del SDK actualizada"), al hacer clic se te lleva directamente a la página Detalles de la aplicación correspondiente (/app/:id) y la notificación no se marca como leída.
• Para cualquier otro tipo de notificación, al hacer clic se te lleva a la página Descargar SDK y la notificación sí se marca como leída (se llama al endpoint para marcarla como leída y se muestra una notificación emergente con el mensaje "Notificación marcada como leída correctamente").

Esta campana solo ofrece un menú desplegable de consulta rápida: su interfaz es distinta y más sencilla que la página específica Mis notificaciones que se describe más adelante en esta guía, y ambas son, a su vez, independientes de la lista de invitaciones de Compartido conmigo. El portal tiene, en efecto, tres áreas distintas para invitaciones y notificaciones; consulta la sección Cuenta para conocer sus diferencias.