Glossario

Glossário

Os termos de negócio e técnicos usados no PolicyDesk e nesta wiki, cada um com um link para o artigo que o explica em detalhe. Use esta página como um dicionário: quando um termo não estiver claro em algum artigo, procure-o aqui.

---

Negócio (seguros)

Termo	Inglês no código	Definição
Segurado	Policyholder	Pessoa protegida pelo seguro e titular da apólice
Apólice	Policy	Contrato de seguro, com cobertura, prêmio e vigência
Sinistro	Claim	Ocorrência de um evento coberto e o pedido de indenização correspondente
Cobertura	CoverageAmount	Valor máximo que a seguradora paga pela apólice, somando os sinistros não negados
Saldo da cobertura	RegisterClaim(amount, committedAmount)	Cobertura menos a soma dos sinistros não negados; limite para um novo sinistro
Prêmio	PremiumAmount	Valor pago pelo segurado pela proteção. Não confundir com "prêmio" no sentido de recompensa
Vigência	StartDate / EndDate	Período em que a apólice cobre eventos
Em vigor	IsInForce	Apólice não cancelada cuja vigência inclui a data considerada
Indenização	—	Valor pago ao segurado em razão de um sinistro aprovado
Negação	Deny	Recusa do sinistro, com motivo
Cancelamento	Cancel	Encerramento antecipado da apólice
Inativação	Deactivate	Exclusão lógica do segurado
Fuso de negócio	BusinessClock, Business:TimeZone	Fuso usado para decidir que dia é hoje (America/Sao_Paulo)
CPF	Cpf	Cadastro de Pessoas Físicas: identificador de 11 dígitos, sendo os 2 últimos verificadores

---

Técnicos

Termo	Definição	Veja
Agregado	Grupo de objetos tratado como unidade de consistência, acessado por uma raiz	Modelo de Domínio
Always-Valid	Princípio de que uma entidade nunca existe em estado inválido	Design Patterns
Anemic Domain Model	Antipadrão em que entidades só têm dados e a lógica fica em serviços	Design Patterns
Artefato	Resultado empacotado de um job do pipeline (o bundle de migrations, o relatório de cobertura), reaproveitado nos jobs seguintes	CI/CD e Deploy
GHCR	GitHub Container Registry (ghcr.io): o registro de imagens Docker do GitHub, onde fica a imagem da API	CI/CD e Deploy
Imagem Docker	Pacote com a aplicação e tudo de que ela precisa para rodar, gerado a partir do Dockerfile	Qualidade e Convenções
AsNoTracking	Consulta do EF Core que não registra as entidades no change tracker	Persistência
Captive dependency	Serviço de vida longa que prende uma dependência de vida curta	Arquitetura
CD	Continuous Delivery/Deployment: publicação automática de cada versão aprovada	CI/CD e Deploy
Change tracker	Mecanismo do EF Core que detecta alterações em entidades carregadas	Persistência
Check constraint	Restrição do banco que recusa valores fora de uma condição (status IN (...))	Persistência
CI	Continuous Integration: build e testes automáticos a cada mudança	CI/CD e Deploy
Composition Root	Ponto único em que o grafo de dependências é montado	Design Patterns
CQS	Command-Query Separation: métodos ou consultam ou alteram	Design Patterns
Correlation ID	Identificador que liga todos os registros de uma requisição	Observabilidade
DateOnly	Tipo do .NET para uma data de calendário, sem horário nem fuso	Modelo de Domínio
DTO	Data Transfer Object: objeto só de dados para cruzar fronteiras	Design Patterns
E.164	Formato internacional de telefone: +, código do país e número, só com dígitos (+5511987654321)	Modelo de Domínio
Fail fast	Falhar o quanto antes, com erro claro, em vez de seguir com estado inválido	Primeiros Passos
Guard clause	Verificação de pré-condição no início de um método, com saída antecipada	Design Patterns
Health check	Endpoint que informa se a aplicação e suas dependências estão operacionais	Observabilidade
Idempotente	Operação que produz o mesmo resultado se repetida	Primeiros Passos
Índice parcial	Índice do PostgreSQL que cobre só as linhas que atendem a um WHERE	Persistência
Invariante	Condição que deve ser sempre verdadeira para um objeto	Modelo de Domínio
ISP	Interface Segregation Principle: clientes não devem depender do que não usam	Design Patterns
LGPD	Lei Geral de Proteção de Dados (Lei nº 13.709/2018)	Observabilidade
Lost update	Anomalia em que uma gravação concorrente sobrescreve outra sem perceber	Design Patterns
Migrations bundle	Executável autocontido do EF Core que aplica as migrations pendentes	Persistência
Migration	Alteração versionada do esquema do banco	Persistência
OIDC	OpenID Connect: no pipeline, troca um token temporário do GitHub por um acesso à Azure, sem senha guardada	CI/CD e Deploy
OTLP	OpenTelemetry Protocol: protocolo de envio de telemetria	Observabilidade
Paginação por offset	Paginação com Skip/Take: pula as linhas das páginas anteriores	Persistência
Persistence ignorance	Domínio que não conhece a forma como é persistido	Persistência
ProblemDetails	Formato padrão de erro em APIs HTTP (RFC 9457)	Tratamento de Erros
Scoped	Tempo de vida de DI: uma instância por requisição	Arquitetura
Singleton	Tempo de vida de DI: uma instância para a aplicação inteira	Arquitetura
Shadow property	Propriedade que existe no modelo do EF Core mas não na classe C#	Persistência
Smoke test	Teste rápido logo após o deploy, que só confirma que a aplicação subiu	CI/CD e Deploy
Soft delete	Exclusão lógica: o registro é marcado, não apagado	Design Patterns
Span	Unidade de trabalho dentro de um trace (uma requisição, uma consulta SQL)	Observabilidade
Tell, Don't Ask	Mandar o objeto agir em vez de perguntar seu estado e decidir fora	Design Patterns
Transient	Tempo de vida de DI: uma instância nova a cada pedido	Arquitetura
Testcontainers	Biblioteca que sobe dependências reais em Docker durante os testes	Estratégia de Testes
Trace	Registro do caminho completo de uma requisição pelo sistema	Observabilidade
Unit of Work	Coordena a gravação de todas as alterações de uma operação de negócio	Design Patterns
Upsert	Inserir ou, se já existir, atualizar, de forma atômica	Design Patterns
Value Object	Objeto definido apenas por seus atributos, sem identidade	Design Patterns
xmin	Coluna de sistema do PostgreSQL que identifica a versão de uma linha	Persistência