Documentação do Projeto

📦 Tecnologias Utilizadas

Backend

• Framework: Laravel 12.x
• Linguagem: PHP
• Gerenciador de dependências: Composer
• Banco de Dados: SQLite (padrão, mas pode ser alterado)

Frontend

• Framework: SvelteKit
• Linguagem: TypeScript
• Gerenciador de pacotes: pnpm (ou npm/yarn)
• Build tool: Vite

⚙️ Instruções para Build e Execução Local

🔁 Requisitos Gerais

• PHP >= 8.2
• Node.js >= 18
• Composer
• pnpm (ou npm/yarn)
• SQLite (ou outro banco configurado no .env)

📂 Estrutura de Diretórios (Mono Repositório)

/backend    ← Aplicação Laravel
/frontend   ← Aplicação SvelteKit

🔧 Backend (Laravel)

1. Acesse o diretório do backend:

   cd backend
   

2. Instale as dependências:

   composer install
   

3. Copie o arquivo .env e gere a key da aplicação:

   cp .env.example .env
   php artisan key:generate
   

4. Configure o banco de dados (padrão: SQLite):

   touch database/database.sqlite
   echo "DB_CONNECTION=sqlite" >> .env
   

5. Execute as migrations e seeders:

   php artisan migrate --seed
   

6. Inicie o servidor local:

   php artisan serve
   

A API estará disponível por padrão em: http://localhost:8000/api/products

🌐 Frontend (SvelteKit)

1. Acesse o diretório do frontend:

   cd frontend
   

2. Instale as dependências:

   npm install
   # ou: pnpm install / yarn install
   

3. Crie o arquivo .env com a URL da API:

   echo "VITE_API_BASE_URL=http://localhost:8000" > .env
   

4. Execute o servidor de desenvolvimento:

   npm run dev
   

O frontend estará disponível por padrão em: http://localhost:5173/products

📡 Endpoints e Acessos

• API: GET http://localhost:8000/api/products – Lista todos os produtos
• Frontend: http://localhost:5173/products – Página que consome e exibe os produtos da API

🛠️ Extras

• A aplicação SvelteKit está configurada para buscar os dados no load() da rota +page.ts, respeitando a separação entre lógica e apresentação (arquivo +page.svelte).
• A aplicação Laravel possui um ProductSeeder e uma ProductFactory para gerar dados de exemplo automaticamente.
• Certifique-se de liberar CORS no Laravel com o comando:

  php artisan install:api
  

✅ Sugestão de Teste Rápido

1. Suba o backend com php artisan serve
2. Suba o frontend com npm run dev
3. Acesse http://localhost:5173/products para visualizar os produtos.