# ⚡ Quick Start - UtilizaAI

## 1️⃣ Instalação Rápida (5 minutos)

### Windows

```bash
# 1. Ir para Downloads
cd %USERPROFILE%\Downloads

# 2. Clonar ou extrair
git clone https://github.com/utilizaai/utilizaai.git
cd utilizaai

# 3. Iniciar servidor PHP
cd public
php -S localhost:8000
```

Abrir navegador: **http://localhost:8000**

### Mac/Linux

```bash
# 1. Ir para home
cd ~

# 2. Clonar
git clone https://github.com/utilizaai/utilizaai.git
cd utilizaai

# 3. Iniciar servidor
cd public
php -S localhost:8000
```

Abrir navegador: **http://localhost:8000**

---

## 2️⃣ Primeiros Passos

### Acessar Ferramentas

1. Abrir http://localhost:8000
2. Clicar em uma ferramenta (ex: "PDF para Word")
3. Fazer upload de um arquivo
4. Clicar em "Converter"

### Explorar

- ✅ Homepage com todas as ferramentas
- 📄 Conversores de arquivos
- 🎨 Edição de imagens
- 🔒 Geradores de segurança
- 📑 Ferramentas de PDF
- 💻 Ferramentas de código

---

## 3️⃣ Configuração Mínima

### Com Banco de Dados (Opcional para começar)

```bash
# 1. Criar banco de dados
mysql -u root -p
CREATE DATABASE utilizaai;
EXIT;

# 2. Importar schema
mysql -u root -p utilizaai < src/database/schema.sql

# 3. Editar config.php
# src/includes/config.php
# Alterar DB_USER e DB_PASS
```

### Sem Banco de Dados

- Começar a explorar sem banco
- Usuário pode adicionar depois
- Perfeito para testes

---

## 4️⃣ Estrutura Básica

```
visitando: http://localhost:8000

├── / (homepage)
│   ├── Conversores
│   ├── Edição
│   ├── Geradores
│   └── ... outras seções
│
├── /tools/
│   ├── pdf-to-word.php
│   ├── image-converter.php
│   └── ... outras ferramentas
│
└── /setup.php (configurações)
```

---

## 5️⃣ Criar Sua Primeira Ferramenta

### Template de Ferramenta

Copiar `public/tools/pdf-to-word.php` e renomear:

```php
<?php
require_once __DIR__ . '/../../src/includes/config.php';
?>
<!DOCTYPE html>
<html lang="pt-BR">
<head>
    <meta charset="UTF-8">
    <title>Minha Ferramenta | <?php echo SITE_NAME; ?></title>
    <link rel="stylesheet" href="/utilizaai/public/css/styles.css">
</head>
<body>

<!-- HEADER -->
<header>
    <div class="header-container">
        <a href="/utilizaai/public/index.php" class="logo"><?php echo SITE_NAME; ?></a>
    </div>
</header>

<!-- MAIN -->
<main>
    <section class="section">
        <h1 class="section-title">🎯 Minha Ferramenta</h1>
        
        <!-- Seu conteúdo aqui -->
    </section>
</main>

<!-- FOOTER -->
<footer>
    <div class="footer-bottom">
        <p>&copy; 2026 <?php echo SITE_NAME; ?></p>
    </div>
</footer>

<script src="/utilizaai/public/js/scripts.js"></script>
</body>
</html>
```

### Adicionar à Homepage

Editar `public/index.php` e adicionar card:

```html
<div class="card">
    <div class="card-icon">🎯</div>
    <h3 class="card-title">Minha Ferramenta</h3>
    <p class="card-description">Descrição da minha ferramenta</p>
    <a href="/utilizaai/public/tools/minha-ferramenta.php" class="card-link">
        Abrir Ferramenta →
    </a>
</div>
```

---

## 6️⃣ Conhecer a Paleta de Cores

### Amarelo (Primário)
- **Hex:** #FFD700
- **RGB:** rgb(255, 215, 0)
- Usar em: Botões, titles, highlights

### Preto (Secundário)
- **Hex:** #000000
- **RGB:** rgb(0, 0, 0)
- Usar em: Texto, backgrounds, borders

