Glossário

Geração automática

Este arquivo é gerado automaticamente a partir do catálogo canônico docs/specs/terms/terms.yaml.

Legenda de Status

Status	Descrição
RASCUNHO	Termo em rascunho ou revisão inicial.
REVISÃO	Termo aguardando validação.
EM DESUSO	Termo em desuso, substituído por outro.
REMOVIDO	Termo removido da metodologia.

Tabela de Siglas

Sigla	Termo
DTO	DTO

A

Adapter RASCUNHO

Isola dependências do Moodle do restante do framework. Toda chamada ao Moodle passa pela fronteira framework/support/moodle/. Pode ou não implementar contract, conforme necessidade de substituição.

• Referências:
  • ADR-0003

Agrupamento de Cursos (coursegroup) RASCUNHO

Extensão de equivalência e agrupamento lógico de cursos no Moodle.

Audit RASCUNHO

Registro persistido e imutável de rastreabilidade, derivado de signals do framework. Responde a "qual fato ocorreu, quem causou e o que mudou?". Persiste em middag_audit_log, _diff e _snapshot.

• Ver também: Signal
• Referências:
  • ADR-0007, ADR-0008

Auditoria e Rastreabilidade RASCUNHO

Sistema de logs granular que registra quem fez o quê, quando e onde em dados sensíveis do Moodle.

Autenticação e Segurança RASCUNHO

Gerencia validação de usuários e permite que extensões de login se conectem sem comprometer a base de dados.

Authorizer RASCUNHO

Implementa authorizer_interface encapsulando checagens de permissão e contexto do Moodle. Permite que services e extensions injetem autorização via DI sem depender de chamadas estáticas.

• Ver também: Adapter
• Referências:
  • ADR-0011

Automação de Mensagens (automessage) RASCUNHO

Extensão de réguas de comunicação automatizada e disparo de mensagens.

B

Biblioteca de Vídeos (videolibrary) RASCUNHO

Extensão de gestão centralizada de mídia em vídeo dentro do Moodle.

Block RASCUNHO

Componente de bloco visual (Moodle block) gerenciado e registrado pelo framework.

C

Cached Item Repository RASCUNHO

Decorator sobre item_repository que adiciona cache MUC (Moodle Universal Cache) sem modificar o repositório base. Implementa a mesma interface item_repository_interface.

• Ver também: Repository
• Referências:
  • ADR-0012

Central de Suporte (helpdesk) RASCUNHO

Extensão de atendimento e suporte integrado ao aluno dentro do Moodle.

Command RASCUNHO

Unidade de trabalho serializável e independente do executor, que encapsula a intenção de uma operação assíncrona ou reutilizável. Entra quando há ganho real em reuso, adiamento ou retry.

• Ver também: Job
• Referências:
  • ADR-0006

Conector BigQuery (bigquery) RASCUNHO

Extensão de exportação de dados para Data Lake e BI externo via Google BigQuery.

Container RASCUNHO

Container de injeção de dependências baseado em Symfony ContainerBuilder; mecanismo oficial de criação, resolução e ciclo de vida de serviços estruturais do framework.

• Referências:
  • ADR-0001

Contract RASCUNHO

Interface que define um papel arquitetural com necessidade real de DI, substituição ou composição. Marcada com @api quando pública estável; interna por padrão quando sem essa anotação.

• Ver também: Extension (base)
• Referências:
  • ADR-0002, ADR-0010

Controller RASCUNHO

Tratador de requisições HTTP integrado ao ciclo de roteamento do framework. Recebe Request, valida permissões e delega para Services.

Códigos Personalizados (snippets) RASCUNHO

Extensão para injeção controlada de JS, CSS e HTML no ambiente Moodle.

D

Diagnóstico e Saúde RASCUNHO

Ferramentas técnicas para identificar gargalos de performance, erros de configuração e falhas de integração.

Dispatcher RASCUNHO

Serviço baseado em Symfony EventDispatcherInterface que publica signals e outras ocorrências tipadas. Acessado publicamente via middag::dispatch().

• Ver também: Signal
• Referências:
  • ADR-0005

DTO RASCUNHO

Data Transfer Object para transporte de dados entre camadas sem lógica de negócio.

E

Empresas e Departamentos (company) RASCUNHO

Extensão de gestão multi-tenant e hierarquias organizacionais no Moodle.

Entity (base) RASCUNHO

Classe abstrata de entidade de domínio imutável, base para tipos persistíveis do framework.

Extension (base) RASCUNHO

Classe abstrata da camada de extensão controlada que extensions estendem para implementar register() e boot(), registrando controllers, services, hooks e filters no kernel.

• Referências:
  • ADR-0002, ADR-0004

F

Facade RASCUNHO

Ponto estático de acesso estável para consumidores externos. Representa uma entrada pública do framework e delega para serviços resolvidos pelo container. Gerada via CLI — não editada manualmente.

• Ver também: Contract
• Referências:
  • ADR-0002

Filter RASCUNHO

Transformação síncrona de valor aplicada em fluxo, separada do dispatcher. Filters não representam ocorrências e não são derivados de signals.

• Referências:
  • ADR-0005

Formulários Customizados (customform) RASCUNHO

Extensão para coleta de dados e automação via formulários dinâmicos.

