# Instalacao - Sistema de Leiloes

## Requisitos

- PHP 7.4+ (com extensoes: PDO, PDO_MySQL, mbstring, gd, curl, openssl)
- MySQL 5.7+ ou MariaDB 10.3+
- Apache com mod_rewrite habilitado (ou Nginx)
- Composer (gerenciador de dependencias PHP)

---

## Passo a Passo

### 1. Upload dos Arquivos

Envie todos os arquivos para o diretorio raiz do dominio no servidor (public_html ou www).

### 2. Banco de Dados

1. Crie um banco de dados MySQL no painel de hospedagem
2. Importe o arquivo `database/schema.sql` (estrutura base) no phpMyAdmin ou via terminal:
   ```bash
   mysql -u USUARIO -p BANCO < database/schema.sql
   ```
3. Importe os dados iniciais (se fornecido):
   ```bash
   mysql -u USUARIO -p BANCO < database/seed.sql
   ```

### 3. Configuracao do Banco de Dados

Edite o arquivo `plugins/ZZ/confg.php` com as credenciais do servidor:

```php
$localhost_config = 'localhost';          // Host do banco (geralmente localhost)
$banco_config     = 'nome_do_banco';     // Nome do banco criado
$nome_config      = 'usuario_do_banco';  // Usuario MySQL
$senha_config     = 'senha_do_banco';    // Senha MySQL
```

### 4. Cores do Sistema

No mesmo arquivo `plugins/ZZ/confg.php`, ajuste as cores principais:

```php
define('LARANJA', '000000');   // Cor primaria (hexadecimal sem #)
define('LARANJA2', '000000');  // Cor secundaria
```

### 5. Dependencias PHP

Na raiz do projeto, execute:

```bash
composer install
```

### 6. Permissoes de Diretorio

Garanta permissao de escrita nos diretorios de upload:

```bash
chmod -R 775 web/fotos/
chmod -R 775 web/img/
```

### 7. Apache - mod_rewrite

Certifique-se de que o mod_rewrite esta habilitado. O `.htaccess` ja esta configurado na raiz.

Se usar Nginx, adicione no bloco server:

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

### 8. Configuracoes do Site (via Painel Admin)

Acesse `seudominio.com/admin` e configure:

| Item | Onde configurar |
|------|----------------|
| Nome da empresa, telefone, WhatsApp | Configuracoes > Config Site |
| Logo do site | Envie `web/logo.png` (ou altere via admin) |
| E-mails SMTP | Configuracoes > Emails |
| Banners da home | Banners |
| Categorias de lotes | Categorias |
| Textos de e-mails | Textos (templates de e-mail editaveis) |

### 9. Primeiro Acesso ao Admin

- URL: `seudominio.com/admin`
- Login: `admin`
- Senha gravada no banco (md5): `mudar`

**ATENCAO — regra do super-admin (id=1):** o sistema exige que voce digite no
formulario de login OS 3 PRIMEIROS CARACTERES DO DOMINIO (sem `www.`, sem
`https://`) na frente da senha. Exemplos:

| Dominio                       | Senha a digitar no form |
|-------------------------------|--------------------------|
| `meusite.com.br`              | `meumudar`               |
| `leilografamoso.com`          | `leimudar`               |
| `xpto.com`                    | `xptmudar`               |

**Troque a senha imediatamente apos o primeiro acesso** em `/admin > Usuarios`.

---

## Estrutura de Diretorios

```
/
├── admin/          # Painel administrativo
├── app/            # Controllers, funcoes, AJAX handlers
│   ├── Ajax/       # Endpoints AJAX (formularios, acoes)
│   ├── Classes/    # Classes PHP (Email, Upload)
│   ├── Funcoes/    # Funcoes utilitarias
│   └── Json/       # Configuracoes de modulos admin (JSON)
├── assets/         # Bibliotecas CSS/JS de terceiros
├── css/            # Estilos do site
├── js/             # Scripts do site
├── plugins/
│   └── ZZ/confg.php  # ** CONFIGURACAO DO BANCO DE DADOS **
├── system/
│   ├── conecta.php   # Bootstrap do sistema (defines, constantes)
│   └── mysql.php     # Classe de conexao PDO
├── vendor/         # Dependencias Composer
├── views/          # Templates do site (phtml)
├── web/
│   ├── fotos/      # Upload de fotos (lotes, banners, etc.)
│   ├── img/        # Imagens estaticas do tema
│   └── logo.png    # Logo principal do site
├── .htaccess       # Regras de rewrite Apache
├── default.php     # Router principal
└── index.php       # Entry point
```

---

## Personalizacao Visual

| Elemento | Arquivo |
|----------|---------|
| Header/Menu | `views/header-46.phtml` |
| Footer | `views/z_footer.phtml` |
| Home | `views/home.phtml` |
| Layout do lote | `views/z_leilao-*.phtml` |
| CSS principal | `css/` |
| Logo | `web/logo.png` |
| Cores do menu | Admin > Configuracoes |

---

## Checklist Pos-Instalacao

- [ ] Banco de dados criado e importado
- [ ] `plugins/ZZ/confg.php` configurado com credenciais corretas
- [ ] `composer install` executado
- [ ] Permissoes de escrita em `web/fotos/` e `web/img/`
- [ ] mod_rewrite habilitado (Apache) ou rewrite configurado (Nginx)
- [ ] Acesso ao admin funcionando (`/admin`)
- [ ] SMTP configurado para envio de e-mails
- [ ] Logo e banners atualizados
- [ ] Categorias de lotes criadas
- [ ] SSL/HTTPS configurado no servidor
- [ ] Senha do admin alterada
