forlogic-core 2.5.0 → 2.5.2

package/dist/sign/utils/formatters/currencyFormatters.d.ts

@@ -0,0 +1 @@
+export declare const formatCurrency: (value: number | undefined | null, currency?: string, locale?: string) => string;

package/dist/sign/utils/formatters/dateFormatters.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Formata uma string ISO 8601 para o formato de data/hora especificado,
+ * convertendo para o timezone do usuário
+ *
+ * @param dateString - String de data no formato ISO 8601 (ex: "2024-03-15T14:30:00Z")
+ * @param datetimeFormat - Máscara de formato date-fns (ex: "dd/MM/yyyy HH:mm")
+ * @param timezone - Identificador IANA do fuso horário (ex: "America/Sao_Paulo")
+ * @param locale - Código do locale para formatação de nomes de mês/dia
+ * @returns String formatada no timezone especificado ou mensagem de erro
+ *
+ * @example
+ * ```ts
+ * // Data UTC sendo exibida em Brasília (UTC-3)
+ * formatDatetime("2024-03-15T17:30:00Z", "dd/MM/yyyy HH:mm", "America/Sao_Paulo");
+ * // "15/03/2024 14:30"
+ *
+ * // Mesma data em Tokyo (UTC+9)
+ * formatDatetime("2024-03-15T17:30:00Z", "dd/MM/yyyy HH:mm", "Asia/Tokyo");
+ * // "16/03/2024 02:30"
+ *
+ * // Com formato americano
+ * formatDatetime("2024-03-15T17:30:00Z", "MM/dd/yyyy hh:mm a", "America/New_York", "en-US");
+ * // "03/15/2024 01:30 PM"
+ * ```
+ */
+export declare const formatDatetime: (dateString: string, datetimeFormat?: string, timezone?: string, locale?: string) => string;
+/**
+ * Formata uma string ISO 8601 para formato de data localizado (sem hora),
+ * convertendo para o timezone do usuário
+ *
+ * Usa o formato 'PP' do date-fns que se adapta automaticamente ao locale:
+ * - pt-BR: "15 de mar. de 2024"
+ * - en-US: "Mar 15, 2024"
+ * - es-ES: "15 mar 2024"
+ *
+ * @param dateString - String de data no formato ISO 8601
+ * @param locale - Código do locale para formatação
+ * @param timezone - Identificador IANA do fuso horário (para determinar a data correta)
+ * @returns String formatada ou mensagem de erro
+ *
+ * @example
+ * ```ts
+ * // Data UTC às 23:00 em Brasília ainda é dia 15
+ * formatDate("2024-03-15T23:00:00Z", "pt-BR", "America/Sao_Paulo");
+ * // "15 de mar. de 2024"
+ *
+ * // Mas em Tokyo (UTC+9) já é dia 16
+ * formatDate("2024-03-15T23:00:00Z", "en-US", "Asia/Tokyo");
+ * // "Mar 16, 2024"
+ * ```
+ */
+export declare const formatDate: (dateString: string, locale?: string, timezone?: string) => string;

package/dist/sign/utils/index.d.ts

@@ -0,0 +1,9 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+export declare const trimTextFields: (data: any) => any;
+export { formatDatetime, formatDate } from './formatters/dateFormatters';
+export { formatCurrency } from './formatters/currencyFormatters';
+export declare const debounce: <T extends (...args: any[]) => any>(func: T, wait: number) => ((...args: Parameters<T>) => void);
+export declare const slugify: (text: string) => string;
+export { generatePastelBg, getLuminance, getContrastRatio } from './color';
+export { handleExternalLink, buildModuleUrl } from './linkHelpers';

package/dist/sign/utils/linkHelpers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Abre link externo em nova aba ou copia para clipboard se bloqueado pelo navegador
+ */
+export declare function handleExternalLink(url: string, e?: React.MouseEvent): void;
+/**
+ * Substitui placeholders `{alias}` em uma URL de módulo pelo alias ativo.
+ * Se alias não fornecido, retorna a URL original.
+ */
+export declare function buildModuleUrl(urlTemplate: string, alias?: string): string;

package/dist/sign/utils/load-fonts.d.ts

@@ -0,0 +1 @@
+export declare function loadForlogicFonts(): void;

