Afirmações
Geração automática
Cada afirmação é derivada automaticamente das relações definidas no catálogo canônico de termos. As frases descrevem pertencimento estrutural, dependências, composições e vínculos operacionais.
Adapter¶
- O componente técnico Adapter materializa o seguinte componente técnico: 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.
- O componente técnico Adapter pertence estruturalmente a Camada de Infraestrutura.
Agrupamento de Cursos (coursegroup)¶
- O componente técnico Agrupamento de Cursos (coursegroup) materializa o seguinte componente técnico: Extensão de equivalência e agrupamento lógico de cursos no Moodle.
- O componente técnico Agrupamento de Cursos (coursegroup) pertence estruturalmente a Conteúdo e Aprendizagem.
Audit¶
- A entidade Audit materializa o seguinte objeto operacional: 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.
- A entidade Audit materializa operacionalmente Camada de Infraestrutura.
- A entidade Audit faz a mediação entre Camada de Infraestrutura e Signal no contexto de Camada de Infraestrutura.
- A entidade Audit depende de Signal.
Auditoria e Rastreabilidade¶
- O componente técnico Auditoria e Rastreabilidade materializa o seguinte componente técnico: Sistema de logs granular que registra quem fez o quê, quando e onde em dados sensíveis do Moodle.
- O componente técnico Auditoria e Rastreabilidade pertence estruturalmente a Core.
Autenticação e Segurança¶
- O componente técnico Autenticação e Segurança materializa o seguinte componente técnico: Gerencia validação de usuários e permite que extensões de login se conectem sem comprometer a base de dados.
- O componente técnico Autenticação e Segurança pertence estruturalmente a Core.
Authorizer¶
- O componente técnico Authorizer materializa o seguinte componente técnico: 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.
- O componente técnico Authorizer pertence estruturalmente a Camada de Infraestrutura.
- O componente técnico Authorizer faz a mediação entre Camada de Infraestrutura e Adapter no contexto de Camada de Infraestrutura.
- O componente técnico Authorizer opera sobre Adapter.
Automação de Mensagens (automessage)¶
- O componente técnico Automação de Mensagens (automessage) materializa o seguinte componente técnico: Extensão de réguas de comunicação automatizada e disparo de mensagens.
- O componente técnico Automação de Mensagens (automessage) pertence estruturalmente a Engajamento e Comunicação.
Biblioteca de Vídeos (videolibrary)¶
- O componente técnico Biblioteca de Vídeos (videolibrary) materializa o seguinte componente técnico: Extensão de gestão centralizada de mídia em vídeo dentro do Moodle.
- O componente técnico Biblioteca de Vídeos (videolibrary) pertence estruturalmente a Conteúdo e Aprendizagem.
Block¶
- O componente técnico Block materializa o seguinte componente técnico: Componente de bloco visual (Moodle block) gerenciado e registrado pelo framework.
- O componente técnico Block pertence estruturalmente a Camada de Interface.
Cached Item Repository¶
- O componente técnico Cached Item Repository materializa o seguinte componente técnico: Decorator sobre item_repository que adiciona cache MUC (Moodle Universal Cache) sem modificar o repositório base. Implementa a mesma interface item_repository_interface.
- O componente técnico Cached Item Repository pertence estruturalmente a Camada de Infraestrutura.
- O componente técnico Cached Item Repository faz a mediação entre Camada de Infraestrutura e Repository no contexto de Camada de Infraestrutura.
- O componente técnico Cached Item Repository opera sobre Repository.
Central de Suporte (helpdesk)¶
- O componente técnico Central de Suporte (helpdesk) materializa o seguinte componente técnico: Extensão de atendimento e suporte integrado ao aluno dentro do Moodle.
- O componente técnico Central de Suporte (helpdesk) pertence estruturalmente a Gestão e Operação.
Códigos Personalizados (snippets)¶
- O componente técnico Códigos Personalizados (snippets) materializa o seguinte componente técnico: Extensão para injeção controlada de JS, CSS e HTML no ambiente Moodle.
- O componente técnico Códigos Personalizados (snippets) pertence estruturalmente a Integrações e Dados.
Command¶
- O conceito Command define o seguinte recorte conceitual: 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.
- O conceito Command aprofunda conceitualmente Camada de Aplicação.
- O conceito Command dá base para Job.
Conector BigQuery (bigquery)¶
- O componente técnico Conector BigQuery (bigquery) materializa o seguinte componente técnico: Extensão de exportação de dados para Data Lake e BI externo via Google BigQuery.
- O componente técnico Conector BigQuery (bigquery) pertence estruturalmente a Integrações e Dados.
Container¶
- O componente técnico Container materializa o seguinte componente técnico: 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.
- O componente técnico Container pertence estruturalmente a Camada de Kernel.
Contract¶
- O conceito Contract define o seguinte recorte conceitual: 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.
- O conceito Contract aprofunda conceitualmente API Pública.
- O conceito Contract mantém relação com Extension (base).
Controller¶
- O componente técnico Controller materializa o seguinte componente técnico: Tratador de requisições HTTP integrado ao ciclo de roteamento do framework. Recebe Request, valida permissões e delega para Services.
- O componente técnico Controller pertence estruturalmente a Camada de Interface.
Diagnóstico e Saúde¶
- O componente técnico Diagnóstico e Saúde materializa o seguinte componente técnico: Ferramentas técnicas para identificar gargalos de performance, erros de configuração e falhas de integração.
- O componente técnico Diagnóstico e Saúde pertence estruturalmente a Core.
Dispatcher¶
- O componente técnico Dispatcher materializa o seguinte componente técnico: Serviço baseado em Symfony EventDispatcherInterface que publica signals e outras ocorrências tipadas. Acessado publicamente via middag::dispatch().
- O componente técnico Dispatcher pertence estruturalmente a Mecanismo Reativo.
- O componente técnico Dispatcher faz a mediação entre Mecanismo Reativo e Signal no contexto de Mecanismo Reativo.
- O componente técnico Dispatcher mantém relação com Signal.
DTO¶
- O componente técnico DTO materializa o seguinte componente técnico: Data Transfer Object para transporte de dados entre camadas sem lógica de negócio.
- O componente técnico DTO pertence estruturalmente a Camada de Domínio.
Empresas e Departamentos (company)¶
- O componente técnico Empresas e Departamentos (company) materializa o seguinte componente técnico: Extensão de gestão multi-tenant e hierarquias organizacionais no Moodle.
- O componente técnico Empresas e Departamentos (company) pertence estruturalmente a Gestão e Operação.
Entity (base)¶
- O componente técnico Entity (base) materializa o seguinte componente técnico: Classe abstrata de entidade de domínio imutável, base para tipos persistíveis do framework.
- O componente técnico Entity (base) pertence estruturalmente a Camada de Domínio.
Extension (base)¶
- O componente técnico Extension (base) materializa o seguinte componente técnico: Classe abstrata da camada de extensão controlada que extensions estendem para implementar register() e boot(), registrando controllers, services, hooks e filters no kernel.
- O componente técnico Extension (base) pertence estruturalmente a API Pública.
Facade¶
- O componente técnico Facade materializa o seguinte componente técnico: 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.
- O componente técnico Facade pertence estruturalmente a API Pública.
- O componente técnico Facade mantém relação com Contract.
Filter¶
- O conceito Filter define o seguinte recorte conceitual: 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.
- O conceito Filter aprofunda conceitualmente Mecanismo Reativo.
Formulários Customizados (customform)¶
- O componente técnico Formulários Customizados (customform) materializa o seguinte componente técnico: Extensão para coleta de dados e automação via formulários dinâmicos.
- O componente técnico Formulários Customizados (customform) pertence estruturalmente a Gestão e Operação.
Gerador de Documentos (customdocs)¶
- O componente técnico Gerador de Documentos (customdocs) materializa o seguinte componente técnico: Extensão para emissão dinâmica de certificados e contratos personalizados.
- O componente técnico Gerador de Documentos (customdocs) pertence estruturalmente a Gestão e Operação.
Gerenciador de Arquivos (manage_files)¶
- O componente técnico Gerenciador de Arquivos (manage_files) materializa o seguinte componente técnico: Extensão que fornece repositório único de documentos e arquivos do Moodle.
- O componente técnico Gerenciador de Arquivos (manage_files) pertence estruturalmente a Conteúdo e Aprendizagem.
Histórico de Matrículas (enrolment)¶
- O componente técnico Histórico de Matrículas (enrolment) materializa o seguinte componente técnico: Extensão que gerencia o ciclo de vida completo do aluno, da inscrição à conclusão.
- O componente técnico Histórico de Matrículas (enrolment) pertence estruturalmente a Gestão e Operação.
Hook¶
- O conceito Hook define o seguinte recorte conceitual: 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.
- O conceito Hook aprofunda conceitualmente Mecanismo Reativo.
Hub de E-commerce (ecommerce)¶
- O componente técnico Hub de E-commerce (ecommerce) materializa o seguinte componente técnico: Extensão de vendas e matrículas automáticas integradas ao Moodle.
- O componente técnico Hub de E-commerce (ecommerce) pertence estruturalmente a Integrações e Dados.
Import Repository¶
- O componente técnico Import Repository materializa o seguinte componente técnico: 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.
- O componente técnico Import Repository pertence estruturalmente a Camada de Infraestrutura.
- O componente técnico Import Repository faz a mediação entre Camada de Infraestrutura e Item no contexto de Camada de Infraestrutura.
- O componente técnico Import Repository opera sobre Item.
Integração Looker Studio (lookerstudio)¶
- O componente técnico Integração Looker Studio (lookerstudio) materializa o seguinte componente técnico: Extensão que embeda dashboards do Google Looker Studio no ambiente Moodle.
- O componente técnico Integração Looker Studio (lookerstudio) pertence estruturalmente a Dashboards e Relatórios.
Item¶
- A entidade Item materializa o seguinte objeto operacional: 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.
- A entidade Item materializa operacionalmente Camada de Domínio.
Job¶
- A entidade Job materializa o seguinte objeto operacional: 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.
- A entidade Job materializa operacionalmente Camada de Aplicação.
Kernel¶
- O componente técnico Kernel materializa o seguinte componente técnico: Coordenador do bootstrap do framework: inicializa o container, descobre recursos, executa o lifecycle das extensions e compila o grafo de serviços.
- O componente técnico Kernel pertence estruturalmente a Camada de Kernel.
- O componente técnico Kernel faz a mediação entre Camada de Kernel e Container, Extension (base) no contexto de Camada de Kernel.
- O componente técnico Kernel opera sobre Container.
- O componente técnico Kernel mantém relação com Extension (base).
Limpeza de Progresso (cleaner)¶
- O componente técnico Limpeza de Progresso (cleaner) materializa o seguinte componente técnico: Extensão para reinício de cursos e reciclagem de progresso do aluno.
- O componente técnico Limpeza de Progresso (cleaner) pertence estruturalmente a Gestão e Operação.
Mapper¶
- O componente técnico Mapper materializa o seguinte componente técnico: 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.
- O componente técnico Mapper pertence estruturalmente a Camada de Infraestrutura.
Monitoramento Sentry (sentry)¶
- O componente técnico Monitoramento Sentry (sentry) materializa o seguinte componente técnico: Extensão de rastreamento de erros e monitoramento de performance via Sentry.
- O componente técnico Monitoramento Sentry (sentry) pertence estruturalmente a Integrações e Dados.
Open Graph (opengraph)¶
- O componente técnico Open Graph (opengraph) materializa o seguinte componente técnico: Extensão que personaliza meta tags Open Graph para compartilhamento social.
- O componente técnico Open Graph (opengraph) pertence estruturalmente a Engajamento e Comunicação.
Painéis de Gestão (dashboard)¶
- O componente técnico Painéis de Gestão (dashboard) materializa o seguinte componente técnico: Extensão de métricas nativas e dashboards administrativos dentro do Moodle.
- O componente técnico Painéis de Gestão (dashboard) pertence estruturalmente a Dashboards e Relatórios.
Plano de Estudos (studyplan)¶
- O componente técnico Plano de Estudos (studyplan) materializa o seguinte componente técnico: Extensão que gera cronogramas automáticos de estudo para o aluno.
- O componente técnico Plano de Estudos (studyplan) pertence estruturalmente a Conteúdo e Aprendizagem.
Privacy Repository¶
- O componente técnico Privacy Repository materializa o seguinte componente técnico: 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.
- O componente técnico Privacy Repository pertence estruturalmente a Camada de Infraestrutura.
- O componente técnico Privacy Repository faz a mediação entre Camada de Infraestrutura e Audit, Item no contexto de Camada de Infraestrutura.
- O componente técnico Privacy Repository opera sobre Audit, Item.
Repository¶
- O componente técnico Repository materializa o seguinte componente técnico: 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).
- O componente técnico Repository pertence estruturalmente a Camada de Infraestrutura.
Revision¶
- A entidade Revision materializa o seguinte objeto operacional: 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?".
- A entidade Revision materializa operacionalmente Camada de Domínio.
- A entidade Revision faz a mediação entre Camada de Domínio e Item no contexto de Camada de Domínio.
- A entidade Revision depende de Item.
Schedule¶
- O conceito Schedule define o seguinte recorte conceitual: 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.
- O conceito Schedule aprofunda conceitualmente Camada de Aplicação.
- O conceito Schedule dispara Command.
Segmentação Inteligente (smartfilters)¶
- O componente técnico Segmentação Inteligente (smartfilters) materializa o seguinte componente técnico: Extensão de listas dinâmicas de usuários filtrados por critérios configuráveis.
- O componente técnico Segmentação Inteligente (smartfilters) pertence estruturalmente a Engajamento e Comunicação.
Service¶
- O componente técnico Service materializa o seguinte componente técnico: Camada de lógica de aplicação que orquestra repositórios, entidades e signals para executar casos de uso.
- O componente técnico Service pertence estruturalmente a Camada de Aplicação.
Signal¶
- O evento Signal registra a seguinte ocorrência reconhecida: 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.
- O evento Signal pertence estruturalmente a Mecanismo Reativo.
- O evento Signal mantém relação com Audit, Hook.
Tradução de Conteúdos (translate)¶
- O componente técnico Tradução de Conteúdos (translate) materializa o seguinte componente técnico: Extensão de internacionalização e tradução de cursos no Moodle.
- O componente técnico Tradução de Conteúdos (translate) pertence estruturalmente a Conteúdo e Aprendizagem.
Transaction Manager¶
- O componente técnico Transaction Manager materializa o seguinte componente técnico: 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.
- O componente técnico Transaction Manager pertence estruturalmente a Camada de Infraestrutura.
- O componente técnico Transaction Manager faz a mediação entre Camada de Infraestrutura e Repository no contexto de Camada de Infraestrutura.
- O componente técnico Transaction Manager mantém relação com Repository.
Trilhas de Aprendizagem (trilha)¶
- O componente técnico Trilhas de Aprendizagem (trilha) materializa o seguinte componente técnico: Extensão que implementa caminhos guiados e sequenciais de estudo.
- O componente técnico Trilhas de Aprendizagem (trilha) pertence estruturalmente a Conteúdo e Aprendizagem.
Validação de Perfil (forceprofile)¶
- O componente técnico Validação de Perfil (forceprofile) materializa o seguinte componente técnico: Extensão que impõe obrigatoriedade de dados cadastrais no perfil do usuário.
- O componente técnico Validação de Perfil (forceprofile) pertence estruturalmente a Gestão e Operação.
Webhooks (webhooks)¶
- O componente técnico Webhooks (webhooks) materializa o seguinte componente técnico: Extensão de notificações evento-driven em tempo real para sistemas externos.
- O componente técnico Webhooks (webhooks) pertence estruturalmente a Integrações e Dados.