Primeros pasos

Crear una cuenta

Los nuevos usuarios se registran desde /register. La pantalla se divide en un panel promocional a la izquierda (con el encabezado animado "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 Fallos y ANR; estos elementos son contenido promocional decorativo, 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 inmediatamente 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 la sección Iniciar sesión más abajo).

Como alternativa, Registrarse con Google utiliza una ventana emergente de Google mediante 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 el formulario 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 rellenarla 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 de ventana emergente de Firebase que el registro con Google, pero para cuentas existentes.
• "¿Eres 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 "Verifica primero tu correo electrónico." y no se iniciará sesión. Tras iniciar sesión correctamente (con cualquiera de los dos métodos), se te redirige 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 contiene un formulario con un único campo: tu dirección de correo electrónico. Al enviarlo, se llama a sendPasswordResetEmail de Firebase. No hay un flujo para restablecer la contraseña dentro del portal: recibes un enlace de restablecimiento por correo electrónico y un aviso emergente confirma "Se ha enviado el correo para restablecer la contraseña. Revisa tu bandeja de entrada"; después, se te redirige 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 has 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 junto a él.

Menú de 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 identifica como el 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 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()), de modo que todo lo que veas a partir de ese momento —Mis aplicaciones, Marcas, Campañas, etc.— refleja sus recursos, filtrados según los permisos que te hayan 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 otra cuenta compartida, 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 etiqueta "Compartida" junto al nombre mostrado, para que siempre puedas identificar de quién son 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 se muestra en ninguna otra parte del portal. Su contador indica el número total de notificaciones de todos los grupos. Al hacer clic en ella, se abre un menú desplegable titulado "Notificaciones", con las entradas agrupadas por tipo, cada una con un mensaje breve.

Al hacer clic en una notificación, 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 el aviso emergente "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. A su vez, ambas son independientes de la lista de invitaciones de Compartido conmigo. En efecto, el portal cuenta con tres interfaces distintas para invitaciones y notificaciones; consulta la sección Cuenta para conocer sus diferencias.