⚡ Admin EBD · Gestão completa

🏗️ 1. Arquitetura atual do sistema

• O site e o painel são publicados no GitHub Pages.
• As lições são salvas na Hostinger, dentro da pasta escala-ebd-api.
• A escala e os demais dados administrativos continuam no Google Sheets, acessados pelo Apps Script.
• Não apague nem substitua manualmente storage/licoes.json quando já houver lições cadastradas.
• O arquivo config.php guarda a senha da API e os domínios autorizados.

Arquivos da API na Hostinger

• .htaccess
• config.php
• licoes.php
• storage/.htaccess
• storage/licoes.json

📚 2. Como escolher a aba de lições

1. Clique em Lições interativas.
2. Abra a aba Jovens e Adultos ou Adolescentes.
3. Escolha um dos três formatos: Conteúdo HTML, Link externo individual ou Programação trimestral.
4. Configure somente a aba que deseja alterar.
5. Antes de salvar, confira se a outra aba não ficou em programação trimestral vazia.

Chaves internas usadas pelo sistema

• adultos = aba Jovens e Adultos
• jovens = aba Adolescentes

✍️ 3. Formato “Conteúdo HTML”

1. Em Formato da lição, escolha Conteúdo HTML.
2. Edite diretamente no Editor visual ou clique em HTML avançado.
3. Use Atualizar prévia para sincronizar o HTML com o editor visual.
4. Use Limpar somente quando quiser apagar todo o conteúdo daquela aba.
5. Clique em Salvar lições na Hostinger.

O botão Salvar sincroniza automaticamente o editor visual e o campo HTML.

🔗 4. Formato “Link externo individual”

1. Escolha Link externo individual.
2. Cole um endereço completo iniciado por https://.
3. Clique em Salvar lições na Hostinger.
4. Abra o site público e teste o botão da lição.

O link abre em nova aba. Endereços HTTP, javascript:, data: e URLs com usuário/senha embutidos são bloqueados.

📆 5. Programação trimestral das 13 lições

1. Escolha Programação trimestral (até 13 lições).
2. Informe em Data da aula — Lição 1 o domingo da primeira aula.
3. Clique em Gerar 13 datas de aula.
4. Cole os links no campo Colar vários links de uma vez, um por linha.
5. Clique em Distribuir links nas 13 lições.
6. Revise os títulos, as datas e os endereços.
7. Confirme se o resumo mostra 13 de 13 lições programadas.
8. Clique em Salvar lições na Hostinger.

Formatos aceitos na colagem em massa

• Um link HTTPS por linha.
• Título da lição | https://endereco-da-licao.
• Título em uma linha e o link na linha seguinte.

🕛 6. Regra de liberação automática

A data informada na programação é a data da aula. O site libera o link na segunda-feira anterior, às 00h, no horário de Brasília.

• Exemplo: aula no domingo 16/08/2026.
• Liberação automática: segunda-feira 10/08/2026 às 00h.
• A lição permanece ativa até a liberação da próxima.
• Depois da última aula, a Lição 13 continua disponível.

No modo automático, não é necessário entrar semanalmente no painel.

📌 7. Seleção automática ou fixação manual

1. Em Lição exibida no site, deixe Automática, conforme a data para seguir o calendário.
2. Para uma exceção, escolha Fixar manualmente a Lição X.
3. Salve novamente na Hostinger.
4. Quando quiser voltar ao calendário normal, selecione Automática, conforme a data e salve.

A fixação manual interrompe temporariamente a troca automática.

💾 8. Como salvar, carregar e conferir as lições

1. Clique em Salvar lições na Hostinger.
2. Aguarde a mensagem de sucesso.
3. Use Carregar versões atuais para reler o que já está salvo na Hostinger.
4. Abra o site público e atualize a página.
5. Teste o botão da lição em cada classe.

Atenção: “Carregar versões atuais” não salva alterações; ele apenas recarrega os dados já gravados.

📅 9. Como alterar professor em uma data da escala

1. Clique em Gerenciar escala.
2. Na área Alterar professor por data, escolha a data.
3. Escolha a classe.
4. Digite o nome correto do professor.
5. Clique em Salvar alteração.
6. Confira a tabela da escala e o site público.

➕ 10. Como adicionar uma nova data na escala

1. Clique em Gerenciar escala.
2. Vá até Nova data na escala.
3. Escolha a data do domingo.
4. Preencha o professor de cada classe.
5. Clique em Adicionar data.
6. Confira a tabela e o site público.

Ordem correta das classes

