Programação para Sistemas Web

Controle
Acadêmico

Um sistema web completo, explicado passo a passo: do conceito à depuração.

BunTypeScriptReactshadcn/uiSQLite
Afya Centro Universitário São Lucas, RO

O que vamos ver

12 seções, do conceito ao sistema funcionando (e depurado)

01

O projeto

02

Conceitos fundamentais

03

A stack

04

Arquitetura e monorepo

05

Banco de dados

06

A API por dentro

07

O site por dentro

08

A viagem de um clique

09

Criando do zero

10

Executando

11

Depurando

12

Próximos passos

Controle Acadêmico · 2
SEÇÃO 01

O projeto

Cadastros · Notas · Relatórios

Afya Centro Universitário São Lucas, RO

O que o sistema faz

Um mini sistema de controle acadêmico feito para aprender programação web

6 telas + documentação interativa da API

Dashboard

Totais, média geral, taxa de aprovação e gráficos simples

Alunos

Nome, CPF, matrícula, e-mail, telefone e foto; busca, edição e exclusão

Professores

Nome, CPF, titulação, graduação, e-mail, telefone e foto

Disciplinas

Nome, curso e carga horária

Matrículas

Liga aluno + professor + disciplina em um semestre, com notas N1, N2 e PF

Relatórios

Boletim do aluno, desempenho por disciplina e turmas por professor

Controle Acadêmico · 4

Simples de propósito

Nada que atrapalhe o entendimento de como as peças se conectam

Sem login e senha

Nenhuma camada de segurança para esconder o essencial

Tudo em português

Variáveis, funções, pastas e comentários: foco na lógica

Um README por pasta

Cada pasta explica o que existe nela e por quê

Peças conectadas

Site, API, banco e tipos: cada um com uma responsabilidade

Nunca publique um sistema assim na internet: ele não tem login, senha nem permissões.
As fotos ficam dentro do banco como texto (base64). É simples, mas sistemas reais costumam guardar imagens em outro lugar.
Controle Acadêmico · 5

Regra de aprovação

O status é calculado pela API: o usuário digita só as notas

Lançar notas

N1 e N2 (de 0 a 10)

Média

(N1 + N2) / 2

≥ 7

aprovado direto

< 7

faz a Prova Final (PF)

(média + PF) / 2

≥ 5 aprovado
< 5 reprovado

Enquanto falta alguma nota necessária, o status é cursando.
A regra mora em um lugar só: apps/api/src/regras/notas.ts
Controle Acadêmico · 6
SEÇÃO 02

Conceitos fundamentais

Glossário · Web · Dados

Afya Centro Universitário São Lucas, RO

Cliente e servidor

Quase todo sistema web é dividido em duas partes: a analogia do restaurante

Usuário

O cliente no salão faz o pedido: “quero ver os alunos”

Site (web)

O garçom: anota e leva o pedido. Não cozinha!

API (Bun)

A cozinha: prepara a resposta

Banco SQLite

A despensa: onde tudo fica guardado

Front-end roda no navegador e apresenta a interface. Aqui: apps/web
Back-end roda no servidor e cuida das regras e dos dados. Aqui: apps/api
Controle Acadêmico · 8

HTTP: o idioma da web

Cada pedido do navegador para a API tem um método e um caminho

GET

Buscar dados

GET /api/alunos

POST

Criar um registro

POST /api/alunos

PUT

Atualizar um registro

PUT /api/alunos/7

DELETE

Excluir um registro

DELETE /api/alunos/7
HTTP é o “idioma” que o navegador e a API usam para conversar. O pedido vai com método, caminho e (às vezes) um corpo em JSON; a resposta volta com um status e um corpo.
Controle Acadêmico · 9

Status HTTP

O número que a API devolve dizendo como foi o pedido

2xx · deu certo

200 Deu certo

201 Criado com sucesso

204 Concluído, corpo vazio

4xx · problema no pedido

400 Pedido com problema (ex.: campo faltando)

404 Não encontrado

409 Conflito com o estado atual

5xx · erro no servidor

500 Algo quebrou dentro da API

No Acadêmico, a função error() do index.ts captura o erro e responde com uma mensagem amigável.

Controle Acadêmico · 10

JSON: o formato da conversa

Texto para trocar dados, parecido com um objeto JavaScript

GET /api/alunos/1 → resposta
{
  "id": 1,
  "nome": "Ana Souza",
  "cpf": "111.222.333-44",
  "matricula": "2026001",
  "email": "[email protected]",
  "telefone": "(69) 99999-0000",
  "foto": null
}

Ida: objeto → texto

JSON.stringify(dados) transforma o objeto em texto para enviar pela rede

Volta: texto → objeto

await resposta.json() no site e await req.json() na API

Controle Acadêmico · 11

API, endpoint e REST

O endereço diz o quê; o método diz a ação

API

Application Programming Interface: o conjunto de operações que um cliente pode chamar pela rede. Métodos e caminhos formam o contrato.

Endpoint / rota

Uma operação identificada por método + caminho, como GET /api/alunos.

GET /api/alunos/7

método
a ação: buscar

recurso
a coleção de alunos

:id
qual aluno (parte variável)

Esse padrão de endereços se chama REST. O mesmo vale para professores, disciplinas e matrículas.
Controle Acadêmico · 12

CRUD

As quatro operações básicas de qualquer cadastro, em cada camada do sistema

OperaçãoSignificadoHTTP (API)SQL (banco)No site
CreateCriarPOSTINSERT INTOBotão “Novo aluno”
ReadLerGETSELECTTabela da listagem
UpdateAtualizarPUTUPDATEÍcone de lápis
DeleteExcluirDELETEDELETE FROMLixeira com confirmação
Percebeu? Uma única ação do usuário atravessa as três colunas: tela → HTTP → SQL.
Controle Acadêmico · 13

Porta, proxy e CORS

Como o site (5173) conversa com a API (3333) sem configuração extra

Navegador

pede /api/alunos a localhost:5173

Vite (proxy)

repassa tudo que começa com /api

API Bun

responde em localhost:3333

Porta

Número que diz qual serviço recebe a conexão: 5173 (site) e 3333 (API).

Proxy

Intermediário que encaminha pedidos. O Vite faz isso durante o desenvolvimento.

CORS

Regra do navegador entre origens diferentes (protocolo + host + porta). Com o proxy, tudo parece ter a mesma origem.

