7. Capítulo 6 - Conclusão e próximos passos
7.1. O que foi construído
Este documento adaptou o núcleo funcional 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), que expõe as mesmas 11 rotas de negócio (JSON) do servidor Spring 4 original, na mesma porta (8080), todas agora 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 subsequente e controle de acesso baseado em papéis ([@Roles]('ADMIN') + [RolesGuard]) nas duas rotas que modificam dados;
- um cliente [React] (componentes funcionais, hooks) que oferece os mesmos recursos do cliente AngularJS 1.x original — selecionar um médico e uma data, visualizar 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 conectado (botões de reserva ocultos para um papel específico) e a possibilidade de alternar a interface entre francês e inglês ([i18next] + [react-i18next]).
O núcleo do banco de dados não mudou (as mesmas tabelas [doctors/clients/slots/appointments], 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.
Há duas diferenças intencionais em relação ao método de autenticação do documento original, documentadas em detalhe 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 visualizar as agendas (somente leitura), ao passo que no original servia apenas para ilustrar uma negação total de acesso.
7.2. O que fica fora do escopo ou por portar
Além do que foi descrito acima, o documento original abordava três tópicos adicionais — um dos quais agora foi 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 usando seu equivalente no ecossistema [React] atual, [i18next] (junto com [react-i18next], que carrega os dicionários fr.json/en.json via HTTP a partir da pasta [public/i18n/]) — veja o Capítulo 5. Assim como [angular-translate] antes dele, [i18next] permite alternar entre idiomas em tempo real, sem recarregar a página — um comportamento fiel 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 a partir da 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 atuais do [React] ([React] DevTools, extensão oficial para navegador) oferecem agora, fora da própria aplicação, uma inspeção muito mais completa dos componentes, de seu estado (hooks) e de suas props do que um painel de depuração personalizado reintegrado à interface ofereceria. Adicionar esse painel equivaleria a criar uma versão inferior de uma ferramenta já fornecida pelo ecossistema — esta decisão é, portanto, definitiva, e não um mero adiamento.
7.2.3. Atraso artificial de rede — adiado
O documento original permitia definir um atraso artificial antes de cada resposta do servidor, para 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 com base inteiramente no código que foi de fato executado: todas as rotas do servidor foram testadas (incluindo 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 quanto ao 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 a partir de sua própria estação de trabalho.
7.4. Para começar agora mesmo
Enquanto aguarda as próximas etapas deste port, o servidor e o cliente incluídos neste documento oferecem 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 chamada /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 maneira de verificar que a arquitetura em camadas do cliente funciona como esperado;
- Consulte o arquivo README de cada pasta do servidor e do cliente entregues: cada um explica, em seu contexto, o papel dos arquivos que contém.