Documentação da Planilha
👨💻 Desenvolvedor
-
No início de cada semestre, trocar o link da variável de ambiente do back-end SPREADSHEET_ID com o novo ID da planilha do Google Sheets com os horários acadêmicos:
URL da planilha:
-
https://docs.google.com/spreadsheets/d/1CKEFgTwz7k44444VytFDGMlYWyTqf2Zq8HbzcQJHKVI/edit?gid=0#gid=0
Variável de Ambiente:
-
SPREADSHEET_ID=1CKEFgTwz7k44444VytFDGMlYWyTqf2Zq8HbzcQJHKVI
-
- A variável de ambiente do back-end SPREADSHEET_LOGIN não precisa ser alterada, pois representa o ID da planilha do Google Sheets com as credenciais de login para acessar a tela de validação de dados.
- Criar uma cópia da planilha original privada do setor de ensino, que será utilizada como banco de dados do aplicativo. Isso é feito por questões de segurança e para manter um backup do conteúdo original.
- Configurar o acesso da planilha para qualquer pessoa com o link, para que a API do Google Sheets possa ler os dados da planilha.
- Durante testes, fazer uma cópia da planilha utilizada no sistema para evitar edições indevidas e modificações acidentais em células.
- (Se usar Koyeb) Acessar a plataforma de deploy do back-end Koyeb pelo menos 1 vez ao mês para evitar que o serviço seja interrompido, pois o modo gratuito exige acesso periódico mensal.
🏫 Administradores da Planilha
✍️ Exemplos de Padrões de Escrita
Nas guias Horário - Ensino Médio e Horário - Graduação:
1. Nome da disciplina:
- Incorreto:
(Calculo Numérico) - Correto:
Calculo Numérico - Explicação: Os nomes das disciplinas não podem ter parênteses, pois o algoritmo utiliza os parênteses para buscar o horário de um professor. Isso pode causar confusão na leitura e consulta dos dados.
2. Nome do professor:
- Incorreto:
Ricardo - Correto:
(Ricardo)ou( Ricardo ) - Explicação: Os nomes dos professores devem estar entre parênteses, pois o algoritmo os reconhece dessa forma ao buscar os horários.
3. Nome da sala:
- Incorreto:
(2 / 3)ou2/3 - Correto:
(2/3) - Explicação: Os nomes das salas devem estar entre parênteses e não podem ter espaços extras, pois o algoritmo tem uma lista fixa de strings com os nomes para buscar o horário de ocupação de uma sala. A presença de espaços pode impedir o reconhecimento correto.
4. Resultado final da escrita de um horário de uma disciplina:
- Incorreto:
(Calculo Numérico) Ricardo 2/3 - Correto:
Calculo Numérico (Ricardo) (2/3) - Explicação: Esse é o formato padrão esperado pelo sistema.
- Exceções: Algumas entradas podem ter informações adicionais ou múltiplos professores, como:
Físico Química II (Magnovaldo) (PPC 2017) (1/5)Estágio área 1 (Antônio, Charles, Fernando Matos, Sérgio)Educação Física (Jairo)
- Essas variações são aceitas e não comprometem o funcionamento do sistema.
Na guia Validação de Dados:
1. Evitar nomes com espaços ou parênteses antes e depois:
- Incorreto:
( Mateus ) - Correto:
Mateus - Explicação: Para facilitar a busca de um nome de professor, pois com espaços e parênteses dificulta a busca.
📊 Explicação das Guias e Intervalos de Células
No Google Sheets, as colunas são representadas por letras (A, B, C, ...) e as linhas por números (1, 2, 3, ...).
Cada célula é identificada pela combinação da letra da coluna com o número da linha.
B2é a célula na coluna B e linha 2.B2:V76esse intervalo começa na célula B2 e vai até a célula V76.B2:AW106esse intervalo começa na célula B2 e vai até a célula AW106.A2é a célula na coluna A e linha 2.A2:Aé um intervalo que começa na célula A2 e se estende indefinidamente para baixo na coluna A são lidas independente da quantidade de linhas.
A seguir são mostradas as guias que possuem a estrutura vital para o correto funcionamento do sistema:
📘 Guia: Horário - Ensino Médio
- Intervalo de células:
B2:V76 - Descrição: Contém os horários das turmas dos cursos técnicos.
📗 Guia: Horário - Graduação
- Intervalo de células:
B2:AW106 - Descrição: Contém os horários das turmas dos cursos superiores.
📙 Guia: Validação de Dados
- Intervalo de células:
A2:A - Descrição: Reúne a lista de professores da instituição.
Importante: Não devem ser feitas alterações como renomear essas guias, excluir abas ou modificar a posição das células. Alterações desse tipo podem comprometer o funcionamento da plataforma. Qualquer mudança estrutural só deve ser feita se for realmente necessária e acompanhada da devida atualização no código - o que, em geral, não será necessário.