01 · Ativar o módulo a partir do Piztu
O Tao não vem «dentro» do Piztu. É um módulo externo: uma aplicação independente com um ficheiro modulo.json que o Piztu descobre na pasta de módulos. Isso é importante para entender o resto: o Piztu limita-se a encontrá-lo, mostrá-lo e lançá-lo.
Para que apareça no Piztu vou a ⚙ Sala de aula → Módulos. Aí vejo tanto os módulos já instalados como os do catálogo. Marco a sua caixa para ativá-lo. O estado é guardado nas definições do Piztu, portanto sobrevive a reinicializações.
Ao ativá-lo, aparece o botão do Tao na barra do Piztu. Um detalhe que convém saber logo no primeiro dia: ao premi-lo, o Piztu fecha-se e fica o Tao no ecrã. Não é uma falha: o Tao é uma aplicação de ecrã inteiro que substitui o mapa, não um acompanhante. Se o quiser abrir sem fechar o Piztu, use Ctrl + clique.
02 · Instalar o Tao nos computadores dos alunos
Até aqui o Tao só está no computador do professor. Os alunos precisam do seu próprio Tao em cada posto, pois será o software que lhes permitirá responder às práticas ou servirá de programa para guardar as práticas em edição e por terminar. O instalador do Piztu já o faz uma vez (Passo 8), mas chegam sempre computadores novos, reinstalações e o portátil que nesse dia não estava ligado. Para isso existe uma ação a quente a partir do mapa:
- O botão ⚙ da linha do Tao dentro de ⚙ Sala de aula → Módulos, ou
- Uma pressão longa (3 s) sobre o próprio botão do Tao na barra.
03 · Para que serve realmente
O Tao é o caderno de aula dos alunos, mas em formato digital e verificável. Cada aluno entra com o seu utilizador e dispõe, por disciplina, de:
- Registo diário em Markdown (com pré-visualização e imagens): o que fez hoje, com que problemas se deparou e como os resolveu.
- Ficheiros de trabalho anexados à sessão.
- Mensagens com o professor e ocorrências (positivo, negativo, expulsão, falta de ordem). Estas últimas são visíveis para o aluno de propósito: se registo algo, quero que ele saiba.
- Calendário e planificação da disciplina: posso mesmo colar o URL da portaria do DOG e o Tao extrai o início, o fim e os períodos não letivos para preencher a tabela (que depois revejo à mão, já que o DOG muda de redação todos os anos).
E uma decisão de arquitetura fundamental para a manutenção: não há base de dados. É tudo ficheiros num servidor File Browser. Uma cópia de segurança consiste, simplesmente, em copiar uma pasta.
04 · A assinatura digital como recurso didático
Esta é a parte sobre a qual os colegas mais me perguntam. Os alunos não entregam um PDF qualquer: entregam um PDF assinado criptograficamente com o seu próprio certificado.
Como obtêm um certificado
Existe uma autoridade de certificação (CA) do departamento. Quando o aluno muda a sua palavra-passe, o Tao gera para ele um certificado pessoal assinado por essa CA, empacota-o como .p12 protegido por palavra-passe e envia-o para a sua pasta no servidor. Não há formalidades, não há FNMT nem papéis: é totalmente transparente para os alunos e acontece no seu próprio computador.
Como assina uma prática
No relatório, o aluno escolhe o âmbito, revê o conteúdo e carrega em assinar. O Tao renderiza o PDF, acrescenta a assinatura na vertical na margem esquerda de cada página com a data, assina-o com PAdES e envia-o para o servidor. O nome do signatário é lido diretamente do certificado.
Porque dificulta o copiar e colar
O relatório não é guardado no ambiente de trabalho para depois ser enviado por qualquer via: é publicado no servidor, assinado, com a data da sessão e com os checksums SHA-256 dos ficheiros enviados nesse dia. Um trabalho copiado de um colega pode continuar a ser copiado, mas já não pode ser apresentado como próprio sem que a assinatura, a data e o hash contradigam a história. E, sobretudo, obriga a algo muito didático: para assinar é preciso escrever o que se fez, sessão a sessão, enquanto se faz.
Na prática, o efeito na sala de aula é mais pedagógico do que policial. Os alunos entendem que assinar é um ato com consequências e aprendem na prática conceitos fundamentais: chave privada, autoridade de certificação, integridade e não repúdio.
Honestidade técnica
⚠️ A CA do departamento vai integrada no binário cliente. Quem extrair o binário pode obter a chave e falsificar certificados. É um método aceitável para uma implantação interna e de confiança dentro da escola, mas não para um uso com validade legal externa. Explico-o assim aos alunos: é um ensaio real de um sistema real, não um cartão de cidadão eletrónico.
05 · Conteúdos individualizados com o Yang
Se cada um assina o seu trabalho, o passo seguinte é óbvio: que cada um tenha o seu próprio enunciado. É aí que entra o Yang, o gerador de exercícios parametrizados com Maxima e LaTeX. O Yang é uma aplicação independente, mas quando é aberto a partir do Tao recebe um contexto e o circuito fecha-se sozinho:
- Tao: na sessão do dia escolhe-se «Editar com o Yang», enviando-lhe a disciplina, a data e a lista de alunos.
- Yang: sugere tantas iterações quantos os alunos e gera essas variantes do exercício, cada uma com dados diferentes.
- Yang: através da opção Distribuir, associa cada variante gerada a um aluno real da lista.
- Tao: cada aluno encontra a sua tarefa na sua sessão. Ninguém tem o mesmo enunciado que o colega do lado.
Quando alguém precisa de uma adaptação (um enunciado mais guiado, outro contexto ou uma ampliação), não é preciso partir nada: dentro do editor desse aluno seleciona-se «Editar com o Yang» individual. O Yang deteta que só está a editar uma pessoa e oculta o botão de distribuir; o conteúdo gerado vai diretamente para esse aluno.
Acoplamento zero
Se abrir o Yang de forma independente (a partir do mapa do Piztu ou à mão), não há contexto do Tao e a opção de «enviar para o Tao» não é mostrada. Continua a ser o gerador de exames habitual. Um módulo não deve mudar de comportamento consoante quem o vê, mas sim consoante quem o abriu.
Com isto ganha-se tempo a sério. Preparar trinta enunciados diferentes à mão é inviável; preparar um enunciado parametrizado e distribuí-lo demora uns minutos. Além disso, desaparece a discussão do «a mim calhou-me mais difícil»: a estrutura é a mesma para todos.
06 · Os relatórios do professor
Os alunos geram relatórios assinados do seu trabalho com cinco âmbitos possíveis:
| Âmbito | Quando se usa na aula |
|---|---|
| Sessão | Práticas de uma só sessão (entrega do dia). |
| Semana | Acompanhamento habitual em cursos profissionais. |
| Entre datas | Um projeto que não encaixa no calendário regular. |
| Unidade | Encerramento de unidade didática, com a sua numeração e título. |
| Avaliação | Entrega global do período. |
Por outro lado, os Relatórios de Acompanhamento do professor são os que mais tempo poupam. O Tao guarda um registo por sessão (o trabalho realizado ou a causa de não a haver: greve, visita de estudo, ausência) e constrói:
- Análise de temporização: sessões planeadas face às reais por unidade, indicando o grau de cumprimento (alto / médio / baixo). É exatamente o que se pede nos departamentos e que antes se fazia de memória no fim do ano.
- Acompanhamento por unidade didática: objetivos, conteúdos, critérios de avaliação, desvios e propostas de melhoria.
- Registo mensal da aula com o detalhe das sessões do mês.
- Relatório fundamentado redigido a partir do registo, exportável para PDF, ODT ou DOCX para incorporar no relatório do departamento.
07 · O que o Tao não faz
O Tao guarda informação sensível: quem está em que computador, o histórico de sessões, ocorrências e trabalhos. Por isso, o resto do ecossistema não tem acesso a ela:
- A API do Piztu para módulos nunca expõe os dados do Tao; esse código nem sequer importa o pacote do Tao.
- O Xesta (o assistente de IA que gera scripts de administração) está completamente isolado deste circuito, por ser uma ferramenta de administração.
- Quando um módulo precisa de saber quem está em cada computador (como o Pancho para os relatórios de inventário), a via correta é pedir as credenciais ao professor nesse momento, sem usar credenciais de administrador embebidas.
- Para passar práticas a uma IA que ajude na correção, o Tao prepara uma cópia anonimizada: cada aluno fica numa pasta identificada por um UUID interno, mantendo a tabela de equivalências fora dessa pasta.