Imported from ateuatado/comercial (AGENTS.md). Install upstream with npx skills add ateuatado/comercial. Copyright stays with the author.

Instruções para agentes de IA

Leia este arquivo antes de qualquer alteração significativa no projeto.

A única árvore física do projeto no ambiente local fica em C:\xampp\htdocs\spiv.
O Apache publica exclusivamente C:\xampp\htdocs\spiv\public como DocumentRoot de https://spiv.test.
Comandos Git, Composer, Spark e testes devem ser executados na raiz C:\xampp\htdocs\spiv, nunca dentro de public.
O caminho legado C:\Users\elian\Desktop\spiv pode existir somente como junção para a raiz canônica; nunca crie ou mantenha nele uma segunda cópia do repositório.
Antes de validar uma alteração no navegador, confirme que a árvore canônica está no commit esperado e aplique as migrations pendentes.

Este repositório contém o SPIV, uma aplicação baseada em CodeIgniter 4 com PostgreSQL, Shield e integração com LDAP para uso interno.

O foco atual é o MVP da carteira de clientes, conforme definido em:

Preserve a arquitetura MVC atual do CodeIgniter 4.
Mantenha mudanças pequenas e bem isoladas.
Documente decisões de negócio no escopo da spec antes de implementar alterações amplas.
Sempre que uma tarefa for concluída, atualize a checklist em specs/001-carteira-clientes/tasks.md.
Antes de iniciar um trabalho relevante, leia esta instrução, a constitution, a spec, o plano e as tasks do feature atual.
Use a checklist como fonte única de progresso e mantenha os status alinhados com o que foi realmente implementado.
Sincronização GitHub/VPS: Sempre faça commit e envie (push) as alterações para o GitHub. A implantação no VPS é baseada no repositório remoto, portanto, manter o GitHub atualizado é obrigatório para cada entrega ou alteração relevante realizada.

Use a checklist em specs/001-carteira-clientes/tasks.md como fonte única de progresso.
Status permitidos:
- Não iniciado
- [~] Em andamento
- Concluído
- [!] Bloqueado
Marque uma tarefa como concluída somente quando houver evidência real de implementação e validação.
Se uma tarefa depender de outra, registre isso na própria linha da checklist.
Quando uma tarefa for alterada, mantenha a descrição objetiva e o estado atual alinhado com o que foi realmente feito.

O MVP inicial deve priorizar:

A partir daí, o trabalho pode avançar para portal operacional, status, antifraude e área administrativa.

comercial