Controle Acadêmico · 14

Banco de dados, SQL e chaves

Informações guardadas de forma organizada, mesmo depois que o programa desliga

Tabela, linha e coluna

Cada tabela guarda um assunto (alunos). Cada linha é um registro; cada coluna, um campo.

SQL

A linguagem do banco: SELECT, INSERT, UPDATE, DELETE, CREATE TABLE...

PK e FK

PK identifica cada linha (o id). FK aponta para a PK de outra tabela (ex.: aluno_id).

id (PK)aluno_id (FK)disciplina_id (FK)semestre
13 → Ana2 → Web2026.1
23 → Ana5 → BD2026.1
38 → Caio2 → Web2026.1
Controle Acadêmico · 15

Componente, props e JSX

A tela é montada com peças reutilizáveis, como LEGO

components/FotoPerfil.tsx (resumido)
type Props = {
  nome: string;
  foto: string | null;
};

export function FotoPerfil({ nome, foto }: Props) {
  return (
    <Avatar>
      {foto && <AvatarImage src={foto} />}
      <AvatarFallback>{iniciais(nome)}</AvatarFallback>
    </Avatar>
  );
}

Componente

Uma função que descreve o que aparecer na tela.

Props

O que o componente recebe: <FotoPerfil nome="Ana" foto={null} />

JSX / TSX

Marcação parecida com HTML dentro do código. .tsx = TypeScript + JSX.

Controle Acadêmico · 16

Estado e hooks

Hooks são funções especiais do React que começam com use

paginas/alunos/PaginaAlunos.tsx
// Lista de alunos que veio da API
const [alunos, setAlunos] = useState<Aluno[]>([]);

async function carregarAlunos() {
  const lista = await listarAlunos();
  setAlunos(lista); // muda o estado → redesenha
}

// [] = "rode só uma vez, quando a página abrir"
useEffect(() => {
  carregarAlunos();
}, []);

useState

Guarda uma informação entre renderizações e devolve a função para alterá-la. Mudou o estado, a tela é redesenhada.

useEffect

Executa algo quando a tela aparece. Aqui: buscar os dados na API.

Controle Acadêmico · 17

Tipos no TypeScript

Um “corretor ortográfico” que avisa erros antes de rodar o código

packages/tipos/index.ts
export type Aluno = {
  id: number;
  nome: string;
  cpf: string;
  matricula: string;
  email: string;
  telefone: string;
  foto: string | null; // base64 ou null
};

// Só estes três textos são aceitos
export type StatusMatricula =
  "aprovado" | "reprovado" | "cursando";

Tipo = formato do dado

Quais campos existem e de que tipo é cada um: texto, número, nulo...

Erro antes de rodar

Escreveu aluno.nme? O editor sublinha em vermelho na hora.

O mesmo tipo é usado pela API e pelo site.
Controle Acadêmico · 18

Monorepo, workspace e pacotes

Como o projeto organiza o próprio código e o código de terceiros

Monorepo

Vários projetos ou pacotes no mesmo repositório: aqui, a API, o site e os tipos.

Workspace

Pacote registrado na configuração do monorepo. @academico/tipos é uma pasta local, não um pacote da internet.

Dependência / pacote

Código feito por outras pessoas que o projeto usa. Fica listado no package.json.

bun install

Baixa as dependências para a pasta node_modules e liga os workspaces.

Controle Acadêmico · 19

OpenAPI, Scalar e CDN

A API se autodocumenta, e a documentação permite testar cada endereço

openapi.ts

Descreve a API no padrão OpenAPI: endereços, o que recebem e devolvem

/api/openapi.json

A mesma descrição, entregue em JSON

/api/docs

O Scalar lê o JSON e desenha uma página interativa

CDN: servidores que entregam arquivos prontos. A interface do Scalar vem de um CDN, por isso /api/docs precisa de internet.
A descrição não controla a API, só a descreve. Criou uma rota? Documente também.
Controle Acadêmico · 20

Mais termos do dia a dia

Palavras que aparecem no código, nos comandos e nos READMEs

Build

Prepara os arquivos para publicação. bun run build confere tipos e gera o site.

Seed (popular)

Coloca dados de exemplo: bun run banco:popular.

Migração

Mudança versionada na estrutura do banco, como acrescentar uma coluna.

Base64

Representa dados binários como texto. Usado para as fotos no SQLite.

Validação

Verificação feita ao rodar: a API recusa campo obrigatório em branco.

Regra de negócio

Condição do mundo real que o software aplica: média 7 aprova.

Controle Acadêmico · 21
SEÇÃO 03

A stack

Ferramentas · Analogias · Decisões

Afya Centro Universitário São Lucas, RO

Ferramentas do back-end

O que roda no servidor e guarda os dados

Bun

Roda JavaScript/TypeScript fora do navegador, instala pacotes, executa scripts e já traz o SQLite (bun:sqlite).

o motor do projeto

TypeScript

JavaScript com tipos: avisa erros antes de rodar o código.

corretor ortográfico

SQLite

Banco de dados que fica todo em um único arquivo: academico.sqlite.

um caderno de dados

Scalar

Gera a documentação interativa da API a partir da descrição OpenAPI.

manual de instruções

Controle Acadêmico · 23

Ferramentas do front-end

O que roda no navegador e desenha as telas

React

Biblioteca para construir telas a partir de peças (componentes).

peças de LEGO

Vite

Roda o site durante o desenvolvimento (com proxy) e gera a versão final.

o forno

Tailwind CSS

Estiliza com classes prontas: p-4, flex, text-sm...

lápis de cor organizados

shadcn/ui

Componentes prontos e bonitos (botões, tabelas, janelas) copiados para dentro do projeto.

móveis prontos

Controle Acadêmico · 24

Decisões de projeto (e por quê)

Cada escolha favorece o entendimento

DecisãoPor quê
API sem framework (só Bun.serve)Menos “mágica”: dá para ver exatamente como uma rota funciona
SQL puro (sem ORM)Você aprende SQL de verdade, que serve para qualquer linguagem
SQLiteNão precisa instalar servidor de banco: é só um arquivo
Proxy do ViteO site chama /api/... como se a API estivesse no mesmo endereço (sem CORS)
Status calculado na APIA regra fica num lugar só e ninguém “força” um status errado
Tipos compartilhadosAPI e site sempre concordam sobre o formato dos dados
Um formulário para criar e editarRecebeu um registro? Edita. Não recebeu? Cria. Menos código repetido
Controle Acadêmico · 25
SEÇÃO 04

