Skip to content

7. Capítulo 6 - Conclusão e próximos passos

7.1. O que foi construído

Este documento portou as funcionalidades principais e a autenticação da aplicação [RdvMedecins] do documento original de 2014 para tecnologias atuais:

  • um servidor [NestJS] completo (entidades [TypeORM], DAO, camada de negócio, camada web), expondo as mesmas 11 rotas de negócio JSON do servidor Spring 4 original, na mesma porta (8080), agora todas protegidas por um token JWT;
  • uma camada de autenticação ([@nestjs/passport] + [@nestjs/jwt]): autenticação por login/senha (POST /login), um token assinado apresentado a cada requisição seguinte e controle de acesso baseado em papéis ([@Roles]('ADMIN') + [RolesGuard]) nas duas rotas que modificam dados;
  • um cliente [Angular] (componentes standalone, signals) que oferece as mesmas funcionalidades do cliente AngularJS 1.x original — selecionar um médico e uma data, ver a agenda, reservar e cancelar uma consulta — complementado com uma tela de login, uma sessão persistente (localStorage), uma interface Bootstrap que se adapta ao papel do usuário autenticado (botões de reserva ocultos para o papel USER) e a possibilidade de alternar a interface entre francês e inglês ([@ngx-translate/core] + [@ngx-translate/http-loader]).

O núcleo do banco de dados não mudou (as mesmas tabelas de médicos/clientes/horários/consultas, as mesmas restrições), exceto pela adição da tabela [users]; a arquitetura geral em camadas também não mudou — apenas as ferramentas que a implementam foram atualizadas.

Duas diferenças intencionais em relação ao mecanismo de autenticação do documento original, documentadas em detalhes no Capítulo 3: um token JWT em vez do cabeçalho HTTP Basic enviado a cada requisição, e uma única coluna [role] por usuário em vez de uma relação muitos-para-muitos entre três tabelas. Uma terceira diferença — esta funcional — foi escolhida deliberadamente para este port: o papel USER agora pode ver as agendas (somente leitura), ao passo que no original ele servia apenas para ilustrar uma negação total de acesso.

7.2. O que fica fora do escopo ou a portar

Além do que foi apresentado, o documento original abordava três tópicos adicionais — um deles já tratado, outro deliberadamente deixado de fora e o terceiro adiado para uma etapa posterior:

7.2.1. Localização francês/inglês — tratada neste documento

O documento original propunha alternar a interface entre francês e inglês usando a biblioteca angular-translate. Este port implementa essa funcionalidade com seu equivalente no ecossistema [Angular] atual, [@ngx-translate/core] (acompanhado de [@ngx-translate/http-loader], que carrega os dicionários fr.json/en.json via HTTP a partir da pasta public/i18n) — veja o Capítulo 5. @angular/localize, a outra solução possível, foi descartado: ele exige compilação separada por idioma, enquanto o ngx-translate permite trocar de idioma na hora, sem recarregar a página — um comportamento mais próximo ao do documento original.

7.2.2. O modo “debug” do cliente — deliberadamente excluído do escopo

O documento original incluía um modo de exibição técnico, ativável pela interface, que dava acesso ao modelo bruto ($scope do AngularJS 1.x) da view atual — um recurso útil em 2014, quando as ferramentas de desenvolvimento disponíveis para inspecionar uma aplicação AngularJS ainda eram limitadas. Este port não o recria: as ferramentas de desenvolvimento [Angular] atuais ([Angular] DevTools, extensão oficial para navegador) oferecem agora, fora da própria aplicação, uma inspeção muito mais completa dos componentes, de seus signals e de suas entradas/saídas do que um painel de depuração personalizado reintegrado à interface ofereceria. Adicionar esse painel equivaleria a criar uma versão inferior de uma ferramenta que o ecossistema já fornece — esta decisão é, portanto, definitiva, e não apenas um adiamento.

7.2.3. Um atraso de rede artificial — adiado

O documento original permitia definir um atraso artificial antes de cada resposta do servidor, a fim de observar o comportamento da interface em uma rede lenta (indicadores de carregamento, desativação temporária de botões etc.). Este recurso ainda não tem equivalente neste port.

7.3. Uma nota sobre a metodologia usada neste documento

Este documento foi escrito apoiando-se sistematicamente no código que foi realmente executado: cada rota do servidor foi testada (inclusive cenários de autenticação: login bem-sucedido/malsucedido, acesso sem token, acesso com o papel errado), e cada captura de tela do cliente (Capítulo 5) foi obtida interagindo com a aplicação real em execução — um navegador Chromium controlado automaticamente, usando dados de demonstração do script SQL fornecido. Essa abordagem também revelou, durante a preparação deste documento, um problema específico no uso do [TypeORM] com colunas calculadas ([@RelationId]) — que foi relatado e corrigido no Capítulo 3, diretamente no código entregue. Essa exigência também explica por que capturas de tela do Postman não estão incluídas neste documento: em vez de simulá-las, pareceu preferível deixar essa etapa para o autor do documento, que pode criá-las diretamente em sua própria estação de trabalho.

7.4. Para ir além desde já

Enquanto se aguardam as próximas etapas deste port, o servidor e o cliente incluídos neste documento fornecem uma base pronta para uso para você experimentar por conta própria:

  • adicionar um novo médico ou um novo paciente (atualmente, isso só pode ser feito modificando o script SQL — uma rota /addDoctor, também protegida por [@Roles]('ADMIN'), poderia ser um bom primeiro exercício);
  • adicionar um terceiro papel, ou um usuário com vários papéis — uma oportunidade de avaliar, de forma bem concreta, o custo de abandonar a simplificação da coluna única [role] (veja o Capítulo 3);
  • modificar a apresentação do cliente (cores, layout) sem alterar o servidor — uma boa forma de verificar que a arquitetura em camadas do cliente funciona como anunciado;
  • revisar o arquivo README de cada pasta do servidor e do cliente entregues: cada um explica, em seu contexto, o papel dos arquivos que ela contém.