forlogic-core 1.15.8 → 1.16.1

package/.note/memory/components/action-button-for-tables.md

@@ -0,0 +1,23 @@
+# Memory: components/action-button-for-tables
+Updated: now
+
+Uso de `ActionButton` é **OBRIGATÓRIO** para menus de ação em linhas de tabela.
+
+```tsx
+// ❌ PROIBIDO - botão genérico com ícone manual
+<Button variant="ghost" size="icon">
+  <MoreHorizontal className="h-4 w-4" />
+</Button>
+
+// ✅ CORRETO - ActionButton padronizado
+import { ActionButton } from 'forlogic-core';
+
+<ActionButton
+  items={[
+    { label: 'Editar', icon: Edit, onClick: handleEdit },
+    { label: 'Excluir', icon: Trash, onClick: handleDelete, variant: 'destructive' }
+  ]}
+/>
+```
+
+**Motivo**: Garante mesma estética e comportamento em todas as tabelas do sistema.

package/.note/memory/components/alertdialog-permanent-deletion.md

@@ -0,0 +1,47 @@
+# Memory: components/alertdialog-permanent-deletion
+Updated: now
+
+AlertDialog é usado **apenas** para exclusões permanentes que requerem digitação de confirmação:
+
+```tsx
+<AlertDialog open={open} onOpenChange={setOpen}>
+  <AlertDialogContent>
+    <AlertDialogHeader className="border-b pb-4">
+      <AlertDialogTitle className="text-center">
+        Exclusão Permanente
+      </AlertDialogTitle>
+    </AlertDialogHeader>
+    
+    <div className="py-4 space-y-4">
+      <div className="flex justify-center">
+        <AlertTriangle className="h-12 w-12 text-destructive" />
+      </div>
+      <AlertDialogDescription className="text-center">
+        Esta ação é irreversível. Digite <strong>EXCLUIR</strong> para confirmar.
+      </AlertDialogDescription>
+      <Input
+        value={confirmation}
+        onChange={(e) => setConfirmation(e.target.value)}
+        placeholder="Digite EXCLUIR"
+        className="text-center"
+      />
+    </div>
+    
+    <AlertDialogFooter>
+      <AlertDialogCancel>Cancelar</AlertDialogCancel>
+      <AlertDialogAction
+        disabled={confirmation !== 'EXCLUIR'}
+        onClick={handlePermanentDelete}
+        className="bg-destructive hover:bg-destructive/90"
+      >
+        Excluir Permanentemente
+      </AlertDialogAction>
+    </AlertDialogFooter>
+  </AlertDialogContent>
+</AlertDialog>
+```
+
+**Quando usar:**
+- ✅ Exclusão de dados sem possibilidade de recuperação
+- ✅ Ações destrutivas em massa críticas
+- ❌ NÃO usar para soft deletes (usar Dialog padrão)

package/.note/memory/components/baseform-custom-fields.md

@@ -0,0 +1,60 @@
+# Memory: components/baseform-custom-fields
+Updated: now
+
+Campos customizados no BaseForm usam `type: 'custom'` com `component` ou `render`:
+
+```tsx
+// Opção 1: Componente externo
+{
+  name: 'module_id',
+  label: 'Módulo',
+  type: 'custom',
+  required: true,
+  component: ModuleCombobox,
+  componentProps: {
+    placeholder: 'Selecione...',
+  },
+}
+
+// Opção 2: Props dinâmicas baseadas em formData
+{
+  name: 'file',
+  label: 'Arquivo',
+  type: 'custom',
+  component: FileUpload,
+  componentProps: (formData) => ({
+    required: !formData?.id, // Obrigatório só no cadastro
+    accept: '.pdf,.doc',
+  }),
+}
+
+// Opção 3: Render function inline
+{
+  name: 'priority',
+  label: 'Prioridade',
+  type: 'custom',
+  render: ({ value, onChange, error }) => (
+    <div className="flex gap-2">
+      {['low', 'medium', 'high'].map(p => (
+        <Button
+          key={p}
+          variant={value === p ? 'default' : 'outline'}
+          onClick={() => onChange(p)}
+        >
+          {p}
+        </Button>
+      ))}
+    </div>
+  ),
+}
+```
+
+**Interface do componente customizado:**
+```tsx
+interface CustomFieldProps {
+  value: any;
+  onChange: (value: any) => void;
+  error?: string;
+  disabled?: boolean;
+}
+```

