forlogic-core 2.0.6 → 2.0.8

package/{.note/memory → docs/design-system}/patterns/feature-flags.md

@@ -7,6 +7,7 @@
 | `VITE_SHOW_USER_PREFERENCES` | Exibe "Preferências" no menu do usuário (idioma, timezone, formato de data) | Não exibe |
 | `VITE_I18N_DEBUG_MODE` | Modo debug de i18n (mostra chaves ao invés de traduções) | `"false"` |
 | `VITE_IS_QUALIEX` | Usa logos Qualiex ao invés de Forlogic | `"false"` |
+| `VITE_SHOW_EDIT_PROFILE` | Exibe "Editar Perfil" no menu do usuário (foto e idioma) | Não exibe |
 
 ## Uso
 

package/{.note/memory/patterns/header-metadata-pattern.md → docs/design-system/patterns/header-metadata.md}

@@ -5,7 +5,7 @@
 **O padrão da aplicação é exibir título, subtítulo e breadcrumbs no header** usando `usePageMetadata()`.
 
 - **NÃO** usar `BodyContent` ou `ContentContainer` com título/subtítulo internos por padrão.
-- Breadcrumbs, títulos e subtítulos internos ao conteúdo são **exceções** e devem ser usados **somente quando explicitamente solicitados** pelo usuário.
+- Breadcrumbs, títulos e subtítulos internos ao conteúdo são **exceções** e devem ser usados **somente quando explicitamente solicitados**.
 
 ## Uso Padrão
 