1. 1. Cordeirinhos de Cristo
2. 2. Soldadinhos de Cristo
3. 3. Heróis e Amigos
4. 4. Mensageiros de Cristo
5. 5. Vencedores por Cristo
6. 6. Vivendo em Cristo
7. 7. Testemunhas de Cristo
8. 8. Sara
9. 9. Heróis da Fé

Atenção: Suporte não é classe. Suporte é apenas uma função do Ronan.

🗑️ 11. Como remover uma data

1. Clique em Gerenciar escala.
2. Vá até Remover data.
3. Escolha a data.
4. Clique em Remover.
5. Confirme somente se tiver certeza.
6. Confira se a data saiu da tabela e do site público.

Cuidado: remover data apaga aquela linha da escala.

🏷️ 12. Como renomear uma classe

1. Clique em Gerenciar escala.
2. Vá até Renomear classe.
3. Escolha a classe atual.
4. Digite o novo nome.
5. Clique em Renomear.
6. Confira a tabela e o site público.

👥 13. Como adicionar, editar ou inativar professor

Adicionar professor

1. Clique em Professores.
2. Digite o nome na área Novo professor.
3. Escolha a classe preferencial e o status.
4. Adicione uma observação, se necessário.
5. Clique em Adicionar.

Editar ou inativar

1. Selecione o professor em Editar / Inativar.
2. Altere nome, classe, status ou observação.
3. Clique em Salvar alterações.

🔄 14. Como substituir professor na escala

1. Clique em Professores.
2. Na área Substituir professor na escala, escolha quem saiu.
3. Digite ou escolha o novo professor.
4. Escolha a classe e o período da substituição.
5. Defina se deseja inativar o professor antigo.
6. Clique em Substituir.

📌 15. Como mudar professor de classe

1. Clique em Professores.
2. Na área Mudar professor de classe, escolha o professor.
3. Escolha a nova classe.
4. Escolha se deseja aplicar também na escala.
5. Clique em Mudar classe.

🧠 16. Como atualizar os quizzes

1. Clique em Quizzes.
2. Para preparar o trimestre inteiro, abra Programação trimestral dos quizzes.
3. Clique em Preencher datas do próximo trimestre.
4. Cole, em cada domingo, o link de Jovens e Adultos e o link dos Adolescentes.
5. Clique em Salvar programação trimestral. Você pode preencher aos poucos e salvar novamente.
6. Na semana correspondente, o app seleciona automaticamente os links programados.
7. Os dois campos de links manuais continuam disponíveis como reserva para uma substituição rápida.

🗺️ 17. Como usar o Mapa do Site

1. Clique em Mapa do Site.
2. Aguarde mapa-site.html carregar.
3. Use Recarregar mapa, se necessário.
4. Use Abrir em nova aba para visualizar separado.

O mapa pode ser atualizado pelo GitHub Actions quando arquivos importantes forem alterados.

📜 18. Como consultar as alterações feitas no app

1. Clique em Trocas dos professores.
2. O app público não solicita mais senha de alteração. Cada pessoa escolhe o próprio nome e essa identificação é registrada junto com a mudança.
3. O nome fica memorizado naquele aparelho. Em celular compartilhado ou se a pessoa selecionar errado, use Sair no final da página e faça uma nova identificação.
4. Confira quem fez a alteração, o professor da escala, a classe, data original, nova data, professor envolvido e data/hora.
5. Use os filtros por quem fez, professor da escala, classe e período.
6. Elias e Ronan são reconhecidos como superintendentes e podem realizar alterações em nome de qualquer professor pelo app público.
7. Os demais professores ficam vinculados ao próprio nome e só podem solicitar alteração da própria escala.
8. Para reverter uma troca, clique em Desfazer troca e confira o resumo antes de confirmar.
9. O painel somente desfaz quando os professores ainda estão nas posições resultantes daquela troca.
10. Clique em Exportar CSV para baixar a consulta.
11. Use Atualizar para buscar os registros mais recentes no Google Sheets.

Importante: a identificação do usuário é declarada pelo nome escolhido no aparelho. Ela facilita o acompanhamento nesta fase inicial, mas não equivale a uma autenticação individual com senha.

📊 19. Como consultar os acessos ao app

1. Clique em Acessos ao app.
2. Confira quantos acessos ocorreram hoje, quantas identificações apareceram nos últimos 7 dias e qual foi o último acesso.
3. Use os filtros por nome, perfil e período.
4. A tabela mostra o último acesso, quantidade de acessos, dias ativos e se a entrada ocorreu pelo app instalado ou navegador.
5. A área Professores que ainda não acessaram considera os professores ativos cadastrados no painel.
6. Use Exportar CSV para baixar os registros do período selecionado.

