Skip to main content
ClavisCore

DaysUnit

Dados de calendário abertos e sem infraestrutura para os estados membros da UEMOA — feriados públicos, indicadores de dias úteis e datas críticas para folha de pagamento servidos como JSON estático a partir de um CDN global, com biblioteca JavaScript agnóstica ao runtime e CLI para cache offline.

Visitar DaysUnitVer no GitHub
[ABOUT]

Sobre

DaysUnit fornece metadados diários (dia útil, feriado público, calendário) para os estados membros da UEMOA como arquivos JSON estáticos, servidos a partir de um CDN global em days.claviscore.com sem chaves de API, sem limites de taxa e sem necessidade de runtime backend para leituras. Uma biblioteca TypeScript complementar (@claviscore/days) encapsula o CDN com uma API fluida que suporta consultas de um único dia, intervalos mensais, consultas em batch multi-país e helpers de navegação (nextWorkingDay, workingDaysInRange). Uma CLI acompanha o pacote para pré-baixar dados em um cache offline local, permitindo consultas de latência zero em aplicações do lado do servidor. A V1 cobre o Benim (BJ) com toda a zona UEMOA no roadmap imediato sob o mesmo schema e sem mudanças disruptivas. Os dados de calendário carregam um campo de confiança (confirmed / tentative / ai-generated) e vinculam cada registro de feriado à sua base legal no Journal Officiel. Dupla licença: código-fonte MIT, dados de calendário CC BY 4.0.

[FEATURES]

Principais Recursos

Zero Infraestrutura: Dados servidos como JSON estático a partir de um CDN — sem runtime de servidor, sem chaves de API, sem limites de taxa, suporte CORS total para consumo direto pelo navegador
Schema Rico por Dia: 25 campos por dia incluindo isWorkingDay, isPublicHoliday, isFirstWorkingDayOfMonth, isLastWorkingDayOfMonth, isRamadanPeriod, legalBasis, URL fonte e nível de confiança
Biblioteca Agnóstica ao Runtime: @claviscore/days funciona em Navegador, Node ≥ 18, Deno e Bun; nenhum dado de calendário empacotado — buscado do CDN ou cache local em runtime
CLI Offline: npx @claviscore/days pull pré-baixa datasets completos por país/ano em um cache local .days/ para consultas de latência zero do lado do servidor
API em Batch Multi-País: days(['BJ','CI','SN']).on('2026-01-01') emite buscas paralelas e retorna um mapa de resultados tipado para todos os países solicitados
Dados com Avaliação de Confiança: Cada registro carrega procedência confirmed / tentative / ai-generated com uma URL fonte apontando para o documento legal oficial
Pronto para SYSCOHADA: Os campos isLastWorkingDayOfMonth e workingDayOfMonth suportam diretamente cálculos de datas de fechamento de diário SYSCOHADA e lógica de corte de folha
[USAGE]

Casos de Uso

  • Sistemas de folha de pagamento que exigem calendários precisos de dias úteis e feriados UEMOA
  • Software contábil SYSCOHADA computando datas de fechamento de diário e prazos de pagamento
  • Plataformas de RH e gerenciamento de licenças aplicando dias não úteis específicos por país
  • Aplicações de agendamento e logística operando em múltiplos territórios UEMOA
  • Produtos SaaS que precisam de dados de calendário confiáveis e sem manutenção, sem dependência backend
[AUDIENCE]

Usuários Alvo

Desenvolvedores FintechEngenheiros ERP/SaaSConstrutores do Mercado UEMOAEquipes Backend