Roteiro Lexwave — do zero à continuidade

0

Módulo

O panorama: da URL até o servidor

Ganhar o mapa mental de tudo: o que acontece entre digitar o endereço e a página aparecer.

Por que importa: quando alguém abre lexwave.lugwave.com.br, uma cadeia de coisas acontece. Entender ela dá a base pra todo o resto.

Conceitos

Cliente e servidor (quem pede × quem responde). Um servidor é só um computador ligado 24h.
VPS — um servidor virtual alugado na nuvem (onde o Lexwave mora).
IP (o "telefone" da máquina) e DNS (a "agenda" que traduz o nome no IP).
Domínio e subdomínio: lugwave.com.br é o domínio; lexwave. e apilexwave. são subdomínios.
HTTP × HTTPS e o cadeado (certificado TLS/SSL, Let's Encrypt).
Proxy reverso — o "porteiro" que recebe todos e encaminha pra caixa certa. No Lexwave é o Traefik.

Pesquise e responda

1.O que é uma VPS? Como difere de "hospedagem compartilhada" e de um PC na sua casa?
2.O que o DNS faz? Pesquise o que são "registro A" e "registro CNAME".
3.O que significa o "S" em HTTPS? O que é um certificado Let's Encrypt e por que é grátis?
4.O que é um proxy reverso e por que faz sentido o Lexwave ter o Traefik na frente?

Mão na massa

Rode ping lexwave.lugwave.com.br — veja o nome virar um número (IP). É o DNS trabalhando.
Abra o site, clique no cadeado do navegador e explore o certificado.
Desenhe no papel: navegador → DNS → IP da VPS → Traefik → container.

Checkpoint

Consigo explicar em 3 frases o que acontece entre digitar o endereço e a página aparecer.

1

Módulo

Linux e a linha de comando

Conversar com o computador por texto — navegar, mexer em arquivos e entender permissões.

Por que importa: a VPS roda Linux. Subir o sistema, ver logs, editar o .env — tudo é feito por comandos, sem mouse.

Conceitos

Terminal / shell — a conversa por texto com a máquina.
Sistema de arquivos — a árvore de pastas, a raiz /, caminhos absolutos × relativos.
Navegar e mexer: pwd, ls, cd, mkdir, cp, mv, rm, cat.
Usuários e root — o administrador do Linux; e o sudo.
Permissões — as letras rwx e os números (600, 755); chmod e chown.
Variáveis de ambiente — configs que ficam "no ar" (o .env é uma lista delas).

Pesquise e responda

1.Quem é o root e por que usar sudo com cuidado?
2.O que significam rwx e os números de permissão? Por que o .env do Lexwave está em 600? (dica: ele tem senhas e chaves).
3.O que é uma variável de ambiente? Por que segredos ficam no .env e não no código?

Mão na massa

Windows: instale o WSL (Linux dentro do Windows). Mac/Linux: já tem terminal.
Crie uma pasta e um arquivo, veja com ls -la, rode chmod 600 arquivo.txt e observe o que muda.

Checkpoint

Navego e mexo em arquivos só pelo terminal, e sei explicar o que chmod 600 .env faz e por quê.

2

Módulo

Docker: containers, imagens e o compose

Entender as "caixinhas" onde o sistema roda — e ler o mapa que as descreve.

Por que importa: o Lexwave inteiro roda em containers. O arquivo docker-compose.yml é literalmente o mapa de todas as peças.

Conceitos

O problema que o Docker resolve: o clássico "na minha máquina funciona".
Imagem × container — a imagem é a receita, o container é o bolo pronto. (Guarde: essa analogia volta no Módulo 4 como "classe × objeto".)
Dockerfile (a receita escrita) e Docker Hub (a loja de imagens).
Portas (a janela pro mundo: 8000, 80) e volumes (dados que sobrevivem: lexwave-storage).
Rede — como os containers conversam (lugwave-network).
Comandos: docker ps, docker logs, docker exec, docker compose up -d.

Pesquise e responda

1.Qual a diferença entre imagem e container? (receita × bolo).
2.O que é um volume e por que, sem ele, os dados somem quando o container reinicia?
3.Abra o docker-compose.yml: quantos serviços existem e o que cada um faz? (backend, frontend, celery-worker, celery-beat).
4.O que faz docker exec -it lexwave-api alembic upgrade head?

Mão na massa

Instale o Docker Desktop e rode docker run hello-world.
Suba um servidor de teste: docker run -p 8080:80 nginx e abra localhost:8080.
Brinque com docker ps e docker logs <nome>.

Checkpoint

Abro o docker-compose.yml do Lexwave e explico, com minhas palavras, cada serviço, o volume e a rede.

3

Módulo

Bancos de dados: guardar e lembrar

Entender onde os dados ficam — e por que o sistema usa dois bancos diferentes.

Por que importa: processos, clientes e prazos ficam no PostgreSQL. O Redis cuida da velocidade e do "tempo real".

Conceitos

Pra que serve um banco: a "memória permanente" do sistema.
SQL × NoSQL — dois jeitos de guardar dados.
Relacional (Postgres): tabelas, linhas, colunas, chave primária, chave estrangeira, relacionamentos (um cliente pertence a uma empresa).
A linguagem SQL: SELECT, INSERT, UPDATE, DELETE.
Redis — banco chave-valor que vive na memória (RAM), por isso é rapidíssimo.
Os 3 papéis do Redis no Lexwave: cache (guardar respostas prontas), broker (fila de tarefas do Celery) e pub/sub (o "rádio" do tempo real).
Migrations (Alembic) — versionar a estrutura do banco, como um "git" das tabelas.

Pesquise e responda

1.Qual a diferença entre banco SQL e NoSQL? Dê um exemplo de cada.
2.O que é uma chave estrangeira? Ache o empresa_id em models/cliente.py — ele liga o cliente a quê?
3.Por que o Redis é tão rápido? (dica: memória × disco).
4.Quais são os 3 papéis que o Redis faz no Lexwave?

Mão na massa

Suba um Postgres: docker run -e POSTGRES_PASSWORD=teste -p 5432:5432 postgres. Crie uma tabela, insira uma linha, faça SELECT * FROM ....
Suba um Redis (docker run -p 6379:6379 redis) e brinque com SET nome "João" / GET nome.

Checkpoint

Sei explicar quando usar Postgres e quando usar Redis, e escrevo um SELECT simples.

4

Módulo

Lógica de programação e objetos

Ler código sem susto: entender objetos, métodos e classes num exemplo real do projeto.

Por que importa: pra dar continuidade, você precisa ler o código. "Objeto, método, classe" aparecem em toda parte — inclusive no model Cliente que você já viu.

Conceitos

Variáveis (uma caixinha com um valor) e tipos (texto, número, verdadeiro/falso).
Decisão e repetição — if (se...) e loop (repita...).
Função — uma maquininha: entra algo, processa, devolve um resultado.
Classe = o molde / a receita (ex: "o que é um Cliente").
Objeto / instância = um item feito com o molde (ex: "o cliente João"). Mesma ideia de imagem × container!
Atributo = um dado do objeto (nome, email). Método = uma ação que ele sabe fazer.
Bônus — como frontend e backend conversam: API, endpoint, HTTP (GET pega, POST envia), JSON.

Pesquise e responda

1.Qual a diferença entre classe e objeto? (analogia molde × item).
2.Abra backend/app/models/cliente.py: qual linha é a classe? Quais são os atributos? O que nome, email e documento representam?
3.O que é uma função — o que recebe e o que devolve?
4.O que é uma API? O que acontece quando o frontend faz um GET /prazos?

Mão na massa

Num "playground" de Python no navegador, escreva um "Olá, mundo".
Crie uma classe Cliente com nome e email e um método apresentar(). Crie um objeto e chame o método.

Checkpoint

Olho uma classe do Lexwave e aponto classe, atributos e métodos; e descrevo o caminho de um dado do banco até a tela.

5

Módulo · capstone

Juntando tudo: a anatomia do Lexwave

Conectar todos os pontos e conseguir navegar o projeto de verdade, sozinho.

Por que importa: agora tudo que você viu vira uma coisa só — e você consegue entender e dar continuidade.

Conceitos revisados no contexto real

O fluxo completo: navegador → DNS → VPS → Traefik → container → Postgres/Redis → resposta.
Celery — o "funcionário dos fundos": lê o e-mail do TJ, calcula prazos, avisa o cliente. (Por isso há celery-worker e celery-beat no compose.)
Segredos / .env — senhas e chaves; nunca vão pro Git (por isso o .gitignore).
Deploy — colocar no ar: docker compose up -d --build.
Quando quebra — onde olhar: docker logs <container>; e por que restart: unless-stopped + healthcheck fazem o sistema se recuperar sozinho.

Leitura guiada e responda

1.Leia o README.md e liste as tecnologias. Você reconhece todas agora? Marque as que ainda geram dúvida — é seu próximo estudo.
2.Trace a jornada: um prazo chega por e-mail do TJ → ... → aparece na tela do advogado. Quais peças participam? (Celery, parser, Postgres, Redis pub/sub, SSE, frontend).
3.O que acontece se o container do backend cair? (dica: restart e healthcheck).

Mão na massa (seguro)

Junto com o Lugão, leia os logs de produção (docker logs) e o docker-compose.yml — sem alterar nada. O objetivo é reconhecer as peças.

Checkpoint final

Consigo, sozinho, ler o docker-compose.yml e o README.md e explicar o sistema inteiro pra outra pessoa — e sei onde olhar quando algo dá errado.

VPS	Um computador alugado na nuvem, ligado 24h, onde o sistema mora.
DNS	A agenda que traduz um nome (`lexwave…`) no número (IP) da máquina.
HTTPS / TLS	O cadeado: conexão criptografada e segura com o site.
Proxy reverso	O porteiro (Traefik) que recebe todo acesso e manda pra caixa certa.
Container	Uma caixinha isolada que roda um pedaço do sistema.
Imagem	A "receita" que gera um container.
Volume	Onde os dados sobrevivem quando o container reinicia.
Docker Compose	O arquivo que sobe e orquestra vários containers juntos.
PostgreSQL	O banco principal (tabelas): clientes, processos, prazos.
Redis	Banco na memória; faz cache, fila de tarefas e "tempo real".
SQL	A linguagem pra consultar bancos relacionais (`SELECT`…).
Classe / Objeto	Molde × item feito com o molde (receita × bolo).
Método	Uma ação que um objeto sabe fazer.
API / Endpoint	A portinha pela qual o frontend pede dados ao backend.
Celery	O funcionário dos fundos que faz tarefas em segundo plano.
.env / segredos	Senhas e chaves; ficam fora do código e fora do Git.
Migration	O "controle de versão" da estrutura do banco (Alembic).

Do zero até dar continuidade no Lexwave

Como usar

O que preparar

⚠️ Segurança

🗺️ O caminho de um acesso

O panorama: da URL até o servidor

Linux e a linha de comando

Docker: containers, imagens e o compose

Bancos de dados: guardar e lembrar

Lógica de programação e objetos

Juntando tudo: a anatomia do Lexwave

😌 O que você NÃO precisa aprender agora

📖 Glossário-relâmpago