forlogic-core 2.2.8 → 2.3.1

package/.note/memory/patterns/dynamic-supabase-config.md

@@ -1,4 +1,4 @@
 # Memory: patterns/dynamic-supabase-config
-Updated: 2026-03-24
+Updated: 2026-05-25
 
-As credenciais do Supabase vêm exclusivamente do `.env` (auto-populado pelo Lovable ao trocar banco). O Vite injeta automaticamente variáveis `VITE_*` em `import.meta.env` — não há bloco `define` manual nem extração de `client.ts`. O `vite.config.ts` usa `loadEnv()` apenas para ler o project ID no contexto Node (CSP headers). O `SupabaseSingleton` lê `import.meta.env.VITE_SUPABASE_URL` e `VITE_SUPABASE_PUBLISHABLE_KEY` em runtime no browser.
+O `vite.config.ts` chama `resolveSupabaseEnv(mode)` (de `forlogic-core/vite`), que lê tanto `VITE_SUPABASE_*` quanto `SUPABASE_*` (formato novo Lovable Cloud), prioriza `VITE_*` e injeta valores consolidados via `define`: `import.meta.env.VITE_SUPABASE_URL`, `VITE_SUPABASE_PUBLISHABLE_KEY`, `VITE_SUPABASE_PROJECT_ID`, `VITE_SUPABASE_PK_OVERRIDE`. O `.env` precisa apenas de UMA versão (`SUPABASE_URL` + `SUPABASE_PUBLISHABLE_KEY`). `VITE_SUPABASE_PK_OVERRIDE` continua obrigatório por causa do bug do Lovable sobrescrever a publishable key com a legacy JWT. `projectId` é derivado da URL quando ausente.

package/.note/memory/patterns/environment-detection-logic.md

@@ -1,35 +1,41 @@
 # Memory: patterns/environment-detection-logic
-Updated: 2026-03-24
+Updated: 2026-05-25
 
 O sistema separa duas preocupações independentes de ambiente:
 
 ## 1. Método de autenticação (`shouldUseDevTokens()` / `isLovablePreview()`)
 Detecta se o app roda em contexto de desenvolvimento (preview Lovable via iframe, `*.lovable.dev`, localhost ou `import.meta.env.DEV`). Quando true, usa a edge function `dev-tokens` do Supabase conectado para autenticar. Quando false (app publicado), usa OAuth padrão do Qualiex.
 
-## 2. Qual API usar (`getEnvironmentConfig()` / `isDevSupabaseProject()`)
-Compara o project ID do Supabase conectado com `PROD_PROJECT_ID` (`ccjfvpnndclajkleyqkc`). Se igual → config PROD (API prod, OAuth prod). Se diferente → config DEV (API dev, OAuth dev).
+## 2. Qual API usar (`getEnvironmentConfig()` / `isDevEnv()`)
+Fonte de verdade **única e explícita**: env var `VITE_APP_ENV`.
 
-## Fonte de verdade do Project ID
-O project ID vem do `.env` (auto-populado pelo Lovable ao trocar banco), que o Vite injeta automaticamente em `import.meta.env.VITE_SUPABASE_PROJECT_ID`. **Não** é extraído de `src/integrations/supabase/client.ts`. O `vite.config.ts` usa `loadEnv()` apenas no contexto Node para configurar CSP headers.
+| `VITE_APP_ENV`                  | Resultado             |
+|---------------------------------|-----------------------|
+| `"PROD"`                        | PROD (API/OAuth prod) |
+| `"DEV"`                         | DEV (API/OAuth dev)   |
+| ausente / qualquer outro valor  | **PROD (failsafe)**   |
+
+Não há fallback derivado do Supabase. Apps que querem apontar para dev precisam declarar `VITE_APP_ENV="DEV"` no `.env`. Apps prod simplesmente omitem (ou setam `"PROD"`).
 
 ## Tabela de regras
 
