Constantes

Por operar em cima de uma planilha, os scripts devem conhecer a geometria da planilha a todo momento. Como é muita mal prática usar números mágicos, existem arquivos em src/const que contêm dados da planilha, como o nome das páginas a serem usadas, números de colunas e fórmulas usadas em certas células.

É crucial que estes dados estejam sempre atualizados. Erros em seu preenchimento pode causar execução incorreta e comportamento imprevisível, gerando possívelmente perda de dados. Em tal caso, as features de histórico do Google Sheets devem ser usadas.

coordinates.ts

Contém todas as constantes relacionadas a posicionamento do projeto, em sua grande parte os números de cada coluna para cada página. Esse é o mais usado e o mais importante de conhecer.

Ele segue o esquema de nomeação: COLUNA_<pagina>_<nome da coluna>. A única exceção é a página de processos, que por ser a mais importante, não possui um prefixo para nome de página.

Além disso, este arquivo também tem a linha de cabeçalho das páginas, isto é, a última linha antes dos dados própriamente ditos.

formulas.ts

Este arquivo costumava ser maior, mas caiu em desuso porque a funcionalidade que necessitava de muitas fórmulas foi removida do projeto.

As fórmulas usam um paradigma mais funcional. Recebem argumentos e retornam uma string com a fórmula preenchida.

sheets.ts

Possui os nomes das páginas da planilha. É só isso.

Nota

Um trabalho futuro possível seria substituir os nomes destas páginas por IDs para não necessitar a edição do arquivo toda vez que decidirmos renomear uma página no Google Sheets.