# Configuração Laragon — Sistema de Vistorias

## Requisitos

- [Laragon](https://laragon.org/download/) (Full ou Portable)
- PHP **8.1+** (marque na instalação ou em Menu > PHP > Version)
- Apache (padrão) ou Nginx
- MySQL

## Instalação rápida

1. Instale o Laragon em **`C:\laragon`** (recomendado).
2. Abra o **Laragon** → **Start All** (Apache + MySQL).
3. Clique com o botão direito em `scripts\setup-laragon.bat` → **Executar como administrador**.

O script configura virtual host, hosts, `php.ini`, `.env`, banco, migrations e dependências Composer.

## Acesso

| Item | Valor |
|------|--------|
| **URL** | http://vistoria.test/ |
| **Login admin** | `admin@vistoria.local` |
| **Senha** | `admin123` |
| **Painel admin** | http://vistoria.test/admin |
| **Banco** | `vistoria` (usuário `root`, sem senha) |

## Estrutura no Laragon

O projeto permanece em:

`C:\Users\0100301112\Documents\Vistoria`

O script cria:

- `C:\laragon\etc\apache2\sites-enabled\auto.vistoria.test.conf` — aponta para `public/`
- `C:\laragon\www\vistoria` — atalho (junction) para o projeto no menu Laragon

## Comandos úteis (terminal)

Adicione o PHP do Laragon ao PATH ou use o caminho completo:

```bat
cd C:\Users\0100301112\Documents\Vistoria
C:\laragon\bin\php\php-8.3.x-Win32-vs16-x64\php.exe spark migrate
C:\laragon\bin\php\php-8.3.x-Win32-vs16-x64\php.exe spark db:seed AdminUserSeeder
```

No Laragon: **Menu > PHP > php.ini** para editar configurações manualmente.

## php.ini (uploads de vídeo)

```ini
upload_max_filesize = 64M
post_max_size = 70M
max_execution_time = 300
memory_limit = 256M
```

Reinicie o Apache após alterar (**Stop All** → **Start All**).

## .env

```ini
app.baseURL = 'http://vistoria.test/'
database.default.hostname = localhost
database.default.database = vistoria
database.default.username = root
database.default.password =
```

## Configuração manual

### Virtual host

Copie `laragon/vistoria.test.conf` para:

`C:\laragon\etc\apache2\sites-enabled\auto.vistoria.test.conf`

Ajuste `define ROOT` para o caminho da pasta **`public`** do projeto.

### hosts

O Laragon atualiza o hosts ao recarregar. Se necessário, adicione:

```
127.0.0.1    vistoria.test
```

### Banco

HeidiSQL (botão **Database** no Laragon):

```sql
CREATE DATABASE vistoria CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
```

Depois no projeto:

```bat
php spark migrate
php spark db:seed AdminUserSeeder
```

## Projeto dentro de `www` (alternativa)

1. Mova ou clone o projeto para `C:\laragon\www\vistoria`
2. No Laragon: clique direito no site → **Webroot** → selecione a pasta **`public`**
3. URL automática: http://vistoria.test/
4. Atualize `app.baseURL` no `.env` se o nome da pasta for diferente

## Nginx

Se usar Nginx no Laragon, crie em `C:\laragon\etc\nginx\sites-enabled\`:

```nginx
server {
    listen 80;
    server_name vistoria.test;
    root "C:/Users/0100301112/Documents/Vistoria/public";
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}
```

Recarregue o Nginx pelo Laragon.

## Problemas comuns

| Problema | Solução |
|----------|---------|
| Site não abre | **Start All** → Menu Apache **Reload** |
| 404 em rotas | `mod_rewrite` / AllowOverride; confira pasta `public` no vhost |
| Erro vendor | `composer install` na pasta do projeto |
| MySQL recusado | **Start All**; verifique porta 3306 |
| Upload falha | Aumente limites no `php.ini` do PHP ativo |
| SSL / HTTPS | Use http://vistoria.test/ em desenvolvimento |

## DigitalOcean Spaces

Edite o `.env` com suas chaves `DO_SPACES_*` para envio de fotos e vídeos.