# 🧪 Guía: Crear cokecolombres en VPS desde 0

**Proyecto:** cokecolombres  
**URL:** cokecolombres.bewpro.com  
**Repositorio:** https://github.com/LACOMPANIADIGITAL/cokecolombres.git  
**Rama:** cd-system

---

## 📋 Información del Proyecto

| Campo | Valor |
|-------|-------|
| **Dominio** | cokecolombres.bewpro.com |
| **Usuario cPanel** | cokecolombres (máx 8 caracteres) |
| **Repositorio** | https://github.com/LACOMPANIADIGITAL/cokecolombres.git |
| **Rama** | cd-system |
| **Base de datos** | cokecolombres_db (se crea automáticamente) |
| **Usuario BD** | cokecolombres_usr (se crea automáticamente) |

---

## 🚀 Paso 1: Conectarse al VPS

```bash
ssh root@72.61.45.136
cd /root/scripts
```

---

## 🚀 Paso 2: Ejecutar Script de Creación

```bash
./bulk_create_cpanel3.sh --interactive
```

---

## 🚀 Paso 3: Responder Preguntas

### 3.1: Datos Básicos

```
Dominio: cokecolombres.bewpro.com
Usuario (máx 8 caracteres): cokecolom
Contraseña (dejar vacío para generar): [Enter]
Plan (default): [Enter]
Email contacto (admin@example.com): [Enter]
Cuota (MB, 0=ilimitado): [Enter]
```

**Nota:** El usuario se truncará a 8 caracteres si es más largo. `cokecolombres` → `cokecolom`

### 3.2: Crear Base de Datos

```
¿Querés crear la base de datos MySQL para cokecolom? (s/n): s
```

**Resultado esperado:**
```
✅ Base de datos y usuario creados:
   Base: cokecolom_db
   Usuario: cokecolom_usr
   Contraseña: [generada automáticamente]
```

### 3.3: Clonar Repositorio

```
¿Querés clonar un repositorio en public_html? (s/n): s
🔗 Ingresá el link del repositorio de GitHub: https://github.com/LACOMPANIADIGITAL/cokecolombres.git
🔍 Ingresá el nombre de la rama que querés usar: cd-system
⚙️  ¿Querés correr el script de setup? (s/n): s
```

**Resultado esperado:**
- Repositorio clonado en `/home/cokecolom/public_html/cokecolombres`
- Composer instalado (si no existe)
- Script `setup_cd_project.sh` ejecutado

---

## 🚀 Paso 4: Obtener Credenciales

```bash
cat /root/credenciales
```

**Salida esperada:**
```
Cuenta cPanel: cokecolom
Contraseña: [contraseña generada]
Base de datos: cokecolom_db
Usuario DB: cokecolom_usr
Contraseña DB: [contraseña generada]
```

**⚠️ IMPORTANTE:** Guarda estas credenciales en un lugar seguro.

---

## 🚀 Paso 5: Verificar Setup

### 5.1: Conectarse como Usuario

```bash
su - cokecolom
cd ~/public_html/cokecolombres
```

### 5.2: Verificar Archivos

```bash
ls -la
# Debe mostrar: artisan, composer.json, .env, etc.
```

### 5.3: Verificar .env

```bash
cat .env | grep -E "APP_NAME|APP_URL|DB_"
```

**Debe mostrar:**
```
APP_NAME=cokecolombres
APP_URL=https://cokecolombres.bewpro.com
DB_DATABASE=cokecolom_db
DB_USERNAME=cokecolom_usr
DB_PASSWORD=[contraseña de BD]
```

### 5.4: Verificar Base de Datos

```bash
php artisan migrate:status
```

Si hay errores, verificar:
```bash
# Verificar conexión
php artisan tinker
>>> DB::connection()->getPdo();
# Debe mostrar información de conexión
```

---

## 🚀 Paso 6: Configurar Dominio (Si es necesario)

Si el dominio no está configurado automáticamente:

1. **En cPanel:**
   - Ir a "Subdominios"
   - Crear subdominio: `cokecolombres.bewpro.com`
   - Apuntar a `public_html/cokecolombres/public`

2. **O vía SSH:**
   ```bash
   # Verificar configuración de Apache
   cat /etc/apache2/conf.d/userdata/std/2_4/cokecolom/cokecolombres.bewpro.com.conf
   ```

---

## 🚀 Paso 7: Verificar Sitio

1. **Acceder a:** `https://cokecolombres.bewpro.com`
2. **Verificar:**
   - ✅ Sitio carga correctamente
   - ✅ No hay errores 500
   - ✅ Base de datos conectada
   - ✅ Assets cargan (CSS, JS, imágenes)

---

## 🔧 Troubleshooting

### Error: "Database connection failed"

**Solución:**
```bash
# Verificar credenciales en .env
cat .env | grep DB_

# Verificar que la BD existe
mysql -u cokecolom_usr -p cokecolom_db
# Ingresar contraseña de BD
```

### Error: "Composer not found"

**Solución:**
```bash
# Verificar instalación
~/.local/bin/composer --version

# Si no existe, instalar manualmente
mkdir -p ~/.local/bin
cd ~
wget https://getcomposer.org/installer -O composer-setup.php
php composer-setup.php --install-dir=~/.local/bin --filename=composer
rm composer-setup.php
```

### Error: "Permission denied"

**Solución:**
```bash
# Verificar permisos
ls -la storage bootstrap/cache

# Corregir permisos
chmod -R 755 storage bootstrap/cache
chown -R cokecolom:cokecolom storage bootstrap/cache
```

### Error: "Extension fileinfo not found"

**Solución:**
1. En cPanel: "Select PHP Version"
2. Click en "Extensions"
3. Habilitar "fileinfo"
4. Guardar cambios

---

## ✅ Checklist Final

- [ ] Cuenta cPanel creada
- [ ] Base de datos creada
- [ ] Repositorio clonado
- [ ] Composer instalado
- [ ] Script de setup ejecutado
- [ ] .env configurado correctamente
- [ ] Migraciones ejecutadas
- [ ] Permisos correctos
- [ ] Dominio configurado
- [ ] Sitio accesible
- [ ] Base de datos conectada
- [ ] Assets cargando

---

## 📝 Notas

1. **Usuario truncado:** `cokecolombres` → `cokecolom` (8 caracteres máximo)
2. **Ruta del proyecto:** `/home/cokecolom/public_html/cokecolombres`
3. **Document root:** `/home/cokecolom/public_html/cokecolombres/public`
4. **Credenciales:** Guardadas en `/root/credenciales`

---

**Última actualización:** Noviembre 2024  
**Estado:** 🧪 LISTO PARA PRUEBA