Frequência

Saldo = horas trabalhadas - carga horária esperada

Se saldo > 0 e dia útil:
  → Horas extras (com percentual conforme regra de ponto)

Se saldo > 0 e domingo/feriado:
  → 100% de adicional típico (CLT Art. 67)

Se saldo < 0:
  → Atraso ou falta parcial
  → Banco de horas (se houver acordo) ou desconto folha

{
  data: string                    // ISO 8601 date (yyyy-MM-dd)
  colaboradorId: string

  jornadaEsperada: {
    horasMinutos: string          // "08:00"
    intervalo: string             // "01:00"
    inicio?: string               // "08:00" (turnos com horário fixo)
    fim?: string                  // "17:00"
  }

  registros: Array<{
    dataHora: string
    tipo: "ENTRADA" | "SAIDA" | "INICIO_INTERVALO" | "FIM_INTERVALO"
    nsr: number
  }>

  totais: {
    horasTrabalhadas: string      // "08:15" — formato HH:MM
    horasExtras: string           // "00:15"
    horasFalta: string            // "00:00"
    horasAtraso: string           // "00:00"
  }

  status: "PRESENTE" | "FALTA" | "ATESTADO" | "FERIAS" | "FOLGA"
  ocorrencias: string[]           // ["BATIDA_DUPLICADA", "FORA_DO_CERCO", ...]
}

async function syncDiarioFolha(token) {
  const ontem = new Date(Date.now() - 86400000).toISOString().slice(0, 10)

  let pagina = 0
  while (true) {
    const resp = await fetch(
      `https://api.pontua.com.br/frequency/daily?` +
      `dataInicio=${ontem}&dataFim=${ontem}&pagina=${pagina}&limite=100`,
      { headers: { Authorization: `Bearer ${token}` } },
    )
    const { resultados, totalRegistros } = await resp.json()

    for (const freq of resultados) {
      await meuSistemaFolha.upsertFrequencia({
        colaborador: freq.colaboradorId,
        data: freq.data,
        horasTrabalhadas: freq.totais.horasTrabalhadas,
        horasExtras: freq.totais.horasExtras,
        status: freq.status,
      })
    }

    if ((pagina + 1) * 100 >= totalRegistros) break
    pagina++
  }
}

async function criarAtestadoComValidacao(token, colaboradorId, data) {
  // 1. Verificar se era dia esperado de trabalho
  const espResp = await fetch(
    `https://api.pontua.com.br/frequency/expected?` +
    `colaboradorId=${colaboradorId}&data=${data}`,
    { headers: { Authorization: `Bearer ${token}` } },
  )
  const { jornadaEsperada } = await espResp.json()

  if (!jornadaEsperada || jornadaEsperada.horasMinutos === '00:00') {
    console.log(`${data} não é dia útil para ${colaboradorId}, atestado dispensável`)
    return null
  }

  // 2. Era dia útil → criar atestado via fluxo de Ajustes
  // (ver Ajustes de Registro)
}

async function dashboardPresenca(token, departamentoId) {
  const hoje = new Date().toISOString().slice(0, 10)
  const resp = await fetch(
    `https://api.pontua.com.br/frequency/daily?` +
    `dataInicio=${hoje}&dataFim=${hoje}&departamentoId=${departamentoId}&limite=100`,
    { headers: { Authorization: `Bearer ${token}` } },
  )
  const { resultados } = await resp.json()

  return {
    presentes: resultados.filter((f) => f.status === 'PRESENTE').length,
    faltas: resultados.filter((f) => f.status === 'FALTA').length,
    atestados: resultados.filter((f) => f.status === 'ATESTADO').length,
    ferias: resultados.filter((f) => f.status === 'FERIAS').length,
  }
}