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
IDNUMBERdo 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 noIDNUMBER, 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:
- O Conteudista elabora e atualiza o Word no SharePoint.
- O Gestor Pedagógico realiza a revisão pedagógica.
- A Publicação Pedagógica oficializa as alterações.
- A Sincronização Pedagógica SharePoint transporta as mudanças para a Base de Conteúdo ativa.
- O conteúdo fica disponível para seleção em Trilhas Pedagógicas.
- 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:
- 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.
- 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.
- 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.