G

Gerador de Documentos (customdocs) RASCUNHO

Extensão para emissão dinâmica de certificados e contratos personalizados.

Gerenciador de Arquivos (manage_files) RASCUNHO

Extensão que fornece repositório único de documentos e arquivos do Moodle.

H

Histórico de Matrículas (enrolment) RASCUNHO

Extensão que gerencia o ciclo de vida completo do aluno, da inscrição à conclusão.

Hook RASCUNHO

Action hook derivado de uma ocorrência despachada, exposto como nome canônico em string. Usa prefixo middag/ e segmentos em snake_case. Não é o mecanismo principal de publicação do framework.

• Referências:
  • ADR-0005

Hub de E-commerce (ecommerce) RASCUNHO

Extensão de vendas e matrículas automáticas integradas ao Moodle.

I

Import Repository RASCUNHO

Repositório especializado para restauração de backup: insere dados diretamente no banco preservando timestamps históricos, contornando intencionalmente a lógica de negócio do item_repository.

• Ver também: Item
• Referências:
  • ADR-0014

Integração Looker Studio (lookerstudio) RASCUNHO

Extensão que embeda dashboards do Google Looker Studio no ambiente Moodle.

Item RASCUNHO

Unidade canônica de persistência flexível do framework, tipada por TYPE. Persiste em middag_items + middag_itemmeta. Equivalente ao post do WordPress: registro-base para múltiplos modelos de negócio.

• Referências:
  • ADR-0007

J

Job RASCUNHO

Registro persistido de governança da execução assíncrona de um Command: status, deduplicação, correlação, sujeito relacionado e histórico de tentativas em middag_job e middag_job_attempt.

• Referências:
  • ADR-0006, ADR-0007

K

Kernel RASCUNHO

Coordenador do bootstrap do framework: inicializa o container, descobre recursos, executa o lifecycle das extensions e compila o grafo de serviços.

• Ver também: Container, Extension (base)

L

Limpeza de Progresso (cleaner) RASCUNHO

Extensão para reinício de cursos e reciclagem de progresso do aluno.

M

Mapper RASCUNHO

Componente que converte registros físicos do banco (stdClass) em entidades de domínio e vice-versa, isolando o schema físico das camadas superiores.

Monitoramento Sentry (sentry) RASCUNHO

Extensão de rastreamento de erros e monitoramento de performance via Sentry.

O

Open Graph (opengraph) RASCUNHO

Extensão que personaliza meta tags Open Graph para compartilhamento social.

P

Painéis de Gestão (dashboard) RASCUNHO

Extensão de métricas nativas e dashboards administrativos dentro do Moodle.

Plano de Estudos (studyplan) RASCUNHO

Extensão que gera cronogramas automáticos de estudo para o aluno.

Privacy Repository RASCUNHO

Repositório especializado para operações massivas de LGPD/GDPR (export, delete, anonymize). Executa queries otimizadas sem carregar models em memória. Recebe contextlist do Moodle.

• Ver também: Audit, Item
• Referências:
  • ADR-0013

R

Repository RASCUNHO

Fronteira oficial de persistência. Isola nomes físicos de tabelas e centraliza consultas por família: item (estado atual), revision (histórico), audit (rastreabilidade) e job (governança).

• Referências:
  • ADR-0007

Revision RASCUNHO

Snapshot histórico e imutável de um Item em um ponto no tempo, persistido em middag_item_revision. Responde à pergunta "como estava o item neste momento?".

• Ver também: Item
• Referências:
  • ADR-0007

S

Schedule RASCUNHO

Declaração de gatilho periódico separada do Command: define qual command acionar, qual intervalo base usar e a qual componente o gatilho pertence. Não governa execução individual nem tentativas.

• Ver também: Command
• Referências:
  • ADR-0006

Segmentação Inteligente (smartfilters) RASCUNHO

Extensão de listas dinâmicas de usuários filtrados por critérios configuráveis.

Service RASCUNHO

Camada de lógica de aplicação que orquestra repositórios, entidades e signals para executar casos de uso.

Signal RASCUNHO

Ocorrência tipada publicada pelo dispatcher via middag::dispatch(). Mecanismo primário de publicação interno — distinto de eventos do Moodle, de action hooks públicos e de registros de auditoria.

• Ver também: Audit, Hook
• Referências:
  • ADR-0005, ADR-0008

T

Tradução de Conteúdos (translate) RASCUNHO

Extensão de internacionalização e tradução de cursos no Moodle.

Transaction Manager RASCUNHO

Centraliza o gerenciamento de transações de banco, encapsulando o workaround de compatibilidade entre o modelo de transações do Moodle 4.x e o Throwable do PHP moderno.

• Ver também: Repository
• Referências:
  • ADR-0015

Trilhas de Aprendizagem (trilha) RASCUNHO

Extensão que implementa caminhos guiados e sequenciais de estudo.

V

Validação de Perfil (forceprofile) RASCUNHO

Extensão que impõe obrigatoriedade de dados cadastrais no perfil do usuário.

W

Webhooks (webhooks) RASCUNHO

Extensão de notificações evento-driven em tempo real para sistemas externos.

Widget RASCUNHO

Componente de interface reutilizável renderizado dentro de telas ou blocos do plugin.