# PROJECT_SPEC.md

## Identificacao

Nome temporario: GLOBAL ESTOQUE.

Cliente: GLOBAL LEGENDARIOS E LEGADO.

Equipe usuaria: Equipe Daniel Vale.

Desenvolvimento: WOOP!web.

Rodape obrigatorio: "Global Legendarios e Legado - Equipe Daniel Vale - Desenvolvido por WOOP!web".

## Objetivo

Controlar estoque central, patrimonio individual, reservas para eventos, aprovacoes, retiradas, movimentacoes internas, devolucoes com inspecao, vendas, perdas, manutencao, ajustes, estornos e auditoria permanente.

## Escopo V1

A V1 inclui autenticacao, perfis, permissoes, estoques, locais/equipes, produtos, unidades individuais, QR Code, etiquetas, importacao, eventos, disponibilidade por periodo, reservas, aprovacao, separacao, retirada, fotos, devolucao, divergencias, vendas, perdas, manutencao, ajustes, estornos, dashboards, relatorios, PWA, auditoria, testes e documentacao cPanel.

## Stack

- PHP 8.3+
- Laravel 12
- MySQL 8+ em producao
- SQLite apenas para desenvolvimento/testes locais
- Blade
- Bootstrap 5.3+
- Bootstrap Icons
- JavaScript puro
- PWA basico
- PhpSpreadsheet
- Intervention Image
- Simple QR Code

## Perfis iniciais

- Super Admin: acesso completo.
- Controlador de Estoque: operacao de estoque, reservas, retirada, devolucao, manutencao e relatorios operacionais.
- Diretor de Evento: acesso aos proprios eventos, solicitacao de reserva, estoque do evento e pendencias.