Arquitetura e monorepo

Pastas · Camadas · Workspaces

Afya Centro Universitário São Lucas, RO

O que é um monorepo

“Mono” = um só: vários projetos morando no mesmo repositório

Um repositório, três partes

apps/api · apps/web · packages/tipos

Um único bun install

Instala as dependências de todos os projetos de uma vez.

Um único bun run dev

Liga a API e o site ao mesmo tempo.

Tipos compartilhados

Mudou um campo? API e site “ficam sabendo” na hora, e o TypeScript aponta o que ajustar.

Controle Acadêmico · 27

A estrutura de pastas

pweb/academico: cada pasta tem o seu próprio README.md

academico/
apps/os PROGRAMAS que rodam
api/o servidor: recebe pedidos e fala com o banco (Bun + SQLite)
web/o site: as telas que o usuário vê (React + shadcn)
packages/código COMPARTILHADO
tipos/o formato de cada dado (Aluno, Professor...)
docs/referência das rotas, do banco e exercícios
package.jsonconfigura o monorepo e os comandos
README.mdvisão geral e como rodar
arquitetura.mdcomo tudo se conecta
tutorial.mdcomo construir do zero
Ordem de leitura: README → arquitetura → tutorial → docs → glossário
O banco academico.sqlite é criado em apps/api e fica fora do Git (.gitignore).
Controle Acadêmico · 28

As três partes e como se ligam

Dois programas que conversam por HTTP e um pacote que os dois importam

apps/web

React + shadcn

porta 5173
HTTP + JSON
pedidos e respostas

apps/api

Bun.serve + SQLite

porta 3333

packages/tipos

Aluno, Professor, Disciplina, Matricula...

biblioteca: não roda sozinha
web importa os tipos
api importa os tipos
Controle Acadêmico · 29

O package.json da raiz

Liga o monorepo e cria os atalhos de comando

academico/package.json
{
  "name": "controle-academico",
  "private": true,
  "workspaces": ["apps/*", "packages/*"],
  "scripts": {
    "dev": "bun run --filter \"@academico/*\" dev",
    "dev:api": "bun run --filter @academico/api dev",
    "dev:web": "bun run --filter @academico/web dev",
    "banco:popular": "bun run --filter @academico/api banco:popular",
    "build": "bun run --filter @academico/web build"
  }
}

"workspaces"

Cada pasta dentro de apps/ e packages/ é um projeto do monorepo.

"scripts"

