Skip to content

ADR-008: romcal para Calendário Litúrgico Offline

Status: Implementado Data (estimada): commit 1c82320c — feat: suporte inicial a romcal Tipo: ADR Retroativo

Contexto

O app exibe o nome do dia litúrgico, cor e tempo litúrgico (Advento, Quaresma etc.) para contextualizar as sugestões de repertório. Isso requer o calendário litúrgico romano com as especificidades do Brasil.

Decisão

Usar a biblioteca romcal com o pacote regional @romcal/calendar.brazil para calcular o calendário litúrgico completamente offline. O resultado é cacheado para o ano inteiro em memória no CalendarioLiturgicoService.

Alternativas Consideradas

  • API externa para calendário — descartado: offline é requisito central; API do DANCRF fornece as leituras mas não o calendário completo
  • Tabela manual de datas — descartado: inviável para manutenção anual
  • Calcular apenas o dia atual — descartado: o app precisa navegar entre datas (ver repertório de domingo passado)

Consequências

  • 🟢 Funciona 100% offline para dados litúrgicos base
  • 🟢 Suporte automático ao calendário brasileiro (festas nacionais: N.Sra. Aparecida, etc.)
  • 🟡 Ciclos PAR/ÍMPAR (para o Ofício Ferial) não implementados ainda — FIXME ativo
  • 🟡 Cálculo anual carregado em memória — pode ser otimizado se o bundle crescer
  • 🟢 romcal é uma biblioteca estabelecida na comunidade litúrgica open-source