forlogic-core 2.0.7 → 2.1.0

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.

package/docs/PROJECT_KNOWLEDGE_TEMPLATE.md

@@ -1,120 +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. Fontes de Contexto (Cross-Project)
-
-Antes de criar qualquer componente, leia via cross-project (`@Admin`):
-
-| O que | Onde buscar |
-|-------|------------|
-| Padrões universais (componentes, CRUD, layout, scroll, setup) | `@Admin docs/design-system/patterns/` |
-| Índice dos padrões | `@Admin docs/design-system/patterns/README.md` |
-| Documentação MD do Design System | `@Admin docs/design-system/*.md` |
-| Código-fonte dos componentes | `@Admin lib/components/ui/` |
-| Implementação CRUD | `@Admin lib/crud/` |
-| Design System visual | Rota `/ds` no app Admin |
-
-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?

package/docs/PUBLISH.md

@@ -1,168 +0,0 @@
-# 📦 Como Publicar a Biblioteca forlogic-core
-
-> **Nota:** Para documentação de uso e instalação da biblioteca, consulte [README.md](../README.md)
-
-## Configuração Inicial
-
-A biblioteca está configurada para ser publicada no NPM como `forlogic-core`.
-
-### Arquivos de Configuração
-
-- `package.json` - Configuração principal com campos de biblioteca
-- `rollup.config.js` - Configuração de build
-- `tsconfig.json` - Configuração TypeScript unificada
-- `.npmignore` - Arquivos excluídos da publicação (inclui `docs/` - não publicada no NPM)
-- `README.md` - Documentação principal (copiada para dist/)
-
-## Comandos Disponíveis
-
-### 1. Build da Biblioteca
-
-```bash
-npm run build:lib
-```
-
-### 2. Teste de Publicação (Dry Run)
-
-```bash
-npm publish --dry-run
-```
-
-### 3. Release Automatizado (Recomendado)
-
-**Script JavaScript**
-
-```bash
-# Release patch (1.0.0 → 1.0.1)
-node scripts/publish.js patch
-
-# Release minor (1.0.0 → 1.1.0)
-node scripts/publish.js minor
-
-# Release major (1.0.0 → 2.0.0)
-node scripts/publish.js major
-```
-
-### 4. Publicação Manual (Legado)
-
-```bash
-# Incrementar versão e publicar manualmente
-npm version patch   # 1.0.0 → 1.0.1
-npm version minor   # 1.0.0 → 1.1.0
-npm version major   # 1.0.0 → 2.0.0
-
-# Publicar versão atual
-npm publish
-```
-
-## Processo de Release Automatizado
-
-### Scripts Automatizados
-
-Os scripts `scripts/publish/release.js` e `scripts/publish/release.sh` executam automaticamente:
-
-1. **Verificação**: Confere se não há mudanças pendentes no Git
-2. **Build**: Executa `npm run build:lib` com Rollup
-3. **Versão**: Incrementa versão no `package.json`
-4. **Publicação**: Publica no NPM
-5. **Tags**: Envia tags para o GitHub
-
-### Processo Manual (Legado)
-
-1. **Build**: Executa `npm run build:lib` com Rollup
-2. **Geração**: Cria arquivos CJS, ESM e declarações TypeScript
-3. **Publicação**: Usa `npm publish` diretamente
-
-## Estrutura da Publicação
-
-```
-dist/
-├── index.js           # CommonJS
-├── index.esm.js       # ES Modules
-├── index.d.ts         # TypeScript declarations
-├── index.css          # CSS da biblioteca
-├── package.json       # Configuração da lib
-└── README.md          # Documentação
-```
-
-## Documentação para Usuários
-
-A documentação completa está **consolidada no README.md** e disponível publicamente no repositório GitHub:
-
-- **[📖 README.md](../README.md)** - Guia completo (~350 linhas)
-  - ✅ Regras críticas e checklist
-  - ✅ Quick start CRUD
-  - ✅ Migrations e RLS
-  - ✅ Troubleshooting
-  - ✅ Referência rápida
-
-### ⚙️ Documentação no Pacote NPM
-
-O `README.md` é incluído no pacote NPM publicado (`dist/README.md`) e contém toda a documentação necessária em um único arquivo otimizado para leitura por IA e desenvolvedores.
-
-#### Documentações Modulares
-
-Algumas features possuem documentação detalhada em arquivos específicos para desenvolvimento local:
-
-- `lib/crud/components/CUSTOM_FIELDS.md` - Campos customizados do BaseForm
-- `lib/qualiex/places/README.md` - Sistema de gestores de locais
-
-**Importante:** Essas documentações **não são publicadas no NPM**. O conteúdo consolidado está no `README.md` principal que é copiado para `dist/README.md`.
-
-## Verificação antes da Publicação
-
-1. ✅ Build bem-sucedido (`npm run build:lib`)
-2. ✅ Dry-run sem erros (`npm publish --dry-run`)
-3. ✅ Versão correta no `package.json`
-4. ✅ README atualizado
-5. ✅ Changelog documentado (se aplicável)
-
-## Troubleshooting
-
-### Erro de Permissão NPM
-
-```bash
-npm login
-```
-
-### Build Falha
-
-Verifique se todas as dependências estão instaladas:
-
-```bash
-npm install
-```
-
-### Rollup Errors
-
-Confirme que o `rollup.config.js` está correto e que o `lib/index.ts` existe e exporta tudo necessário.
-
-### CSS Import Issues
-
-Se houver erro ao importar CSS, use:
-
-```tsx
-import 'forlogic-core/index.css';
-```
-
-O CSS é extraído para `index.css` durante o build da biblioteca.
-
-# Comandos Disponíveis
-
-## Instalar a última versão do forlogic-core
-
-```bash
-npm i forlogic-core@latest
-```
-
-## Build do projeto
-
-```bash
-npm run build
-```
-
-## Limpar cache do NPM
-
-```bash
-npm cache clean --force
-```

