# Convenções de desenvolvimento — eCook-Plus LOJA

## Arquivos modificados (obrigatório para o agente)

Ao concluir qualquer ajuste de código neste projeto, a resposta **deve terminar** com a seção:

### Arquivos modificados

Lista em bullets com caminho relativo à raiz do repositório, separando:

- **Criados** — arquivos novos
- **Alterados** — arquivos já existentes que foram editados

Exemplo:

```markdown
### Arquivos modificados

**Criados**
- `includes/novo_modulo.php`

**Alterados**
- `index.php`
- `paginas/tela.php`
```

Regras:

1. Incluir **todos** os arquivos tocados na tarefa (PHP, CSS, JS, API, menu, regras, documentação).
2. Se não houver alteração de arquivo, informar explicitamente: *Nenhum arquivo modificado.*
3. Não omitir arquivos “pequenos” (menu, rota, include compartilhado).
4. Esta convenção vale também para correções pontuais (uma linha).

A regra equivalente para o Cursor está em `.cursor/rules/arquivos-modificados.mdc` (`alwaysApply: true`).

---

## Controle de versão do sistema

Nome e versão do painel: `includes/app_config.php` (`ECOOK_APP_NOME`, `ECOOK_APP_VERSAO`).

---

## Relatórios com layout AJAX

Páginas carregadas via `index.php?ajax=true` devem emitir o CSS do wrap, por exemplo:

```php
require_once __DIR__ . '/../includes/estilos_relatorio_wrap.php';
renderEstilosRelatorioWrap();
```

Usado em: Espelho de Comandas, Documentos Fiscais (e futuros relatórios no mesmo padrão).
