🏕️ Kabanas

Kabanas é uma plataforma completa para gestão de aluguel de cabanas e casas por temporada, composta por uma API backend em Laravel e um frontend SPA em React. A aplicação oferece autenticação segura, controle de usuários, gestão de imóveis, reservas, e interface moderna e responsiva.

Repositórios:

• Backend: https://github.com/WillRy/cabanas-api
• FrontEnd: https://github.com/WillRy/cabanas-front

Usuário de teste

• email: admin@admin.com
• senha: password

⚙️ Backend — Laravel API

🧱 Stack

• Laravel 13

• PHP 8.5

• MySQL 8

• MySQL (para filas e cache)

• Laravel Sanctum no modo statefull/stateless para autenticação

• Mail Queues (envio assíncrono de e-mails)

• PHPUnit (testes automatizados) com 100% de cobertura de testes

🔐 Autenticação

O backend utiliza uma combinação de:

• Sanctum para autenticação de sessões SPA;

🧪 Testes (100% de cobertura)

Cobertura completa de:

Models: Validação de relacionamentos, casts e mutators.

Controllers: Fluxos de autenticação, criação e listagem de recursos.

Endpoints: Testes de integração cobrindo rotas REST principais.

#rodar os testes
php artisan test

#gerar relatorio de cobertura (vai gerar um index.html dentro da pasta coverage)
php artisan test --coverage-html coverage

📨 Filas de E-mail

As notificações e confirmações (como reservas ou redefinição de senha) são processadas de forma assíncrona via Redis Queue para melhor performance.

💻 Frontend — React SPA

🧱 Stack

• React 19+
• Vite
• React Router v7
• TanStack Query (React Query) — gerenciamento de estado de dados assíncronos
• Tailwind CSS — estilização moderna e responsiva

⚡ Funcionalidades

• Autenticação
• Listagem e gerenciamento de cabanas
• Listagem e gerenciamento de reservas
• Gerenciamento de check-in/check-out
• Dashboards:
  • Atividades do dia
  • Reservas por período
  • Vendas por período
  • Check-Ins por período
  • Taxa de ocupação
  • Gráfico de evolução de vendas/reservas
• Tabelas dinâmicas com paginação e ordenação server-side
• Prefetching de dados (API-side) para navegação fluida
• Feedback visual otimizado (loading, error boundaries)

Instalação

BackEnd

git clone https://github.com/WillRy/cabanas-api.git

cd cabanas-api

docker compose up -d


# executar fila de emails
docker exec -it phpfpm bash
php artisan queue:work

FrontEnd

git clone https://github.com/WillRy/cabanas-front.git

cd cabanas-front

cp .env.example .env

npm i

npm run dev