### Cores Auxiliares
- **Branco:** #FFFFFF (fundo)
- **Cinza:** #f5f5f5 (backgrounds secundários)
- **Sucesso:** #4CAF50 (mensagens positivas)
- **Erro:** #f44336 (mensagens de erro)

### Exemplo de Uso

```css
/* CSS */
.btn-primary {
    background: var(--color-primary);      /* #FFD700 */
    color: var(--color-dark);              /* #000000 */
}

.btn-primary:hover {
    background: var(--color-light);        /* #FFFFFF */
    color: var(--color-primary);           /* #FFD700 */
    border: 2px solid var(--color-dark);   /* #000000 */
}
```

---

## 7️⃣ Usar JavaScript Utilities

```javascript
// Notificações
Utils.showNotification('Sucesso!', 'success');
Utils.showNotification('Erro!', 'error');

// Upload de Arquivos
const uploader = new Utils.FileUploader();
uploader.upload(file, '/api/endpoint');

// Copiar para Clipboard
Utils.copyToClipboard('texto para copiar');

// Download
Utils.downloadFile('/arquivo.pdf', 'meu-arquivo.pdf');

// Formatação
Utils.formatDate(new Date());
Utils.formatDate('2026-04-25');
```

---

## 8️⃣ API Básica

### Enviar Arquivo

```javascript
const formData = new FormData();
formData.append('file', fileInput.files[0]);

fetch('/utilizaai/src/api/converters/pdf-to-word.php', {
    method: 'POST',
    body: formData
})
.then(r => r.json())
.then(data => console.log(data));
```

### Resposta

```json
{
  "success": true,
  "message": "Arquivo convertido",
  "data": {
    "output_file": "resultado.docx",
    "download_url": "/api/download.php?file=resultado.docx"
  }
}
```

---

## 9️⃣ Troubleshooting Rápido

### Erro 404

```
Problema: Página não encontrada
Solução: 
- Verificar se arquivo existe
- Verificar URL no navegador
- Reiniciar servidor PHP
```

### Erro de Upload

```
Problema: Arquivo não foi aceito
Solução:
- Verificar tamanho (máx 50MB)
- Verificar tipo de arquivo
- Verificar permissões da pasta uploads
```

### Erro de Banco de Dados

```
Problema: Conexão recusada
Solução:
- Verificar se MySQL está rodando
- Verificar credenciais em config.php
- Importar schema.sql
```

---

## 🔟 Links Importantes

- 📖 [Documentação Completa](./INSTALL.md)
- 🚀 [Roadmap do Projeto](./ROADMAP.md)
- 🤝 [Como Contribuir](./CONTRIBUTING.md)
- 📝 [API Reference](./docs/API.md)
- 💬 [GitHub Discussions](https://github.com/utilizaai)

---

## 🎓 Próximos Passos

1. ✅ Explorar as ferramentas
2. ✅ Configurar banco de dados
3. ✅ Criar sua primeira ferramenta
4. ✅ Customizar design
5. ✅ Implementar autenticação
6. ✅ Fazer deploy em produção

---

## 💡 Dicas Práticas

### Desenvolvimento Local

```bash
# Terminal 1: Servidor
cd public
php -S localhost:8000

# Terminal 2: Editor (VS Code, etc)
code .

# Terminal 3: Testes (opcional)
php -l public/index.php  # Verificar sintaxe
```

### Reload Automático

```bash
# Instalar watchdog (Linux)
sudo apt install inotify-tools

# Script de reload automático
while true; do
    inotifywait -e modify -r public/
    # recarregar browser
done
```

### Debug com var_dump

```php
<?php
var_dump($_POST);
var_dump($_FILES);
var_dump($database->getConnection());
?>
```

---

## 🆘 Precisa de Ajuda?

- 📧 Email: suporte@utilizaai.com
- 💬 Discord: [Comunidade](https://discord.gg/utilizaai)
- 🐛 Issues: [GitHub Issues](https://github.com/utilizaai/issues)
- 📚 Docs: [Documentação](./docs/)

---

**Bem-vindo ao UtilizaAI! Divirta-se criando! 🚀**

Última atualização: **25/04/2026**
