# 🚀 QUICK START - Codex SaaS

**Status: PRONTO PARA IMPLANTAÇÃO** ✅

> Última atualização: 2026-04-08

---

## ⚠️ PRÉ-REQUISITO: PHP e Composer

### ❌ Se você recebeu erro "composer não encontrado":

**Opção 1: Instalação Automática (Mais Fácil)**
```batch
# Execute como administrador:
install_php_windows.bat
```

**Opção 2: Instalação Manual**
1. Instale XAMPP: https://www.apachefriends.org/download.html
2. Ou PHP standalone: https://windows.php.net/download
3. Instale Composer: https://getcomposer.org/Composer-Setup.exe

**Testar instalação:**
```batch
# Execute após instalar:
test_installation.bat
```

---

## ⚡ Instalação Rápida (5 minutos)

### 1. Upload para servidor
```bash
git clone seu-repo /var/www/codex
cd /var/www/codex
```

### 2. Instalar dependências
```bash
composer install --no-dev --optimize-autoloader
```

### 3. Configurar ambiente (arquivo: `.env`)
```bash
DB_HOST=seu-banco.com
DB_NAME=saas_barbearia
DB_USER=usuario_banco
DB_PASS=senha_forte_aqui
APP_ENV=production
APP_KEY=chave-unica-e-segura
```

### 4. Criar pastas e permissões
```bash
mkdir -p storage/logs storage/uploads
chmod -R 755 storage
chown -R www-data:www-data /var/www/codex
chmod 600 /var/www/codex/.env
```

### 5. Configurar servidor web
  
**Apache**: Nada a fazer - `.htaccess` já existe
  
**Nginx**: Use arquivo `nginx.conf` como referência

### 6. Verificar status
```bash
# Interface visual
https://seu-dominio.com/diagnose.php

# API JSON  
https://seu-dominio.com/health-check.php
```

---

## 📋 Requisitos do Servidor

- ✅ PHP 8.0+
- ✅ MySQL 5.7+ (ou MariaDB 10.2+)
- ✅ Composer
- ✅ OpenSSL
- ✅ Extensões: PDO, PDO MySQL, JSON
- ✅ SSH access (opcional)
- ✅ cPanel/Plesk (opcional)

---

## 🔍 Verificação Rápida

```bash
# SSH no servidor e execute:
cd /var/www/codex

# 1. Verificar PHP
php -v  # Deve ser >= 8.0

# 2. Verificar Composer
composer --version

# 3. Verificar permissões
ls -la .env  # Deve mostrar -rw------- (600)
ls -la storage/  # Deve mostrar drwxr-xr-x (755)

# 4. Testar credenciais banco de dados
php /var/www/codex/test_db.php
```

---

## 📞 Arquivos de Ajuda Neste Repositório

| Arquivo | Descrição |
|---------|-----------|
| `DEPLOYMENT_INSTRUCTIONS.md` | Guia completo (Apache/Nginx) |
| `SECURITY_CHECKLIST.md` | Lista segurança pré-prod |
| `prepare-server.sh` | Script bash automático |
| `Dockerfile` | Para containerização |
| `docker-compose.yml` | Ambiente local completo |
| `nginx.conf` | Configuração Nginx |
| `public/.htaccess` | Configuração Apache |
| `public/diagnose.php` | Ferramenta diagnóstico |
| `public/health-check.php` | Endpoint monitoramento |

---

## ❌ Se algo der errado

### Erro: "vendor/autoload.php not found"
```bash
composer install --no-dev
```

### Erro: "Permission denied" em storage/
```bash
chmod -R 755 storage/
chown -R www-data:www-data storage/
```

### Erro: ".env not found"
```bash
cp .env.example .env
# Edite com suas credenciais
```

### Erro: "Database connection failed"
```bash
# Verifique .env
nano .env

# Teste conexão
php -r "
\$pdo = new PDO('mysql:host='.getenv('DB_HOST').';dbname='.getenv('DB_NAME'), 
                 getenv('DB_USER'), 
                 getenv('DB_PASS'));
echo 'OK';
"
```

---

## ✨ Recursos Inclusos

✅ Roteamento automático (URL rewriting)  
✅ Headers de segurança (CSRF, X-Frame-Options)  
✅ Compressão Gzip automática  
✅ Cache de navegador configurado  
✅ Health check para monitoramento  
✅ Diagnóstico visual web  
✅ Documentação completa  
✅ Docker support  

---

## 🆘 Suporte

1. Consulte `DEPLOYMENT_INSTRUCTIONS.md`
2. Consulte `SECURITY_CHECKLIST.md`
3. Verifique `/diagnose.php` na aplicação
4. Verifique logs em `storage/logs/`

**Espera-se que esteja rodando em ~10 minutos!**