# E-mail
O envio automático de e-mails em diferentes situações é a principal função dessas macros. Outras tarefas são desempenhadas, mas esta é a mais importante delas. Para o envio de e-mails, deve ser usada exclusivamente a conta `manutencaoscne@gmail.com`.

## Tipos
Atualmente, são enviados os seguintes tipos de notificações via e-mail:
- Arquivamento de processo, destinada a(o) solicitante;
- Bloqueio de execução por aguardo de alguma definição ou interação do solicitante;
- Compilação de processos *não estruturais* arquivados durante a semana passada à CGD, enviada todo dia;
- Compilação de processos *estruturais* enviados aos colaboradores relevantes, caso tenha;
- Alteração de layout à CPLAN;
- Resposta automatizada para feedback. Um tipo para nota baixa e outro para serviço julgado como **não concluído** pelo(a) solicitante;
- Insumos atrasados atrapalhando execução, enviada ao fiscal de contrato;
- (EM DESENVOLVIMENTO) Remoção de colaborador com status "DESLIGADO" na página de "Equipe" por mais de 30 dias (padrão, configurável no painel de controle);

_Última atualização: 07 nov. 2025_

## Templates
O envio de e-mails é feito usando HTML com templates. Mensagens com corpo de texto puro não são suportadas pelo projeto, já que implementar um parser próprio de HTML não é viável de um ponto de vista de esforço e de performance. O formato das templates é próprio ao Google Apps Script, exemplos podem ser encontrados em `src/templates/`. O arquivo `mail.ts` contém vários _wrappers_ para `GmailApp.SendMail` que avaliam essas templates, preenchendo dados para cada um dos tipos de notificação especificados.

A sintaxe de templates do Apps Script permite `<? ... ?>` para lógica e `<?= ... ?>` para saída.

Exemplo de arquivo de template, que seria colocado em `src/templates/`
```html
<!-- src/templates/notification.html -->
<p>Olá <?= nome ?>,</p>

<p>Seguem os processos:</p>
<ul>
<? for (var i = 0; i < processos.length; i++) { ?>
    <li><?= processos[i].numero ?> — <?= processos[i].assunto ?></li>
<? } ?>
</ul>

<p>Atenciosamente,<br>Equipe</p>
```

Exemplo de código no Google Apps Script que avalia a template e envia um e-mail:
```js
function sendNotification(to, nome, processos) {
    // Carrega a template pelo nome do arquivo (sem extensão)
    var template = HtmlService.createTemplateFromFile('notification');
    template.nome = nome;
    template.processos = processos;

    // Avalia a template e obtém o HTML final
    var htmlBody = template.evaluate().getContent();

    // Envia usando a conta dedicada
    GmailApp.sendEmail(
        to,
        'Notificação de processos',
        'Seu cliente de e-mail não suporta HTML.',
        {
            htmlBody: htmlBody,
            from: 'manutencaoscne@gmail.com'
        }
    );
}
```

## Verificação Manual
Os envios de e-mail são programados para fazer logging extenso e deixar o processo transparente. É possível observar suas execuções nos logs do Google Apps Script. A função alto-nível responsável por ativar todas as notificações é `enviarNotificacoes()` em `main.ts`