@@ -55,8 +55,3 @@ usePageMetadata({
   </ContentContainer>
 </BodyContent>
 ```
-
-## Quando usar breadcrumbs/título interno
-
-- Apenas quando o usuário **pedir explicitamente** breadcrumbs ou título dentro do conteúdo.
-- Páginas com navegação hierárquica profunda podem justificar breadcrumbs, mas sempre confirmar antes.

package/docs/design-system/patterns/i18n-setup.md

@@ -0,0 +1,117 @@
+# Padrão: Setup de Traduções (i18n)
+
+## Arquitetura de namespaces
+
+- `core` — traduções base da lib (save, cancel, delete, etc.)
+- `app` — traduções do projeto consumidor (injetadas via `CoreProviders`)
+- Resolução: `app` → `core` → fallback `pt-BR`
+
+## Setup em projetos consumidores
+
+### Projeto simples (poucas chaves)
+
+1. Criar JSON flat em `src/i18n/pt-BR.json`: `{ "key": "value" }` (sem nesting)
+2. Passar para CoreProviders:
+
+```tsx
+<CoreProviders appTranslations={{ 'pt-BR': ptBR, 'en-US': enUS }}>
+```
+
+3. Usar `useTranslation` de `forlogic-core` (nunca de `react-i18next`)
+
+### Projeto modular (múltiplas features)
+
+Para módulos com muitas chaves, dividir traduções por feature:
+
+```text
+src/i18n/
+├── pt-BR/
+│   ├── common.json          ← chaves gerais do módulo
+│   ├── matrices.json        ← feature: matrizes
+│   ├── requirements.json    ← feature: requisitos
+│   └── reports.json         ← feature: relatórios
+├── en-US/
+│   ├── common.json
+│   ├── matrices.json
+│   ├── requirements.json
+│   └── reports.json
+└── index.ts                 ← merge automático
+```
+
+#### Arquivo `src/i18n/index.ts`
+
+```ts
+import { mergeTranslationFiles } from 'forlogic-core/i18n';
+
+import ptCommon from './pt-BR/common.json';
+import ptMatrices from './pt-BR/matrices.json';
+import ptRequirements from './pt-BR/requirements.json';
+import ptReports from './pt-BR/reports.json';
+
+import enCommon from './en-US/common.json';
+import enMatrices from './en-US/matrices.json';
+import enRequirements from './en-US/requirements.json';
+import enReports from './en-US/reports.json';
+
+export const appTranslations = {
+  'pt-BR': mergeTranslationFiles(ptCommon, ptMatrices, ptRequirements, ptReports),
+  'en-US': mergeTranslationFiles(enCommon, enMatrices, enRequirements, enReports),
+};
+```
+
+#### Uso no App
+
+```tsx
+import { CoreProviders } from 'forlogic-core';
+import { appTranslations } from './i18n';
+
+function App() {
+  return (
+    <CoreProviders appTranslations={appTranslations}>
+      <BrowserRouter><Routes /></BrowserRouter>
+    </CoreProviders>
+  );
+}
+```
+
+## Regras dos JSONs
+
+- Formato **flat** (sem nesting): `{ "key": "value" }`
+- Chaves duplicadas entre arquivos: o último spread vence (common → features)
+- Chaves do `app` sobrescrevem chaves do `core` com mesmo nome
+
+## Resolução de chaves
+
+```
+t('save')       → app: não encontra → core: "Salvar"
+t('objective')  → app: "Objetivo"
+t('save') com override no app → app: "Gravar" (sobrescreve core)
+```
+
+## Helper `mergeTranslationFiles`
+
+Utilitário exportado pela lib para facilitar o merge:
+
+```ts
+import { mergeTranslationFiles } from 'forlogic-core/i18n';
+
+const ptBR = mergeTranslationFiles(common, matrices, requirements);
+// Equivalente a: { ...common, ...matrices, ...requirements }
+```
+
+## Debug
+
+```ts
+import { i18n } from 'forlogic-core';
+console.log('Resources:', i18n.store.data);
+```
+
+## Troubleshooting
+
+| Causa | Solução |
+|-------|---------|
+| Chaves aparecem ao invés de traduções | Instalar peer deps `i18next` e `react-i18next` |
+| Import de `react-i18next` direto | Usar import de `forlogic-core` |
+| `appTranslations` não passado | Adicionar prop no CoreProviders |
+| JSON com formato errado | Deve ser flat, sem nesting |
+| Chave duplicada entre features | Último arquivo no merge vence |

package/{.note/memory/components/pagination-usage.md → docs/design-system/patterns/pagination.md}

@@ -1,5 +1,4 @@
-# Memory: components/pagination-usage
-Updated: now
+# Padrão: Paginação
 
 **SEMPRE** usar `Pagination` ou `CrudPrimitivePagination` da lib. NUNCA implementar manualmente.
 

package/{.note/memory/patterns/single-scroll-pattern.md → docs/design-system/patterns/single-scroll.md}

@@ -1,5 +1,4 @@
-# Memory: patterns/single-scroll-pattern
-Updated: now
+# Padrão: Scroll Único no Viewport
 
 O padrão de Scroll Único evita barras de rolagem duplicadas na aplicação.
 

package/{.note/memory → docs/design-system}/patterns/vite-tailwind-setup.md

@@ -14,9 +14,8 @@ export default defineConfig(({ mode }) => ({
     }),
   ],
   resolve: {
-    alias: { '@': path.resolve(__dirname, './src') }, // DEVE ser absoluto
+    alias: { '@': path.resolve(__dirname, './src') },
   },
-  // optimizeDeps.force: true já vem por padrão via createForlogicViteConfig()
   publicDir: false,
   esbuild: { sourcemap: true, target: 'es2020' },
   build: { chunkSizeWarningLimit: 4000 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forlogic-core",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",

package/.note/memory/features/crud-defaults-batteries-included.md

@@ -1,14 +0,0 @@
-# Memory: features/crud-defaults-batteries-included
-
-Todos os CRUDs (CrudTable, createCrudPage) agora incluem por padrão:
-- **Column resize** (`enableColumnResize=true`) — já era default
-- **Column manager** (`enableColumnManager=true`) — botão ⋮ no header da coluna "Ações"
-- **Sort** — **todas as colunas são ordenáveis por padrão** (`sortable` default `true`). Use `sortable: false` para desabilitar.
-- **Busca** — por padrão usa a busca global do header (não a action bar). Para busca na action bar, usar `showSearch=true`
-- **Storage keys** — `createCrudPage` gera automaticamente `columnManagerStorageKey` e `resizeStorageKey` a partir do `entityName`
-
-**NÃO vem por padrão:**
-- **Agrupamento** (`enableGrouping=false`) — precisa ser habilitado explicitamente com `enableGrouping={true}`
-- **Busca na action bar** (`showSearch=false`) — padrão é busca no header
-
-**Paginação:** padrão de 25 itens por página.

package/.note/memory/features/crud-standardized-config-props.md

@@ -1,3 +0,0 @@
-# Memory: features/crud-standardized-config-props
-
-A interface CrudPageConfig foi estendida para padronizar a experiência do usuário (UX) em todos os CRUDs (createCrudPage, CrudTable, CrudGrid). As novas propriedades incluem: showNewButton (default: true), showSearch (default: true), showBulkActions (alias para enableBulkActions), showActionBar (default: true, substituindo hideActionBar), newButtonLabel (para customizar o texto do botão de criação) e searchPlaceholder. Esta padronização garante que todos os CRUDs ofereçam as mesmas capacidades de busca, criação e ações em lote de forma consistente.

package/.note/memory/patterns/components-registry.md

@@ -1,18 +0,0 @@
-# Memory: documentation/consolidated-components-registry
-Updated: now
-
-Design System maintains a Consolidated Components Registry tracking components documented together under single documentation entries for reusability reference:
-
-- **Breadcrumb** (documents Breadcrumb and PageBreadcrumb)
-- **Calendar & Date Picker** (documents Calendar and DatePicker)
-- **Combobox** (documents Combobox with Command used internally)
-- **Toggle & Group** (documents Toggle and ToggleGroup)
-- **Skeleton** (documents base Skeleton and all skeleton variants)
-- **AppSidebar** (documents AppSidebar, Sidebar base component, SidebarProvider, SidebarMenu*, Collapsible integration)
-- **Accordion** (documents Accordion and Collapsible)
-- **Input** (documents Input, InputGroup, InputGroupAddon, InputGroupButton)
-- **Grid & Stack** (documents Grid and Stack layout components)
-- **Dialog** (documents Dialog, AlertDialog, Sheet positional variants, Drawer)
-- **Tabs** (documents Tabs and TabPageLayout)
-
-This registry must be checked before creating new documentation to avoid duplicates. The Sidebar base component from Shadcn is documented as a subsection within AppSidebarDoc for users who need to create custom sidebars outside the AppLayout context.

package/.note/memory/patterns/crud-action-bar-3-zone-layout.md

@@ -1,3 +0,0 @@
-# Memory: patterns/crud-action-bar-3-zone-layout
-
-O CrudActionBar (lib/crud/components/CrudActionBar.tsx) é o componente compartilhado que unifica a barra de ações de todos os CRUDs do sistema. Ele implementa um layout rígido de 3 zonas: ESQUERDA (Botão Novo + Dropdown de Ações em Lote), CENTRO (Barra de busca centralizada) e DIREITA (Filtros customizados + Toggle de visualização). Este componente substitui as implementações locais de barra de ferramentas no CrudTable, CrudGrid e createCrudPage, garantindo que a barra superior tenha sempre o mesmo visual (bg-muted/50), comportamento e espaçamento, independentemente do componente de visualização de dados utilizado.

package/.note/memory/patterns/crud-bulk-actions-dropdown-standard.md

@@ -1,3 +0,0 @@
-# Memory: patterns/crud-bulk-actions-dropdown-standard
-
-As ações em lote foram unificadas em um dropdown 'Ações em lote' no CrudActionBar. Este menu permanece visível se habilitado, exibindo um badge com a contagem de itens selecionados. As opções internas são desabilitadas se a seleção for zero. O componente BulkActionBar foi removido para evitar barras duplicadas e 'layout shifts'. Na CrudTable, a coluna de ações de linha não deve ter label no cabeçalho (usar apenas ícone ⋮ ou tooltip) para evitar confusão com o menu de ações em lote da toolbar.

package/.note/memory/patterns/i18n-setup.md

@@ -1,43 +0,0 @@
-# Padrão: Setup de Traduções (i18n)
-
-## Arquitetura de namespaces
-
-- `core` — traduções base da lib (save, cancel, delete, etc.)
-- `app` — traduções do projeto consumidor (injetadas via `CoreProviders`)
-- Resolução: `app` → `core` → fallback `pt-BR`
-
-## Setup em projetos consumidores
-
-1. Criar JSONs flat em `src/i18n/pt-BR.json`: `{ "key": "value" }` (sem nesting)
-2. Passar para CoreProviders:
-
-```tsx
-<CoreProviders appTranslations={{ 'pt-BR': ptBR, 'en-US': enUS }}>
-```
-
-3. Usar `useTranslation` de `forlogic-core` (nunca de `react-i18next`)
-
-## Resolução de chaves
-
-```
-t('save')       → app: não encontra → core: "Salvar"
-t('objective')  → app: "Objetivo"
-t('save') com override no app → app: "Gravar" (sobrescreve core)
-```
-
-## Debug
-
-```ts
-import { i18n } from 'forlogic-core';
-console.log('Resources:', i18n.store.data);
-// { 'pt-BR': { core: {...}, app: {...} } }
-```
-
-## Troubleshooting
-
-| Causa | Solução |
-|-------|---------|
-| Chaves aparecem ao invés de traduções | Instalar peer deps `i18next` e `react-i18next` |
-| Import de `react-i18next` direto | Usar import de `forlogic-core` |
-| `appTranslations` não passado | Adicionar prop no CoreProviders |
-| JSON com formato errado | Deve ser flat, sem nesting |

package/docs/AUDIT_PROMPT.md

@@ -1,74 +0,0 @@
-# Prompt de Auditoria — Design System
-
-> **Como usar**: Cole este prompt em uma conversa do Lovable no projeto consumidor para auditar e corrigir violações do Design System.
-
----
-
-## Prompt para copiar
-
-```
-Audite TODOS os arquivos .tsx do projeto em busca de violações do Design System do forlogic-core.
-
-Antes de começar, leia obrigatoriamente via cross-project:
-@Admin docs/design-system/crud.md
-@Admin docs/design-system/inputs.md
-@Admin docs/design-system/selectors.md
-@Admin docs/design-system/layout.md
-@Admin docs/design-system/dialogs.md
-@Admin docs/design-system/buttons-actions.md
-
-Verifique CADA arquivo .tsx contra estas regras:
-
-### Imports inválidos
-- [ ] Import de componente UI que NÃO vem de `forlogic-core` (Button, Dialog, Input, Select, Table, etc.)
-- [ ] Import de `react-i18next` em vez de `useTranslation` de `forlogic-core`
-- [ ] Import de `@/integrations/supabase/client` em vez de `getSupabaseClient()` de `forlogic-core`
-
-### Componentes proibidos
-- [ ] `<Select>` ou `<StatusSelect>` → deve ser `<Combobox>`
-- [ ] `<MoreHorizontal>` genérico como menu de ações → deve ser `<ActionButton>`
-- [ ] `<DeleteConfirmationDialog>` → deve ser `<Dialog>`
-- [ ] `<Searchbar>` → deve ser `<Input>` com ícone de busca
-- [ ] `BulkActionBar` separado → deve ser dropdown no `CrudActionBar`
-- [ ] Paginação manual → deve ser `CrudPrimitivePagination`
-
-### Supabase
-- [ ] Query sem `.schema('SCHEMA_PADRAO')` (qualquer `supabase.from(` direto)
-- [ ] DELETE físico (deve ser soft delete com `deleted_at`)
-- [ ] `supabase` importado diretamente do client em vez de `getSupabaseClient()`
-
-### Layout
-- [ ] Página sem `usePageMetadata` (título/subtítulo)
-- [ ] Layout sem `AppLayout` + `AppSidebar`
-- [ ] Componente criado localmente quando existe equivalente na lib
-
-### Formulários
-- [ ] Formulário sem `BaseForm` ou `react-hook-form` + `zod`
-- [ ] Select nativo HTML em vez de `Combobox`
-
-Para cada violação encontrada, gere um relatório no formato:
-
-| Arquivo | Linha | Violação | Correção |
-|---------|-------|----------|----------|
-| src/pages/X.tsx | 15 | Import de Button local | Usar `import { Button } from 'forlogic-core'` |
-
-Depois do relatório, pergunte se devo corrigir automaticamente.
-```
-
----
-
-## Variações
-
-### Auditoria rápida (apenas imports)
-
-```
-Busque em TODOS os arquivos .tsx do projeto por imports que NÃO vêm de 'forlogic-core'.
-Liste: arquivo, linha, import atual, e o import correto de forlogic-core.
-```
-
-### Auditoria de Supabase
-
-```
-Busque em TODOS os arquivos .ts/.tsx por chamadas a `supabase.from(` sem `.schema('SCHEMA_PADRAO')`.
-Liste: arquivo, linha, query atual, e a correção com .schema().
-```

package/docs/KNOWLEDGE.md

@@ -1,109 +0,0 @@
-# KNOWLEDGE — Regras Críticas do Projeto
-
-> 🤖 **Para IA**: Detalhes de componentes, props e tipos → ler do projeto **Admin** via cross-project.
-> Consulte `.note/memory/` para padrões de layout e componentes.
-
----
-
-## 0. Schema do Projeto
-
-**SCHEMA = `common`**
-
-☝️ Este é o **único local** onde o schema é definido. Toda query Supabase
-**DEVE** usar `.schema('<valor acima>')`. Altere **apenas aqui** ao configurar
-um novo projeto.
-
-```ts
-// ✅ usar o schema definido acima
-supabase.schema('common').from('tabela').select('*');
-// ❌ vai falhar (sem schema)
-supabase.from('tabela').select('*');
-```
-
----
-
-## 1. Regras Invioláveis
-
-| Regra | Detalhe |
-|-------|---------|
-| Schema obrigatório | `.schema()` com o schema do projeto (seção 0) em toda query |
-| Sem DELETE físico | Soft delete com `deleted_at` + policy `FOR UPDATE` |
-| Sem índices automáticos | Apenas com aprovação explícita |
-| Sem modificar `.env` | Apenas com autorização do usuário |
-| Sem hardcoded admin | Nunca localStorage/sessionStorage para roles |
-| Lib-first | Usar `forlogic-core` antes de criar componente |
-| Import do Supabase | Sempre `getSupabaseClient()` de `forlogic-core`, nunca `@/integrations/supabase/client` |
-
----
-
-## 2. RLS — Resumo de Sintaxe
-
-- `SELECT` → `USING` | `INSERT` → `WITH CHECK` | `UPDATE` → `USING` + `WITH CHECK`
-- **Nunca** `FOR DELETE`
-- **Sempre** `(SELECT auth.jwt())` com parênteses (evita re-execução por linha)
-- Padrão multi-tenant: `((SELECT auth.jwt()) ->> 'alias'::text) = alias`
-
----
-
-## 3. Convenções SQL
-
-| Tipo | Padrão | Exemplo |
-|------|--------|---------|
-| FK | `id_<singular>` | `id_process` |
-| Boolean | `is_` / `has_` | `is_active` |
-| Timestamps | `created_at`, `updated_at`, `deleted_at` | — |
-| Tabelas | plural, snake_case | `processes` |
-
----
-
-## 4. Mapa de Módulos (forlogic-core)
-
-> Para props, tipos e implementação: ler do projeto **Admin** (forlogic-core) via cross-project.
-
-| Módulo | Caminho | O que contém |
-|--------|---------|--------------|
-| **UI Components** | `lib/components/ui/` | Button, Dialog, Input, Select, Combobox, Badge, Tabs, etc. |
-| **Layout** | `lib/components/layout/` | AppLayout, AppHeader, AppSidebar, BodyContent |
-| **CRUD** | `lib/crud/` | createCrudPage, CrudTable, CrudGrid, BaseForm, ActionBar |
-| **CRUD Primitives** | `lib/crud/primitives/` | Table, FilterBar, Pagination, ActionMenu, TreeTable |
-| **Auth** | `lib/auth/` | AuthContext, ProtectedRoute, LoginPage, TokenManager |
-| **Módulos** | `lib/components/modules/` | ModulesDialog, ModuleGrid, ModuleAccessGuard |
-| **Places** | `lib/places/` | PlacesList, PlaceCard, ManageAccessModal |
-| **Leadership** | `lib/leadership/` | LeadershipPage, LeadershipDialog |
-| **Media** | `lib/media/` | ImageEditor, VideoEditor, useMediaUpload |
-| **Sign** | `lib/sign/` | SignWidget, D4SignWidget, SignConfigForm |
-| **Qualiex** | `lib/qualiex/` | QualiexUserField, useQualiexUsers |
-| **i18n** | `lib/i18n/` | Namespaces core/app, JSONs por idioma, addAppTranslations, formatadores |
-| **Config** | `lib/config/` | Environments, CRUD defaults, mensagens |
-| **Services** | `lib/services/` | BaseService, EmailService, ErrorService |
-| **Hooks** | `lib/hooks/` | useDebounce, useWizard, useModuleAccess, useColumnResize |
-| **Providers** | `lib/providers/` | CoreProviders (setup simplificado) |
-| **Vite** | `lib/vite/` | create-config, CSP, security headers |
-| **Tailwind** | `lib/tailwind/` | Preset compartilhado |
-
----
-
-## 5. Padrões Deprecated
-
-| ❌ Não usar | ✅ Usar |
-|------------|--------|
-| `BulkActionBar` separado | Dropdown no `CrudActionBar` |
-| `<MoreHorizontal>` genérico | `ActionButton` |
-| Paginação manual | `CrudPrimitivePagination` |
-| `StatusSelect` | `Combobox` |
-| `DeleteConfirmationDialog` | `Dialog` |
-| `Searchbar` | `Input` com ícone |
-
----
-
-## 6. Fontes de Contexto
-
-| Fonte | Caminho | Conteúdo |
-|-------|---------|----------|
-| Memory components | `.note/memory/components/` | Props, variantes e exemplos de componentes |
-| Memory patterns | `.note/memory/patterns/` | Layouts, setup, convenções, regras do projeto |
-| Memory features | `.note/memory/features/` | Contexto de features específicas do projeto |
-| Código-fonte da lib | Cross-project → projeto **Admin** (forlogic-core) | Props, tipos, implementação |
-| Design System (visual) | Rota `/ds` no app do projeto **Admin** | Documentação interativa |
-
-> ℹ️ `.note/memory/` usa 3 pastas padronizadas: `components/`, `patterns/`, `features/`. `KNOWLEDGE.md` é a fonte única de verdade para regras e convenções.

package/docs/PROJECT_KNOWLEDGE_TEMPLATE.md

@@ -1,117 +0,0 @@
-# KNOWLEDGE — [Nome do Módulo]
-
-> Copie este template para o Project Knowledge do seu projeto Lovable.
-> Preencha os placeholders `[...]` e remova comentários `<!-- -->`.
-
----
-
-## 0. Schema
-
-> ⚠️ **SCHEMA_PADRAO = `[seu_schema]`**
-
-```ts
-supabase.schema('[seu_schema]').from('tabela').select('*');
-```
-
----
-
-## 1. Regras do Módulo
-
-<!-- Liste regras específicas deste módulo que a IA precisa saber -->
-
-- [Regra 1: ex: Processos só podem ser inativados, nunca deletados]
-- [Regra 2: ex: Todo documento precisa de aprovação antes de publicar]
-- [Regra 3: ex: Usuários só veem dados do próprio alias/empresa]
-
----
-
-## 2. Mapa de Telas
-
-<!-- Para cada tela, descreva: nome, tipo, tabela e componentes do DS -->
-
-### [Nome da Tela 1: ex: Processos]
-
-- **Tipo**: CRUD listagem
-- **Tabela**: `[processes]`
-- **Componente DS**: `createCrudPage` ou `CrudTable`
-- **Colunas**: [title, status, responsible, updated_at]
-- **Ações de linha**: [Editar, Duplicar, Inativar]
-- **Filtros**: [status, responsible]
-
-### [Nome da Tela 2: ex: Formulário de Processo]
-
-- **Tipo**: Formulário (Dialog ou página)
-- **Tabela**: `[processes]`
-- **Campos**:
-  - `title` — text, obrigatório
-  - `description` — textarea
-  - `status` — Combobox (Ativo, Inativo, Rascunho)
-  - `id_responsible` — Combobox (busca em users)
-  - `due_date` — DatePicker
-
-<!-- Repita para cada tela do módulo -->
-
----
-
-## 3. Tabelas e Relacionamentos
-
-<!-- Liste as tabelas do módulo com campos principais -->
-
-| Tabela | Campos principais | FKs |
-|--------|-------------------|-----|
-| `[processes]` | id, title, status, created_at, deleted_at | id_responsible → users |
-| `[documents]` | id, name, version, id_process | id_process → processes |
-
----
-
-## 4. Enums e Status
-
-<!-- Liste valores possíveis para campos de status/tipo -->
-
-| Campo | Valores |
-|-------|---------|
-| `processes.status` | `active`, `inactive`, `draft` |
-| `documents.type` | `policy`, `procedure`, `instruction` |
-
----
-
-## 5. Regras de Negócio por Tela
-
-<!-- Detalhe regras específicas que afetam a UI -->
-
-### [Processos]
-- Ao inativar: confirmar com Dialog, definir `deleted_at = now()`
-- Coluna status: exibir com Badge colorido (active=green, inactive=red)
-- Busca: pesquisar em `title` e `description`
-
-### [Formulário]
-- Campo `title`: mínimo 3 caracteres
-- Campo `id_responsible`: carregar de `users` filtrado por alias
-- Ao salvar: validar com Zod, exibir toast de sucesso
-
----
-
-## 6. Imports Obrigatórios
-
-```ts
-import {
-  createCrudPage, CrudTable, CrudActionBar,
-  Button, Dialog, Input, Combobox, ActionButton,
-  BaseForm, EmptyState, LoadingState,
-  cn, useTranslation, getSupabaseClient
-} from 'forlogic-core';
-```
-
----
-
-## 7. Instrução para IA
-
-Antes de criar qualquer componente, leia via cross-project:
-
-- `@Admin docs/design-system/crud.md` — listagens
-- `@Admin docs/design-system/inputs.md` — formulários
-- `@Admin docs/design-system/selectors.md` — selects/combos
-- `@Admin docs/design-system/layout.md` — estrutura de página
-- `@Admin docs/design-system/dialogs.md` — modais
-
-Nunca crie componentes sem consultar esses arquivos primeiro.

package/docs/PROMPT_TEMPLATE.md

@@ -1,77 +0,0 @@
-# Prompt Template — Criação de Telas com Design System
-
-> **Como usar**: Copie o bloco abaixo e cole como **primeiro prompt** ao iniciar uma conversa no Lovable para criar/migrar telas em projetos consumidores. Preencha os placeholders `[...]`.
-
----
-
-## Prompt para copiar
-
-```
-Antes de gerar qualquer código, leia OBRIGATORIAMENTE a documentação do Design System via cross-project:
-
-@Admin docs/design-system/crud.md        — para telas de listagem (CRUD)
-@Admin docs/design-system/inputs.md      — para campos de formulário
-@Admin docs/design-system/selectors.md   — para selects, combos, multiselect
-@Admin docs/design-system/layout.md      — para estrutura de página (AppSidebar, AppLayout)
-@Admin docs/design-system/dialogs.md     — para modais e confirmações
-@Admin docs/design-system/buttons-actions.md — para botões e ações
-@Admin docs/design-system/data-display.md    — para exibição de dados
-@Admin docs/design-system/tables-grids.md    — para tabelas e grids
-
-Regras obrigatórias:
-1. TODO import de componente visual DEVE vir de `forlogic-core` — nunca criar componente local se existir na lib
-2. Usar `createCrudPage` para telas de listagem simples, `CrudTable` para customizadas
-3. Usar `Combobox` para selects com busca (nunca Select nativo ou StatusSelect)
-4. Usar `ActionButton` para ações de linha (nunca ícone MoreHorizontal solto)
-5. Usar `Dialog` para confirmações (nunca DeleteConfirmationDialog)
-6. Usar `.schema('SCHEMA_PADRAO')` em toda query Supabase
-7. Usar `useTranslation` de `forlogic-core`, nunca de `react-i18next`
-
----
-
-Agora crie a seguinte tela:
-
-**Nome da tela**: [ex: Gestão de Processos]
-**Tipo**: [CRUD listagem | Formulário | Dashboard | Detalhe]
-**Schema Supabase**: [ex: quality]
-**Tabela principal**: [ex: processes]
-
-**Campos da listagem** (se CRUD):
-- [campo1]: [tipo] — [descrição]
-- [campo2]: [tipo] — [descrição]
-
-**Campos do formulário** (se tiver criação/edição):
-- [campo1]: [tipo, obrigatório?] — [descrição]
-- [campo2]: [tipo, obrigatório?] — [descrição]
-
-**Regras de negócio**:
-- [regra 1]
-- [regra 2]
-
-**Ações disponíveis**:
-- [ação 1: ex: Editar, Duplicar, Inativar]
-```
-
----
-
-## Mapeamento: Tipo de tela → Docs obrigatórios
-
-| Tipo de tela | Docs que a IA DEVE ler |
-|--------------|------------------------|
-| CRUD listagem | `crud.md`, `buttons-actions.md`, `tables-grids.md` |
-| Formulário | `inputs.md`, `selectors.md`, `dialogs.md` |
-| Dashboard | `charts-dashboards.md`, `data-display.md` |
-| Página com sidebar | `layout.md`, `navigation.md` |
-| Modal/Dialog | `dialogs.md`, `inputs.md` |
-
----
-
-## Checklist de revisão pós-geração
-
-- [ ] Todos os imports vêm de `forlogic-core`?
-- [ ] Nenhum componente foi criado localmente quando existe na lib?
-- [ ] `Combobox` usado em vez de Select/StatusSelect?
-- [ ] `ActionButton` usado para ações de linha?
-- [ ] `CrudActionBar` com layout de 3 zonas?
-- [ ] `.schema('SCHEMA_PADRAO')` em toda query?
-- [ ] Soft delete em vez de DELETE físico?