forlogic-core 2.0.7 → 2.0.8

package/dist/leadership/components/LeadershipPage.d.ts

@@ -13,7 +13,7 @@ export interface LeadershipPageProps {
     columns?: TreeTableColumn<LeaderNode>[];
     /** Header da coluna de nome (default: "Líder") */
     nameHeader?: string;
-    /** Texto da zona de drop raiz (default: "Tornar Líder Raiz") */
+    /** Texto da zona de drop raiz (default: t('leadership_make_root')) */
     rootDropLabel?: string;
 }
 export declare function LeadershipPage({ unassociatedUsers, onAssociateUser, onMoveNode: customMoveNode, onMoveNodes: customMoveNodes, columns: customColumns, nameHeader, rootDropLabel, }?: LeadershipPageProps): import("react/jsx-runtime").JSX.Element;

package/dist/media/components/ImageRenderer.d.ts

@@ -12,7 +12,7 @@
  *   content={{
  *     imageUrl: 'https://example.com/image.jpg',
  *     caption: 'Minha imagem',
- *     alt: 'Descrição da imagem',
+ *     alt: t('image_description'),
  *     alignment: 'center',
  *     allowDownload: true
  *   }}

package/dist/media/components/VideoEditor.d.ts

@@ -1,22 +1,2 @@
-/**
- * Video Editor Component
- *
- * Editor genérico de vídeo para forlogic-core.
- * Suporta URL, upload e código embed.
- *
- * @example
- * ```tsx
- * import { VideoEditor } from 'forlogic-core';
- *
- * <VideoEditor
- *   value={videoData}
- *   onChange={setVideoData}
- *   onSubmit={handleSave}
- *   onCancel={handleCancel}
- *   uploadFunction={myUploadFunction}
- *   uploadOptions={{ bucket: 'videos', folder: 'content' }}
- * />
- * ```
- */
 import type { MediaEditorProps, VideoBlockContent } from '../types';
 export declare function VideoEditor({ value, onChange, onSubmit, onCancel, uploadFunction, deleteFunction, uploadOptions }: MediaEditorProps<VideoBlockContent>): import("react/jsx-runtime").JSX.Element;

package/dist/media/components/VideoRenderer.d.ts

@@ -1,8 +1,2 @@
-/**
- * Video Renderer Component
- *
- * Renderizador genérico de vídeo para forlogic-core.
- * Suporta YouTube, Vimeo e arquivos diretos.
- */
 import type { MediaRendererProps, VideoBlockContent } from '../types';
 export declare function VideoRenderer({ content, className, style }: MediaRendererProps<VideoBlockContent>): import("react/jsx-runtime").JSX.Element;

package/dist/qualiex/components/QualiexUserField.d.ts

@@ -52,7 +52,7 @@ export type QualiexUserDisplayFormat = 'name' | 'name-email' | 'name-role' | 'cu
  * // Display customizado
  * <QualiexUserField
  *   displayFormat="custom"
- *   customDisplayFn={(user) => `${user.userName} - ${user.placeName || 'Sem local'}`}
+ *   customDisplayFn={(user) => `${user.userName} - ${user.placeName || t('no_place_selected')}`}
  *   value={userId}
  *   onChange={setUserId}
  * />

package/dist/types.d.ts

