1. Introdução
O PDF do documento está |AQUI|.
Os códigos do documento estão |AQUI|.
Este documento é um produto de Claude, a IA da Anthropic. Seu objetivo é transpor o documento [A Client/Server Example - AngularJS 1.x / Spring 4 ] de duas maneiras:
- o cliente AngularJS 1.x é substituído por um cliente [Angular] 22;
- o framework web Java Spring MVC é substituído pelo framework web NestJS;
Claude, da Anthropic (IA) fez a maior parte do trabalho (90%):
- geração do código: Claude gerou todo o código. Eu apenas o testei seguindo o curso gerado
- geração do curso em formato ODT: Claude gerou várias versões a meu pedido. Foi aqui que atuei principalmente.
Nota: ao ler o curso gerado por Claude, a IA, percebi que há muitos conceitos a assimilar. Se o objetivo principal do leitor é “aprender NestJS”, um exemplo mais simples está disponível no documento [Introdução à linguagem TypeScript e ao framework web NestJS por meio de exemplos (2026)]. O leitor poderá então voltar a este documento para entender o framework Angular do lado do cliente.
Serge Tahé, setembro de 2026
==
Este documento é a continuação do curso “Um exemplo cliente/servidor - AngularJS 1.x / Spring 4,” escrito em 2014. Esse documento original construía uma pequena aplicação de agendamento de consultas médicas (“[RdvMedecins]”) com um servidor Spring 4 / Spring Data / Spring MVC e um cliente AngularJS 1.x .
Doze anos depois, os dois frameworks utilizados evoluíram muito, ou até foram substituídos no uso corrente:
- no lado do servidor, [NestJS] consolidou-se como um dos frameworks Node.js/TypeScript mais utilizados para construir aplicações web estruturadas, com uma filosofia semelhante à do Spring (módulos, controllers, serviços, injeção de dependência), mas dentro do ecossistema JavaScript/TypeScript;
- no lado do cliente, AngularJS 1.x foi completamente reescrito a partir de 2016 com o nome [Angular] (2, 4, 5… até a versão 22 usada neste documento), com uma arquitetura baseada em componentes e, mais recentemente, um sistema de reatividade baseado em signals que substitui o mecanismo de monitoramento ($watch) do AngularJS 1.x.
O objetivo deste documento é retomar o estudo de caso original (a mesma aplicação, as mesmas funcionalidades, o mesmo banco de dados) e reconstruí-lo com as ferramentas atuais, mantendo o máximo possível a mesma progressão didática do documento de 2014.
1.1. Uma reconstrução passo a passo
O documento original tinha cerca de 300 páginas e abordava, além das funcionalidades centrais da aplicação, a autenticação baseada em papéis (Spring Security) e doze exemplos progressivos para aprender AngularJS 1.x passo a passo. Reconstruir todo esse conteúdo de uma só vez seria demorado e difícil de assimilar.
Este documento cobre, portanto, as duas primeiras etapas da reconstrução:
- a arquitetura geral da aplicação (inalterada em seu princípio);
- o banco de dados (inalterado, exceto pela adição da tabela [users]);
- o servidor [NestJS] completo, com todas as funcionalidades de consulta, agendamento e cancelamento de consultas;
- a autenticação por token (JWT) e o controle de acesso baseado em papéis (ADMIN/USER), equivalente à camada Spring Security do documento original;
- o cliente [Angular] correspondente, com as mesmas funcionalidades, uma tela de login, uma interface Bootstrap adaptada ao papel do usuário conectado e a possibilidade de alternar a interface entre francês e inglês ([@ngx-translate/core]).
Duas funcionalidades do documento original ficam, nesta etapa, fora deste documento: o modo “debug” do cliente original (exibição do template bruto da view atual), que foi deliberadamente omitido desta portagem (veja o Capítulo 6 para as razões dessa decisão), e a configuração de um atraso artificial de rede, adiada para uma etapa posterior.
1.2. A quem se destina este documento
Este documento não pressupõe nenhum conhecimento prévio de [NestJS] nem de Angular. Cada novo conceito (decorador, injeção de dependência, componente, signal etc.) é explicado quando aparece, com o maior detalhe possível, inclusive para leitores que nunca escreveram uma única linha de TypeScript.
No entanto, alguns conhecimentos básicos ajudam a aproveitar melhor este documento:
- noções básicas da linguagem JavaScript (variáveis, funções, arrays, objetos);
- noções básicas das interações HTTP em uma aplicação web (métodos GET/POST, formato JSON);
- as tags mais comuns da linguagem HTML;
- o uso da linha de comando (cd, npm install…).
Não é necessário conhecer previamente a linguagem TypeScript (usada tanto no servidor quanto no cliente): ela é um superconjunto do JavaScript que acrescenta um sistema de tipos, explicado ao longo do documento sempre que é utilizado. O leitor interessado pode consultar o documento [Introdução à linguagem TypeScript e ao framework web NestJS por meio de exemplos (2026)], que explica o TypeScript em detalhes.
1.3. A arquitetura da aplicação
A arquitetura geral da aplicação não mudou desde o documento original:
- um servidor web entrega uma única página HTML/CSS/JS, contendo uma aplicação [Angular] construída sobre o modelo de componentes (view + lógica associada), que se apoia em serviços para se comunicar com o servidor;
- o usuário interage com as views exibidas no navegador. As ações do usuário exigem às vezes uma requisição ao servidor [NestJS], que processa a requisição e devolve uma resposta JSON (JavaScript Object Notation); essa resposta é usada para atualizar a view apresentada ao usuário.
A aplicação em estudo terá a seguinte arquitetura:

