Ciclo de Alterações do Word
EM CONSTRUÇÃO
Esta página está em construção. O conteúdo atual é um esboço técnico da estrutura geral. A versão final terá mais detalhes, exemplos e explicações.
Contexto
A qualidade da metodologia depende não só da produção de conteúdo, mas da forma como alterações são revisadas, publicadas e comunicadas. Esta página formaliza o ciclo completo: da alteração no Arquivo de Disciplina (Word) até o impacto (ou a ausência de impacto) no Plano do Aluno.
Sem gestão de alterações clara, mudanças relevantes podem ser publicadas sem avaliação de impacto, e a rastreabilidade entre autoria e execução se perde.
Papéis no ciclo de alterações
| Papel | Responsabilidade principal |
|---|---|
| Conteudista | Produção e atualização da Disciplina/Unidade no SharePoint |
| Gestor Pedagógico | Curadoria final, coerência metodológica e decisão de publicação |
| Operação pedagógica | Apoio à comunicação e monitoramento de impacto |
Fluxo conceitual de atualização
{{ mermaid_include(“assets/diagrams/metodologia/importacao-word/ciclo-de-alteracoes-do-word/ciclo-alteracoes.mermaid”) }}
O fluxo segue esta lógica:
- O Conteudista atualiza o Arquivo de Disciplina (Word) no SharePoint.
- O Gestor Pedagógico realiza a revisão pedagógica.
- O sistema avalia se a alteração é relevante (impacto em fluxo, avaliação, pré-requisito ou carga).
- Se relevante: gera Registro de Alteração Pedagógica e relatório antes de publicar.
- A Publicação Pedagógica oficializa as mudanças.
- A Sincronização Pedagógica SharePoint transporta as alterações para a Base de Conteúdo.
- O sistema avalia se é necessário comunicar ao Aluno.
Relatório de Alterações do Gestor
Em definição
Esta seção descreve o fluxo especificado no epic
moodle-local_helico#118. A primeira entrega cobre o relatório e o registro da decisão do Gestor. O efeito da decisão sobre o conteúdo dos Alunos é uma fase posterior e ainda não está implementado.
Depois do processamento do Word, o Gestor Pedagógico usa o Relatório de Alterações, no Moodle, para ver o que mudou em cada Unidade. O relatório compara o conteúdo em uso com o conteúdo mais recente, item a item, e mostra a diferença em texto, em linha ou lado a lado.
O que aparece:
- Tópicos, cada um pela sua chave (
U001_T01,U001_T02…); - Questões VF, objetivas e escritas, cada uma pela sua chave (
VF_Q01,OBJ_Q07,DISC_Q01…); - Informações gerais (visão geral, legislação, jurisprudência) e vídeo.
Cada item é decidido inteiro: não há mistura de parte do texto antigo com parte do novo. Flashcards e áudios não fazem parte do relatório; continuam sendo gerados pelo botão da versão do arquivo da Disciplina, e o relatório apenas avisa, ao lado de cada tópico alterado, que áudio e flashcards ainda não foram regenerados.
Para cada item o Gestor escolhe:
| Ação | O que significa |
|---|---|
| Aprovar | Registra que a mudança foi revista e aceita. Nesta fase, o sistema só registra a decisão; nada muda ainda para o Aluno. |
| Arquivar | Deixa o item sem ação. Fica guardado e pode ser aprovado depois. |
A escolha pode ser feita item a item ou para toda a Disciplina ou Unidade de uma vez. Unidade sem mudança não aparece no relatório.
Como as questões serão tratadas (fase posterior)
| Mudança na questão | Nota do Aluno |
|---|---|
| O gabarito mudou | Recalculada |
| Só o texto (uma palavra, redação) | Mantida |
| A questão foi removida do Word | A questão permanece para quem já a viu; nota mantida |
| Questão escrita | Nunca recalcula; o texto também é atualizado onde o professor corrige |
Para tópicos, o Caderno Online do Aluno contém as anotações e edições dele, e a aprovação do Gestor não as altera. Na fase posterior, o Aluno que tem artefato do tópico no Caderno recebe uma oferta e decide se leva o texto novo para o próprio Caderno; ao aceitar, a versão anterior fica guardada.
Sincronização Pedagógica SharePoint
A Sincronização Pedagógica SharePoint é o processo que faz a ponte entre a autoria (SharePoint/Word) e a Base de Conteúdo ativa na plataforma. Ela:
- transporta as alterações revisadas para a Base de Conteúdo;
- atualiza a Versão Ativa de cada Unidade afetada;
- classifica a alteração como Alteração de Conteúdo quando não houver conflito estrutural;
- gera Notificação de Alteração de Conteúdo quando necessário;
- preserva a execução já iniciada por meio de Snapshot de Unidade.
Proteção do Aluno: Versão Ativa, Acionamento e Snapshot
Este é o mecanismo central que garante estabilidade ao estudo já em andamento:
| Etapa | O que acontece | Quem é afetado |
|---|---|---|
| Alteração no Word | O Conteudista modifica o conteúdo. A Base de Conteúdo ainda não é afetada. | Ninguém |
| Sincronização Pedagógica SharePoint | A alteração é transportada para a Base de Conteúdo. A Versão Ativa da Unidade é atualizada. | Novos Acionamentos de Unidade consumirão a versão atualizada |
| Geração do Fluxo de Estudo e Acionamento de Unidade | O sistema resolve a Versão Ativa e a configuração herdada; reutiliza Snapshot compatível ou cria outro conforme Unidade + hash do conteúdo ativo + hash da configuração | O fluxo gerado; o ciclo atual não é alterado |
| Aluno já em execução | O Snapshot anterior permanece intacto. O Aluno continua consumindo sua versão congelada. | Nenhum Aluno em execução é afetado retroativamente |
A Versão Ativa não alcança Snapshots já criados
Um Snapshot de Unidade já vinculado a um acionamento não é atualizado por sincronizações posteriores. A geração de um Fluxo de Estudo posterior consulta a Versão Ativa e a configuração herdada e pode criar outro Snapshot se a combinação diferir. Isso não altera o ciclo atual e preserva a coerência do histórico, do Caderno Online e das Métricas de Desempenho.
Conflito com Trilha Pedagógica
Nem toda alteração no Word é uma simples atualização de conteúdo. Quando a mudança afeta a estrutura (ex: remoção de Unidade, alteração de IDNUMBER, mudança de Pré-requisito de Unidade), o sistema pode detectar um Conflito com Trilha Pedagógica.
| Tipo de alteração | Classificação | Efeito |
|---|---|---|
| Atualização de texto, melhoria editorial, ajuste de conteúdo | Alteração de Conteúdo | Sincroniza normalmente. Sem conflito. |
| Remoção de Unidade que está selecionada em Trilha publicada | Conflito com Trilha Pedagógica | Trava publicação de novos Planos de Estudo. Exige decisão do Gestor Pedagógico. |
Alteração do IDNUMBER da Disciplina |
Conflito com Trilha Pedagógica | Quebra rastreabilidade. Trava publicação. |
| Mudança de Pré-requisito que gera dependência circular | Conflito com Trilha Pedagógica | Impede geração válida da Sequência do Plano de Estudo. |
Conflito com Trilha Pedagógica trava a publicação
Quando detectado, o Conflito com Trilha Pedagógica impede imediatamente a publicação de novos Planos de Estudo vinculados à Disciplina afetada. Somente o Gestor Pedagógico pode resolver o conflito, seja revertendo a alteração, seja ajustando a Trilha Pedagógica para acomodar a mudança estrutural.
Versionamento pedagógico
Disciplina
- Alteração estrutural ampla pode gerar nova referência de Disciplina (novo
IDNUMBER), o que na prática significa um novo artefato. - Alteração incremental sem ruptura mantém referência vigente com novo Registro de Alteração Pedagógica.
Unidade
- Atualizações de conteúdo podem ocorrer por nova Sincronização Pedagógica SharePoint, atualizando a Versão Ativa.
- Mudanças que alteram fluxo, avaliação ou Pré-requisito de Unidade exigem análise de relevância pedagógica e podem gerar Conflito com Trilha Pedagógica.
Critérios de relevância para comunicação ao Aluno
| Tipo de mudança | Relevância típica | Ação sugerida |
|---|---|---|
| Ajuste editorial sem impacto de estudo | Baixa | Registrar, sem comunicação ampla |
| Inclusão/remoção de Tópico de Conteúdo central | Alta | Registrar e comunicar |
| Mudança de questão avaliativa crítica | Alta | Registrar e comunicar |
| Mudança de Pré-requisito de Unidade com bloqueio | Alta | Registrar e comunicar |
Escopo
Esta gestão de alterações descreve quem, quando e por que sincronizar/publicar. O processo técnico de integração não faz parte da metodologia.
Pendência: limiar de relevância
Qual limiar objetivo define alteração relevante para comunicação obrigatória ao Aluno: impacto em fluxo, em avaliação, em carga horária ou combinação desses fatores? No Relatório de Alterações a decisão é do Gestor, item a item; falta definir se existe um corte a partir do qual toda mudança aprovada deve ser oferecida ao Aluno.
FAQ local — Ciclo de Alterações do Word
Toda atualização exige relatório?
Não. O relatório é exigido para alterações com relevância pedagógica, conforme critério de impacto definido pelo Gestor Pedagógico.
O Gestor decide o que fazer com cada alteração?
Sim. No Relatório de Alterações o Gestor aprova ou arquiva cada item. A decisão é sempre do Gestor, nunca do sistema. Ver a seção “Relatório de Alterações do Gestor”, ainda em definição.
Quem aprova publicação final?
A aprovação final é do Gestor Pedagógico, com base na revisão do Conteudista e nos Registros de Alteração Pedagógica.
Uma alteração no Word pode afetar Alunos já em execução?
Não diretamente. Snapshots já vinculados a acionamentos existentes permanecem congelados, e a atualização não altera o ciclo atual. Em uma geração posterior de Fluxo de Estudo, Unidades ainda não acionadas são resolvidas pela Versão Ativa atual e pela configuração herdada; um Snapshot equivalente pode ser reaproveitado, inclusive entre Planos de Estudo.