Skip to content

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

7.1. O que foi construído

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

  • um servidor [NestJS] completo (incluído neste documento, instalado e testado no Capítulo 2, mas cujo código não é abordado aqui), que expõe as mesmas 11 rotas JSON de negócio 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 seguinte e controle de acesso baseado em papéis ([@Roles]('ADMIN') + [RolesGuard]) nas duas rotas que modificam dados;
  • um cliente [Flutter] (widgets [Material], pacote [provider]) que oferece as mesmas funcionalidades do cliente AngularJS 1.x original—selecionar um médico e uma data, visualizar o calendário, reservar e cancelar uma consulta—complementado por uma tela de login, uma sessão persistente ([shared_preferences]), uma interface adaptada ao papel do usuário conectado (botões de reserva ocultos para o papel USER) e a possibilidade de alternar a interface entre francês e inglês ([TranslationsService], reimplementado sem biblioteca de terceiros).

O núcleo do banco de dados não mudou (mesmas tabelas [doctors/clients/slots/appointments], 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 à autenticação do documento original, implementadas pelo servidor entregue (veja o Capítulo 2): 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 calendários (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 por portar

Além do que foi visto acima, o documento original abordava três tópicos adicionais—um dos quais foi agora tratado, outro deliberadamente deixado de fora e o terceiro adiado para uma etapa posterior:

7.2.1. Internacionalizaçã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 [TranslationsService] (veja o Capítulo 4), escrito especificamente para este documento em vez de delegado a um plugin de terceiros: os dicionários fr.json/en.json, embutidos no aplicativo (e não mais servidos por um servidor web), são carregados por meio de [rootBundle.loadString(...)]. Assim como [angular-translate] e [vue-i18n] antes dele, [TranslationsService] permite alternar os idiomas em tempo real sem recarregar o aplicativo—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 pela interface, que dava acesso ao modelo bruto ($scope 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 reconstrói: as ferramentas de desenvolvimento atuais do [Flutter] ([Flutter] DevTools, utilizáveis nos três alvos—mobile, desktop, web) oferecem agora, à parte a própria aplicação, uma inspeção muito mais completa da árvore de widgets, de seu estado e de suas propriedades 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 simples adiamento.

7.2.3. Atraso de rede artificial—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 apoiando-se sistematicamente no código realmente executado: cada rota do servidor foi testada (incluindo os cenários de autenticação: login bem-sucedido/malsucedido, acesso sem token, acesso com o papel errado); o cliente [Flutter] (Capítulo 4), por outro lado, foi revisado e verificado linha a linha em vez de executado por Claude—o ambiente que produziu este documento não tem acesso a uma máquina capaz de executar [Flutter] (mobile, desktop ou web), ao contrário dos clientes web anteriores deste curso, que podem ser executados diretamente em um navegador [Chromium] automatizado. As capturas de tela do cliente nos Capítulos 4 e 5 (web, desktop Windows, emulador Android) foram feitas pelo autor em sua própria máquina.

7.4. Para ir mais longe agora mesmo

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

  • adicionar um novo médico ou um novo paciente (atualmente, isso é feito apenas modificando o script SQL—uma rota /addDoctor, também protegida por [@Roles]('ADMIN'), poderia ser um primeiro exercício);
  • adicionar um terceiro papel ou um usuário com vários papéis—uma oportunidade de avaliar, de forma muito concreta, o custo de abandonar a simplificação de coluna única proporcionada por [role] (veja o Capítulo 2);
  • modificar a apresentação do cliente (cores, layout) sem alterar o servidor—uma boa maneira de verificar se 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.