- Em [1], o usuário da aplicação [Angular] consulta a camada [presentation] e [2] dessa aplicação;
- para realizar a ação solicitada pelo usuário, a camada [presentation] [2] pode consultar a camada [Services] [3];
- para fornecer o serviço solicitado, a camada [3] pode precisar consultar [4], o servidor JSON remoto implementado com [NestJS];
- Dependendo da requisição recebida em [5], as camadas [6-8] podem ser consultadas;
- a resposta do servidor percorre as camadas [2-8] em sentido inverso;
- a view exibida ao usuário, [1], reflete essa resposta;
Nota: se a arquitetura do projeto lhe parecer confusa, volte a este diagrama. Observe que o SGBD é tratado pelo servidor, não pelo cliente.
1.4. Ferramentas utilizadas
Este documento usa as seguintes ferramentas (sua instalação é detalhada no Capítulo 2):
- Node.js (versão 22 ou posterior) e seu gerenciador de pacotes npm, o equivalente, no ecossistema JavaScript, do que eram Java + Maven para o servidor Spring original;
- Visual Studio Code, um editor de código gratuito, com suas extensões TypeScript, o equivalente do Spring Tool Suite (STS) e do WebStorm usados no documento original;
- a CLI do [NestJS] ([@nestjs/cli]) e a CLI do [Angular] ([@angular/cli]), duas ferramentas de linha de comando que geram a estrutura do projeto e iniciam os servidores de desenvolvimento;
- [MySQL] 8 para o banco de dados (o documento original usava [MySQL] 5; o esquema relacional em si permanece inalterado);
- Postman (ou qualquer outro cliente HTTP), para testar as respostas das URLs do servidor às requisições POST (/addAppointment, /deleteAppointment); um navegador só consegue testar requisições GET.
1.5. Funcionalidades da aplicação
As funcionalidades “de negócio” da aplicação [RdvMedecins] permanecem inalteradas em relação ao documento original; o controle de acesso, porém, é um pouco mais robusto do que no original (veja a tabela abaixo):
- Um consultório médico emprega vários médicos, cada um com seus próprios horários de consulta;
- o usuário deve fazer login (nome de usuário/senha) para acessar a aplicação;
- uma vez conectado, o usuário pode escolher um médico e um dia e ver a agenda do médico nesse dia: cada horário aparece como disponível ou reservado;
- um usuário com o papel ADMIN pode também reservar um horário disponível para um paciente de sua escolha e cancelar uma consulta existente;
- um usuário com o papel USER pode ver as agendas, mas não pode reservar nem cancelar (acesso somente leitura), uma diferença deliberada em relação ao documento original, em que o papel USER servia apenas para ilustrar uma negação de acesso e não podia ver nada (veja o Capítulo 3, seção “Autenticação”, para as razões dessa escolha).

1.6. O que mudou e o que não mudou
Documento original (2014) | Este documento (2026) | |
[MySQL] 5, tabelas MEDECINS/CLIENTS/CRENEAUX/RV | [MySQL] 8, mesmas tabelas, mesmas colunas, mesmas restrições | |
Java, Spring 4, Spring Data (JPA/Hibernate), Spring MVC | TypeScript, [NestJS], [TypeORM], mesmas URLs (agora com nomes em inglês) | |
JavaScript, AngularJS 1.x, Bower | TypeScript, [Angular] 22 (componentes standalone, signals), npm | |
Bootstrap 3 | Bootstrap 5 | |
Spring Security, HTTP Basic, papéis em 3 tabelas; somente o ADMIN usa a aplicação | Passport/JWT ([@nestjs/passport], [@nestjs/jwt]), um token assinado apresentado a cada requisição, papéis em uma única coluna, ADMIN com acesso total e USER somente leitura | |
biblioteca angular-translate | [@ngx-translate/core] + [@ngx-translate/http-loader] |
1.7. Organização deste documento
- Configuração do ambiente de desenvolvimento: instalação das ferramentas, criação do banco de dados e primeira execução do servidor e do cliente.
- Introdução ao [NestJS]: os fundamentos do framework (módulos, controllers, providers), com um miniprojeto para começar.
- O servidor [NestJS] da aplicação [RdvMedecins]: o banco de dados, as entidades [TypeORM], a camada DAO, a camada de negócio, a camada web e a autenticação por token JWT e papéis.
- Introdução ao [Angular]: os fundamentos do framework atual (componentes, signals, serviços e comunicação HTTP).
- O cliente [Angular] da aplicação [RdvMedecins]: arquitetura do cliente, cada um de seus componentes (incluindo a tela de login), a interface Bootstrap, a alternância entre francês e inglês na interface e um passo a passo de toda a aplicação.
- Conclusão e próximos passos.