forlogic-core 1.16.2 → 1.16.3

package/.note/memory/features/import/attachment-idempotency-registry.md

@@ -0,0 +1,8 @@
+# Memory: features/import/attachment-idempotency-registry
+Updated: now
+
+## REMOVIDO
+
+O controle de idempotência via tabela `common.imports_file_registry` foi removido para simplificar o fluxo de importação de anexos. Agora todo arquivo válido (>0 bytes) é enviado diretamente ao Azure Blob Storage sem verificar se já existe no registry. As funções `lookupExistingFiles`, `registerUploadedFiles` e o campo `newFiles` do `UploadResult` foram removidos de `attachmentUploadService.ts`.
+
+A tabela `common.imports_file_registry` no Supabase pode ser removida manualmente se desejado — a aplicação não a consulta mais.

package/.note/memory/features/import/attachment-strategy.md

@@ -1,18 +1,30 @@
 # Memory: features/import/attachment-strategy
 Updated: now
 
-O sistema de anexos usa upload direto ao Azure Blob Storage (sem staging). O .zip contém pastas nomeadas pelo código do registro (ex: `OC-001/foto.pdf`). Cada arquivo recebe um `id_file_revision` de 8 caracteres alfanuméricos (`crypto.randomUUID().slice(0,8)`) gerado no front-end. O arquivo é enviado ao container `un{id_company_padded_5}` com nome `{id_file_revision}.{ext}`. Esse mesmo ID é incluído no CSV como coluna `id_file_revision` para que a API grave no banco com a mesma referência. Metadados (nome, extensão, tamanho, usuário, revision) são injetados automaticamente nas linhas do CSV via campos `data_type: 'file'` e `'file_metadata'`. A Edge Function `azure-blob-upload` aceita campo `container` opcional no FormData.
+O sistema de anexos usa upload direto ao Azure Blob Storage (sem staging). O .zip contém pastas nomeadas pelo código do registro (ex: `OC-001/foto.pdf`). Cada arquivo recebe um `id_file_revision` de 8 caracteres alfanuméricos (`crypto.randomUUID().slice(0,8)`) gerado no front-end. O arquivo é enviado ao container `un{id_company}` com nome `{id_file_revision}.{ext}`. Esse mesmo ID é incluído no CSV como coluna `id_file_revision` para que a API grave no banco com a mesma referência.
+
+## Idempotência via `common.imports_file_registry`
+
+Tabela Supabase com PK `CHAR(8)` (o próprio `id_file_revision`) e constraint `UNIQUE(alias, code, file_name)`:
+- Se `(alias, code, file_name)` já existe com **mesmo tamanho** → reutiliza `id_file_revision` e `blob_url`, **não faz upload**
+- Se existe com **tamanho diferente** → erro de conflito
+- Se não existe → gera novo ID, faz upload, registra no registry **somente após sucesso da API**
+- Arquivos com 0 bytes são rejeitados imediatamente
+
+## Fluxo de consistência
+
+1. Upload para Azure (novos arquivos)
+2. Envio do CSV para API staging
+3. **Se API sucesso** → `registerUploadedFiles()` grava no registry
+4. **Se API falhar** → registry NÃO é gravado, próxima tentativa refaz upload
 
 ## Templates de anexo (attachment-only)
 
-Quando todos os campos ativos do template são `data_type: 'file'` ou `'file_metadata'`, o sistema detecta automaticamente como "template de anexo". Nesse modo:
+Quando `import_target === 'attachments'` ou todos os campos ativos são `file`/`file_metadata`, o sistema detecta automaticamente. Nesse modo:
 - O .zip **não precisa conter xlsx** — apenas pastas com arquivos
-- O código do registro é extraído do **diretório pai imediato** do arquivo (último nível): `dir1/dir2/file.txt → "dir2"`
-- As linhas do CSV são geradas automaticamente a partir dos metadados dos arquivos
-- O botão "Baixar template" é substituído por "Gerenciar template"
-- O dropzone aceita apenas `.zip`
-- Não há fetch de lookups nem validação de colunas
-- Função `executeAttachmentOnlyImport` no `importHelpers.ts` orquestra o fluxo completo
-- Função `buildRowsFromAttachments` no `attachmentUploadService.ts` gera as linhas
-- Função `extractZipAttachmentsOnly` no `zipExtractorService.ts` extrai sem exigir xlsx
-- Detecção via `isAttachmentOnlyTemplate` no `attachmentUploadService.ts`
+- O código é extraído do **diretório pai imediato** do arquivo
+- As linhas do CSV são geradas automaticamente a partir dos metadados
+- Função `executeAttachmentOnlyImport` orquestra o fluxo completo
+- `buildRowsFromAttachments` gera as linhas
+- `extractZipAttachmentsOnly` extrai sem exigir xlsx
+- `isAttachmentOnlyTemplate` detecta o tipo

package/dist/hooks/useModuleAccess.d.ts

@@ -2,17 +2,16 @@ import type { ModuleAccessResult } from '../types';
 /**
  * Hook para verificar se o usuário logado tem acesso a um módulo específico.
  *
- * Busca a lista de softwares e as associações do usuário via API Qualiex,
- * cruza os dados e retorna se o usuário tem acesso ao módulo configurado.
+ * Usa um mapa estático de softwares (alias → id) e busca apenas as associações
+ * do usuário via API Qualiex para verificar acesso.
  *
  * **Pré-requisitos:**
  * - O projeto deve configurar `moduleAlias` no `CoreProviders`
  * - O usuário deve estar autenticado (via `useAuth`)
  *
  * **Cache:**
- * - Softwares: cache de 30 minutos (raramente muda)
  * - Associações: cache de 10 minutos (pode mudar com permissões)
- * - Ambos são limpos automaticamente no `switchUnit`
+ * - Limpo automaticamente no `switchUnit`
  *
  * @param moduleAliasOverride - Alias opcional para verificar acesso a outro módulo
  *                               (ignora o alias configurado no CoreProviders)