package/docs/WORKSPACE_KNOWLEDGE.md

@@ -46,6 +46,7 @@
 | Spec do módulo Queries | `spec/queries.md` |
 | Inventário de Supabase Storage | `docs/STORAGE_BUCKETS.md` |
 | **Guardrails de Segurança (normativo)** | **`docs/SECURITY.md`** |
+| **Tokens Qualiex (access + id, claims, headers)** | **`lib/auth/TOKENS.md`** |
 
 ---
 

package/docs/sql/import/00_infra.sql

@@ -0,0 +1,210 @@
+/*
+    Infraestrutura compartilhada do fluxo de importação (staging).
+    Executar UMA ÚNICA VEZ por base, antes das procedures validate_*.
+*/
+
+USE [qualiex_common]
+GO
+
+IF NOT EXISTS (SELECT 1 FROM [dbo].[imports_types] WHERE [id] = N'5')
+BEGIN
+    INSERT INTO [dbo].[imports_types] ([id], [name])
+    VALUES (N'5', N'Staging')
+END
+GO
+
+IF SCHEMA_ID('import') IS NULL
+    EXEC('CREATE SCHEMA import')
+GO
+
+IF OBJECT_ID(N'import.batches', N'U') IS NULL
+BEGIN
+    CREATE TABLE import.batches
+    (
+        id              UNIQUEIDENTIFIER PRIMARY KEY DEFAULT NEWSEQUENTIALID(),
+        entity_name     VARCHAR(100) NOT NULL,
+        status          VARCHAR(30)  NOT NULL DEFAULT 'PENDING',
+        total_rows      INT NULL,
+        valid_rows      INT NULL,
+        error_rows      INT NULL,
+        created_at      DATETIME2 NOT NULL DEFAULT SYSUTCDATETIME(),
+        started_at      DATETIME2 NULL,
+        finished_at     DATETIME2 NULL,
+
+        CONSTRAINT chk_import_batches_status
+            CHECK
+            (
+                status IN
+                (
+                    'PENDING',
+                    'PROCESSING',
+                    'PROCESSED',
+                    'PROCESSED_WITH_ERRORS',
+                    'FAILED'
+                )
+            )
+    )
+END
+GO
+
+IF OBJECT_ID(N'import.errors', N'U') IS NULL
+BEGIN
+    CREATE TABLE import.errors
+    (
+        id          INT IDENTITY PRIMARY KEY,
+        id_batch    UNIQUEIDENTIFIER NOT NULL,
+        row_num     INT NOT NULL,
+        error_msg   NVARCHAR(2000) NOT NULL,
+        created_at  DATETIME2 NOT NULL DEFAULT SYSUTCDATETIME()
+    )
+
+    ALTER TABLE import.errors
+        ADD CONSTRAINT FK_import_errors_batch
+        FOREIGN KEY (id_batch) REFERENCES import.batches(id)
+END
+GO
+
+CREATE OR ALTER PROCEDURE import.process_batch
+(
+    @id_batch UNIQUEIDENTIFIER,
+    @tablename SYSNAME
+)
+AS
+BEGIN
+
+    SET NOCOUNT ON;
+    SET XACT_ABORT ON;
+
+    DECLARE
+        @sql                    NVARCHAR(MAX),
+        @lock_result            INT,
+        @validation_procedure   SYSNAME,
+        @staging_table          SYSNAME,
+        @total                  INT,
+        @errors                 INT;
+
+    -- DEFINIÇÕES DINÂMICAS
+    SET @validation_procedure = 'validate_' + @tablename;
+    SET @staging_table = @tablename + '_staging';
+
+    IF NOT EXISTS
+    (
+        SELECT 1
+        FROM sys.procedures
+        WHERE name = @validation_procedure
+        AND schema_id = SCHEMA_ID('import')
+    )
+    THROW 50003, 'Procedure de validação não encontrada.', 1;
+
+
+    BEGIN TRY
+
+        -- LOCK DE CONCORRÊNCIA
+        EXEC @lock_result = sp_getapplock
+            @Resource = @id_batch,
+            @LockMode = 'Exclusive',
+            @LockOwner = 'Session',
+            @LockTimeout = 10000;
+
+        IF @lock_result < 0
+            THROW 50001, 'Não foi possível obter lock do batch.', 1;
+
+
+        -- MARCAR PROCESSANDO
+        UPDATE import.batches WITH (UPDLOCK, ROWLOCK)
+        SET
+            status = 'PROCESSING',
+            started_at = SYSUTCDATETIME()
+        WHERE id = @id_batch
+        AND status = 'PENDING';
+
+        IF @@ROWCOUNT = 0
+            THROW 50002, 'Batch inválido ou não está PENDING.', 1;
+
+
+        BEGIN TRAN;
+
+
+        -- LIMPAR ERROS
+        DELETE FROM import.errors WHERE id_batch = @id_batch;
+
+        -- EXECUTAR VALIDAÇÃO
+        SET @sql =
+            'EXEC [import].'
+            + QUOTENAME(@validation_procedure)
+            + ' @id_batch=@id_batch';
+
+        EXEC sp_executesql
+            @sql,
+            N'@id_batch UNIQUEIDENTIFIER',
+            @id_batch;
+
+
+        -- CONTAR TOTAL DE LINHAS
+        SET @sql =
+        '
+        SELECT
+            @total_out = COUNT(*)
+        FROM [import].' + QUOTENAME(@staging_table) + '
+        WHERE id_batch = @id_batch
+        ';
+
+        EXEC sp_executesql
+            @sql,
+            N'@id_batch UNIQUEIDENTIFIER, @total_out INT OUTPUT',
+            @id_batch,
+            @total OUTPUT;
+
+
+        -- CONTAR LINHAS COM ERRO
+        SELECT
+            @errors = COUNT(DISTINCT row_num)
+        FROM import.errors
+        WHERE id_batch = @id_batch;
+
+
+        -- FINALIZAR BATCH
+        UPDATE import.batches
+        SET
+            total_rows = @total,
+            error_rows = @errors,
+            valid_rows = @total - @errors,
+
+            status =
+                CASE
+                    WHEN @errors > 0
+                        THEN 'PROCESSED_WITH_ERRORS'
+                    ELSE 'PROCESSED'
+                END,
+
+            finished_at = SYSUTCDATETIME()
+        WHERE id = @id_batch;
+
+        COMMIT;
+
+        EXEC sp_releaseapplock
+            @Resource = @id_batch,
+            @LockOwner = 'Session';
+
+    END TRY
+    BEGIN CATCH
+
+        IF @@TRANCOUNT > 0
+            ROLLBACK;
+
+        UPDATE import.batches
+        SET
+            status = 'FAILED',
+            finished_at = SYSUTCDATETIME()
+        WHERE id = @id_batch;
+
+        EXEC sp_releaseapplock
+            @Resource = @id_batch,
+            @LockOwner = 'Session';
+
+        THROW;
+
+    END CATCH
+
+END
+GO

