# VF Portal — Instruções para Claude Code

## Comportamento geral

- Trabalhar de forma **autônoma e direta** — sem pedir confirmações para tarefas de código
- Fazer **commit e push** ao final de cada implementação completa
- Nunca quebrar funcionalidades existentes; verificar impacto lateral antes de alterar

## Commits

- Mensagens de commit **em português**, descritivas, explicando o "porquê" não só o "o quê"
- Formato: `escopo: resumo da mudança` (ex: `fluxo: adiciona coluna negócio na aba geral`)
- Incluir co-authored-by: `Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>`

## Qualidade

- Testar a lógica do código antes de commitar: revisar SQL, condições de borda, visibilidade de métodos PHP
- Não adicionar abstrações ou refatorações além do que a tarefa exige
- Não adicionar comentários óbvios — somente quando o "por quê" não é evidente no código

## Stack do projeto

- **PHP 8+**, MVC próprio em `src/` — Router, Controllers, Models, Templates
- **Banco**: PDO singleton via `Connection::get(name)` para `auth`, `mika`, `emil`, `geral`, `woocommerce`
- **Auth**: JWT SSO; apps standalone usam `auth.php` com cookie `vfportal_token`
- **Apps portal**: roteados pelo Router central (`routes/web.php`)
- **Apps standalone** (`public/apps/mika_folica/`, `public/apps/emil/`): servidos direto pelo Apache, bypass do router

## Padrão de cabeçalho (apps standalone)

Todas as páginas standalone devem ter:
1. Barra escura `vf-topbar` no topo com link "← VF Portal" e botão "Sair" apontando para `https://portal.mikafolica.com.br/logout`
2. Cabeçalho principal da app abaixo

## Checklist obrigatório para novos módulos do portal

Ao implementar qualquer novo módulo com rota em `/apps/mika_folica/X` ou `/apps/emil/X`, seguir **todos** os passos abaixo antes de commitar:

1. **Controller** — Criar `src/Controllers/{Negocio}/{Nome}Controller.php` com namespace correto e métodos necessários
2. **Template** — Criar `templates/{negocio}/{nome}/index.php`
3. **Rota** — Registrar em `routes/web.php` com `use` correto + `permission:` adequada; se o padrão da URL for `/apps/mika_folica/X` ou `/apps/emil/X`, obrigatoriamente ir ao passo 4
4. **`.htaccess`** — Adicionar exceção em `public/.htaccess` na regra de bypass das apps standalone:
   ```
   RewriteCond %{REQUEST_URI} !^/apps/mika_folica/{nome} [NC]
   ```
   **Sem isso a URL retorna 404** — Apache serve como diretório estático antes do PHP.
5. **Dashboard** — Adicionar card em `src/Controllers/DashboardController.php`
6. **Permissão no cadastro de usuários** — Adicionar em `src/Models/Admin/Usuario.php` dentro de `GROUPS`, no grupo correto:
   ```php
   '{negocio}.{nome}.ver' => 'Label da Permissão',
   ```
   **Sem isso a permissão nunca aparece no modal de criar/editar usuário.**
7. **Permissão no controller** — Validar com `$ctx->can('{negocio}.{nome}.ver')` e/ou via `permission:` na rota
8. **Migration SQL** — Criar e aplicar se o módulo usa tabelas novas
9. **Assets** — Criar `public/assets/css/{nome}.css` e `public/assets/js/{nome}.js` se passados em `$this->render(..., ['{nome}'])`