Atalhos: bun run dev executa o script dev de todos os projetos @academico/*.

--filter

Escolhe em qual projeto rodar. Nos projetos, "workspace:*" pega o pacote daqui.

Controle Acadêmico · 30

packages/tipos: o cardápio

Um arquivo, index.ts, descreve o formato de cada informação do sistema

Aluno

id, nome, cpf, matricula, email, telefone, foto

Professor

id, nome, cpf, titulacao, graduacao, email, telefone, foto

Disciplina

id, nome, curso, carga_horaria

Matricula

aluno_id, professor_id, disciplina_id, semestre, n1, n2, pf, status

MatriculaDetalhada

Matricula & nomes do aluno, professor e disciplina (vindos do JOIN)

NovoAluno, NovaMatricula...

Os mesmos tipos sem o id, usados nos formulários

Também ficam aqui os tipos do Dashboard e das linhas dos relatórios.
Controle Acadêmico · 31

apps/api: organizada em camadas

Cada camada só conversa com a de baixo

index.ts

Porta de entrada: liga o servidor e lista as rotas

rotas/

Recebem o pedido, validam e devolvem a resposta

regras/

Regras de negócio: o cálculo das notas

banco/

Conexão, criação das tabelas e dados de exemplo

documentacao/

Descrição OpenAPI exibida pelo Scalar

Por que separar?

Cada arquivo fica pequeno e com uma única responsabilidade.

Manutenção fácil

Mudou a regra de aprovação? Só regras/. Mudou uma tabela? banco/ e as rotas dela.

Controle Acadêmico · 32

apps/web: organização do site

Do ponto de entrada até as peças reaproveitáveis

main.tsx

Liga o React dentro do index.html

App.tsx

Diz qual página aparece em cada endereço

paginas/

As TELAS: uma pasta por assunto

components/

Peças nossas: menu, foto, botão excluir...
ui/ = peças do shadcn

servicos/api.ts

O único lugar que conversa com a API

lib/

Funções de ajuda: formatar nota, iniciais do nome...

Controle Acadêmico · 33

Como uma tela é montada

Componentes dentro de componentes: a árvore da página de alunos

main.tsx
App.tsxrotas
Layoutmenu lateral + conteúdo
PaginaAlunosa página
CabecalhoPaginacomponente nosso
Table, Button, Cardshadcn (ui/)
FotoPerfilcomponente nosso
FormularioAlunojanela de cadastro/edição
PaginaAlunos é a página modelo: professores e disciplinas funcionam do mesmo jeito.
Página nova = componente em paginas/ + uma <Route> no App.tsx + um item no menu do Layout.
Controle Acadêmico · 34
SEÇÃO 05

Modelo de banco de dados

Tabelas · Chaves · Restrições

Afya Centro Universitário São Lucas, RO

O diagrama do banco

Quatro tabelas: matriculas liga as outras três

alunos
PKidINTEGER
nomeTEXT
cpfTEXT único
matriculaTEXT único
emailTEXT
telefoneTEXT
fotoTEXT (base64)
matriculas
PKidINTEGER
FKaluno_idINTEGER
FKprofessor_idINTEGER
FKdisciplina_idINTEGER
semestreTEXT
n1, n2, pfREAL 0 a 10
statusTEXT
professores
PKidINTEGER
nomeTEXT
cpfTEXT único
titulacaoTEXT
graduacaoTEXT
email · telefoneTEXT
fotoTEXT (base64)
disciplinas
PKidINTEGER
nomeTEXT
cursoTEXT
carga_horariaINTEGER > 0
Um aluno pode ter várias matrículas; cada matrícula aponta para um aluno, um professor e uma disciplina.
Controle Acadêmico · 36

Criando a tabela de alunos

O SQL que define colunas, tipos e restrições

apps/api/src/banco/criar-tabelas.ts
CREATE TABLE IF NOT EXISTS alunos (
  id        INTEGER PRIMARY KEY AUTOINCREMENT,
  nome      TEXT NOT NULL,
  cpf       TEXT NOT NULL UNIQUE,
  matricula TEXT NOT NULL UNIQUE,
  email     TEXT NOT NULL,
  telefone  TEXT NOT NULL DEFAULT '',
  foto      TEXT
)

PRIMARY KEY AUTOINCREMENT

O banco gera o id sozinho: 1, 2, 3...

NOT NULL

Campo obrigatório: o banco recusa vazio (nulo).

UNIQUE

Não aceita repetido: dois alunos com o mesmo CPF ou matrícula.

foto TEXT

Sem NOT NULL: aceita nulo quando não há foto.

Controle Acadêmico · 37

Disciplinas e matrículas

Restrições que protegem os dados mesmo se a API errar

criar-tabelas.ts
CREATE TABLE IF NOT EXISTS matriculas (
  id            INTEGER PRIMARY KEY AUTOINCREMENT,
  aluno_id      INTEGER NOT NULL REFERENCES alunos(id),
  professor_id  INTEGER NOT NULL REFERENCES professores(id),
  disciplina_id INTEGER NOT NULL REFERENCES disciplinas(id),
  semestre      TEXT NOT NULL,
  n1  REAL CHECK (n1 BETWEEN 0 AND 10),
  n2  REAL CHECK (n2 BETWEEN 0 AND 10),
  pf  REAL CHECK (pf BETWEEN 0 AND 10),
  status TEXT NOT NULL DEFAULT 'cursando',
  UNIQUE (aluno_id, disciplina_id, semestre)
)

REFERENCES

Chave estrangeira: o aluno_id precisa existir em alunos.

CHECK

Notas entre 0 e 10. Em disciplinas: carga_horaria > 0.

UNIQUE (aluno, disciplina, semestre)

Impede matricular o mesmo aluno duas vezes na mesma disciplina e semestre.

Controle Acadêmico · 38

Conexão com o SQLite

Sem instalar servidor: o próprio Bun lê e escreve no arquivo

apps/api/src/banco/conexao.ts
import { Database } from "bun:sqlite";
import { criarTabelas } from "./criar-tabelas";

// Sobe duas pastas: salva em apps/api
const caminhoDoArquivo = import.meta.dir + "/../../academico.sqlite";

// Abre o arquivo (e cria, se ainda não existir)
export const banco = new Database(caminhoDoArquivo, { create: true });

// No SQLite a checagem de FKs vem DESLIGADA!
banco.run("PRAGMA foreign_keys = ON");

// Garante que as tabelas existem
criarTabelas(banco);
Sem PRAGMA foreign_keys = ON, o SQLite aceitaria matrícula de aluno inexistente.
CREATE TABLE IF NOT EXISTS é ignorado se a tabela já existe: por isso roda toda vez que a API liga.
Por isso também: mudou uma tabela? Apague o .sqlite para recriar.
Controle Acadêmico · 39

Consultas com JOIN e GROUP BY

Juntar tabelas e agrupar linhas direto no SQL

JOIN: matrícula com os nomes

rotas/matriculas.ts
SELECT m.*,
  a.nome AS aluno_nome,
  p.nome AS professor_nome,
  d.nome AS disciplina_nome
FROM matriculas m
JOIN alunos      a ON a.id = m.aluno_id
JOIN professores p ON p.id = m.professor_id
JOIN disciplinas d ON d.id = m.disciplina_id

GROUP BY: situação no dashboard

rotas/relatorios.ts
SELECT status AS rotulo,
       COUNT(*) AS valor
FROM matriculas
GROUP BY status
rotulovalor
aprovado12
cursando7
reprovado3
Controle Acadêmico · 40
SEÇÃO 06

A API por dentro

Rotas · Regras · Documentação

Afya Centro Universitário São Lucas, RO

index.ts: o mapa de rotas

O “cardápio” da API: lista tudo o que ela sabe fazer

apps/api/src/index.ts (resumido)
Bun.serve({
  port: 3333,
  routes: {
    "/api/alunos":     { GET: alunos.listar, POST: alunos.criar },
    "/api/alunos/:id": { GET: alunos.buscar,
                         PUT: alunos.atualizar,
                         DELETE: alunos.excluir },
    // ... professores, disciplinas, matriculas
    "/api/dashboard":  { GET: relatorios.dashboard },
    "/api/docs":       { GET: documentacao.paginaDocumentacao },
  },
  // Endereço que não existe no mapa
  fetch() { return erro("Rota não encontrada.", 404); },
  // Alguma rota "quebrou": a API não cai
  error(problema) {
    console.error(problema);
    return erro(traduzirErroDoBanco(problema.message));
  },
});

routes

Liga cada endereço + método a uma função. :id é a parte variável.

fetch

Resposta padrão: 404 para rotas desconhecidas.

error

Captura qualquer erro, mostra no terminal e responde com mensagem amigável.

Controle Acadêmico · 42

Os endpoints da API

Padrão REST repetido para os quatro cadastros

MétodoEndereçoAção
GET/api/alunosLista todos
GET/api/alunos/:idBusca um
POST/api/alunosCria
PUT/api/alunos/:idAtualiza
DELETE/api/alunos/:idExclui

Mesmo padrão

professores, disciplinas e matriculas

Relatórios (só leitura)

GET /api/dashboard
GET /api/relatorios/disciplinas
GET /api/relatorios/professores

Filtros

/api/matriculas?aluno_id=3 ou ?semestre=2026.1

Controle Acadêmico · 43

Anatomia de uma rota

alunos.criar: o modelo que todas as rotas de cadastro seguem

apps/api/src/rotas/alunos.ts
export async function criar(req: BunRequest) {
  // 1. Ler o corpo do pedido (dados do formulário)
  const dados = (await req.json()) as NovoAluno;
  // 2. Validar os campos obrigatórios
  const problema = verificarObrigatorios(dados, CAMPOS_OBRIGATORIOS);
  if (problema) return erro(problema);
  // 3. Gravar: os "?" são preenchidos em ordem
  const resultado = banco
    .query(`INSERT INTO alunos
            (nome, cpf, matricula, email, telefone, foto)
            VALUES (?, ?, ?, ?, ?, ?)`)
    .run(dados.nome, dados.cpf, dados.matricula,
         dados.email, dados.telefone ?? "", dados.foto ?? null);
  // 4. Responder com o aluno criado (201)
  const alunoCriado = banco
    .query("SELECT * FROM alunos WHERE id = ?")
    .get(resultado.lastInsertRowid);
  return Response.json(alunoCriado, { status: 201 });
}

bun:sqlite

.all() todas as linhas · .get() uma linha · .run() INSERT, UPDATE, DELETE

Nunca junte valores no texto do SQL: use ?. Concatenar abre brecha para SQL Injection.

lastInsertRowid

O id que o banco acabou de gerar.

Controle Acadêmico · 44

Ajudantes e erros amigáveis

Pequenas funções reaproveitadas por todas as rotas (rotas/ajudantes.ts)

erro(mensagem, status = 400)

Devolve { "erro": "mensagem" } com o status certo.

verificarObrigatorios(dados, campos)

Devolve a mensagem do primeiro campo vazio, ou null se estiver tudo certo.

paraNota(valor)

Campo vazio vira null (nota ainda não lançada); o resto vira número.

traduzirErroDoBanco(msg)

Troca as mensagens técnicas do SQLite, em inglês, por frases que o usuário entende.

O SQLite diz…A API responde…
UNIQUE constraint failedJá existe um cadastro com esses dados (CPF, matrícula...)
FOREIGN KEY constraint failedEste registro está ligado a uma ou mais matrículas
CHECK constraint failedNotas entre 0 e 10 e carga horária maior que zero
Controle Acadêmico · 45

A regra de negócio no código

calcularStatus(n1, n2, pf) em regras/notas.ts

apps/api/src/regras/notas.ts (sem os tipos)
export const MEDIA_PARA_APROVAR = 7;
export const MEDIA_FINAL_PARA_APROVAR = 5;

export function calcularStatus(n1, n2, pf) {
  if (n1 === null || n2 === null) return "cursando";

  const media = (n1 + n2) / 2;
  if (media >= MEDIA_PARA_APROVAR) return "aprovado";

  // Não passou direto: depende da prova final
  if (pf === null) return "cursando";

  const mediaFinal = (media + pf) / 2;
  if (mediaFinal >= MEDIA_FINAL_PARA_APROVAR) return "aprovado";

  return "reprovado";
}
N1N2PFStatus
87–aprovado
56–cursando
567aprovado (6,25)
345reprovado (4,25)
As rotas de matrícula chamam esta função no criar e no atualizar. Ninguém digita o status.
Controle Acadêmico · 46

Documentação com Scalar

Abra http://localhost:3333/api/docs e teste a API sem escrever código

documentacao/openapi.ts

Descrição escrita à mão no padrão OpenAPI

GET /api/openapi.json

Rota que devolve a descrição em JSON

GET /api/docs

HTML que carrega o Scalar (CDN) e lê o JSON

Test Request

Alunos → Listar alunos → a lista aparece

A página precisa de internet: a interface do Scalar vem de um CDN.
Rota nova? Documente em openapi.ts, senão ela não aparece no Scalar.
Controle Acadêmico · 47
SEÇÃO 07

O site por dentro

React · Rotas · Componentes

Afya Centro Universitário São Lucas, RO

main.tsx e App.tsx

Do <div id="root"> até a página certa para cada endereço

apps/web/src/main.tsx
// main.tsx: liga o React dentro do index.html
const elementoRaiz = document.getElementById("root")!;

createRoot(elementoRaiz).render(
  <StrictMode>
    <BrowserRouter>
      <App />
    </BrowserRouter>
  </StrictMode>
);
apps/web/src/App.tsx (resumido)
// App.tsx: qual página em cada endereço
export function App() {
  return (
    <Layout>
      <Routes>
        <Route path="/" element={<PaginaDashboard />} />
        <Route path="/alunos" element={<PaginaAlunos />} />
        {/* ... as outras páginas */}
      </Routes>
      <Toaster position="top-right" richColors />
    </Layout>
  );
}
BrowserRouter troca de página sem recarregar o site. Toaster é a área onde aparecem os avisos de sucesso e erro.
Controle Acadêmico · 49