-| Cenário                      | API  | Auth       |
-|------------------------------|------|------------|
-| Preview + Prod Supabase      | Prod | dev-tokens |
-| Preview + Dev Supabase       | Dev  | dev-tokens |
-| Publicado + Prod Supabase    | Prod | OAuth      |
-| Publicado + Dev Supabase     | Dev  | OAuth      |
+| Cenário                         | API  | Auth       |
+|---------------------------------|------|------------|
+| Preview + `VITE_APP_ENV=PROD`   | Prod | dev-tokens |
+| Preview + `VITE_APP_ENV=DEV`    | Dev  | dev-tokens |
+| Publicado + `VITE_APP_ENV=PROD` | Prod | OAuth      |
+| Publicado + `VITE_APP_ENV=DEV`  | Dev  | OAuth      |
 
 ## Guard de troca de projeto (`TokenManager.checkProjectMismatch()`)
-Ao inicializar (`AuthService.initialize()`), o sistema compara `import.meta.env.VITE_SUPABASE_PROJECT_ID` com o valor armazenado em `localStorage('supabase_project_id')`. Se diferente, limpa todos os tokens stale automaticamente antes de qualquer chamada a `validate-token`, evitando 401 desnecessários. Após a limpeza, armazena o novo project ID. Isso garante transição limpa ao trocar de banco Supabase sem erros ou blank screen.
+Independente de `VITE_APP_ENV`. Ao inicializar (`AuthService.initialize()`), compara `import.meta.env.VITE_SUPABASE_PROJECT_ID` (consolidado por `resolveSupabaseEnv()` no `vite.config.ts`) com o valor armazenado em `localStorage('supabase_project_id')`. Se diferente, limpa tokens stale antes de qualquer chamada a `validate-token`. Sem efeito em apps `backend="dotnet"`.
 
 ## Funções (lib/config/index.ts)
 - `isLovablePreview()` — detecta contexto de preview/localhost
-- `shouldUseDevTokens()` — wrapper semântico sobre `isLovablePreview()`
+- `shouldUseDevTokens()` — wrapper semântico sobre `isLovablePreview()` (apenas modo Supabase)
 - `isDevEnvironment` — alias deprecated, mantido para compatibilidade
-- `getEnvironmentConfig()` — retorna config PROD ou DEV baseado no project ID
-- `isDevSupabaseProject()` — true se project ID ≠ PROD_PROJECT_ID
+- `getAppEnv()` — retorna `'PROD' | 'DEV'` lendo `VITE_APP_ENV` (default `'PROD'`)
+- `getEnvironmentConfig()` — retorna config PROD ou DEV baseado em `getAppEnv()`
+- `isDevEnv()` — true se `getAppEnv() === 'DEV'`
 
 ## Funções (lib/auth/services/TokenManager.ts)
 - `checkProjectMismatch()` — detecta troca de projeto Supabase e limpa tokens stale

package/README.md

