Entidade

Definição

Entidade é o conceito do domínio com identidade ou significado próprio no modelo do sistema. Cliente e Pedido são entidades: cada um representa um elemento que o negócio reconhece e precisa guardar.

Identificar o que importa para o negócio

Antes de desenhar tabelas ou telas, você identifica os conceitos relevantes no domínio. Cliente carrega características como nome e e-mail, enquanto Pedido carrega data e valor. Cada entidade reúne os atributos essenciais e os vínculos com outras entidades, e é essa reunião que orienta as colunas que aparecem depois na persistência.

CREATE TABLE clientes (
id INTEGER PRIMARY KEY,
nome TEXT NOT NULL,
email TEXT NOT NULL
);
CREATE TABLE pedidos (
id INTEGER PRIMARY KEY,
cliente_id INTEGER NOT NULL,
valor REAL NOT NULL,
FOREIGN KEY (cliente_id) REFERENCES clientes (id)
);

Modelo e persistência têm responsabilidades diferentes

Entidade não é necessariamente uma tabela. O modelo de domínio descreve conceitos e regras, enquanto a persistência escolhe como guardá-los. A mesma entidade pode ser armazenada de formas diferentes, e a estrutura física não precisa espelhar o desenho conceitual campo a campo.

Falha comum e como verificar

A falha mais comum é tratar a tabela como sinônimo da entidade e pular o desenho do domínio. Quando as tabelas são criadas antes dos conceitos, um atributo que pertence a uma entidade pode parar na tabela errada, e a mudança posterior exige ajustes em várias estruturas. Para verificar, liste os conceitos do negócio e pergunte, para cada tabela, qual entidade ela representa e qual atributo ficou fora do lugar. A confirmação acontece quando a leitura do modelo explica as tabelas sem esforço: se você precisa decorar regras escondidas no código para entender o banco, o desenho das entidades está incompleto.

Aplicação na formação

Formação DevOps

Na Formação DevOps, entidades orientam o desenho das tabelas antes da aplicação de migrations e da definição de chaves.

Conhecer a formação →