servicos/api.ts

O único arquivo do site que conversa com a API

apps/web/src/servicos/api.ts (resumido)
async function requisicao(caminho, metodo = "GET", dados?) {
  const resposta = await fetch("/api" + caminho, {
    method: metodo,
    headers: { "Content-Type": "application/json" },
    body: dados ? JSON.stringify(dados) : undefined,
  });
  const corpo = await resposta.json();
  if (!resposta.ok) {              // status 400, 404, 500...
    const mensagem = corpo.erro ?? "Não foi possível falar com a API.";
    toast.error(mensagem);         // aviso vermelho na tela
    throw new Error(mensagem);     // interrompe quem chamou
  }
  return corpo;
}
// Com id: ATUALIZA (PUT). Sem id: CRIA (POST).
export function salvarAluno(dados: NovoAluno, id?: number) {
  if (id) return requisicao("/alunos/" + id, "PUT", dados);
  return requisicao("/alunos", "POST", dados);
}

Um ponto de contato

As telas nunca chamam fetch: chamam as funções daqui.

Manutenção

O endereço da API mudou? Mexemos só neste arquivo.

Erro tratado uma vez

Toda falha vira um aviso vermelho com a mensagem da API.

Controle Acadêmico · 50

A página modelo: PaginaAlunos

Estado, efeito e filtro: o mesmo jeito de funcionar em todos os cadastros

paginas/alunos/PaginaAlunos.tsx
const [alunos, setAlunos] = useState<Aluno[]>([]);
const [busca, setBusca] = useState("");
const [formularioAberto, setFormularioAberto] = useState(false);
// null = cadastrando um aluno novo
const [alunoEmEdicao, setAlunoEmEdicao] = useState<Aluno | null>(null);

useEffect(() => { carregarAlunos(); }, []);

// Filtra pelo texto digitado (nome ou matrícula)
const termo = busca.toLowerCase();
const alunosFiltrados = alunos.filter((aluno) =>
  aluno.nome.toLowerCase().includes(termo) ||
  aluno.matricula.includes(termo)
);

Novo aluno

alunoEmEdicao = null e abre o formulário.

Editar

Guarda o aluno clicado e abre o mesmo formulário.

Excluir

excluirAluno(id) → aviso de sucesso → recarrega a lista.

Controle Acadêmico · 51

Componentes do shadcn/ui

