Primeiros passos

Como criar uma conta

Novos usuários se cadastram em /register. A tela é dividida entre um painel promocional à esquerda (um título animado "Boas-vindas ao Apps Kit SDK", uma descrição do produto em uma linha e três cards animados de estatísticas — Maior receita, Taxas de correspondência, Falhas e ANR — que são apenas elementos promocionais decorativos, não dados da sua conta) e um formulário de cadastro à direita.

O formulário de cadastro solicita:

• Nome completo — obrigatório.
• E-mail — obrigatório; deve ser um endereço de e-mail válido.
• Senha — obrigatória; deve ter no mínimo 8 caracteres e conter pelo menos uma letra maiúscula, uma letra minúscula e um caractere especial (por exemplo, !@#$%^&*).

Ao clicar em Criar conta, uma conta com e-mail e senha é criada no Firebase, um e-mail de verificação do Firebase é enviado imediatamente e, em seguida, o usuário é registrado no backend do Apps Kit SDK (POST /oauth/login com oauthProvider: "email"). Depois disso, você é redirecionado para /login — o cadastro não faz login automaticamente, e você não pode entrar até verificar seu e-mail (veja Como fazer login abaixo).

Como alternativa, Cadastrar-se com o Google usa um pop-up do Google via Firebase (signInWithPopup) e registra a conta com oauthProvider: "gmail". Cadastros pelo Google não exigem uma verificação de e-mail separada e levam você diretamente para / (Meus apps) ou /users, dependendo do tipo de conta.

O link "Já tem uma conta? ENTRE AQUI" leva de volta a /login.

Como fazer login

A tela de login (/login) usa o mesmo layout de dois painéis da tela de cadastro: um painel promocional à esquerda e o card de login à direita.

LOGIN_SCREEN_IMAGE

O formulário de login contém:

• E-mail — obrigatório, em um formato de e-mail válido.
• Senha — obrigatória.
• Um controle para mostrar/ocultar a senha (ícone de olho) no campo de senha.
• Continuar — botão de envio, desabilitado até que o formulário seja válido.
• Lembrar de mim — uma caixa de seleção que, quando marcada, salva seu endereço de e-mail (não sua senha) no navegador para preenchê-lo automaticamente na próxima visita.
• Esqueceu a senha? — link para /forget-password.
• Um botão "Entrar com o Google" — usa o mesmo fluxo de pop-up do Firebase do cadastro pelo Google, mas para contas existentes.
• "Novo usuário? CADASTRE-SE AQUI" — link para /register.

O login com e-mail e senha também verifica se o e-mail da sua conta do Firebase foi confirmado. Caso não tenha sido, você verá a mensagem "Verifique seu e-mail primeiro." e o login não será concluído. Após um login bem-sucedido (por qualquer um dos métodos), você é direcionado para / (Meus apps) se sua conta for de um usuário comum, ou para /users se for uma conta interna/de administrador.

Esqueceu a senha

A página /forget-password contém um formulário com um único campo (seu endereço de e-mail). O envio chama sendPasswordResetEmail do Firebase — não há um fluxo de redefinição de senha dentro do Portal; você recebe um link de redefinição por e-mail, e uma mensagem toast confirma "E-mail de redefinição de senha enviado. Verifique sua caixa de entrada.". Em seguida, você é levado de volta a /login. O link "Voltar para o login?" também está disponível diretamente na página.

Barra de navegação superior

Após o login, todas as páginas (exceto as telas de autenticação) exibem uma barra de navegação superior com o menu da sua conta à direita e — apenas na página Meus apps — um sino de notificações ao lado dele.

Menu da conta. Ao clicar no seu avatar, nome ou e-mail no canto superior direito, você abre um menu suspenso com:

• Um item "Minha conta" que representa sua própria conta (um ponto azul indica que ela é o contexto ativo quando selecionada).
• Uma seção "Compartilhado comigo" — ela só aparece se você tiver aceitado pelo menos um convite de compartilhamento de outra equipe. A seção lista cada pessoa que enviou um convite, com nome, e-mail e avatar. Ao clicar em uma delas, todo o contexto do Portal muda para essa conta (tecnicamente, dispara switchAccount()), de modo que tudo o que você vê a partir daí — Meus apps, Marcas, Campanhas etc. — passa a refletir os recursos dessa conta, filtrados pelas permissões que ela concedeu a você.
• Um rodapé que muda conforme o contexto: se você estiver visualizando sua própria conta, ele mostra o link "Perfil". Se estiver visualizando uma outra conta compartilhada, ele mostra, em vez disso, um botão vermelho "Sair → Compartilhado comigo", que retorna à sua própria conta e leva à página Compartilhado comigo.

Quando você está visualizando outra conta, a barra de navegação também exibe um pequeno selo "Compartilhado" ao lado do nome exibido, para deixar sempre claro de quem são os dados que você está consultando.

Sino de notificações. Ele aparece apenas nas rotas / e /apps (ou seja, no painel Meus apps) — não está presente nas demais áreas do Portal. Seu contador mostra o número total de notificações de todos os grupos. Ao clicar nele, você abre um menu suspenso com o título "Notificações", que lista as entradas agrupadas por tipo, cada uma com uma mensagem curta.

O comportamento ao clicar em uma notificação varia conforme o tipo:

• Se o tipo da notificação for upatedSdkVersion (um alerta de "Versão do SDK atualizada"), clicar nela leva você diretamente à página Detalhes do app correspondente (/app/:id) e não marca a notificação como lida.
• Para todos os outros tipos de notificação, clicar leva à página Baixar SDK e marca a notificação como lida (chama o endpoint de marcação como lida e exibe a mensagem toast "Notificação marcada como lida com sucesso").

Esse sino oferece apenas um menu suspenso para consulta rápida — é uma interface diferente e mais simples que a página dedicada Minhas notificações, descrita mais adiante neste guia, e ambas são separadas da lista de convites de Compartilhado comigo. De fato, há três interfaces distintas de convites/notificações no Portal; consulte a seção Conta para entender as diferenças entre elas.