package/.note/memory/components/baseform-usage.md

@@ -0,0 +1,43 @@
+# Memory: components/baseform-usage
+Updated: now
+
+BaseForm é o formulário dinâmico do sistema CRUD, configurado via `sections` e `fields`.
+
+```tsx
+import BaseForm from 'forlogic-core/crud/components/BaseForm';
+
+const sections: FormSection[] = [
+  {
+    id: 'basic',
+    title: 'Informações Básicas',
+    fields: [
+      { name: 'title', label: 'Título', type: 'text', required: true },
+      { name: 'email', label: 'E-mail', type: 'email' },
+      { name: 'is_active', label: 'Ativo', type: 'switch' },
+    ],
+  },
+];
+
+<BaseForm
+  title="Novo Item"
+  sections={sections}
+  initialData={data}
+  open={isOpen}
+  onSubmit={handleSubmit}
+  onCancel={() => setIsOpen(false)}
+/>
+```
+
+**Tipos de campo suportados:**
+`text`, `email`, `password`, `number`, `textarea`, `select`, `multiselect`, `date`, `datetime-local`, `switch`, `checkbox`, `color`, `color-picker`, `icon-picker`, `user-select`, `custom`
+
+**Grupos de campos:**
+```tsx
+{
+  name: 'row1',
+  type: 'group',
+  layout: 'horizontal', // ou 'vertical'
+  wrapperClassName: 'col-span-full',
+  fields: [...]
+}
+```

package/.note/memory/components/delete-confirmation-dialog.md

@@ -0,0 +1,48 @@
+# Memory: components/delete-confirmation-dialog
+Updated: now
+
+Dialog de exclusão segue padrão visual específico (NÃO usar AlertDialog para deleções simples):
+
+```tsx
+<Dialog open={open} onOpenChange={setOpen}>
+  <DialogContent size="sm" className="bg-white">
+    <DialogHeader showSeparator>
+      <DialogTitle className="sr-only">Confirmação</DialogTitle>
+    </DialogHeader>
+    
+    {/* Conteúdo centralizado */}
+    <div className="flex flex-col items-center text-center space-y-3 py-4">
+      {/* Ícone de alerta */}
+      <div className="w-12 h-12 rounded-full bg-destructive/10 flex items-center justify-center">
+        <AlertTriangle className="h-6 w-6 text-destructive" />
+      </div>
+      
+      {/* Título */}
+      <h3 className="text-lg font-semibold">Tem certeza?</h3>
+      
+      {/* Mensagem em duas linhas */}
+      <p className="text-sm text-muted-foreground">
+        Você está prestes a excluir este registro.<br />
+        Esta ação não pode ser desfeita.
+      </p>
+    </div>
+    
+    {/* Botões centralizados */}
+    <DialogFooter className="justify-center gap-2 mt-6">
+      <Button variant="outline" onClick={() => setOpen(false)}>
+        Cancelar
+      </Button>
+      <Button variant="destructive" onClick={handleDelete}>
+        Sim, excluir
+      </Button>
+    </DialogFooter>
+  </DialogContent>
+</Dialog>
+```
+
+**Regras:**
+- Usar `size="sm"` (~420px quadrado)
+- Background branco (`bg-white`)
+- Ícone AlertTriangle com `bg-destructive/10`
+- Botões lado a lado, centralizados
+- Texto fixo em português

package/.note/memory/components/dialog-sizes-and-structure.md

@@ -0,0 +1,31 @@
+# Memory: components/dialog-sizes-and-structure
+Updated: now
+
+Dialog possui 3 tamanhos opcionais (sem default) e estrutura obrigatória:
+
+| Size | Width | MaxHeight | Uso |
+|------|-------|-----------|-----|
+| (nenhum) | Auto (className controla) | Auto | Quando classes Tailwind definem o tamanho |
+| `sm` | 30vw (320-480px) | 320px | Confirmações rápidas |
+| `md` | 50vw (480-720px) | 70vh | Formulários padrão |
+| `lg` | 85vw (720-1440px) | 900px | Tabelas, conteúdo extenso |
+
+**Regra de prioridade:** Quando `size` é informado, inline styles são aplicados e vencem sobre className. Sem `size`, className controla livremente.
+
+**Estrutura obrigatória:**
+```tsx
+<DialogContent size="md">
+  <DialogHeader showSeparator>
+    <DialogTitle>Título</DialogTitle>
+  </DialogHeader>
+  <DialogBody>
+    {/* Conteúdo aqui */}
+  </DialogBody>
+  <DialogFooter>...</DialogFooter>
+</DialogContent>
+```
+
+**Regras:**
+- `showSeparator` no DialogHeader para linha divisória
+- DialogBody é obrigatório para scroll interno
+- `size` é opcional — sem ele, classes Tailwind no className controlam o tamanho

