📖 Manual de uso
Guia completo do Relatinho — do cadastro à geração dos relatórios.
1. O que é o sistema
O Relatinho gera os relatórios individuais das crianças em arquivo Word (.docx), já com o cabeçalho, logo e rodapé exatos da escola.
A ideia é simples: você cadastra os dados uma única vez e o sistema cuida da parte repetitiva.
- Acaba a redigitação de nome, data de nascimento, turma, idade, sexo, turno…
- A idade é calculada automaticamente pela data de nascimento.
- Você escreve o relato de cada criança e gera todos os documentos de uma vez.
2. Como abrir o sistema
Abra o navegador (Chrome, Edge…) e acesse o endereço do sistema. Funciona no computador e no celular.
No topo da tela há sempre três áreas no menu:
- Turmas — onde você cadastra turmas, alunos, escreve relatos e gera os documentos.
- Modelos — onde fica o documento (.docx) da escola que serve de base.
- Manual — esta página de ajuda.
3. Passo a passo (uso no dia a dia)
Confira o modelo da escola
Em Modelos, deve haver um modelo marcado como ATIVO. É ele que define o layout dos relatórios. (Já deixamos o modelo oficial da escola ativo.)
Crie a turma
Em Turmas → + Nova turma, informe nome (ex.: “Maternal II A”), ano letivo, turno e a professora. Salve.
Adicione os alunos
Dentro da turma, clique em + Adicionar aluno e informe nome, data de nascimento e sexo. Faça isso uma vez por aluno — os dados ficam salvos para os próximos semestres.
Escolha o semestre e escreva os relatos
No topo da turma, escolha o Semestre e o Ano e clique em Aplicar. Depois, em cada aluno, clique em Escrever relato, digite o texto e salve. Quem já tem relato aparece com ✔ Preenchido.
Gere os documentos
Clique em ⬇️ Gerar todos (.docx ZIP) para baixar um arquivo .zip
com um documento por aluno — ou no .docx ao lado de um aluno para gerar só o dele.
Abra no Word, revise, imprima e colha as assinaturas.
.zip é uma “pasta compactada”. Para abrir os documentos: clique com o botão direito → Extrair tudo.
4. O modelo .docx e os marcadores
O modelo é o documento da escola (com cabeçalho, logo e rodapé). Onde entram os dados,
ele usa marcadores — palavrinhas entre ${ }.
Ao gerar, o sistema troca cada marcador pelo dado real da criança. O layout da escola é 100% preservado.
| Marcador | Vira… |
|---|---|
| ${NOME} | Nome do aluno |
| ${TURMA} | Turma |
| ${IDADE} | Idade calculada (ex.: 4 anos e 2 meses) |
| ${DATA_NASC} | Data de nascimento |
| ${SEXO} | Masculino / Feminino |
| ${TURNO} | Manhã / Tarde / Integral |
| ${ANO} | Ano letivo |
| ${RELATO} | Texto do relato |
| ${DATA_RELATORIO} | Data de hoje |
O modelo oficial da escola já vem com esses marcadores nos lugares certos. Você normalmente não precisa mexer neles.
5. E se a diretora mudar o layout?
🎨 Mudou só o visual (cores, logo, posições, textos do cabeçalho/rodapé)
É o caso mais comum e não precisa de programador. Passo a passo:
- A diretora altera o documento Word como quiser.
- Garanta que os marcadores ${...} continuem no lugar dos dados.
- Em Modelos, clique em enviar, escolha o novo arquivo e clique em Ativar.
Pronto: os próximos relatórios já saem no layout novo.
✅ Dica de ouro: guarde um “arquivo-mestre”
Use sempre o arquivo que já contém os marcadores como base. Quando precisar mudar o layout, edite esse mesmo arquivo (mantendo os ${...}) e reenvie. Assim os marcadores viajam junto e você nunca mais precisa recolocá-los.
🧱 Mudou a estrutura de dados (ex.: passou a pedir “Nº de matrícula”)
Aí é preciso um pequeno ajuste no sistema (novo campo + novo marcador) — fale com quem dá manutenção. Campos removidos não dão problema: o marcador que não for usado é simplesmente ignorado.
6. Dicas e problemas comuns
- Um marcador não foi substituído (saiu ${NOME} no documento)?
No Word, ele provavelmente foi “quebrado” por formatação. Apague e digite o marcador de novo, de uma vez só, sem mudar negrito/itálico no meio dele. - A idade saiu errada?
Confira a data de nascimento do aluno (a idade é calculada a partir dela). - Esqueci de escrever o relato de alguém.
Sem problema: o documento é gerado mesmo assim, só com o espaço do relato em branco. Você completa depois e gera de novo. - Quero corrigir um texto depois de gerar.
Pode editar direto no Word, ou ajustar o relato no sistema e gerar novamente — é rápido. - Os dados ficam guardados?
Sim. No próximo semestre/ano, os alunos já estão lá; basta escrever os novos relatos.
Ficou com dúvida? Volte a este manual pelo menu Manual a qualquer momento. 💜