Primeiros passos

Como criar uma conta

Novos usuários se cadastram em /register. A tela é dividida entre um painel de marketing à esquerda (um título animado "Boas-vindas ao Apps Kit SDK", uma descrição do produto em uma linha e três cartões animados de estatísticas — Maior receita, Taxas de correspondência, Falhas e ANR — que são textos 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, com no mínimo 8 caracteres, incluindo 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ê só pode entrar depois de verificar seu e-mail (veja Como fazer login abaixo).

Como alternativa, Cadastrar-se com o Google usa um popup do Google via Firebase (signInWithPopup) e registra a conta com oauthProvider: "gmail". O cadastro com o Google não exige uma verificação de e-mail separada e leva 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 de marketing à esquerda e o cartão 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 — o 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" — o mesmo fluxo de popup do Firebase usado no cadastro com o 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 verificado; caso não tenha sido, você verá a mensagem "Verifique seu e-mail primeiro." e o login não será realizado. Após um login bem-sucedido (por qualquer um dos métodos), você é direcionado para / (Meus apps) se tiver uma conta de usuário comum, ou para /users se tiver uma conta interna ou de administrador.

Esqueceu a senha

/forget-password é um formulário com um único campo (apenas 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 temporária (toast) confirma "E-mail de redefinição de senha enviado. Verifique sua caixa de entrada.". Em seguida, você retorna a /login. Um link "Voltar para o login?" também está disponível diretamente na página.

A 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 — somente 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, um menu suspenso é aberto 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" — exibida apenas se você tiver aceitado pelo menos um convite de compartilhamento de outra equipe. Ela 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. — corresponde aos recursos dessa conta, filtrados pelas permissões concedidas a você.
• Um rodapé que muda conforme o contexto: se você estiver visualizando sua própria conta, ele exibe um link "Perfil". Se estiver visualizando outra conta compartilhada, ele exibe, em vez disso, um botão vermelho "Sair → Compartilhado comigo", que retorna à sua própria conta e navega para a 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 que fique sempre visível a quem pertencem 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 em outras áreas do Portal. O contador no selo mostra o número total de notificações de todos os grupos. Ao clicar nele, um menu suspenso com o título "Notificações" é aberto, listando as notificações 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"), o clique 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, o clique leva à página Baixar SDK e marca a notificação como lida (chama o endpoint de marcação como lida e exibe a mensagem temporária "Notificação marcada como lida com sucesso").

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