@fayz-ai/plugin-workforce 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Faya Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,56 @@
+# @fayz-ai/plugin-workforce
+
+> Escala, ponto e fechamento de competência — o RH operacional de qualquer app Fayz.
+
+[![npm](https://img.shields.io/npm/v/@fayz-ai/plugin-workforce.svg)](https://www.npmjs.com/package/@fayz-ai/plugin-workforce)
+[![license](https://img.shields.io/npm/l/@fayz-ai/plugin-workforce.svg)](https://github.com/FayaLabs/fayz-sdk/blob/main/LICENSE)
+
+**Status:** beta — pre-1.0. A camada de dados está escrita e validada; a superfície de UI pode mudar antes do 1.0.
+
+Toda casa que tem gente na escala precisa responder três perguntas: quem está escalado, quem de fato veio, e o mês está fechado. `plugin-workforce` é o módulo que responde as três sem inventar um segundo cadastro de pessoa e sem uma segunda tabela de horário.
+
+Três decisões sustentam o modelo, e estão no SQL antes de estarem na tela:
+
+- **A batida é um EVENTO, append-only.** `kind ∈ (clock_in, break_start, break_end, clock_out)`, N por dia, agrupados por `(person_id, work_date)`. Intervalo de almoço e turno partido saem de graça, e "quais pontos estão em aberto?" tem resposta sem coluna derivada.
+- **O ajuste é uma LINHA, com autor e motivo obrigatório.** Nunca um UPDATE na batida — o horário real fica intocado, que é o que torna o ponto prova.
+- **O previsto mora em `public.schedules`**, com `kind = 'work_shift'`. A escala publicada materializa a linha e guarda o id; o cruzamento previsto × realizado vira uma chave, e não um casamento por nome e hora.
+
+## O que tem dentro
+- Um módulo `/workforce` com seis telas: Escalas, Templates, Registros de Ponto, Fechamento, Pessoas & Documentos, Encargos e Honorários
+- Escala do dia a partir de um molde, com SNAPSHOT do turno — mudar o molde não reescreve o passado
+- Folha de ponto agrupada por dia, com o crachá previsto × realizado lendo `v_workforce_day` (`absent` = falta, `outside_schedule` = fora da escala)
+- Fechamento de competência por RPC (`workforce_period_close` / `workforce_period_reopen`), com motivo obrigatório para reabrir
+- A ficha do colaborador vem do arquétipo de pessoa do `@fayz-ai/admin` — documentos, endereços, unidades e horário inclusos
+- Custo de pessoal LIDO do razão do Financeiro (`plg_financial_rep_dre`, a mesma view do relatório de DRE), desenhado como DEMONSTRATIVO — árvore do plano de contas, uma coluna por mês de competência; este plugin não escreve nenhuma despesa
+- **Qual ramo do plano é pessoal é uma DECLARAÇÃO da casa**, em `workforce.payroll_account_codes` (`tenants.settings`, migration 006). Sem escolha a tela mostra todas as despesas classificadas e avisa que é o que está fazendo — deduzir o ramo pelo nome da conta erraria no primeiro plano que numera diferente
+- Provider plugável: memória por padrão, Supabase quando há cliente registrado
+
+## Install
+```bash
+npm install @fayz-ai/plugin-workforce
+```
+Peer deps: `@fayz-ai/core`, `@fayz-ai/ui`, `@fayz-ai/admin`, mais `react` / `react-dom`.
+
+## Usage
+```tsx
+import { defineSaas } from '@fayz-ai/admin'
+import { createWorkforcePlugin } from '@fayz-ai/plugin-workforce'
+
+export const app = defineSaas({
+  // ...
+  plugins: [
+    createWorkforcePlugin({
+      currency: { code: 'BRL', locale: 'pt-BR', symbol: 'R$' },
+      labels: { pageTitle: 'RH', pageSubtitle: 'Escala, ponto e fechamento da equipe' },
+      // O SQL da jornada não guarda remuneração. Sem isto a folha mostra horas e
+      // um traço no lugar do valor, em vez de inventar um número.
+      hourlyRate: 22.5,
+    }),
+  ],
+})
+```
+
+## Permissões
+O baseline semeia oito chaves, e duas delas são segregação de função de propósito:
+`workforce.adjust_time` (corrigir a batida de outra pessoa é prova, não edição) e
+`workforce.close_period` (quem aponta não é quem fecha o mês).

package/dist/context.d.ts

@@ -0,0 +1,57 @@
+import { formatCurrency, type CurrencyConfig, type EntityLookup } from '@fayz-ai/admin';
+import type { WorkforcePluginLabels } from './index';
+import type { WorkforceDataProvider } from './data/types';
+import type { WorkforceUIState } from './store';
+export interface WorkforceModules {
+    /** Escalas: o calendário mensal e o dia. */
+    schedules: boolean;
+    /** Templates: o molde da escala. */
+    templates: boolean;
+    /** Registros de Ponto: a folha, com ajuste auditado. */
+    timeEntries: boolean;
+    /** Fechamento: a competência mensal. */
+    periods: boolean;
+    /** Pessoas & Documentos: a ficha do colaborador. */
+    people: boolean;
+    /** Encargos e Honorários: o custo de pessoal, lido do Financeiro. */
+    payrollCosts: boolean;
+    /**
+     * Ficha de RH: vínculo, férias, afastamentos e pendências.
+     *
+     * Passa pela permissão `workforce_hr.*`, separada de `workforce.*` — quem vê
+     * escala e ponto não vê salário nem CID. É o conserto do V1-069, e o FLOW da
+     * Ficha diz que ele tinha de ser resolvido ANTES de portar.
+     */
+    hr: boolean;
+}
+export type WorkforceCurrency = CurrencyConfig;
+export interface ResolvedWorkforceConfig {
+    modules: WorkforceModules;
+    labels: WorkforcePluginLabels;
+    currency: WorkforceCurrency;
+    /** Ver WorkforcePluginOptions.moduleNav. */
+    moduleNav?: 'rail' | 'tabs' | 'sidebar';
+    /**
+     * O valor da hora, quando o app souber dizer.
+     *
+     * O SQL da jornada NÃO guarda remuneração em lugar nenhum — nem na batida,
+     * nem no turno, nem em `public.people`. Sem isto a coluna "Valor" da folha
+     * não tem de onde sair, e a tela mostra "—" em vez de inventar um número.
+     */
+    hourlyRate?: number;
+    /** Busca de pessoa para escalar, quando o app quiser oferecer uma. */
+    staffLookup?: EntityLookup;
+    /** Item de nav → feature de acesso, exatamente como o APP declarou. */
+    navFeatureMap: Record<string, string>;
+}
+export declare const WorkforceContextProvider: import("react").FC<{
+    config: ResolvedWorkforceConfig;
+    provider: WorkforceDataProvider;
+    store: import("zustand").StoreApi<WorkforceUIState>;
+    children?: React.ReactNode;
+}>;
+export declare const useWorkforceConfig: () => ResolvedWorkforceConfig;
+export declare const useWorkforceProvider: () => WorkforceDataProvider;
+export declare const useWorkforceStore: <T>(selector: (state: WorkforceUIState) => T) => T;
+export { formatCurrency };
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC5G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAM/C,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAA;IAClB,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAA;IAClB,wDAAwD;IACxD,WAAW,EAAE,OAAO,CAAA;IACpB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAA;IAChB,oDAAoD;IACpD,MAAM,EAAE,OAAO,CAAA;IACf,qEAAqE;IACrE,YAAY,EAAE,OAAO,CAAA;IACrB;;;;;;OAMG;IACH,EAAE,EAAE,OAAO,CAAA;CACZ;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,EAAE,qBAAqB,CAAA;IAC7B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACvC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,WAAW,CAAC,EAAE,YAAY,CAAA;IAC1B,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC;AAID,eAAO,MAAM,wBAAwB;;;;;EAAsB,CAAA;AAC3D,eAAO,MAAM,kBAAkB,+BAAgB,CAAA;AAC/C,eAAO,MAAM,oBAAoB,6BAAkB,CAAA;AACnD,eAAO,MAAM,iBAAiB,oDAAe,CAAA;AAE7C,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/data/index.d.ts

@@ -0,0 +1,4 @@
+export type { WorkforceDataProvider } from './types';
+export { createMockWorkforceProvider } from './mock';
+export { createSupabaseWorkforceProvider, WORK_SHIFT_KIND } from './supabase';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,QAAQ,CAAA;AACpD,OAAO,EAAE,+BAA+B,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA"}

package/dist/data/mock.d.ts

@@ -0,0 +1,3 @@
+import type { WorkforceDataProvider } from './types';
+export declare function createMockWorkforceProvider(): WorkforceDataProvider;
+//# sourceMappingURL=mock.d.ts.map

package/dist/data/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/data/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAiCpD,wBAAgB,2BAA2B,IAAI,qBAAqB,CAgSnE"}

package/dist/data/supabase.d.ts

@@ -0,0 +1,5 @@
+import type { WorkforceDataProvider } from './types';
+/** A espécie de horário que o RH oferta. Semeada pela migration 000. */
+export declare const WORK_SHIFT_KIND = "work_shift";
+export declare function createSupabaseWorkforceProvider(): WorkforceDataProvider;
+//# sourceMappingURL=supabase.d.ts.map

package/dist/data/supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/data/supabase.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAYpD,wEAAwE;AACxE,eAAO,MAAM,eAAe,eAAe,CAAA;AA6F3C,wBAAgB,+BAA+B,IAAI,qBAAqB,CA8pBvE"}

package/dist/data/types.d.ts

@@ -0,0 +1,81 @@
+import type { TimeEntry, TimeEntryQuery, TimeAdjustmentInput, PunchPhoto, WorkDay, WorkforcePeriod, ScheduleTemplate, SaveTemplateInput, SaveShiftInput, SaveRequirementInput, DaySchedule, ScheduleQuery, CreateScheduleInput, WorkforcePerson, PayrollCostRow, PayrollCostQuery, Employment, Vacation, Absence, PendingItem, HrOverview, HrUpcoming } from '../types';
+/**
+ * O contrato de dados da jornada.
+ *
+ * Duas implementações: `createSupabaseWorkforceProvider` (o cluster) e
+ * `createMockWorkforceProvider` (memória, para quem monta o app sem banco).
+ * A escolha é do `createSafeDataProvider` do core, uma vez, na fábrica.
+ */
+export interface WorkforceDataProvider {
+    getHrOverview(): Promise<HrOverview | null>;
+    getHrUpcoming(): Promise<HrUpcoming[]>;
+    getEmployment(personId: string): Promise<Employment | null>;
+    saveEmployment(input: Employment): Promise<void>;
+    getVacations(personId: string): Promise<Vacation[]>;
+    saveVacation(input: Vacation): Promise<void>;
+    getAbsences(personId: string): Promise<Absence[]>;
+    saveAbsence(input: Absence): Promise<void>;
+    getPendingItems(personId: string): Promise<PendingItem[]>;
+    savePendingItem(input: PendingItem): Promise<void>;
+    /** Marca resolvida, ou desmarca. Um ato, não uma edição de texto. */
+    resolvePendingItem(id: string, resolved: boolean): Promise<void>;
+    /** Lê `v_workforce_time_entries` — a batida com a hora que vale. */
+    getTimeEntries(query: TimeEntryQuery): Promise<TimeEntry[]>;
+    /** Lê `v_workforce_day` — previsto × realizado por pessoa e dia. */
+    getWorkDays(query: TimeEntryQuery): Promise<WorkDay[]>;
+    /**
+     * Grava UMA LINHA em `plg_workforce_time_adjustments`. Nunca um UPDATE na
+     * batida: a tabela de batidas é append-only por trigger, e o histórico de
+     * correções é o que torna o ponto prova.
+     */
+    adjustTimeEntry(input: TimeAdjustmentInput): Promise<void>;
+    /**
+     * URLs assinadas para as fotos das batidas — curtas, e EM LOTE.
+     *
+     * Assinar é obrigatório: o bucket é privado porque a foto é biometria facial
+     * de um funcionário, com hora e coordenada ao lado, e o V1 já a tratava assim.
+     *
+     * O lote não é otimização prematura. Uma assinatura por foto é uma requisição
+     * por LINHA da tabela — trinta dias do Pertinho do Céu são 261 linhas, logo
+     * 261 idas ao storage antes de a primeira cara aparecer. Em lote é uma ida por
+     * página.
+     *
+     * A chave do retorno é `bucket + '/' + path`, e uma foto que não pôde ser
+     * assinada simplesmente não aparece nele — a tela cai nas iniciais, que é a
+     * resposta honesta.
+     */
+    signPunchPhotos(photos: PunchPhoto[], expiresInSeconds?: number): Promise<Record<string, string>>;
+    getPeriods(): Promise<WorkforcePeriod[]>;
+    /** RPC `workforce_period_close`. Escrever a linha direto não é permitido. */
+    closePeriod(competenceMonth: string, notes?: string): Promise<void>;
+    /** RPC `workforce_period_reopen`. O motivo é obrigatório. */
+    reopenPeriod(competenceMonth: string, reason: string): Promise<void>;
+    getTemplates(): Promise<ScheduleTemplate[]>;
+    saveTemplate(input: SaveTemplateInput): Promise<string>;
+    deleteTemplate(id: string): Promise<void>;
+    saveShift(input: SaveShiftInput): Promise<string>;
+    deleteShift(id: string): Promise<void>;
+    saveRequirement(input: SaveRequirementInput): Promise<string>;
+    deleteRequirement(id: string): Promise<void>;
+    getSchedules(query: ScheduleQuery): Promise<DaySchedule[]>;
+    /**
+     * Cria a escala do dia a partir de um molde, copiando o SNAPSHOT do turno
+     * para cada atribuição — é assim que mudar o molde não reescreve o passado.
+     */
+    createSchedule(input: CreateScheduleInput): Promise<string>;
+    /**
+     * Publica: marca a escala e materializa cada titular como uma linha de
+     * `public.schedules` com `kind = 'work_shift'`, guardando o id em
+     * `schedule_row_id`. É a ponte com a agenda, e é o que torna o cruzamento
+     * previsto × realizado uma chave em vez de um casamento por nome e hora.
+     */
+    publishSchedule(scheduleId: string): Promise<void>;
+    /** `public.people` com papel de equipe — quem pode ser escalado. */
+    getStaff(): Promise<WorkforcePerson[]>;
+    /**
+     * Opcional: um cluster sem o Financeiro instalado não tem razão para ler, e a
+     * tela diz isso em vez de quebrar.
+     */
+    getPayrollCosts?(query: PayrollCostQuery): Promise<PayrollCostRow[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/data/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAC1D,OAAO,EACP,eAAe,EACf,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,EACzE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAC/C,eAAe,EACf,cAAc,EAAE,gBAAgB,EAChC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EACnE,MAAM,UAAU,CAAA;AAEjB;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IAMpC,aAAa,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IAC3C,aAAa,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACtC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IAC3D,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IACnD,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IACjD,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IACzD,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAGhE,oEAAoE;IACpE,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAC3D,oEAAoE;IACpE,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IACtD;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAGjG,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IACxC,6EAA6E;IAC7E,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnE,6DAA6D;IAC7D,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAGpE,YAAY,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAA;IAC3C,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACvD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACjD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7D,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAG5C,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAC1D;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3D;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAGlD,oEAAoE;IACpE,QAAQ,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IAGtC;;;OAGG;IACH,eAAe,CAAC,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;CACrE"}

package/dist/index.d.ts

@@ -0,0 +1,98 @@
+import type { EntityDef, PluginManifest, PluginScope, VerticalId } from '@fayz-ai/core';
+import type { EntityLookup } from '@fayz-ai/admin';
+import type { WorkforceDataProvider } from './data/types';
+/**
+ * O provider da jornada, resolvido tarde: Supabase quando há cliente, memória
+ * quando não há. Público porque um app que queira compartilhar UM provider
+ * entre o módulo e uma ponte (o totem de ponto, por exemplo) precisa do mesmo.
+ */
+export declare function createSafeWorkforceProvider(): WorkforceDataProvider;
+export interface WorkforcePluginLabels {
+    pageTitle: string;
+    pageSubtitle: string;
+    schedules: string;
+    templates: string;
+    timeEntries: string;
+    hr: string;
+    periods: string;
+    people: string;
+    payrollCosts: string;
+}
+export interface WorkforcePluginOptions {
+    /** Onde a sub-navegação do módulo mora. Padrão: o que a shell decidir. */
+    moduleNav?: 'rail' | 'tabs' | 'sidebar';
+    modules?: {
+        schedules?: boolean;
+        templates?: boolean;
+        timeEntries?: boolean;
+        hr?: boolean;
+        periods?: boolean;
+        people?: boolean;
+        payrollCosts?: boolean;
+    };
+    labels?: Partial<WorkforcePluginLabels>;
+    currency?: {
+        code?: string;
+        locale?: string;
+        symbol?: string;
+    };
+    navPosition?: number;
+    navSection?: 'main' | 'secondary';
+    scope?: PluginScope;
+    verticalId?: VerticalId;
+    /** Provider de dados. Padrão: Supabase-ou-memória. */
+    dataProvider?: WorkforceDataProvider;
+    /**
+     * Quanto vale a hora, para a folha mostrar valor.
+     *
+     * NÃO existe coluna de remuneração no SQL da jornada — nem na batida, nem no
+     * turno, nem em `public.people`. Sem esta opção a tela mostra "—" em vez de
+     * inventar um número, e o relatório do módulo diz isso.
+     */
+    hourlyRate?: number;
+    /** A entidade de pessoa que a aba "Pessoas & Documentos" edita. Padrão: o
+     *  recorte de `people` com papel de equipe (ver views/PeopleView). */
+    staffEntity?: EntityDef;
+    /** Busca de pessoa, quando o app quiser oferecer uma para escalar. */
+    staffLookup?: EntityLookup;
+    /**
+     * Onde mora a página de UMA pessoa da equipe neste app — `'/staff'`.
+     *
+     * O nome na lista de Registros de Ponto é um `PersonLink`, e ele resolve a
+     * rota pelo registro compartilhado de caminhos. O padrão daquele registro é
+     * `/registry/staff`, que é herança do app veterinário: num app que monta a
+     * equipe em `/staff` o nome viraria um link para uma rota inexistente — pior
+     * que texto puro, porque parece clicável e não é.
+     *
+     * O plugin não adivinha: quem sabe onde a página está é o app que a montou.
+     * Sem esta opção o registro fica como está, e o link cai onde o padrão
+     * aponta.
+     */
+    staffRoute?: string;
+    /**
+     * Qual link interno ESTE app cobra, como `id do item de nav → id da feature`.
+     * Vazio por padrão: empacotamento é decisão do app, não do plugin.
+     */
+    navFeatureMap?: Record<string, string>;
+}
+/**
+ * Preset OPCIONAL de ids de feature para as subtelas — uma convenção oferecida
+ * aos apps, NÃO um padrão. Nada aqui vale sem `options.navFeatureMap`.
+ */
+export declare const WORKFORCE_NAV_FEATURES: {
+    readonly schedules: "wf_schedules";
+    readonly templates: "wf_templates";
+    readonly 'time-entries': "wf_time_entries";
+    readonly hr: "wf_hr";
+    readonly periods: "wf_periods";
+    readonly people: "wf_people";
+    readonly 'payroll-costs': "wf_payroll_costs";
+};
+export declare function createWorkforcePlugin(options?: WorkforcePluginOptions): PluginManifest;
+export type { WorkforceDataProvider } from './data/types';
+export type { ResolvedWorkforceConfig } from './context';
+export type { TimeEntry, TimeEntryKind, TimeEntryQuery, TimeAdjustmentAction, TimeAdjustmentInput, WorkDay, WorkforcePeriod, ScheduleTemplate, ScheduleShift, ScheduleRequirement, DaySchedule, ScheduleAssignment, ScheduleQuery, CreateScheduleInput, WorkforcePerson, PayrollCostRow, PayrollCostQuery, } from './types';
+export { createMockWorkforceProvider } from './data/mock';
+export { createSupabaseWorkforceProvider, WORK_SHIFT_KIND } from './data/supabase';
+export { DEFAULT_STAFF_ENTITY } from './views/PeopleView';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAEvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAIlD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAMzD;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAKnE;AAMD,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACvC,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,EAAE,CAAC,EAAE,OAAO,CAAA;QACZ,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,YAAY,CAAC,EAAE,OAAO,CAAA;KACvB,CAAA;IACD,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACvC,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;IACjC,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,UAAU,CAAC,EAAE,UAAU,CAAA;IAEvB,sDAAsD;IACtD,YAAY,CAAC,EAAE,qBAAqB,CAAA;IAEpC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;0EACsE;IACtE,WAAW,CAAC,EAAE,SAAS,CAAA;IAEvB,sEAAsE;IACtE,WAAW,CAAC,EAAE,YAAY,CAAA;IAE1B;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAoBD;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;CAQQ,CAAA;AA4B3C,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,cAAc,CA2HtF;AAMD,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AACxD,YAAY,EACV,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,oBAAoB,EAAE,mBAAmB,EACnF,OAAO,EAAE,eAAe,EACxB,gBAAgB,EAAE,aAAa,EAAE,mBAAmB,EACpD,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,mBAAmB,EACnE,eAAe,EAAE,cAAc,EAAE,gBAAgB,GAClD,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,+BAA+B,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}