package/.note/memory/components/dialog-variants.md

@@ -0,0 +1,44 @@
+# Memory: components/dialog-variants
+Updated: 2026-02-26
+
+## Variantes Semânticas do Dialog
+
+O `DialogContent` possui uma prop `variant` que controla o comportamento de fechamento:
+
+### Variantes
+
+| Variante | Clique externo | ESC | Botão X | Uso |
+|----------|---------------|-----|---------|-----|
+| `informative` (padrão) | Fecha | Fecha | Fecha | Avisos, leitura |
+| `form` | Bloqueado | Fecha* | Fecha* | Formulários, edições |
+| `destructive` | Bloqueado | Bloqueado | Oculto | Exclusões, ações irreversíveis |
+
+\* Com `isDirty={true}`, exibe `window.confirm` antes de fechar.
+
+### Props
+
+```typescript
+interface DialogContentProps {
+  variant?: 'informative' | 'form' | 'destructive'; // default: 'informative'
+  isDirty?: boolean; // para variant='form', confirmação antes de fechar
+}
+```
+
+### Padrão de uso
+
+```tsx
+// Formulários
+<DialogContent variant="form" isDirty={form.formState.isDirty}>
+
+// Exclusões
+<DialogContent variant="destructive" size="sm">
+
+// Informativos (comportamento padrão, pode omitir variant)
+<DialogContent variant="informative">
+```
+
+### Regras
+- Default é `'informative'` para compatibilidade com dialogs existentes
+- `destructive` oculta o botão X — fechamento apenas por botões no DialogFooter
+- `form` com `isDirty` usa `window.confirm` nativo para confirmação
+- Tipos exportados: `DialogVariant`, `DialogSize`, `DialogContentProps`

package/.note/memory/components/pagination-usage.md

@@ -0,0 +1,28 @@
+# Memory: components/pagination-usage
+Updated: now
+
+**SEMPRE** usar `Pagination` ou `CrudPrimitivePagination` da lib. NUNCA implementar manualmente.
+
+```tsx
+// ❌ PROIBIDO - paginação manual
+<div className="flex gap-2">
+  <Button onClick={() => setPage(p => p - 1)}>Anterior</Button>
+  <span>Página {page}</span>
+  <Button onClick={() => setPage(p => p + 1)}>Próxima</Button>
+</div>
+
+// ✅ CORRETO - componente padronizado
+import { CrudPrimitivePagination } from 'forlogic-core';
+
+<CrudPrimitivePagination
+  currentPage={page}
+  totalPages={totalPages}
+  pageSize={pageSize}
+  totalItems={total}
+  onPageChange={setPage}
+  onPageSizeChange={setPageSize}
+  variant="full"
+/>
+```
+
+**Obrigatório**: `variant="full"` inclui seletor de itens por página e "X-Y de Z itens".

package/.note/memory/documentation/consolidated-components-registry.md

@@ -0,0 +1,18 @@
+# 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/features/crud-standardized-config-props.md

@@ -0,0 +1,3 @@
+# 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/features/import/attachment-strategy.md

