Skip to content

1. Introdução

O PDF do documento está |AQUI|.

O código deste documento está |AQUI|.

Este documento é um produto da IA Claude, da Anthropic. Seu objetivo é adaptar o documento “Um exemplo cliente/servidor - AngularJS 1.x / Spring 4” em duas frentes:

  • o cliente AngularJS 1.x é substituído por um aplicativo Android nativo escrito em [Kotlin] com o uso de [Jetpack Compose];
  • o framework web Java Spring MVC é substituído pelo framework web [NestJS];

Para isso, ele acompanha, capítulo por capítulo, o documento “Um exemplo cliente/servidor - Flutter / NestJS (2026)”: mesmo servidor, mesmo banco de dados, mesma arquitetura de cliente; apenas o framework do cliente muda, com o Flutter (Dart) sendo substituído pelo Jetpack Compose (Kotlin).

A IA Claude, da Anthropic, fez a maior parte do trabalho:

  • geração do código: Claude gerou todo o código do cliente em Kotlin. Ele mesmo o compilou e o testou em um emulador Android no computador do revisor, com a permissão deste; as capturas de tela do emulador foram feitas durante esses testes;
  • geração do curso em formato ODT: Claude gerou o documento, que o revisor leu com atenção e testou acompanhando-o passo a passo.

Nota 1: Se o principal objetivo do leitor é “aprender NestJS”, há uma introdução a esse framework web no documento Introdução à linguagem TypeScript e ao framework web NestJS por meio de exemplos. Neste documento, o servidor NestJS é tratado como uma caixa-preta. Explica-se como usá-lo, mas seu código não é descrito.

Nota 2: A linguagem de programação usada neste documento é [Kotlin]. Supõe-se que seus fundamentos (classes, data classes, nulabilidade, lambdas, funções de extensão, coleções etc.) já sejam conhecidos: eles são abordados no curso de Kotlin. Os conceitos específicos do Android ou do Jetpack Compose, assim como as corrotinas, são explicados ao longo do documento.

Nota 3: Claude faz referência com frequência ao cliente [Flutter] do curso “Um exemplo cliente/servidor - Flutter / NestJS” (2026), do qual este documento é uma adaptação, e, às vezes, aos clientes web Angular, React e Vue.js da mesma aplicação. Essas comparações ajudam os leitores familiarizados com um desses frameworks, mas conhecer qualquer um deles não é necessário para acompanhar este documento.

Nota 4: Se você achar que as explicações de Claude não são suficientes, envie uma solicitação a Claude pedindo esclarecimentos sobre um ponto específico do curso. Isso costuma ser útil.

Serge Tahé, outubro de 2026

==

Este documento é uma 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 de forma significativa, ou até foram substituídos no uso corrente:

  • no lado do servidor, o [NestJS] se consolidou como um dos frameworks Node.js/TypeScript mais usados para construir aplicações web estruturadas, com uma filosofia semelhante à do Spring (módulos, controllers, serviços, injeção de dependência);
  • No lado do cliente, os aplicativos são cada vez mais acessados pelo celular. Este documento descreve, portanto, um aplicativo Android NATIVO: escrito em [Kotlin], a linguagem recomendada pelo Google para Android desde 2019, e com uma interface descrita por meio do [Jetpack Compose], a biblioteca declarativa de interface do Android (estável desde 2021), que substitui o antigo sistema de views descrito em XML.

O objetivo deste documento é revisitar o estudo de caso original (o mesmo aplicativo, as mesmas funcionalidades, o mesmo banco de dados) e reconstruí-lo com as ferramentas atuais, mantendo o máximo possível da mesma progressão didática do documento de 2014 e de sua variante Flutter de 2026.

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 (autenticação baseada em papéis com Spring Security), doze exemplos progressivos para aprender AngularJS 1.x passo a passo. Assim como a variante Flutter, este documento aborda:

  • a arquitetura geral da aplicação (inalterada em princípio);
  • o banco de dados (inalterado, exceto pela adição da tabela [users]);
  • a instalação do servidor [NestJS] completo, cujas funcionalidades de visualização de consultas e de agendamento/cancelamento são testadas com o Postman; seu código não é abordado aqui;
  • a autenticação baseada em token (JWT) e o controle de acesso baseado em papéis (ADMIN/USER) desse servidor; aprenderemos apenas a usá-los, primeiro por meio do Postman e depois pelo cliente;
  • o cliente Android correspondente, com as mesmas funcionalidades, uma tela de login, uma interface adaptada ao papel do usuário conectado (Material Design 3) e a possibilidade de alternar a interface entre francês e inglês ([TranslationsService]).

Duas funcionalidades do documento original foram omitidas deste documento, como na versão Flutter: o modo “debug” do cliente original, deixado de fora deliberadamente (veja o Capítulo 6), e a configuração de um atraso de rede artificial, adiada para uma etapa posterior.

1.2. A quem se destina este documento

Este documento não pressupõe nenhum conhecimento prévio de Android, Jetpack Compose ou [NestJS]. Cada novo conceito (activity, função @Composable, estado, ViewModel, corrotina, interceptor HTTP etc.) é explicado à medida que aparece. Ainda assim, alguns conhecimentos básicos são úteis:

  • um conhecimento básico da linguagem Kotlin (veja o curso de Kotlin);
  • um conhecimento básico das trocas HTTP (métodos GET/POST, formato JSON);
  • experiência com o uso da linha de comando (cd, npm install...).