O código é copiado para components/ui: dá para ler e alterar tudo

card

Caixas com borda

table

Tabelas de listagem

dialog

Janela do formulário

alert-dialog

“Tem certeza que deseja excluir?”

input · label · select

Campos de formulário

badge

Etiquetas de status e titulação

avatar

Foto redonda ou iniciais

tabs · sonner

Abas dos relatórios e avisos no canto

Controle Acadêmico · 52

Os nossos componentes

Peças criadas para o projeto, em src/components

ComponenteO que faz
LayoutMenu lateral + área de conteúdo de todas as páginas
CabecalhoPaginaTítulo, descrição e botões no topo de cada tela
CampoRótulo + campo de formulário
FotoPerfil · CampoFotoMostra a foto (ou iniciais) · escolhe a foto no formulário
SeloStatusEtiqueta colorida: aprovado, reprovado, cursando
BotaoExcluirLixeira com janela de confirmação
GraficoBarrasGráfico de barras feito só com CSS (dashboard)
Controle Acadêmico · 53
SEÇÃO 08

A viagem de um clique

Formulário · API · Banco

Afya Centro Universitário São Lucas, RO

Cadastrar um aluno em 10 passos

Do botão “Salvar” até a tabela redesenhada

1

Usuário

Preenche o formulário e clica em “Salvar”

2

FormularioAluno.tsx

Chama salvarAluno(dados)

3

servicos/api.ts

fetch POST /api/alunos com o corpo em JSON

4

Vite (proxy)

Repassa o pedido de :5173 para :3333

5

api/src/index.ts

“POST /api/alunos” é com alunos.criar

6

rotas/alunos.ts

Confere os obrigatórios e executa INSERT INTO alunos

7

SQLite

Grava no arquivo academico.sqlite

8

rotas/alunos.ts

Devolve o aluno criado com status 201

9

FormularioAluno.tsx

Mostra “Aluno cadastrado.” e fecha a janela

10

PaginaAlunos.tsx

Busca a lista de novo e a tabela é redesenhada

Controle Acadêmico · 55

E quando dá erro?

Exemplo: tentar cadastrar um aluno com um CPF que já existe

SQLite recusa

A regra UNIQUE da coluna cpf dispara: UNIQUE constraint failed

error() captura

A função error do index.ts pega o erro e chama traduzirErroDoBanco

API responde 400

{ "erro": "Já existe um cadastro com esses dados..." }

Site avisa

servicos/api.ts vê !resposta.ok e mostra o aviso vermelho

Já existe um cadastro com esses dados (CPF, matrícula, ou o aluno já está nesta disciplina neste semestre).
Controle Acadêmico · 56
SEÇÃO 09

Criando do zero

Etapas · Comandos · Testes

Afya Centro Universitário São Lucas, RO

As 8 etapas

Cada etapa termina com um teste antes de seguir

0

Preparar

Bun e VS Code

1

Monorepo

pastas e package.json

2

Tipos

packages/tipos

3

API

Bun + SQLite + Scalar

4

Site

Vite + React + Tailwind

5

shadcn/ui

componentes prontos

6

Código do site

serviços, peças, páginas

7

Rodar tudo

teste final

Os comandos funcionam no PowerShell (Windows) e no terminal (Linux/macOS). Quando forem diferentes, as duas versões aparecem.
Controle Acadêmico · 58

Etapa 0: preparar o computador

Instale o Bun uma única vez e confira a versão

PowerShell
# Windows (PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"
Terminal
# Linux / macOS
curl -fsSL https://bun.sh/install | bash
Feche e abra o terminal, depois:
bun --version

VS Code

Editor recomendado (code.visualstudio.com)

Tailwind CSS IntelliSense

Sugere as classes do Tailwind enquanto digita

SQLite Viewer

Abre o arquivo do banco e mostra as tabelas

Teste: bun --version mostra um número (ex.: 1.3.12).
Controle Acadêmico · 59

Etapas 1 e 2: monorepo e tipos

A casa e o cardápio, antes de qualquer programa

Etapa 1: o monorepo

  • Em pweb/academico, crie apps/, packages/ e docs/
  • Crie o package.json da raiz com workspaces e scripts (seção 04)
  • O .gitignore em pweb ignora node_modules, dist e *.sqlite
  • (Opcional) git init na pasta pweb

Etapa 2: o pacote de tipos

packages/tipos/package.json
{
  "name": "@academico/tipos",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "main": "index.ts",
  "types": "index.ts"
}
Teste: packages/tipos/index.ts existe e não tem sublinhado vermelho.
Controle Acadêmico · 60

Etapa 3: a API

Pastas, configuração e a ordem de criação dos arquivos