@@ -36,10 +36,25 @@ function App() {
 | `forlogic-core` (CRUD) | `createCrudPage`, `CrudTable`, `BaseForm`, services hook | `docs/design-system/crud.md` |
 | `forlogic-core/auth` | OAuth + PKCE, multi-tenant alias routing, `useAuth` | [`lib/auth/README.md`](lib/auth/README.md) |
 | `forlogic-core/services` | `BaseService`, `createSimpleService`, Email, Error | [`lib/services/README.md`](lib/services/README.md) |
-| `forlogic-core/places` | Hierarchical Org Units (UO) selectors and tree view | [`lib/places/README.md`](lib/places/README.md) |
 | `forlogic-core/approval-flow` | Approval sidebar, dialogs and types | [`lib/approval-flow/README.md`](lib/approval-flow/README.md) |
 | `forlogic-core/media` | `VideoEditor`, `ImageEditor` with pluggable upload | [`lib/media/README.md`](lib/media/README.md) |
 | `forlogic-core/integrations` | Clarity, Supabase client | [`lib/integrations/README.md`](lib/integrations/README.md) |
+| `forlogic-core/sign` | `DocumentSigner` (Clicksign + D4Sign) — **requer Supabase** | [`lib/sign/`](lib/sign/) |
+| `forlogic-core/audit-trail` | `AuditTrailPage` e diff drawers — **requer Supabase** | [`lib/audit-trail/`](lib/audit-trail/) |
+| `forlogic-core/action-plans` | Planos de ação 5W2H — **requer Supabase** | [`lib/action-plans/`](lib/action-plans/) |
+| `forlogic-core/leadership` | Gestão de líderes/equipes — **requer Supabase** | [`lib/leadership/`](lib/leadership/) |
+| `forlogic-core/places` | Hierarchical Org Units (UO) — **requer Supabase** | [`lib/places/README.md`](lib/places/README.md) |
+
+## Backend opcional (Supabase)
+
+A partir da versão com `CoreProviders backend="..."`, o Supabase deixou de ser obrigatório:
+
+- `backend="supabase"` (default, retrocompat) — exige `SUPABASE_URL` + `SUPABASE_PUBLISHABLE_KEY` (ou `VITE_SUPABASE_*` legadas; o `vite.config.ts` consolida ambos).
+- `backend="dotnet"` — autentica apenas com tokens OAuth do Qualiex; **não** lê envs do Supabase.
+
+**Breaking change:** os módulos `sign`, `audit-trail`, `action-plans`, `leadership` e `places` foram **removidos do barrel principal** e só podem ser importados via subpath (ex.: `import { DocumentSigner } from 'forlogic-core/sign'`). Eles continuam exigindo Supabase em runtime mesmo quando o app usa `backend="dotnet"`.
+
+Detalhes e exemplos: [`docs/design-system/patterns/core-providers.md`](docs/design-system/patterns/core-providers.md).
 
 ## Modular imports
 
@@ -50,9 +65,14 @@ import { Button } from 'forlogic-core/ui';
 import { createCrudPage } from 'forlogic-core/crud';
 import { createSecurityHeadersPlugin } from 'forlogic-core/vite';
 import { forlogicTailwindPreset } from 'forlogic-core/tailwind';
+import { DocumentSigner } from 'forlogic-core/sign';            // requer Supabase
+import { AuditTrailPage } from 'forlogic-core/audit-trail';     // requer Supabase
+import { ActionPlanList } from 'forlogic-core/action-plans';    // requer Supabase
+import { LeadershipManager } from 'forlogic-core/leadership';   // requer Supabase
+import { PlacesTree } from 'forlogic-core/places';              // requer Supabase
 ```
 
-The flat `forlogic-core` export re-exports everything for convenience.
+O barrel `forlogic-core` re-exporta os módulos não-Supabase para conveniência.
 
 ---
 

package/dist/action-plans/action-plans/components/ActionPlanAttachmentsTab.d.ts

@@ -0,0 +1,21 @@
+import type { ActionPlanAttachment } from '../types';
+interface ActionPlanAttachmentsTabProps {
+    attachments?: ActionPlanAttachment[];
+    onUpload?: (file: File) => Promise<any> | void;
+    onDelete?: (attachmentId: string) => Promise<any> | void;
+    onRename?: (attachmentId: string, newName: string) => Promise<any> | void;
+    onDownload?: (attachmentId: string) => Promise<any> | void;
+    onView?: (attachmentId: string) => Promise<any> | void;
+    disabled?: boolean;
+}
+/**
+ * Aba de Anexos do Plano de Ação
+ *
+ * Portado de FlcAttachmentsComponent (flc-attachments).
+ * Suporta upload, visualização, download, renomear e exclusão de arquivos.
+ *
+ * @example
+ * ActionPlanAttachmentsTab();
+ */
+export declare function ActionPlanAttachmentsTab({ attachments, onUpload, onDelete, onRename, onDownload, onView, disabled, }: ActionPlanAttachmentsTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/action-plans/components/ActionPlanCommentsTab.d.ts

@@ -0,0 +1,21 @@
+import type { ActionPlanComment } from '../types';
+interface ActionPlanCommentsTabProps {
+    comments?: ActionPlanComment[];
+    currentUserId?: string;
+    onAdd?: (text: string) => Promise<any> | void;
+    onEdit?: (comment: ActionPlanComment) => Promise<any> | void;
+    onDelete?: (commentId: string) => Promise<any> | void;
+    disabled?: boolean;
+    maxLength?: number;
+}
+/**
+ * Aba de Comentários do Plano de Ação
+ *
+ * Portado de FlcCommentsComponent (flc-comments).
+ * Suporta criação, edição e exclusão de comentários com avatar e timestamp.
+ *
+ * @example
+ * ActionPlanCommentsTab();
+ */
+export declare function ActionPlanCommentsTab({ comments, currentUserId, onAdd, onEdit, onDelete, disabled, maxLength, }: ActionPlanCommentsTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/action-plans/components/ActionPlanCostTab.d.ts

@@ -0,0 +1,15 @@
+import type { ActionPlanCost } from '../types';
+interface ActionPlanCostTabProps {
+    costs?: ActionPlanCost[];
+    onAdd?: (cost: Omit<ActionPlanCost, 'id'>) => void;
+    onEdit?: (cost: ActionPlanCost) => void;
+    onDelete?: (costId: string) => void;
+    disabled?: boolean;
+}
+/**
+ * Função utilitária `ActionPlanCostTab`.
+ * @example
+ * ActionPlanCostTab();
+ */
+export declare function ActionPlanCostTab({ costs, onAdd, onEdit, onDelete, disabled, }: ActionPlanCostTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/action-plans/components/ActionPlanGeneralTab.d.ts

@@ -0,0 +1,21 @@
+import type { ActionPlan, ActionPlanPageProps } from '../types';
+interface ActionPlanGeneralTabProps {
+    formData: Partial<ActionPlan>;
+    updateField: (field: keyof ActionPlan, value: any) => void;
+    disabled?: boolean;
+    users?: ActionPlanPageProps['users'];
+    places?: ActionPlanPageProps['places'];
+    actionTypes?: ActionPlanPageProps['actionTypes'];
+    causes?: ActionPlanPageProps['causes'];
+    parentActions?: ActionPlanPageProps['parentActions'];
+    config?: ActionPlanPageProps['config'];
+}
+/**
+ * Aba Geral do formulário de Plano de Ação
+ * Contém todos os campos principais configuráveis
+ *
+ * @example
+ * ActionPlanGeneralTab();
+ */
+export declare function ActionPlanGeneralTab({ formData, updateField, disabled, users, places, actionTypes, causes, parentActions, config, }: ActionPlanGeneralTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/action-plans/components/ActionPlanHistoryTab.d.ts

@@ -0,0 +1,16 @@
+import type { ActionPlanHistoryItem } from '../types';
+interface ActionPlanHistoryTabProps {
+    history?: ActionPlanHistoryItem[];
+    isLoading?: boolean;
+}
+/**
+ * Aba de Histórico do Plano de Ação
+ *
+ * Portado de FlcHistoryComponent (flc-history).
+ * Exibe uma timeline de eventos do plano de ação.
+ *
+ * @example
+ * ActionPlanHistoryTab();
+ */
+export declare function ActionPlanHistoryTab({ history, isLoading, }: ActionPlanHistoryTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/action-plans/components/ActionPlanPage.d.ts

@@ -0,0 +1,25 @@
+import type { ActionPlanPageProps } from '../types';
+/**
+ * ActionPlanPage — Componente orquestrador de página full para planos de ação
+ *
+ * Renderiza o formulário completo com tabs: Geral, Progresso, Predecessores, Custos,
+ * Anexos, Comentários e Histórico.
+ *
+ * O componente é agnóstico de backend — recebe todos os dados e callbacks via props.
+ *
+ * @example
+ * ```tsx
+ * <ActionPlanPage
+ *   actionPlan={actionPlan}
+ *   config={{ enablePredecessors: true, enableCosts: true }}
+ *   users={users}
+ *   places={places}
+ *   progress={progress}
+ *   onSave={handleSave}
+ *   onCancel={() => navigate(-1)}
+ *   onChangeStatus={handleChangeStatus}
+ *   onReportProgress={handleReportProgress}
+ * />
+ * ```
+ */
+export declare function ActionPlanPage(props: ActionPlanPageProps): import("react/jsx-runtime").JSX.Element;

package/dist/action-plans/action-plans/components/ActionPlanPredecessorsTab.d.ts

@@ -0,0 +1,15 @@
+import type { ActionPlanPredecessor, ActionPlanOption } from '../types';
+interface ActionPlanPredecessorsTabProps {
+    predecessors?: ActionPlanPredecessor[];
+    availablePredecessors?: ActionPlanOption[];
+    onAdd?: (predecessorId: string) => void;
+    onRemove?: (predecessorId: string) => void;
+    disabled?: boolean;
+}
+/**
+ * Função utilitária `ActionPlanPredecessorsTab`.
+ * @example
+ * ActionPlanPredecessorsTab();
+ */
+export declare function ActionPlanPredecessorsTab({ predecessors, availablePredecessors, onAdd, onRemove, disabled, }: ActionPlanPredecessorsTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/action-plans/components/ActionPlanProgressDialog.d.ts

@@ -0,0 +1,16 @@
+import type { ActionPlanReport } from '../types';
+interface ActionPlanProgressDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    report: ActionPlanReport | null;
+    onSave: (report: ActionPlanReport) => void;
+    isSubmitting?: boolean;
+}
+/**
+ * Dialog para editar um relatório de progresso existente
+ *
+ * @example
+ * ActionPlanProgressDialog();
+ */
+export declare function ActionPlanProgressDialog({ open, onOpenChange, report, onSave, isSubmitting, }: ActionPlanProgressDialogProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/action-plans/components/ActionPlanProgressTab.d.ts

@@ -0,0 +1,10 @@
+import type { ActionPlanPageProps } from '../types';
+interface ActionPlanProgressTabProps extends ActionPlanPageProps {
+}
+/**
+ * Função utilitária `ActionPlanProgressTab`.
+ * @example
+ * ActionPlanProgressTab();
+ */
+export declare function ActionPlanProgressTab(props: ActionPlanProgressTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/action-plans/components/ActionPlanStatusBadge.d.ts

@@ -0,0 +1,18 @@
+import { ETaskPlanStatus } from '../types';
+interface ActionPlanStatusBadgeProps {
+    status: ETaskPlanStatus;
+    labels?: Record<ETaskPlanStatus, string>;
+    className?: string;
+    size?: 'sm' | 'md' | 'lg';
+    showIcon?: boolean;
+    variant?: 'filled' | 'outline' | 'ghost';
+}
+/**
+ * Badge de status do plano de ação com cores dinâmicas.
+ * Wrapper do StatusBadge genérico com mapeamento de ETaskPlanStatus.
+ *
+ * @example
+ * ActionPlanStatusBadge();
+ */
+export declare function ActionPlanStatusBadge({ status, labels, className, size, showIcon, variant, }: ActionPlanStatusBadgeProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/action-plans/action-plans/constants.d.ts

@@ -0,0 +1,86 @@
+import { ETaskPlanStatus, ETaskPlanPriority } from './types';
+/**
+ * Cores de background por status
+ * Portado de FlcActionPlansService.getStatusColorById
+ *
+ * @example
+ * <STATUS_COLORS />
+ */
+export declare const STATUS_COLORS: Record<ETaskPlanStatus, string>;
+/**
+ * Cores de texto por status
+ *
+ * @example
+ * <STATUS_TEXT_COLORS />
+ */
+export declare const STATUS_TEXT_COLORS: Record<ETaskPlanStatus, string>;
+/**
+ * Mapa de status para chave i18n / identificador
+ * Portado de FlcActionPlansService.getTaskPlanStatusMap
+ *
+ * @example
+ * <STATUS_MAP />
+ */
+export declare const STATUS_MAP: Record<ETaskPlanStatus, string>;
+/**
+ * Labels para status (i18n)
+ * Retorna um objeto traduzido — deve ser chamado em tempo de renderização.
+ */
+export declare function getStatusLabels(): Record<ETaskPlanStatus, string>;
+/**
+ * @deprecated Use getStatusLabels() instead
+ *
+ * @example
+ * <STATUS_LABELS />
+ */
+export declare const STATUS_LABELS: Record<ETaskPlanStatus, string>;
+/**
+ * Tipos de ação (i18n)
+ */
+export declare function getActionTypes(): {
+    id: string;
+    label: string;
+}[];
+/**
+ * @deprecated Use getActionTypes() instead
+ *
+ * @example
+ * <DEFAULT_ACTION_TYPES />
+ */
+export declare const DEFAULT_ACTION_TYPES: {
+    id: string;
+    label: string;
+}[];
+/**
+ * Prioridades (i18n)
+ */
+export declare function getPriorities(): {
+    id: ETaskPlanPriority;
+    label: string;
+    color: string;
+}[];
+/**
+ * @deprecated Use getPriorities() instead
+ *
+ * @example
+ * <PRIORITIES />
+ */
+export declare const PRIORITIES: {
+    id: ETaskPlanPriority;
+    label: string;
+    color: string;
+}[];
+/**
+ * Status considerados "fechados" (não editáveis)
+ *
+ * @example
+ * <CLOSED_STATUSES />
+ */
+export declare const CLOSED_STATUSES: ETaskPlanStatus[];
+/**
+ * Status que permitem reporte de progresso
+ *
+ * @example
+ * <PROGRESS_ALLOWED_STATUSES />
+ */
+export declare const PROGRESS_ALLOWED_STATUSES: ETaskPlanStatus[];

package/dist/action-plans/action-plans/hooks/useActionPlan.d.ts

@@ -0,0 +1,19 @@
+import type { ActionPlan, ActionPlanPageProps, ETaskPlanStatus } from '../types';
+/**
+ * Função utilitária `useActionPlan`.
+ * @example
+ * useActionPlan();
+ */
+export declare function useActionPlan(props: ActionPlanPageProps): {
+    formData: Partial<ActionPlan>;
+    isLoading: boolean;
+    isSaving: boolean;
+    activeTab: string;
+    isFormDisabled: boolean;
+    updateField: (field: keyof ActionPlan, value: any) => void;
+    setActiveTab: (tab: string) => void;
+    save: () => Promise<void>;
+    changeStatus: (newStatus: ETaskPlanStatus) => Promise<void>;
+    remove: () => Promise<void>;
+    cancel: () => void;
+};

package/dist/action-plans/action-plans/hooks/useActionPlanProgress.d.ts

@@ -0,0 +1,20 @@
+import type { ActionPlanReport, ActionPlanPageProps } from '../types';
+/**
+ * Função utilitária `useActionPlanProgress`.
+ * @example
+ * useActionPlanProgress();
+ */
+export declare function useActionPlanProgress(props: ActionPlanPageProps): {
+    progress: import("..").ActionPlanProgress;
+    canReportProgress: boolean;
+    isSubmitting: boolean;
+    editingReport: ActionPlanReport;
+    setEditingReport: import("react").Dispatch<import("react").SetStateAction<ActionPlanReport>>;
+    reportProgress: (data: {
+        percentProgress: number;
+        timeProgress: string;
+        comments?: string;
+    }) => Promise<void>;
+    editProgress: (report: ActionPlanReport) => Promise<void>;
+    deleteProgress: (reportId: string) => Promise<void>;
+};

package/dist/action-plans/action-plans/index.d.ts

@@ -0,0 +1,15 @@
+export { ActionPlanPage } from './components/ActionPlanPage';
+export { ActionPlanGeneralTab } from './components/ActionPlanGeneralTab';
+export { ActionPlanProgressTab } from './components/ActionPlanProgressTab';
+export { ActionPlanPredecessorsTab } from './components/ActionPlanPredecessorsTab';
+export { ActionPlanCostTab } from './components/ActionPlanCostTab';
+export { ActionPlanCommentsTab } from './components/ActionPlanCommentsTab';
+export { ActionPlanHistoryTab } from './components/ActionPlanHistoryTab';
+export { ActionPlanAttachmentsTab } from './components/ActionPlanAttachmentsTab';
+export { ActionPlanStatusBadge } from './components/ActionPlanStatusBadge';
+export { ActionPlanProgressDialog } from './components/ActionPlanProgressDialog';
+export { useActionPlan } from './hooks/useActionPlan';
+export { useActionPlanProgress } from './hooks/useActionPlanProgress';
+export * from './types';
+export * from './constants';
+export { formatTime, formatTimeProgress, getProgressColor } from './utils/formatTime';