Configuração TOML Hierárquica

O Papéli resolve variáveis em 3 camadas de precedência descendente. Se o remetente for de um domínio não gerenciado (ex: @gmail.com), o daemon ignora a mensagem sem alterá-la.

Arquivo papeli.toml completo

[server]
# Socket de escuta: UNIX socket ou TCP inet
listen = "unix:/run/papeli/papeli.sock"
# listen = "inet:127.0.0.1:8899"
templates_dir = "/etc/papeli/templates"

[default]
company_name  = "Organização Geral"
logo_url      = "https://empresa.com/assets/logo-padrao.png"
template_html = "default.mjml"
template_txt  = "default.txt.j2"
disclaimer    = "Esta mensagem contém informações confidenciais."

[domains."acme.com"]
company_name = "ACME Corporation"
logo_url     = "https://acme.com/logo.png"
disclaimer   = "Mensagem protegida pela política de confidencialidade da ACME."

[senders."diretoria@acme.com"]
sender_name  = "Carlos Silva"
sender_role  = "Diretor Executivo"
sender_phone = "+55 11 99999-9999"

[senders."suporte@acme.com"]
sender_name  = "Suporte ao Cliente"
sender_role  = "Central de Atendimento 24/7"
sender_phone = "0800 123 4567"

Referência das variáveis de template

Templates MJML

O Papéli compila templates MJML para HTML responsivo usando a biblioteca mrml (Rust puro). As variáveis são interpoladas com MiniJinja antes da compilação MJML.

Template MJML mínimo (default.mjml)

<mjml>
  <mj-head>
    <mj-attributes>
      <mj-all font-family="Arial, sans-serif" font-size="14px" />
    </mj-attributes>
  </mj-head>

  <mj-body background-color="#f4f6f8">

    <!-- Cabeçalho com logotipo -->
    <mj-section background-color="#ffffff" padding="20px 30px">
      <mj-column>
        <mj-image src="{{ logo_url }}" width="180px" alt="{{ company_name }}" />
      </mj-column>
    </mj-section>

    <!-- Corpo da mensagem -->
    <mj-section background-color="#ffffff" padding="10px 30px 20px">
      <mj-column>
        <mj-text>
          {{ body_html }}
        </mj-text>
      </mj-column>
    </mj-section>

    <!-- Assinatura -->
    <mj-section background-color="#fafafa" border-top="1px solid #e0e0e0"
                padding="15px 30px">
      <mj-column>
        <mj-text font-size="12px" color="#666666">
          <div class="papeli-sig-long" data-papeli="signature"
               data-sender="{{ from }}">
            <strong>{{ sender_name }}</strong><br>
            {{ sender_role }} | {{ company_name }}<br>
            Tel: {{ sender_phone }}<br>
            <small>{{ disclaimer }}</small>
          </div>
        </mj-text>
      </mj-column>
    </mj-section>

  </mj-body>
</mjml>

Sistema de Assinatura Dupla

O módulo src/signatures.rs implementa o mecanismo de dupla assinatura que resolve o problema clássico de inchaço em threads longas.

<div class="papeli-sig-long"
     data-papeli="signature"
     data-sender="carlos@acme.com">
  <strong>Carlos Silva</strong><br>
  Diretor de Tecnologia | ACME Corp<br>
  Tel: +55 11 99999-9999 | www.acme.com<br>
  <small>Aviso de confidencialidade: ...</small>
</div>

<div class="papeli-sig-short" data-papeli="signature">
  <p style="color: #666; font-size: 11px;">— Carlos Silva (ACME Corp)</p>
</div>

--
<!--papeli:sig:start:long-->
Carlos Silva
Diretor de Tecnologia | ACME Corp
Tel: +55 11 99999-9999
[Aviso legal...]
<!--papeli:sig:end:long-->

<!--papeli:sig:start:short-->
— Carlos Silva (ACME Corp)
<!--papeli:sig:end:short-->

Processamento MIME

O módulo src/mime.rs é o coração do Papéli: analisa toda a árvore MIME da mensagem e a reconstrói de forma cirúrgica, preservando 100% dos anexos.

Casos suportados

Sanitização HTML

O módulo src/sanitizer.rs usa Ammonia e Scraper para limpar semanticamente o HTML sem destruir o conteúdo significativo.

O que é removido

O que é preservado

• Formatação semântica: negrito, itálico, listas, tabelas, links
• Imagens inline (CID e URLs absolutas)
• Estrutura de cabeçalhos (h1–h6)
• Blocos de código e citações (blockquote)
• Todo o conteúdo textual do email

Protocolo Milter

O src/milter.rs implementa um servidor Milter em Rust puro, compatível com o protocolo Sendmail Milter v6.

Modos de socket

# papeli.toml
[server]
listen = "unix:/run/papeli/papeli.sock"

# master.cf do Postfix
-o smtpd_milters=unix:/run/papeli/papeli.sock,inet:localhost:8891

# papeli.toml
[server]
listen = "inet:127.0.0.1:8899"

# master.cf do Postfix
-o smtpd_milters=inet:127.0.0.1:8899,inet:localhost:8891

Bypass automático

Se o domínio do remetente não estiver configurado no papeli.toml (ex: @gmail.com, @hotmail.com), o daemon retorna SMFIS_ACCEPT imediatamente, passando a mensagem inalterada para o próximo milter.

Suite de Testes

O Papéli possui mais de 30 testes automatizados cobrindo todos os cenários de processamento MIME, sanitização e assinatura.

Executar os testes

# Rodar todos os testes
cargo test

# Com output detalhado
cargo test -- --nocapture

# Filtrar por módulo
cargo test mime
cargo test sanitizer
cargo test signatures

Cobertura de testes por módulo

Fixtures de teste

Emails reais de diferentes clientes (Outlook 365, Apple Mail, Thunderbird, Gmail Web, Android Gmail, iPhone Mail) estão disponíveis como fixtures em tests/fixtures/ para testes de regressão end-to-end.