Conhecer Flutter não é necessário: as numerosas comparações com o cliente Flutter se destinam aos leitores que fizeram esse curso, mas cada conceito é primeiro explicado por si só.

1.3. A arquitetura da aplicação

A arquitetura geral da aplicação não mudou desde o documento original:

  • o cliente apresenta ao usuário uma única interface, construída sobre o modelo de componentes (view + lógica associada), que se apoia em serviços para se comunicar com o servidor; neste caso, um aplicativo Android executado no sistema do celular;
  • o usuário interage com as telas do aplicativo. As ações do usuário às vezes exigem o envio de uma requisição ao servidor [NestJS], que processa a requisição e devolve uma resposta JSON; essa resposta é usada para atualizar a tela exibida ao usuário.

A aplicação em estudo terá a seguinte arquitetura:

Image

  • Em [1], o usuário do aplicativo Android consulta a camada [Presentation] [2] da aplicação;
  • para executar 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 pelo [NestJS];
  • Dependendo da requisição recebida em [5], as camadas [6-8] podem ser consultadas;
  • a resposta do servidor percorre as camadas [2-8] na ordem inversa;
  • a tela exibida ao usuário ([1]) reflete essa resposta.

Nota: Se você se confundir com a arquitetura do projeto, volte a este diagrama. Observe que o SGBD é gerenciado pelo servidor, não pelo cliente.

1.4. Ferramentas utilizadas

Este documento usa as seguintes ferramentas (sua instalação é detalhada nos Capítulos 1 e 2):

  • Node.js (versão 22 ou posterior) e npm, para executar o servidor [NestJS];
  • [Android Studio], o ambiente de desenvolvimento do Google para Android. Ele fornece tudo de que o cliente precisa: o editor de código (baseado no IntelliJ IDEA), o Android SDK, um JDK (o JetBrains Runtime), o emulador Android e a ferramenta de build [Gradle]. Diferentemente do curso de Flutter, em que o Android Studio era usado apenas para instalar o Android SDK, aqui ele serve como editor do cliente;
  • Visual Studio Code (ou qualquer outro editor) para o servidor NestJS, se você quiser ver seu código;
  • [MySQL] 8 para o banco de dados, instalado com o Laragon;
  • Postman (ou qualquer outro cliente HTTP) para testar as URLs do servidor;
  • um celular Android (opcional): um emulador é suficiente para acompanhar todo este documento.

1.5. Funcionalidades da aplicação

As funcionalidades “de negócio” do aplicativo [RdvMedecins] são as mesmas das versões anteriores:

  • Um consultório médico emprega vários médicos, cada um com seus próprios horários de consulta;
  • o usuário precisa fazer login (nome de usuário/senha) para acessar o aplicativo;
  • Depois de conectado, o usuário pode selecionar 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 também pode reservar um horário disponível para um paciente à 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 consultas (acesso somente leitura).

Image

Image

Acima, o aplicativo no emulador Android: a tela de login, em seguida a agenda de um médico e, depois, a tela após a reserva de um horário.

1.6. O que mudou e o que não mudou

 
Documento original (2014)
Variante Flutter (2026)
Este documento (2026)
Database
MySQL 5
MySQL 8, mesmas tabelas
idêntico à variante Flutter
Server
Java, Spring 4
TypeScript, NestJS
mesmo servidor NestJS
Client
JavaScript, AngularJS 1.x
Dart, Flutter (mobile, desktop, web)
Kotlin, Jetpack Compose (Android)
Client execution
navegador
código nativo compilado pelo Flutter
máquina virtual Android (ART)
Build
Bower
Flutter / Pub
Gradle
Authentication
Spring Security, HTTP Basic
Passport/JWT
Passport/JWT (mesmo servidor)
FR/EN internationalization
angular-translate
TranslationsService (feito à mão)
TranslationsService (feito à mão, mesmos dicionários)

1.7. Organização deste documento

  • Capítulo 1 - Configuração do ambiente de trabalho: instalar o Android Studio e o Android SDK, abrir o projeto do cliente, criar um emulador e configurar um celular.
  • Capítulo 2 - Instalação do servidor [NestJS]: instalar o Laragon e o banco de dados MySQL, configurar, iniciar e testar o servidor e, em seguida, executar o cliente pela primeira vez.
  • Capítulo 3 - Introdução ao Android e ao Jetpack Compose: activities, funções @Composable, estado e recomposição, CompositionLocal, corrotinas, ciclo de vida e ViewModel, com o equivalente em Flutter indicado para cada um.
  • Capítulo 4 - O cliente Kotlin do aplicativo [RdvMedecins]: a arquitetura do cliente, cada um de seus arquivos e um passo a passo do aplicativo completo.
  • Capítulo 5 - Execução do aplicativo: emulador, celular, APK e o que você precisa saber sobre rede, tráfego HTTP não criptografado, rotação de tela e telas estreitas; por fim, o que seria necessário para também ter como alvo o iOS, o desktop e a web.
  • Capítulo 6 - Conclusão e próximos passos.