Skip to content

Estrutura do Arquivo de Disciplina (Word)

Estrutura do Arquivo de Disciplina (Word)

Referência técnica

A estrutura descrita aqui segue o que o parser de importação lê hoje. Para as chaves exatas, exemplos e validações, veja o Guia Técnico do Arquivo Word.

Risco crítico: Alteração do IDNUMBER

Alterar o IDNUMBER do Arquivo de Disciplina (Word) por descuido quebra a rastreabilidade algorítmica entre a Base de Conteúdo e os Planos de Estudo já publicados: o sistema trata o arquivo como outra Disciplina, sem vínculo com a anterior. Antes de qualquer edição no IDNUMBER, confirme com o Gestor Pedagógico e com a equipe de Desenvolvimento.

Contexto: do SharePoint à Base de Conteúdo

O Arquivo de Disciplina (Word) é o artefato central de autoria pedagógica na HÉLICO. Ele é mantido no repositório SharePoint pelo Conteudista e constitui a ponte entre o trabalho editorial humano e a Base de Conteúdo consumida pela plataforma.

O fluxo conceitual dessa ponte funciona assim:

  1. O Conteudista elabora e atualiza o Word no SharePoint.
  2. O Gestor Pedagógico realiza a revisão pedagógica.
  3. A Publicação Pedagógica oficializa as alterações.
  4. A Sincronização Pedagógica SharePoint transporta as mudanças para a Base de Conteúdo ativa.
  5. O conteúdo fica disponível para seleção em Trilhas Pedagógicas.
  6. Um Registro de Alteração Pedagógica é gerado para rastreabilidade.

Diagrama do fluxo conceitual

{{ mermaid_include(“assets/diagrams/metodologia/importacao-word/visao-geral/fluxo-conteudo.mermaid”) }}

Papel pedagógico do Arquivo de Disciplina

Dimensão Função
Conteúdo Organizar Unidades e Material Didático de forma uniforme e estruturada
Rastreabilidade Preservar vínculo com IDNUMBER e histórico de Registro de Alteração Pedagógica
Qualidade Permitir revisão por regra estruturada, checklist e Contrato Estrutural do Word
Gestão de Alterações Viabilizar Publicação Pedagógica com responsabilização clara e rastreabilidade algorítmica

Hierarquia do conteúdo dentro do Word

O Arquivo de Disciplina segue uma hierarquia fixa que espelha a estrutura da Base de Conteúdo:

Nível do Word Elemento da Base de Conteúdo Marcação obrigatória
Arquivo inteiro Disciplina Nome do arquivo: [IDNUMBER] Nome da Disciplina.docx, com _ no IDNUMBER (ex.: [DC_001])
Parágrafo UNIDADE Nº <n> Unidade Um por Unidade; vale o texto, não o estilo
Parágrafo [U<n>_T<n>] Tópico de Conteúdo Um por Tópico; chave <IDNUMBER>_U<n>_T<n>
Estilo Título 2 / Heading 2 Título do Tópico Obrigatório em cada Tópico
Estilo Título 3 / Heading 3 Subtítulo do Tópico (opcional) Detalhamento sem romper estrutura
Tag-Colchete Componentes do Material Didático Ex: [QUADRO_GERAL_DE_INFORMACOES], [[VF_Q01]], [[OBJ_Q01]], [DISC_Q01]

O detalhamento completo das regras fica em Contrato Estrutural do Word. O catálogo completo de Tag-Colchete fica em Catálogo de Tags e Componentes. A leitura chave a chave, com exemplos e validações, está no Guia Técnico do Arquivo Word.

Proteção do Aluno em execução

Quando o Conteudista altera o Word, essa alteração não alcança diretamente os Alunos que já estão em execução. A proteção funciona assim:

  1. Durante a geração do Fluxo de Estudo, o Acionamento de Unidade resolve a Versão Ativa e a configuração herdada pelo Plano do Aluno.
  2. O sistema reutiliza um Snapshot de Unidade se Unidade, versão do conteúdo e configuração coincidirem; caso contrário, cria outro. Snapshots compatíveis podem ser compartilhados entre Planos de Estudo.
  3. O acionamento não altera o ciclo atual, e Snapshots já vinculados permanecem intactos após alterações posteriores no Word.

Essa mecânica é detalhada em Ciclo de Alterações do Word.

Prós e contras da padronização

Aspecto Prós Contras
Consistência Reduz variação de estrutura entre Disciplinas Exige aderência estrita da equipe
Escala Facilita manutenção de grande volume de Unidades Aumenta custo inicial de capacitação
Gestão de Alterações Melhora rastreabilidade e tomada de decisão Necessita rotina formal de revisão

Ponto de fronteira

Esta subpasta define regras pedagógicas e semânticas do Word. O de-para técnico para modelagem de sistema é tratado fora da metodologia.

FAQ local — Estrutura do Arquivo Word

O arquivo Word pode variar livremente por disciplina?

Não. O conteúdo pode variar, mas a estrutura semântica e as regras de marcação devem seguir o Contrato Estrutural do Word.

O Word substitui a gestão de alterações na publicação?

Não. O Word é artefato central, mas a decisão de publicação depende do fluxo de Registro de Alteração Pedagógica e aprovação do Gestor Pedagógico.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close