apps/api/package.json
{
  "name": "@academico/api",
  "type": "module",
  "scripts": {
    "dev": "bun --watch src/index.ts",
    "start": "bun src/index.ts",
    "banco:popular": "bun src/banco/popular.ts"
  },
  "dependencies": {
    "@academico/tipos": "workspace:*"
  },
  "devDependencies": { "@types/bun": "latest" }
}
#ArquivoPapel
1banco/criar-tabelas.tsCREATE TABLE das 4 tabelas
2banco/conexao.tsAbre o .sqlite e cria as tabelas
3regras/notas.tscalcularStatus
4rotas/ajudantes.tserro, validação, tradução
5rotas/alunos.tsO modelo: leia com calma
6rotas/*.tsprofessores, disciplinas, matrículas, relatórios
7index.tsLiga o servidor na 3333
8banco/popular.tsDados de exemplo
Controle Acadêmico · 61

Etapa 3: testando a API

Antes de existir o site, a API já funciona sozinha

Na raiz do projeto
bun run banco:popular
bun run dev:api
# ✅ API rodando em http://localhost:3333/api
Abra no navegadorResultado
localhost:3333/api/alunoslista em JSON
localhost:3333/api/dashboardnúmeros do dashboard
localhost:3333/api/xyz{"erro":"Rota não encontrada."}
Outro terminal · Linux / macOS / Git Bash
curl -X POST http://localhost:3333/api/disciplinas \
  -H "Content-Type: application/json" \
  -d '{"nome":"Redes","curso":"Computação","carga_horaria":60}'
Outro terminal · Windows PowerShell
Invoke-RestMethod -Method Post `
  -Uri http://localhost:3333/api/disciplinas `
  -ContentType "application/json" `
  -Body '{"nome":"Redes","curso":"Computação","carga_horaria":60}'
Controle Acadêmico · 62

Etapa 3.11: documentação com Scalar

Um pacote, dois arquivos e duas linhas no index.ts

Instalar e criar a pasta
cd apps/api
bun add @scalar/client-side-rendering
cd ../..
mkdir apps/api/src/documentacao
ArquivoO que faz
documentacao/openapi.tsA descrição da API (OpenAPI)
rotas/documentacao.tsEntrega o JSON e a página do Scalar
apps/api/src/index.ts
import * as documentacao from "./rotas/documentacao";

// dentro de routes:
"/api/openapi.json": { GET: documentacao.openapi },
"/api/docs": { GET: documentacao.paginaDocumentacao },
Teste: abra localhost:3333/api/docs → Alunos → Listar alunos → Test Request.
Controle Acadêmico · 63

Etapa 4: o site com Vite

Criar o projeto React, limpar o exemplo e instalar o essencial

4.1 · Criar o projeto
cd apps
bun create vite web --template react-ts --no-interactive
cd ..
4.2 · Limpar o exemplo (PowerShell)
Remove-Item -Recurse -Force apps/web/src/App.css, apps/web/src/assets, `
  apps/web/public/icons.svg, apps/web/README.md, apps/web/.oxlintrc.json
4.4 · Tailwind e React Router
cd apps/web
bun add tailwindcss @tailwindcss/vite react-router

4.3 · Ajustar apps/web/package.json

  • Nome: "@academico/web"
  • Remover o script lint e a dependência oxlint
  • Acrescentar "@academico/tipos": "workspace:*"
  • Rodar bun install na raiz
Em src/index.css, troque tudo por @import "tailwindcss";
Controle Acadêmico · 64

Etapa 4: vite.config.ts

Plugins, atalho @/, porta fixa e o proxy para a API

apps/web/vite.config.ts
export default defineConfig({
  plugins: [react(), tailwindcss()],
  resolve: {
    // Atalho: "@/" significa "a pasta src/"
    alias: { "@": path.resolve(import.meta.dirname, "./src") },
    // Uma única cópia do React (evita página em branco)
    dedupe: ["react", "react-dom"],
  },
  server: {
    port: 5173,
    strictPort: true, // ocupada? para com aviso
    // Tudo que começar com /api vai para a API
    proxy: { "/api": "http://localhost:3333" },
  },
});

Atalho @/

Configure também em tsconfig.json e tsconfig.app.json: "paths": { "@/*": ["./src/*"] }

Teste: bun run dev dentro de apps/web abre localhost:5173 sem erros.
Controle Acadêmico · 65

Etapa 5: shadcn/ui

O shadcn copia o código dos componentes para dentro do projeto

5.1 · Inicializar (dentro de apps/web)
bunx --bun shadcn@latest init -t vite -b radix -p nova --no-monorepo
5.2 · Adicionar os componentes usados
bunx --bun shadcn@latest add card table dialog alert-dialog input label select badge avatar tabs sonner separator

-t vite

Projeto usa Vite

-b radix

Base: Radix UI

-p nova

Estilo visual Nova

--no-monorepo

Cuida só do site

Controle Acadêmico · 66

Etapa 6: o código do site

Do mais simples para o mais completo

6.1 Base

  • index.html
  • public/favicon.svg
  • servicos/api.ts
  • lib/formatar.ts

6.2 Componentes

  • Layout
  • CabecalhoPagina
  • Campo
  • FotoPerfil · CampoFoto
  • SeloStatus
  • BotaoExcluir
  • GraficoBarras

6.3 Páginas

  • alunos/ (o modelo)
  • professores/
  • disciplinas/
  • matriculas/
  • dashboard/
  • relatorios/

6.4 Juntar

  • App.tsx
  • main.tsx
Dica didática: comece só com Layout + Alunos. No App.tsx, deixe só a rota /alunos. Funcionou? Acrescente as outras.
Controle Acadêmico · 67
SEÇÃO 10

Executando o sistema

Instalar · Popular · Rodar

Afya Centro Universitário São Lucas, RO

Rodar em 3 comandos

Na pasta raiz do projeto: pweb/academico

1
Instalar as dependências
bun install
2
Dados de exemplo (recomendado)
bun run banco:popular
3
Ligar API + site
bun run dev
O queEndereço
Site (telas)http://localhost:5173
API (JSON)http://localhost:3333/api/alunos
Documentaçãohttp://localhost:3333/api/docs
Para desligar: Ctrl + C no terminal.
Controle Acadêmico · 69

Comandos úteis

Os atalhos definidos no package.json da raiz

ComandoO que faz
bun run devLiga a API e o site ao mesmo tempo
bun run dev:apiLiga só a API (porta 3333)
bun run dev:webLiga só o site (porta 5173)
bun run banco:popularApaga os dados e coloca dados de exemplo
bun run buildConfere os tipos e gera a versão final do site em apps/web/dist
Quer zerar o banco? Apague apps/api/academico.sqlite. Ele é recriado (vazio) quando a API ligar.
Controle Acadêmico · 70

Teste final

Confira, com o sistema rodando, se tudo se conecta

O dashboard mostra os números e os gráficos
Cadastre um aluno com foto
Mesmo CPF de novo → aparece um aviso vermelho
Excluir aluno com matrículas → o sistema não deixa
Matrícula com N1 = 5 e N2 = 6 → cursando
Edite com PF = 7 → aprovado (6,25)
Veja o boletim do aluno em Relatórios
Abra /api/docs e teste um endereço pelo Scalar
Controle Acadêmico · 71
SEÇÃO 11

Depurando o sistema

Encontrar · Entender · Corrigir

Afya Centro Universitário São Lucas, RO

Onde está o problema?

Siga o pedido camada por camada: cada uma tem a sua ferramenta

Tela (React)

Console e React DevTools

Pedido HTTP

Aba Rede (Network) do F12

API (Bun)

Terminal, console.log e depurador

Banco

SQLite Viewer no VS Code

1 · O pedido saiu?

Se não aparece na aba Rede, o problema está na tela.

2 · Qual o status?

4xx/5xx: leia o corpo da resposta e o terminal da API.

3 · Gravou certo?

Abra a tabela no banco e confira os dados.

Controle Acadêmico · 73

DevTools do navegador (F12)

A principal ferramenta para depurar o site

Console

Erros em vermelho (ex.: Invalid hook call) e as mensagens de console.log(dados) que você colocar no código.

Rede (Network)

Cada pedido para /api/...: método, status, o corpo enviado (Payload) e a resposta (Response).

Fontes (Sources)

Pontos de parada (breakpoints) no código .tsx. Ou escreva debugger; na linha: a execução pausa ali com o F12 aberto.

React DevTools

Extensão do navegador: mostra a árvore de componentes, as props e o estado (useState) de cada um.

Controle Acadêmico · 74

Depurando o site na prática

Coloque pistas no código e observe

Exemplo em PaginaAlunos / FormularioAluno
async function carregarAlunos() {
  const lista = await listarAlunos();
  console.log("alunos recebidos:", lista);
  setAlunos(lista);
}

async function salvar() {
  debugger; // pausa aqui com o F12 aberto
  await salvarAluno(dados, aluno?.id);
}

Pausado no debugger

Passe o mouse sobre as variáveis para ver os valores; use os botões para avançar linha a linha.

Passo a passo

F10 próxima linha · F11 entra na função · F8 continua.

Terminou? Apague os console.log e debugger antes de entregar.
Controle Acadêmico · 75

Depurando a API

O terminal do bun run dev é o “console” do servidor

rotas/alunos.ts
export async function criar(req: BunRequest) {
  const dados = (await req.json()) as NovoAluno;
  console.log("POST /api/alunos recebeu:", dados);
  // ...
}
Depurador do Bun
cd apps/api
bun --inspect src/index.ts
# abre um link do depurador web do Bun (debug.bun.sh)

Logs no terminal

console.log da API aparece no terminal, não no navegador. A função error() do index.ts já faz console.error de toda falha.

--watch

Salvou o arquivo? A API reinicia sozinha: é só repetir o pedido.

No VS Code

Com a extensão Bun for Visual Studio Code, clique na margem para criar breakpoints e rode a API em modo debug.

Controle Acadêmico · 76

Testando a API isolada

Tire o site da equação: o problema é da API ou da tela?

Navegador

Pedidos GET: abra localhost:3333/api/alunos e veja o JSON cru.

Scalar

/api/docs: escolha o endereço, preencha o corpo e clique em Test Request. Funciona para POST, PUT e DELETE.

curl / Invoke-RestMethod

Pedidos pelo terminal: bons para repetir o mesmo teste várias vezes.

Funcionou no Scalar mas não no site? O problema está em servicos/api.ts ou na tela. Falhou no Scalar também? Está na API ou no banco.
Controle Acadêmico · 77

Olhando o banco de dados

Confira o que realmente foi gravado

SQLite Viewer

Clique em apps/api/academico.sqlite no VS Code e navegue pelas tabelas.

Voltar ao início

bun run banco:popular substitui tudo pelos dados de exemplo.

Recriar do zero

Apague o .sqlite: a API cria de novo, vazio, ao ligar.

Mudou uma tabela em criar-tabelas.ts e nada mudou? CREATE TABLE IF NOT EXISTS não altera tabela existente. Apague o .sqlite e rode banco:popular.
consulta de teste
-- Teste uma consulta antes de pôr no código
SELECT a.nome, m.n1, m.n2, m.status
FROM matriculas m
JOIN alunos a ON a.id = m.aluno_id
WHERE m.semestre = '2026.1';
Controle Acadêmico · 78

Problemas comuns (1/2)

Do academico/tutorial.md: sintoma → solução

ProblemaSolução
bun: command not foundFeche e abra o terminal depois de instalar o Bun
Site abre, mas as listas ficam vazias e aparece erroA API está ligada? Use bun run dev na raiz (liga os dois)
Port 3333 is already in useJá existe uma API rodando em outro terminal: feche-a
Port 5173 is already in useUm bun run dev esquecido em outro terminal: feche com Ctrl + C
Cannot find module '@academico/tipos'Rode bun install na raiz do projeto
Controle Acadêmico · 79

Problemas comuns (2/2)

Página em branco, documentação e banco

ProblemaSolução
Site em branco, sem erro no terminalF12 → Console. Se aparecer Invalid hook call: confira o dedupe no vite.config.ts, apague apps/web/node_modules/.vite e rode de novo
A página /api/docs fica em brancoEla precisa de internet: a interface do Scalar vem de um CDN
Criei uma rota e ela não aparece no ScalarDocumente-a em src/documentacao/openapi.ts
Mudei uma tabela e nada mudouApague o .sqlite e rode bun run banco:popular
Quero começar o banco do zeroApague apps/api/academico.sqlite e rode bun run banco:popular
Controle Acadêmico · 80
SEÇÃO 12

Próximos passos

Praticar · Evoluir · Criar

Afya Centro Universitário São Lucas, RO

Exercícios por nível

Cada um tem uma dica de por onde começar (docs/exercicios.md)

Nível 1aquecimento
  • Mudar a média de aprovação para 6 (regras/notas.ts)
  • Mais um aluno e uma disciplina nos dados de exemplo (popular.ts)
  • Titulação “Livre-Docente” no formulário de professor
Nível 2mexendo em uma camada
  • Quantidade de registros abaixo de cada tabela
  • Busca de alunos também por CPF
  • Filtro ?disciplina_id= nas matrículas (e documentar no Scalar)
Nível 3atravessando o sistema
  • Campo “data de nascimento” no aluno
  • Passos: criar-tabelas.ts → tipos → rotas (INSERT e UPDATE) → formulário e tabela
  • Repare como o TypeScript aponta o que ajustar
Controle Acadêmico · 82

Roteiro de estudo

Os três projetos da pasta pweb e por onde continuar

academico/

O sistema exemplo desta aula.

controle_n2/

Sistema exemplo e controle dos grupos e apresentações.

web/

Este site da aula, explicando o Acadêmico passo a passo.

Ordem de leitura

  1. README.md · visão geral e como rodar
  2. arquitetura.md · como as partes conversam
  3. tutorial.md · construir do zero
  4. docs/ · rotas, banco e exercícios
  5. pweb/docs/ · glossário, TypeScript, React, SQLite, API e Scalar
Controle Acadêmico · 83

Programação para Sistemas Web

Bons estudos
e bom código!

Dúvidas? Abra o projeto, rode, quebre, depure e conserte.

pweb/academicopweb/web
Afya Centro Universitário São Lucas, RO
← → navegar · N notas · G visão geral · F tela cheia