@@ -405,6 +405,7 @@ export interface UserInfo {
     name: string;
     identifier: string;
     alias?: string;
+    isSysAdmin: boolean;
 }
 export interface Company {
     id: string;

package/docs/WORKSPACE_KNOWLEDGE.md

@@ -0,0 +1,254 @@
+# forlogic-core — Workspace Knowledge
+
+> **Documento de referência** para todos os projetos que consomem `forlogic-core`.
+> Cole este conteúdo como **Workspace Knowledge** no Lovable.
+
+---
+
+## 🔗 Cross-Project: Projeto Admin (DS + Lib)
+
+> **Para consultar componentes, props, tipos, exemplos e implementação**: use cross-project (`@Admin`) para ler arquivos do projeto **"Admin"** (`qualiex-admin`).
+
+### Caminhos úteis no projeto Admin
+
+| O que procurar | Caminho no Admin |
+|----------------|------------------|
+| Código-fonte dos componentes UI | `lib/components/ui/` |
+| Sistema CRUD | `lib/crud/` |
+| Barrel exports (lista completa) | `lib/exports/ui.ts`, `lib/exports/index.ts` |
+| Documentação MD do Design System | `docs/design-system/` |
+| Docs interativos (código-fonte) | `src/design-system/docs/` |
+| Hooks compartilhados | `lib/hooks/` |
+| Providers (CoreProviders) | `lib/providers/` |
+| Serviços (Base, Email, Error) | `lib/services/` |
+| Config Vite/Tailwind | `lib/vite/`, `lib/tailwind/` |
+| Constituição (regras canônicas) | `spec/constitution.md` |
+| Prompt template | `docs/PROMPT_TEMPLATE.md` |
+| Project Knowledge template | `docs/PROJECT_KNOWLEDGE_TEMPLATE.md` |
+| Starter template | `docs/STARTER_TEMPLATE.md` |
+| Golden snippets | `docs/design-system/examples.md` |
+
+---
+
+## 0. Schema do Projeto
+
+> ⚠️ **O schema é definido no `README.md` de cada projeto.** Consulte-o antes de qualquer query.
+
+```ts
+// ✅ CORRETO — substituir pelo schema do projeto (ex: 'common', 'docs', etc.)
+supabase.schema('SCHEMA_DO_PROJETO').from('tabela').select('*');
+
+// ❌ ERRADO (vai falhar em produção)
+supabase.from('tabela').select('*');
+```
+
+> Nunca usar o schema `public`. Cada projeto tem seu próprio schema documentado no `README.md`.
+
+---
+
+## 1. Constituição — Regras Canônicas
+
+> 📖 **Todas as regras, convenções e melhores práticas estão em `spec/constitution.md`** no projeto Admin.
+
+Antes de implementar qualquer funcionalidade, consulte a constituição via cross-project:
+```
+@Admin spec/constitution.md
+```
+
+### Resumo das regras invioláveis
+
+| Regra | Detalhe |
+|-------|---------|
+| Schema obrigatório | `.schema('...')` em toda query Supabase (schema do `README.md`) |
+| Sem DELETE físico | Soft delete com `deleted_at` + policy `FOR UPDATE` |
+| Sem índices automáticos | Apenas com aprovação explícita + `EXPLAIN ANALYZE` |
+| 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` |
+| Import de i18n | Sempre `useTranslation` de `forlogic-core`, nunca de `react-i18next` |
+
+---
+
+## 2. Lib-First — forlogic-core
+
+> Antes de criar qualquer componente, **verificar se já existe em `forlogic-core`**.
+
+```ts
+// ✅ CORRETO
+import { Button, Dialog, Input, Combobox, ActionButton, useTranslation } from 'forlogic-core';
+
+// ❌ PROIBIDO — criar componente local que já existe na lib
+import { MyCustomButton } from '@/components/MyCustomButton';
+```
+
+### Checklist
+
+- [ ] Pesquisei se existe na forlogic-core?
+- [ ] Verifiquei o Design System (`@Admin docs/design-system/`)?
+- [ ] Pode ser alcançado com props/variantes existentes?
+
+### Exceções permitidas
+
+1. Componente específico de domínio de negócio (ex: `InvoiceCard`)
+2. Composição de componentes da lib (wrapper Dialog + Form)
+3. Protótipo temporário que será migrado para a lib
+
+---
+
+## 3. Design System — Categorias
+
+> Para ver props e exemplos: `@Admin docs/design-system/<arquivo>.md`
+
+| Categoria | Arquivo |
+|-----------|---------|
+| Fundação | `foundation.md` |
+| Botões & Ações | `buttons-actions.md` |
+| Inputs | `inputs.md` |
+| Seletores | `selectors.md` |
+| Data Display | `data-display.md` |
+| Data Grid | `tables-grids.md` |
+| Gráficos & Dashboards | `charts-dashboards.md` |
+| Navegação | `navigation.md` |
+| Dialogs | `dialogs.md` |
+| Notifications & Feedback | `notifications-feedback.md` |
+| Layout | `layout.md` |
+| CRUD | `crud.md` |
+| Plataforma | `platform.md` |
+| Business Components | `domain.md` |
+| Developer Tools | `infra-utils.md` |
+
+### Aliases disponíveis
+
+| Original | Alias(es) |
+|----------|-----------|
+| Combobox | SelectSearch, MultiSelect, EntitySelect, AutoComplete |
+| ComboTree | TreeSelect |
+| StepSelector | Stepper |
+| ActionButton | ActionMenu, RowActions |
+| TruncatedCell | EllipsisText |
+| CrudPrimitiveTable | DataTable |
+| CrudPrimitivePagination | DataPagination |
+| CrudPrimitiveFilterBar | DataFilterBar |
+
+---
+
+## 4. Instrução para IA — Leitura Obrigatória
+
+**QUANDO** criar ou modificar qualquer arquivo `.tsx` com JSX:
+
+- **SE** contém tabela, listagem ou CRUD → **LER** `@Admin docs/design-system/crud.md` e `@Admin docs/design-system/tables-grids.md` ANTES
+- **SE** contém formulário, input ou campo → **LER** `@Admin docs/design-system/inputs.md` e `@Admin docs/design-system/selectors.md` ANTES
+- **SE** contém modal ou confirmação → **LER** `@Admin docs/design-system/dialogs.md` ANTES
+- **SE** contém botões ou ações de linha → **LER** `@Admin docs/design-system/buttons-actions.md` ANTES
+- **SE** é estrutura de página/layout → **LER** `@Admin docs/design-system/layout.md` ANTES
+
+**SEMPRE** consultar `@Admin docs/design-system/examples.md` como referência de implementação.
+
+**VALIDAÇÃO pós-geração**: Todo import de componente visual DEVE vir de `forlogic-core`. Se criou componente local que existe na lib, refatore imediatamente.
+
+---
+
+## 5. Padrões CRUD
+
+### Toolbar — Layout obrigatório de 3 zonas
+
+| Zona | Posição | Conteúdo |
+|------|---------|----------|
+| Esquerda | `justify-start` | Botão "Novo" + Dropdown ações em lote |
+| Centro | `flex-1 max-w-md` | Campo de busca |
+| Direita | `justify-end` | Filtros + Toggle view |
+
+### Defaults obrigatórios
+
+- Paginação: `CrudPrimitivePagination variant="full"`, **10 itens/página** (menor opção)
+- Column resize: ativado por padrão
+- Column manager: ativado por padrão
+- Ordenação: ativada em todas as colunas por padrão
+- Busca: na action bar com `showSearch=true`
+- Ações de linha: sempre usar `ActionButton` da lib
+
+---
+
+## 6. 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 |
+| Schema `public` | `.schema('...')` com schema do projeto |
+
+---
+
+## 7. Feature Flags
+
+| Variável | Descrição | Padrão |
+|----------|-----------|--------|
+| `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 `🔑 chave` 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 |
+
+Todas precisam do prefixo `VITE_` para serem expostas ao cliente.
+
+---
+
+## 8. Configuração — Setup do Projeto
+
+### CoreProviders
+
+```tsx
+import { CoreProviders } from 'forlogic-core';
+import ptBR from './i18n/pt-BR.json';
+
+function App() {
+  return (
+    <CoreProviders moduleAlias="seu-modulo" appTranslations={{ 'pt-BR': ptBR, 'en-US': enUS }}>
+      <BrowserRouter><Routes /></BrowserRouter>
+    </CoreProviders>
+  );
+}
+```
+
+### Vite
+
+```ts
+import { createSecurityHeadersPlugin } from 'forlogic-core/vite';
+
+export default defineConfig(({ mode }) => ({
+  plugins: [
+    react(),
+    createSecurityHeadersPlugin(mode === 'development', {
+      supabaseUrls: ['https://SEU_PROJETO.supabase.co'],
+      additionalConnectSrc: ['https://*.qualiex.com'],
+    }),
+  ],
+  resolve: { alias: { '@': path.resolve(__dirname, './src') } },
+}));
+```
+
+### Tailwind
+
+```ts
+import { forlogicTailwindPreset, forlogicContentPaths } from 'forlogic-core/tailwind';
+
+export default {
+  presets: [forlogicTailwindPreset],
+  content: [...forlogicContentPaths],
+} satisfies Config;
+```
+
+---
+
+## 9. Estrutura de Documentação
+
+| Local | Responsabilidade |
+|-------|-----------------|
+| `README.md` (raiz de cada projeto) | **Schema do projeto** — única fonte canônica |
+| `spec/constitution.md` (projeto Admin) | **Regras e convenções** — fonte canônica para todos os projetos |
+| `docs/design-system/` (projeto Admin) | **Design System** — documentação de componentes |
+| Rota `/ds` no app Admin | **Design System visual** — documentação interativa |

package/docs/design-system/README.md

@@ -3,7 +3,7 @@
 
 # Design System — forlogic-core
 
-> Gerado automaticamente em 2026-04-06
+> Gerado automaticamente em 2026-04-08
 > Total: 92 componentes documentados em 15 categorias
 
 ## Categorias

package/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/docs/design-system/patterns/i18n-setup.md

@@ -8,7 +8,9 @@
 
 ## Setup em projetos consumidores
 
-1. Criar JSONs flat em `src/i18n/pt-BR.json`: `{ "key": "value" }` (sem nesting)
+### Projeto simples (poucas chaves)
+
+1. Criar JSON flat em `src/i18n/pt-BR.json`: `{ "key": "value" }` (sem nesting)
 2. Passar para CoreProviders:
 
 ```tsx
@@ -17,6 +19,67 @@
 
 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
 
 ```
@@ -25,6 +88,17 @@ 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
@@ -40,3 +114,4 @@ console.log('Resources:', i18n.store.data);
 | 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/package.json

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

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.
-> Padrões universais (componentes, layout, CRUD, scroll) → `docs/design-system/patterns/`
-> Padrões internos do Admin → `.note/memory/`
-
----
-
-## 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 |
-|-------|---------|----------|
-| **Padrões universais** | `docs/design-system/patterns/` | Componentes, CRUD, layout, scroll, setup — acessível via cross-project |
-| Padrões internos Admin | `.note/memory/` | Lógicas específicas do Admin (alias, doc-sync, env detection) |
-| 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 |
-
-> ℹ️ Padrões universais foram migrados de `.note/memory/` para `docs/design-system/patterns/` para ficarem acessíveis a todos os projetos consumidores via `@Admin docs/design-system/patterns/`. `KNOWLEDGE.md` é a fonte única de verdade para regras e convenções.