@@ -0,0 +1,18 @@
+# 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.
+
+## 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:
+- 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`

package/.note/memory/patterns/body-content-scroll-usage.md

@@ -0,0 +1,59 @@
+# Memory: patterns/body-content-scroll-usage
+Updated: now
+
+## Quando Usar Cada Abordagem
+
+| Cenário | Componente | Classes |
+|---------|------------|---------|
+| **Página nova (Design System)** | `BodyContent` + `ContentContainer` | Padrão, sem classes extras |
+| **Página legada (design próprio)** | `BodyContent` | `className="bg-transparent p-0"` |
+| **Módulo customizado** | `div` simples | `className="h-full overflow-y-auto"` |
+
+## Exemplos
+
+### ✅ Página Nova (Design System Completo)
+```tsx
+import { BodyContent, ContentContainer } from 'forlogic-core';
+
+<BodyContent breadcrumbs={[{ label: 'Home', href: '/' }, { label: 'Página' }]}>
+  <ContentContainer title="Título" subtitle="Descrição">
+    {/* Conteúdo */}
+  </ContentContainer>
+</BodyContent>
+```
+
+### ✅ Página Legada (Preservar Design Original)
+```tsx
+import { BodyContent } from 'forlogic-core';
+
+<BodyContent className="bg-transparent p-0">
+  {/* Conteúdo original mantido sem alterações */}
+  <div className="p-6">
+    <h1>Título Original</h1>
+    {/* ... */}
+  </div>
+</BodyContent>
+```
+
+### ✅ Container Mínimo (Sem BodyContent)
+```tsx
+// Apenas scroll, sem dependência do forlogic-core
+<div className="h-full overflow-y-auto">
+  {/* Conteúdo original */}
+</div>
+```
+
+## ❌ Erro Comum
+```tsx
+// ERRADO: ContentContainer em página com design próprio
+<BodyContent>
+  <ContentContainer>
+    {/* Resultado: fundo branco, bordas, padding extra indesejados */}
+  </ContentContainer>
+</BodyContent>
+```
+
+## Regra de Ouro
+- `ContentContainer` adiciona: fundo branco, borda, sombra, padding
+- Use apenas quando o design da página DEVE seguir esse padrão
+- Para páginas legadas: `BodyContent className="bg-transparent p-0"`

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

@@ -0,0 +1,3 @@
+# 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

@@ -0,0 +1,3 @@
+# 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/crud-toolbar-layout.md

@@ -0,0 +1,26 @@
+# Memory: patterns/crud-toolbar-layout
+Updated: now
+
+Toolbar CRUD segue layout obrigatório de 3 zonas:
+
+| Zona | Posição | Conteúdo |
+|------|---------|----------|
+| Esquerda | `justify-start` | Botão "Novo" (ação principal) |
+| Centro | `flex-1 max-w-md` | Campo de busca (FilterBar/Input) |
+| Direita | `justify-end` | Botões Filtro/Ações |
+
+```tsx
+// ✅ CORRETO
+<div className="flex items-center gap-4">
+  <Button>Novo Item</Button>
+  <div className="flex-1 max-w-md">
+    <Input placeholder="Buscar..." />
+  </div>
+  <div className="flex gap-2">
+    <Button variant="outline">Filtrar</Button>
+    <ActionButton items={actions} />
+  </div>
+</div>
+```
+
+**Regra**: Botão de criação NUNCA deve ficar isolado no cabeçalho do Card.

package/.note/memory/patterns/dialog-body-scroll-pattern.md

@@ -0,0 +1,27 @@
+# Memory: patterns/dialog-body-scroll-pattern
+Updated: now
+
+Conteúdo de Dialog/Sheet com scroll interno **DEVE** usar o padrão responsivo:
+
+```tsx
+// ✅ CORRETO - padrão obrigatório
+<div className="flex-1 min-h-0 overflow-auto py-4 px-1 -mx-1">
+  {/* Conteúdo scrollável */}
+</div>
+
+// ❌ ERRADO - overflow escondido, sem scroll
+<div className="p-4">
+  {/* Conteúdo pode ser cortado */}
+</div>
+```
+
+**Breakdown das classes:**
+| Classe | Função |
+|--------|--------|
+| `flex-1` | Expande para preencher espaço disponível |
+| `min-h-0` | Permite shrink em flex container |
+| `overflow-auto` | Habilita scroll quando necessário |
+| `py-4` | Padding vertical padrão (16px) |
+| `px-1 -mx-1` | Previne corte de focus rings |
+
+**Aplica-se a:** Dialog, Sheet, Drawer, AlertDialog

package/.note/memory/patterns/single-scroll-pattern.md

@@ -0,0 +1,22 @@
+# Memory: patterns/single-scroll-pattern
+Updated: now
+
+O padrão de Scroll Único evita barras de rolagem duplicadas na aplicação.
+
+| Componente | Responsabilidade |
+|------------|------------------|
+| `AppLayout` | `overflow-hidden` - delega scroll para filhos |
+| `BodyContent` | `h-full overflow-y-auto` - gerencia scroll da página |
+| Custom | `h-full` + `ScrollArea` interno quando necessário |
+
+**Regra**: Apenas UM nível da hierarquia deve ter scroll ativo.
+
+```tsx
+// ❌ ERRADO - h-screen causa scroll duplicado
+<div className="h-screen overflow-auto">
+
+// ✅ CORRETO - h-full respeita container pai
+<BodyContent>
+  <ContentContainer>...</ContentContainer>
+</BodyContent>
+```

package/.note/memory/patterns/spa-navigation-pattern.md

@@ -0,0 +1,19 @@
+# Memory: patterns/spa-navigation-pattern
+Updated: now
+
+Navegação SPA deve usar componentes do React Router, nunca `<a href>` ou `window.location`.
+
+```tsx
+// ❌ ERRADO - recarrega página inteira
+<a href="/dashboard">Dashboard</a>
+window.location.href = '/page';
+
+// ✅ CORRETO - navegação SPA sem reload
+import { Link, useNavigate } from 'react-router-dom';
+
+<Link to="/dashboard">Dashboard</Link>
+const navigate = useNavigate();
+navigate('/page');
+```
+
+**Exceção**: Links externos devem usar `<a>` com `target="_blank"` e `rel="noopener noreferrer"`.

package/.note/memory/rules/no-auto-index-rule.md

@@ -0,0 +1,20 @@
+# Memory: rules/no-auto-index-rule
+Updated: now
+
+**NUNCA** criar índices automaticamente em migrations.
+
+```sql
+-- ❌ PROIBIDO - índice "por precaução"
+CREATE INDEX idx_subprocess_process ON subprocesses(id_process);
+CREATE INDEX idx_process_title ON processes(title);
+
+-- ✅ CORRETO - criar tabela SEM índices
+CREATE TABLE common.processes (...);
+```
+
+**Quando criar índices?** APENAS quando:
+1. Solicitado explicitamente pelo usuário
+2. Análise de performance comprovou necessidade (EXPLAIN ANALYZE)
+3. Aprovação prévia do usuário
+
+**Motivo**: Índices custam espaço, impactam escrita e 99% dos "preventivos" nunca são usados.

package/.note/memory/rules/no-delete-policy-rule.md

@@ -0,0 +1,23 @@
+# Memory: rules/no-delete-policy-rule
+Updated: now
+
+**NUNCA** criar política RLS de DELETE. Usar soft delete com UPDATE.
+
+```sql
+-- ❌ PROIBIDO
+CREATE POLICY "table_delete" ON common.table
+FOR DELETE USING (...);
+
+-- ✅ CORRETO - adicionar coluna deleted_at
+ALTER TABLE common.table ADD COLUMN deleted_at TIMESTAMP WITH TIME ZONE;
+
+CREATE POLICY "table_update" ON common.table
+FOR UPDATE USING (...) WITH CHECK (...);
+```
+
+**Motivo**: Soft delete preserva histórico e evita problemas de integridade referencial.
+
+**Sintaxe RLS**:
+- `SELECT` → usa `USING`
+- `INSERT` → usa `WITH CHECK`
+- `UPDATE` → usa `USING` E `WITH CHECK`

package/.note/memory/rules/no-env-modification-rule.md

@@ -0,0 +1,19 @@
+# Memory: rules/no-env-modification-rule
+Updated: now
+
+**NUNCA** modificar o arquivo `.env` sem autorização EXPLÍCITA do usuário.
+
+```bash
+# ❌ PROIBIDO sem autorização
+VITE_SUPABASE_URL="..."
+VITE_QUALIEX_API_URL="..."
+
+# ✅ CORRETO - perguntar antes
+"Posso modificar o .env para alterar X?"
+```
+
+**Quando modificar?** APENAS quando:
+1. Solicitado explicitamente pelo usuário
+2. Usuário aprovou a mudança de ambiente (dev/prod)
+
+**Motivo**: O .env controla ambiente (dev/prod) e contém credenciais sensíveis.

package/.note/memory/rules/supabase-schema-rule.md

@@ -0,0 +1,19 @@
+# Memory: rules/supabase-schema-rule
+Updated: now
+
+**SEMPRE** especifique o schema `common` em TODA query Supabase:
+
+```typescript
+// ✅ CORRETO
+const { data } = await supabase
+  .schema('common')
+  .from('tabela')
+  .select('*');
+
+// ❌ ERRADO - vai falhar em produção
+const { data } = await supabase
+  .from('tabela')
+  .select('*');
+```
+
+**Motivo**: O projeto usa schema customizado `common`, não o `public` padrão do Supabase.