package/docs/sql/import/validate_criteria.sql

@@ -0,0 +1,209 @@
+-- =============================================================
+-- Procedures de importação — Fornecedores | Parâmetros | Critérios
+-- Banco: qualiex_common (SQL Server)
+-- Dispatch dinâmico: import.process_batch resolve pelo table_name
+--   (@tablename = 'criteria').
+--
+-- Colunas esperadas no CSV (ordem do template):
+--   1)  Título                 -> title             (obrigatório)
+--   2)  Etapa de seleção       -> selection_stage   (Sim/Não)
+--   3)  Etapa de aquisição     -> acquisition_stage (Sim/Não)
+--   4)  Tipo de resposta       -> id_answer_type    (obrigatório, int)
+--   5)  Critério               -> type              (obrigatório, 1 Mérito / 2 Demérito)
+--   6)  Valor do demérito      -> demerit_value     (decimal, aceita vírgula)
+--   7)  Critério obrigatório   -> required          (Sim/Não)
+--   8)  Ocorrências            -> is_occurrences    (Sim/Não)
+--   9)  Como avaliar           -> how_to_evaluate   (opcional)
+--   10) Situação               -> is_active         (Ativo/Inativo, default Ativo)
+--   11) Emissor                -> id_creation_user  (obrigatório, lookup users)
+--
+-- id_company é resolvido pelo backend a partir do contexto da unidade.
+--
+-- Nota de collation:
+--   Colunas texto/ID usam Latin1_General_CS_AS explicitamente para
+--   evitar conflito de collation com a base de produção.
+-- =============================================================
+
+USE [qualiex_common]
+GO
+
+IF EXISTS (SELECT * FROM sys.objects 
+           WHERE object_id = OBJECT_ID(N'[import].[criteria_staging]') 
+             AND type IN (N'U'))
+    DROP TABLE [import].[criteria_staging]
+GO
+
+CREATE TABLE [import].[criteria_staging](
+    [id_batch]             [uniqueidentifier] NOT NULL,
+    [row_num]              [int]              NOT NULL,
+    [title]                [varchar](500)     COLLATE Latin1_General_CS_AS NOT NULL,
+    [selection_stage]      [varchar](20)      COLLATE Latin1_General_CS_AS NULL,
+    [acquisition_stage]    [varchar](20)      COLLATE Latin1_General_CS_AS NULL,
+    [id_answer_type]       [int]              NULL,
+    [how_to_evaluate]      [nvarchar](max)    COLLATE Latin1_General_CS_AS NULL,
+    [required]             [varchar](20)      COLLATE Latin1_General_CS_AS NULL,
+    [type]                 [int]              NULL, 
+    [demerit_value]        [varchar](20)      COLLATE Latin1_General_CS_AS NULL,
+    [is_active]            [varchar](20)      COLLATE Latin1_General_CS_AS NULL,
+    [is_occurrences]       [varchar](20)      COLLATE Latin1_General_CS_AS NULL, 
+    [id_creation_user]     [char](8)          COLLATE Latin1_General_CS_AS NOT NULL,
+    [id_company]           [char](8)          COLLATE Latin1_General_CS_AS NOT NULL,
+ CONSTRAINT [pk_criteria_staging] PRIMARY KEY CLUSTERED 
+(
+    [id_batch] ASC,
+    [row_num]  ASC
+) WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, 
+        ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON, 
+        OPTIMIZE_FOR_SEQUENTIAL_KEY = OFF) ON [PRIMARY]
+) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]
+GO
+
+USE [qualiex_common]
+GO
+
+CREATE OR ALTER PROCEDURE [import].[validate_criteria]
+    @id_batch UNIQUEIDENTIFIER
+AS
+BEGIN
+    SET NOCOUNT ON;
+
+    -- Validação 1: Título duplicado dentro do próprio lote
+    INSERT INTO import.errors (id_batch, row_num, error_msg)
+    SELECT @id_batch, sub.row_num, 'Título duplicado no arquivo'
+    FROM (
+        SELECT *, COUNT(*) OVER (PARTITION BY title) AS cnt
+        FROM import.criteria_staging WITH (NOLOCK)
+        WHERE id_batch = @id_batch
+    ) sub
+    WHERE sub.cnt > 1;
+
+    -- Validação 2: Título já existente na produção (mesma unidade)
+    INSERT INTO import.errors (id_batch, row_num, error_msg)
+    SELECT @id_batch, cs.row_num, 'Critério já existe na base para esta unidade'
+    FROM import.criteria_staging cs WITH (NOLOCK)
+    INNER JOIN suppliers.criteria c WITH (NOLOCK)
+        ON c.title COLLATE Latin1_General_CS_AS = cs.title 
+       AND c.removed = 0
+       AND c.id_company COLLATE Latin1_General_CS_AS = cs.id_company 
+    WHERE cs.id_batch = @id_batch;
+
+    -- Validação 3: Validação de Situação (Ativo / Inativo)
+    INSERT INTO import.errors (id_batch, row_num, error_msg)
+    SELECT @id_batch, cs.row_num, 'Situação inválida (selecione Ativo ou Inativo na planilha)'
+    FROM import.criteria_staging cs WITH (NOLOCK)
+    WHERE cs.id_batch = @id_batch
+      AND ISNULL(cs.is_active, '') NOT IN ('Ativo', 'Inativo', '');
+
+    -- Validação 4: Validação de booleanos genéricos (Sim / Não)
+    INSERT INTO import.errors (id_batch, row_num, error_msg)
+    SELECT @id_batch, cs.row_num, 'Valor inválido para campos de Sim/Não (Certifique-se de escolher Sim ou Não na planilha)'
+    FROM import.criteria_staging cs WITH (NOLOCK)
+    WHERE cs.id_batch = @id_batch
+      AND (
+             ISNULL(cs.selection_stage, '') NOT IN ('Sim', 'Não', '')
+          OR ISNULL(cs.acquisition_stage, '') NOT IN ('Sim', 'Não', '')
+          OR ISNULL(cs.required, '') NOT IN ('Sim', 'Não', '')
+          OR ISNULL(cs.is_occurrences, '') NOT IN ('Sim', 'Não', '')
+      );
+
+    -- Validação 5: Validação de número Decimal (demerit_value)
+    INSERT INTO import.errors (id_batch, row_num, error_msg)
+    SELECT @id_batch, cs.row_num, 'Valor de demérito inválido. Insira um número válido.'
+    FROM import.criteria_staging cs WITH (NOLOCK)
+    WHERE cs.id_batch = @id_batch
+      AND cs.demerit_value IS NOT NULL 
+      AND TRY_CAST(REPLACE(cs.demerit_value, ',', '.') AS DECIMAL(6,2)) IS NULL;
+
+    -- INSERÇÃO DOS DADOS VÁLIDOS
+    INSERT INTO suppliers.criteria
+        (
+            id_company,
+            title,
+            selection_stage,
+            acquisition_stage,
+            id_answer_type,
+            how_to_evaluate,
+            how_to_evaluate_text,
+            required,
+            id_creation_user,
+            id_last_modified_user,
+            creation_date,
+            last_modified,
+            is_active,
+            removed,
+            type,
+            demerit_value,
+            is_occurrences
+        )
+    SELECT
+        cs.id_company,
+        cs.title,
+
+        CASE WHEN cs.selection_stage = 'Sim' THEN 1 ELSE 0 END AS selection_stage,
+        CASE WHEN cs.acquisition_stage = 'Sim' THEN 1 ELSE 0 END AS acquisition_stage,
+        
+        ISNULL(cs.id_answer_type, 0) AS id_answer_type, 
+        
+        NULLIF(cs.how_to_evaluate, '') AS how_to_evaluate,
+        NULLIF(cs.how_to_evaluate, '') AS how_to_evaluate_text,
+
+        CASE WHEN cs.required = 'Sim' THEN 1 ELSE 0 END AS required,
+
+        cs.id_creation_user,
+        cs.id_creation_user AS id_last_modified_user,
+        SYSDATETIMEOFFSET() AS creation_date,
+        SYSDATETIMEOFFSET() AS last_modified,
+
+        CASE WHEN cs.is_active = 'Inativo' THEN 0 ELSE 1 END AS is_active,
+        0 AS removed,
+        
+        ISNULL(cs.type, 0) AS type,
+        ISNULL(TRY_CAST(REPLACE(cs.demerit_value, ',', '.') AS DECIMAL(6,2)), 0.00) AS demerit_value,
+        
+        CASE WHEN cs.is_occurrences = 'Sim' THEN 1 ELSE 0 END AS is_occurrences
+
+    FROM import.criteria_staging cs WITH (NOLOCK)
+    WHERE cs.id_batch = @id_batch
+      AND NOT EXISTS (
+          SELECT 1 
+          FROM import.errors e 
+          WHERE e.id_batch = cs.id_batch 
+            AND e.row_num = cs.row_num
+      );
+
+END
+GO
+
+USE [qualiex_common]
+GO
+
+CREATE OR ALTER PROCEDURE [import].[get_errors_criteria]
+(
+    @id_batch UNIQUEIDENTIFIER
+)
+AS
+BEGIN
+    SET NOCOUNT ON;
+
+    SELECT 
+        STRING_AGG(
+            CAST(e.error_msg AS NVARCHAR(MAX)), 
+            '; '
+        ) WITHIN GROUP (ORDER BY e.error_msg) AS error_msg,
+        
+        e.row_num,
+        cs.title,
+        cs.id_creation_user
+
+    FROM import.errors e WITH (NOLOCK)
+    JOIN import.criteria_staging cs WITH (NOLOCK)
+        ON cs.row_num  = e.row_num
+       AND cs.id_batch = e.id_batch
+    WHERE e.id_batch = @id_batch
+    GROUP BY 
+        e.row_num,
+        cs.title,
+        cs.id_creation_user
+    ORDER BY e.row_num;
+END
+GO