Glossário
Definições de termos técnicos utilizados na documentação do Filament Core Suite.
A
Action (Laravel Actions)
Classe que encapsula uma única operação de negócio, seguindo o princípio de responsabilidade única. No contexto do Filament Core, Actions centralizam lógica como CreateInvoiceAction, CancelInvoiceAction, evitando duplicação em controllers e commands.
ADR (Architecture Decision Record)
Documento que registra uma decisão arquitetural importante, incluindo contexto, alternativas consideradas, decisão tomada e consequências esperadas.
B
Broker
Componente intermediário que gerencia comunicação assíncrona entre sistemas. No packages/communications, o broker coordena envio de mensagens multi-canal.
C
Contracts-First
Abordagem arquitetural onde interfaces, DTOs e eventos são definidos antes das implementações concretas, garantindo que módulos dependam de abstrações estáveis.
Channel (Notification)
Driver específico para envio de notificações (SMTP, SMS, WhatsApp). Cada channel implementa NotificationChannelInterface e encapsula integração com provedor externo.
D
DTO (Data Transfer Object)
Objeto imutável usado para transferir dados entre camadas ou módulos sem expor modelos de domínio. No Filament Core, DTOs padronizam estruturas como valores monetários, timestamps e identificadores.
DDD (Domain-Driven Design)
Abordagem de design de software focada em modelar o domínio do negócio através de linguagem ubíqua, agregados, entidades e value objects.
E
Event-Driven Architecture
Arquitetura onde módulos comunicam-se através de eventos assíncronos ao invés de chamadas diretas, promovendo baixo acoplamento.
Evento Global
Evento publicado em packages/contracts que pode ser consumido por qualquer módulo do ecossistema (ex: PersonCreated, InvoiceCreated, PaymentCompleted).
F
Filament
Framework PHP para construção rápida de painéis administrativos em Laravel, com foco em TALL stack (Tailwind, Alpine.js, Laravel, Livewire).
Fuzzy Search
Técnica de busca que encontra resultados aproximados, tolerando pequenas diferenças de digitação ou ortografia.
G
Gateway (Payment)
Implementação de PaymentGatewayInterface que integra com provedor de pagamento externo (InfinityPay, Stripe, etc).
I
Interface
Contrato PHP que define métodos públicos sem implementação. No Filament Core, interfaces residem em packages/contracts e são implementadas por módulos específicos.
L
Linguagem Ubíqua
Vocabulário compartilhado entre equipe técnica e especialistas de domínio, usado consistentemente em código, documentação e conversas.
M
Monorepo
Estratégia de organizar código de múltiplos módulos em um único repositório, facilitando refatorações atômicas e sincronização de mudanças cross-module. Todos os módulos do Filament Core vivem em packages/ do monorepo.
MiniSearch
Biblioteca JavaScript de busca full-text usada pelo VitePress para implementar busca local sem backend.
N
Nixpacks
Ferramenta que gera Dockerfiles automaticamente detectando tecnologias do projeto, usada em plataformas como Railway para deploy simplificado.
O
Observabilidade
Capacidade de entender o estado interno de um sistema através de suas saídas (logs, métricas, traces), essencial para debugging e monitoramento.
P
Plugin (Filament)
Pacote que estende funcionalidades do Filament, como adicionar novos campos, widgets ou páginas administrativas.
Policy (Laravel)
Classe que centraliza lógica de autorização para um modelo, definindo quem pode visualizar, criar, atualizar ou deletar recursos.
R
Resource (Filament)
Classe que define CRUD completo para um modelo no painel administrativo, incluindo listagem, formulários, filtros e actions.
S
Service Provider (Laravel)
Classe que registra bindings no container de injeção de dependência do Laravel e executa bootstrapping de pacotes.
T
Template Engine
Sistema que processa templates com placeholders () substituindo-os por valores dinâmicos. Usado em packages/communications para emails e mensagens.
V
Value Object
Objeto imutável definido por seus valores ao invés de identidade. Exemplos: Money, EmailAddress, PhoneNumber. Encapsula validações e comportamentos do domínio.
VitePress
Gerador de sites estáticos otimizado para documentação técnica, baseado em Vue 3 e Vite.
W
Webhook
Endpoint HTTP que recebe notificações assíncronas de sistemas externos quando eventos ocorrem (ex: confirmação de pagamento, falha de entrega).
Contribuindo com o Glossário
Ao adicionar novos termos:
- Mantenha ordem alfabética
- Use definições claras e concisas (1-3 frases)
- Inclua contexto específico do Filament Core quando relevante
- Adicione links para documentação detalhada quando apropriado
- Evite jargão excessivo - explique termos técnicos
Formato:
### Nome do Termo
Definição clara e objetiva. Contexto de uso no Filament Core Suite.