Importante: o registro usa a identificação escolhida na entrada. Os perfis Aluno e Diretoria são genéricos e não identificam a pessoa individualmente.

🔔 20. Notificações na barra do celular

1. Configure o projeto Firebase e as propriedades do script conforme o passo a passo da atualização.
2. No painel, abra Notificações e confirme se aparece Firebase configurado ✅.
3. Clique em Instalar automação uma única vez.
4. Cada professor deve tocar em Ativar notificações no próprio celular e permitir o envio.
5. A automação verifica a escala diariamente por volta das 08h e envia somente na segunda e na sexta para quem estiver escalado no domingo seguinte.
6. Use Testar para conferir o recebimento em um professor que já tenha ativado as notificações.
7. Elias e Ronan podem marcar Lembrar neste aparelho; essa autorização não expira por tempo e só é removida ao sair, limpar os dados do app ou pela opção de revogação no painel.
8. Em Notificações → Acessos lembrados dos superintendentes, você pode revogar os acessos salvos de Elias, Ronan ou de todos os aparelhos.

iPhone/iPad: o app precisa estar adicionado à Tela de Início para receber Web Push. Os lembretes internos continuam funcionando como alternativa.

📦 21. Encerramento e mudança de trimestre

1. Abra Escalas salvas e confira uma única vez se a automação trimestral está ativa.
2. O quadro Preparação do próximo trimestre mostra quantas lições e quizzes já estão programados para cada classe.
3. Se houver pendências, Elias e Ronan com notificações ativas recebem alertas de preparação a 15, 7 e 2 dias do primeiro domingo do novo trimestre.
4. Depois da última data do trimestre, o sistema arquiva automaticamente a escala encerrada e cria um backup oculto de segurança.
5. Em seguida, gera automaticamente todos os domingos do trimestre seguinte e continua a sequência dos professores.
6. Antes de concluir, a nova escala passa por uma conferência automática de datas, duplicidades, classes e continuidade do rodízio.
7. Se a conferência falhar, a escala anterior é preservada/restaurada e os superintendentes recebem um alerta no celular.
8. A regra é permanente e também funciona na troca do 4º trimestre para o 1º trimestre do ano seguinte.
9. Em condições normais, não é necessário usar nenhum botão para preparar a nova escala.
10. O botão Virada manual de emergência existe apenas como contingência.

Rotina normal: o administrador precisa apenas programar as lições e os quizzes; a escala e a conferência ficam automáticas.

🚀 22. Quando publicar no GitHub, Hostinger ou Apps Script

GitHub Pages

Substitua arquivos no GitHub quando houver atualização de index.html, admin.html, imagens, manifestos ou scripts visuais.

Hostinger

Substitua arquivos na Hostinger quando houver atualização de licoes.php, config.php ou da estrutura da API.

Evite substituir storage/licoes.json, pois ele contém as lições cadastradas.

Google Apps Script

Atualize e implante uma Nova versão somente quando o arquivo Code.gs for alterado.

🧯 23. Problemas comuns

“Senha administrativa incorreta” ao salvar lições

1. Abra public_html/escala-ebd-api/config.php na Hostinger.
2. Confira a constante EBD_ADMIN_PASSWORD.
3. Ela deve ser igual à senha usada para entrar no painel.
4. Salve, saia do painel e entre novamente.

“Failed to fetch” ao salvar lições

1. Abra config.php.
2. Confira se https://escala.ebdfiel.com.br está em EBD_ALLOWED_ORIGINS.
3. Salve e atualize o painel com Ctrl + F5.

“Não há nenhuma lição completa na programação”

1. Confira se cada linha possui data da aula e link HTTPS.
2. Confira se o resumo mostra a quantidade programada.
3. Se a outra aba não será programada, mude-a para HTML ou link individual.
4. Salve novamente.

Alterei no painel, mas o site continua antigo

1. Use Ctrl + F5.
2. Teste em aba anônima.
3. Se usa o aplicativo instalado, limpe o cache ou reinstale a PWA.
4. Aguarde a publicação do GitHub Pages, quando arquivos do GitHub tiverem sido substituídos.

A API abre com erro 500 ou página em branco

1. Confira se a pasta está em public_html/escala-ebd-api.
2. Confira se existem config.php, licoes.php e a pasta storage.
3. Verifique permissões: pastas normalmente 755 e arquivos normalmente 644.
4. Teste novamente o endereço da API.