# AGENTS.md

## Papel do desenvolvedor

Este projeto e o sistema GLOBAL ESTOQUE, da GLOBAL LEGENDARIOS E LEGADO, utilizado pela equipe de Daniel Vale e desenvolvido por WOOP!web.

Antes de alterar regras de negocio, leia PROJECT_SPEC.md, BUSINESS_RULES.md, DATABASE_SPEC.md, UI_UX_SPEC.md e DEPLOYMENT.md.

## Diretrizes permanentes

- PHP 8.3+ com Laravel estavel, Blade, Bootstrap 5.3+, MySQL 8+ e Composer.
- Nao usar React, Vue, Angular, SPA obrigatoria, Docker obrigatorio ou servicos externos obrigatorios.
- Git nao e requisito operacional do cliente.
- Toda movimentacao confirmada deve ser imutavel. Erros sao corrigidos por estorno auditado.
- Operacoes criticas devem usar validacao backend, autorizacao, transacoes e registro em audit_logs.
- A regra de disponibilidade por periodo e critica e deve ser preservada por testes.
- Interface mobile-first para retirada, devolucao e scanner.

## Fluxo de trabalho

1. Atualize a documentacao quando uma decisao permanente mudar.
2. Crie migrations relacionais; nao concentrar o dominio em tabela unica.
3. Use Services para regras complexas, Policies/Gates ou middleware para acesso e Form Requests quando os formularios crescerem.
4. Rode migrations e testes relacionados antes de considerar uma etapa concluida.