2.9 KiB
Portal de Requisição e Reserva de Equipamentos
Portal interno para consultar, requisitar, aprovar, entregar e devolver equipamentos cuja fonte oficial de inventário é o Snipe-IT.
Estado atual
O projeto concluiu as Fases 1 a 5: fundação técnica, integração Snipe-IT, motor de reservas, aprovações e operações físicas. Estão disponíveis autenticação local, catálogo temporal, pré-reservas, conflitos, calendário pessoal, decisões e notificações, checkout/check-in Snipe-IT, área diária do operador, entrega/devolução auditada, incidentes, atrasos e bloqueios. A próxima entrega é a administração e os relatórios.
Consulte sempre docs/PROJECT_STATUS.md antes de alterar o projeto. Esse documento contém o ponto de situação, riscos e próxima tarefa recomendada.
Arranque rápido
Requisitos: Docker Desktop e Docker Compose.
cp .env.example .env
docker compose build
docker compose run --rm app php artisan key:generate
docker compose up -d
docker compose exec app php artisan migrate --seed
O portal fica disponível em http://localhost:8000 e o Mailpit em http://localhost:8025.
Contas de desenvolvimento:
| Perfil | Palavra-passe | |
|---|---|---|
| Requisitante | demo@escola.pt |
password |
| Administrador | admin@escola.pt |
password |
Estas credenciais existem apenas no DatabaseSeeder e nunca devem ser usadas em produção.
Comandos frequentes
docker compose exec app composer test
docker compose exec app composer lint
docker compose exec app composer types:check
docker compose exec node npm run types:check
docker compose exec node npm run lint:check
docker compose exec node npm run build
Como o serviço Docker define variáveis de desenvolvimento, use o script Composer para testes. O script força de forma isolada APP_ENV=testing, SQLite em memória, cache/sessão em memória e fila síncrona, evitando locks Redis ou middleware CSRF do ambiente local:
docker compose exec app composer test
Para repor apenas dados de desenvolvimento:
docker compose exec app php artisan migrate:fresh --seed
Documentação
- Estado e handoff
- Arquitetura
- Requisitos e âmbito
- Decisões técnicas
- Operação local
- Registo de alterações
- Regras para agentes
Stack
- Laravel 13 / PHP 8.3+
- React 19 / TypeScript / Inertia 3
- Tailwind CSS 4 / componentes shadcn/ui
- PostgreSQL 17
- Redis 7
- Nginx, worker de filas, scheduler e Mailpit em Docker Compose
- Pest, PHPStan/Larastan, ESLint, Prettier e TypeScript
Princípio central
O portal nunca escreve diretamente na base de dados do Snipe-IT. Identificação e estado operacional do equipamento pertencem ao Snipe-IT; períodos, aprovações, conflitos, notificações, entrega/devolução e auditoria pertencem ao portal.