forlogic-core 2.0.7 → 2.0.8

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/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