package/docs/STARTER_TEMPLATE.md

@@ -1,114 +0,0 @@
-# Starter Template — Projeto Consumidor forlogic-core
-
-> **Como usar**: Ao criar um novo projeto no Lovable, cole este conteúdo como **primeiro prompt** para gerar a estrutura base completa.
-
----
-
-## Prompt para criar projeto base
-
-```
-Crie a estrutura base do projeto seguindo EXATAMENTE este boilerplate.
-Leia @Admin docs/design-system/layout.md antes de começar.
-
-### 1. vite.config.ts
-
-import { defineConfig } from 'vite';
-import react from '@vitejs/plugin-react-swc';
-import path from 'path';
-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') } },
-  optimizeDeps: { force: true },
-}));
-
-### 2. tailwind.config.ts
-
-import type { Config } from 'tailwindcss';
-import { forlogicTailwindPreset, forlogicContentPaths } from 'forlogic-core/tailwind';
-
-export default {
-  presets: [forlogicTailwindPreset],
-  content: ['./src/**/*.{ts,tsx}', ...forlogicContentPaths],
-} satisfies Config;
-
-### 3. src/App.tsx
-
-import { BrowserRouter, Routes, Route, Navigate } from 'react-router-dom';
-import { CoreProviders, AppLayout } from 'forlogic-core';
-import { Home, FileText, Settings } from 'lucide-react';
-import ptBR from './i18n/pt-BR.json';
-import { HomePage } from './pages/HomePage';
-
-const sidebarConfig = {
-  navigation: [
-    { label: 'Início', path: '/', icon: Home },
-    { label: 'Registros', path: '/registros', icon: FileText },
-    { type: 'separator' as const, label: '', path: '' },
-    { label: 'Configurações', path: '/config', icon: Settings },
-  ],
-};
-
-function AppRoutes() {
-  return (
-    <AppLayout sidebarConfig={sidebarConfig}>
-      <Routes>
-        <Route path="/" element={<HomePage />} />
-        <Route path="*" element={<Navigate to="/" replace />} />
-      </Routes>
-    </AppLayout>
-  );
-}
-
-export default function App() {
-  return (
-    <CoreProviders moduleAlias="SEU_MODULO" appTranslations={{ 'pt-BR': ptBR }}>
-      <BrowserRouter>
-        <AppRoutes />
-      </BrowserRouter>
-    </CoreProviders>
-  );
-}
-
-### 4. src/pages/HomePage.tsx
-
-import { usePageMetadata } from 'forlogic-core';
-
-export function HomePage() {
-  usePageMetadata({ title: 'Início', subtitle: 'Bem-vindo ao módulo' });
-  return <div className="p-6">Conteúdo aqui</div>;
-}
-
-### 5. src/i18n/pt-BR.json
-
-{
-  "home": "Início",
-  "records": "Registros",
-  "settings": "Configurações"
-}
-
-Substitua:
-- SEU_PROJETO pelo ref do Supabase
-- SEU_MODULO pelo alias do módulo (ex: "performance", "suppliers")
-- Ajuste as rotas e sidebar conforme o módulo
-```
-
----
-
-## Checklist pós-criação
-
-- [ ] `forlogic-core` instalado como dependência
-- [ ] `vite.config.ts` usando `createSecurityHeadersPlugin`
-- [ ] `tailwind.config.ts` usando `forlogicTailwindPreset` + `forlogicContentPaths`
-- [ ] `App.tsx` usando `CoreProviders` + `AppLayout`
-- [ ] Sidebar com itens e separadores definidos
-- [ ] `usePageMetadata` em cada página
-- [ ] `.schema('SCHEMA_PADRAO')` em toda query Supabase
-- [ ] Arquivo `pt-BR.json` com traduções do módulo