Roteiro de vídeo: Autenticação, Segurança e Permissões
Roteiro de gravação — Flavio Muniz (fundador) na câmera + filmagem real da tela do sistema — baseado na lição Autenticação, Segurança e Permissões. A fala é texto literal, em 1ª pessoa do Flavio.
1. Ficha técnica
| Formato | Flavio Muniz (fundador) na câmera + filmagem real da tela do sistema. O Flavio fala e executa cada passo; nas cenas de tela, insert da tela com o Flavio em picture-in-picture ou alternância câmera/tela. |
|---|---|
| Duração-alvo | ≈ 9:10 (alvo 9 min) |
| Público | Todos os usuários novos (primeiro vídeo da trilha) + implantadores, pela parte de permissões |
| Pré-requisitos de gravação | Gravar em homologação: app sistema.hmg.rabisistemas.dev, Keycloak login.hmg.rabisistemas.dev, usuário danilo@clinicas.com. Começar DESLOGADO e com sessão limpa (janela anônima). Para a cena de recuperação de senha, usar uma conta de teste com caixa de e-mail acessível — NÃO redefinir a senha da conta principal de demonstração. Para a cena de permissões, ter a conta da Carla Souza (carla.souza@clinicarabi.teste, perfil recepção: agenda e pacientes sim, financeiro NONE) criada no vídeo de Configurações. Senhas sempre borradas/cortadas na edição. Resolução 1920×1080. |
| Telas a visitar | Tela inicial → redirecionamento para /login (Keycloak) · fluxo "Esqueci minha senha" (Keycloak + e-mail) · /dashboard · /portal/minha-conta · menu do perfil → Sair · menu lateral com módulo oculto / erro 403 (usuária Carla Souza) |
| Não mostrar (roadmap) | Permissões granulares (#395) — múltiplos perfis, ações configuráveis, tela admin, sincronização de grupos com Keycloak. Só CITAR como futuro; em produção vale Role + 4 ações fixas. Não exibir o console admin do Keycloak. Entregues em julho/2026 (entram na fala): guard de edição (#401/#404), idempotência anti-duplo-clique (#408), busca global (#456) e setas próximo/anterior (#459). |
2. Dados desta gravação
Use os blocos 2/3 — Estrutura e equipe e 4 — Pacientes da página Dados de Gravação — Clínica Rabi Sistemas:
- Usuária restrita (cena 8): Carla Souza —
carla.souza@clinicarabi.teste— perfil recepção (agenda e pacientes com UPDATE; financeiro NONE) - Médica citada: Dra. Ana Beatriz Rocha — Cardiologia — CREATE em atendimento
- Busca global (cena 9): buscar "Silva" e depois o telefone (61) 98765-4321 (Maria da Silva Santos)
3. Cenas
| # | Tela / ação | FALA DO FLAVIO (texto literal) | Duração |
|---|---|---|---|
| 1 | Flavio na câmera; vinheta ou tela de login congelada ao fundo. | "Olá, e bem-vindo ao Rabi! Eu sou o Flavio Muniz, fundador do sistema. Neste vídeo eu vou te mostrar como entrar no sistema, recuperar sua senha sozinho, sair com segurança e entender quem pode ver e fazer o quê. É o vídeo que todo usuário novo deve assistir primeiro. Vamos juntos." | 0:35 |
| 2 | Em janela anônima, digite o endereço do sistema e mostre o redirecionamento automático para a tela de login (/login). | "O Rabi roda direto no navegador — Chrome, Edge ou Firefox atualizados — sem instalar nada. Eu digito o endereço da clínica e, como ainda não estou autenticado, o sistema me leva sozinho pra tela de login. Importante: o acesso não é público. Sua conta precisa ter sido criada antes pelo administrador da clínica." | 0:45 |
| 3 | Na tela de login, aponte os campos E-mail, Senha, o botão Entrar e o link "Esqueci minha senha". Faça o login (senha borrada). Caia no Dashboard. | "A tela tem o essencial: e-mail, senha, o botão Entrar e o link Esqueci minha senha — guarda esse link, já vamos usá-lo. Informo o e-mail cadastrado, a senha... e Entrar. Credenciais validadas, o sistema abre o Dashboard. E uma regra de ouro desde o primeiro dia: nunca compartilhe sua senha. Cada pessoa tem o seu próprio acesso." | 0:45 |
| 4 | Faça logout e clique em "Esqueci minha senha". Informe o e-mail da conta de teste, mostre a mensagem de envio; corte para a caixa de entrada, abra o e-mail, clique no link e mostre a tela de nova senha (digitação borrada). Volte ao login e entre. | "Esqueceu a senha? Você resolve sozinho — e olha como é simples. Na tela de login, clico em Esqueci minha senha. Informo o e-mail da conta e confirmo. Agora, na caixa de entrada — e vale conferir o spam — chegou o e-mail de redefinição. Clico no link, crio a nova senha nos dois campos e confirmo. Atenção: o link expira rápido, em cerca de cinco minutos. Expirou? Sem drama: repete o processo e recebe um novo. E se a conta bloquear por muitas tentativas erradas, aguarda alguns minutos ou chama o administrador." | 1:15 |
| 5 | Logado, acesse Minha Conta (/portal/minha-conta). Percorra: nome, e-mail, alterar senha, sessões ativas, foto de perfil. | "Dentro do sistema, a página Minha Conta reúne o seu perfil: nome, e-mail, a opção de trocar a senha a qualquer momento, a foto de perfil e — repara nisso comigo, porque é muito útil — as sessões ativas, mostrando os dispositivos conectados com a sua conta. Mudanças de nome ou e-mail podem depender de confirmação do administrador, conforme a política da clínica." | 0:45 |
| 6 | Clique na foto/nome no canto superior direito e em "Sair". Mostre a volta à tela de login. | "Pra encerrar o expediente, não basta fechar a aba — a sessão pode continuar viva. Eu clico na minha foto, no canto superior direito, e depois em Sair. Pronto: desconectado, de volta ao login. Em computador compartilhado, como o da recepção, isso não é capricho: é proteção de dados de pacientes e informações financeiras." | 0:45 |
| 7 | Tela de login do Keycloak em destaque (pode usar overlay simples com o fluxo: navegador → Keycloak → token → Rabi). | "Um bastidor que explica muita coisa: quem cuida do login é o Keycloak, um servidor de identidade que usa os padrões OAuth2 e OpenID Connect. Sua senha nunca passa pelo Rabi — ele só recebe um token de acesso já validado. É também o que permite o single sign-on: uma autenticação para os sistemas do mesmo ambiente. E as sessões expiram sozinhas após um tempo de inatividade." | 0:45 |
| 8 | Troque para a conta da Carla Souza (perfil recepção) ou mostre lado a lado. Mostre o menu SEM o módulo Financeiro; se possível, mostre um erro 403 ao tentar uma ação sem nível. Exiba overlay com a escada NONE < VIEW < CREATE < UPDATE < DELETE e os 9 grupos. | "Agora, quem pode fazer o quê. O modelo em produção é direto: cada usuário tem um papel, e pra cada módulo um nível de ação. NONE esconde o módulo. VIEW só consulta. CREATE cria. UPDATE edita. DELETE exclui — esse, concede com cautela. São nove grupos: agendamento, atendimento, pacientes, financeiro, faturamento, configurações, estoque, relatórios e dashboard. Vê na prática comigo: esta é a conta da Carla, a recepcionista da nossa Clínica Rabi Sistemas. Ela tem permissão de agenda e de pacientes — que é o trabalho dela — mas não tem financeiro: o menu simplesmente não existe pra ela. Já a Doutora Ana, a médica, tem CREATE em atendimento pra registrar as consultas. E se a Carla tentar uma ação acima do nível dela, recebe o erro quatrocentos e três. A solução nos dois casos é a mesma: pedir ajuste ao administrador. Existe um modelo de permissões granulares planejado no roadmap, mas ele ainda não está em produção." | 1:35 |
| 9 | Em qualquer tela de cadastro: alterar um campo e tentar sair sem salvar (mostrar a confirmação do guard). Depois usar a busca global — buscar "Silva" e o telefone (61) 98765-4321 — e as setas próximo/anterior no topo da tela. | "Antes de fechar, quatro proteções que chegaram na atualização de julho de dois mil e vinte e seis e valem pro sistema inteiro. O guard de edição: eu alterei um campo, tentei sair sem salvar... e o sistema pediu confirmação — nada de perder trabalho por um clique errado. A proteção contra duplo clique: se você clicar duas vezes no salvar sem querer, o sistema entende como um clique só — sem registro duplicado. A busca global de pacientes: eu digito 'Silva'... e acho a Maria; digito o telefone dela... e acho também — um pedaço do nome, telefone, e-mail ou CPF, e o sistema encontra. E essas setas de próximo e anterior no topo das telas, que deixam você navegar entre registros sem voltar pra lista toda hora." | 0:50 |
| 10 | Tela dos Logs de Auditoria em Relatórios (rápida) ou overlay sobre rastreabilidade. | "E por que tanta insistência no acesso individual? Porque o sistema registra tudo nos logs de auditoria: quem fez, o quê e quando. Isso protege você e a clínica, e atende à LGPD. Senha compartilhada quebra essa rastreabilidade — por isso é proibida." | 0:30 |
| 11 | Flavio na câmera para o encerramento. | "Resumo: login pelo Keycloak, senha recuperável por e-mail com link de validade curta, logout sempre pelo botão Sair, permissões por papel com quatro níveis de ação — e o sistema ainda te protege com o guard de edição e o anti duplo clique. Com isso você entra, trabalha e sai com segurança — e segurança bem feita é o que faz clínica confiar no profissional. O Rabi Sistemas é o sistema definitivo para a sua clínica. Bons atendimentos, e até o próximo vídeo!" | 0:40 |
Soma das cenas: 9:10.
Cena alternativa — participação da Dra. Heloisa (opcional)
Opcional. Se a agenda permitir, a cena 10 pode ser gravada com a Dra. Heloisa Ravagnani Muniz (médica, cofundadora do dia a dia da clínica) na câmera, no lugar do overlay. Fala sugerida (texto literal dela): "Eu sou a Dra. Heloisa, e atendo pacientes todos os dias no Rabi. Pra mim, médica, esse controle de acesso não é burocracia: é sigilo médico. O prontuário é do paciente, e a LGPD exige que só quem precisa veja. Os logs de auditoria registram quem fez o quê e quando — e é isso que protege o paciente, protege você e protege a clínica. Por isso, senha é individual, sempre." Se gravada, substitui a fala do Flavio na cena 10 (duração passa de 0:30 para ≈0:40; total ≈9:20). Se a Dra. Heloisa não puder, gravar a cena 10 original com o Flavio — nada muda no restante do roteiro.
4. Checklist pós-gravação
- [ ] 11 cenas gravadas na ordem; duração total entre 8:30 e 9:45.
- [ ] A cena final inclui o bordão: "O Rabi Sistemas é o sistema definitivo para a sua clínica."
- [ ] A cena 8 usou a conta da Carla Souza (recepção: agenda/pacientes sim, financeiro NONE) e citou a Dra. Ana como exemplo de CREATE em atendimento.
- [ ] As proteções transversais jul/2026 da cena 9 (guard de edição, anti duplo clique, busca global com "Silva"/(61) 98765-4321, setas próximo/anterior) foram demonstradas ou narradas.
- [ ] Nenhuma senha legível em nenhum frame (digitação borrada/cortada nas cenas 3, 4 e 8).
- [ ] A cena 4 usou conta de teste dedicada; a senha da conta principal de demonstração não foi alterada.
- [ ] E-mail exibido na caixa de entrada não contém mensagens pessoais ou dados de terceiros.
- [ ] A cena 8 mostrou o modelo real (Role + 4 ações); permissões granulares apenas citadas como roadmap, sem tela.
- [ ] Se a cena alternativa da Dra. Heloisa foi gravada, a fala dela cobriu sigilo médico + LGPD e substituiu a cena 10.
- [ ] Console administrativo do Keycloak não apareceu em nenhum momento.
- [ ] Nenhum dado real de paciente visível (LGPD); ambiente de homologação com a base fictícia da Clínica Rabi Sistemas.
- [ ] Fala confere com o texto literal; desvios anotados para atualizar o roteiro.
- [ ] Vídeo exportado em 1080p e revisado contra
licoes/seguranca.html.