# 🚀 Setup de Nuevo Proyecto CD-System

## 📋 Resumen Rápido

Después de clonar el cd-system (Paso 1), ejecuta el script de setup que configurará automáticamente tu proyecto.

---

## 🎯 Opción 1: Modo Rápido con JSON (Recomendado)

### 1. Preparar configuración
```bash
# Copiar template
cp tools/project.config.example.json tools/project.config.json

# Editar valores
nano tools/project.config.json
```

### 2. Ejecutar setup
```bash
chmod +x scripts/setup_cd_project.sh
./scripts/setup_cd_project.sh
```

**El script leerá automáticamente `tools/project.config.json` y no hará preguntas.**

---

## 🎯 Opción 2: Modo con Parámetros CLI

Para automatización o CI/CD:

```bash
./scripts/setup_cd_project.sh \
  --project-name="fundacionchaka" \
  --app-url="https://fundacionchaka.com" \
  --db-name="fundacionchaka_db" \
  --db-user="usuario" \
  --db-pass="contraseña" \
  --cpanel \
  --ga-id="G-XXXXXXXXXX" \
  --skip-interactive
```

---

## 🎯 Opción 3: Modo Interactivo (Por Defecto)

Si no usas JSON ni parámetros CLI, el script te preguntará todo:

```bash
chmod +x scripts/setup_cd_project.sh
./scripts/setup_cd_project.sh
```

---

## 📦 Requisitos Previos

Antes de ejecutar, asegúrate de tener:

- [ ] **Base de datos MySQL creada** (puede estar vacía)
- [ ] **Archivos JSON en `database/seeders/project-data/`**:
  - `projects.json`
  - `blog.json`
  - `cd-base.json`
  - `gallery.json`
  - `products.json`
  - `references.json`
  - `team.json`
- [ ] **Archivo `.env.example`** en la raíz del proyecto

---

## 📝 Estructura de `project.config.json`

```json
{
  "project": {
    "name": "nombre-proyecto",
    "url": "http://localhost",
    "environment": "local"
  },
  "database": {
    "name": "nombre_bd",
    "host": "127.0.0.1",
    "port": 3306,
    "username": "root",
    "password": ""
  },
  "analytics": {
    "google_analytics_id": ""
  },
  "deployment": {
    "skip_interactive": false,
    "auto_migrate": true,
    "auto_seed": true
  }
}
```

---

## ✅ Qué Hace el Script

1. ✅ **Valida dependencias** (composer, php)
2. ✅ **Valida archivos JSON** requeridos
3. ✅ **Instala dependencias** PHP (composer update)
4. ✅ **Configura .env** con tus valores
5. ✅ **Genera APP_KEY**
6. ✅ **Valida conexión** a base de datos
7. ✅ **Ejecuta migraciones** (con manejo de errores)
8. ✅ **Ejecuta seeders** para poblar datos
9. ✅ **Muestra credenciales** de acceso

---

## 🎉 Después del Setup

### Iniciar servidor (desarrollo local):
```bash
php artisan serve
```

### Personalizar identidad de marca:
```bash
# Actualizar assets (logos, favicons, skins)
php artisan project:update-assets public/cd-project/assets

# Personalizar sistema
php artisan cd-system:customize --brand-name="Nombre Proyecto"
```

### Acceder al panel:
- **URL**: `{APP_URL}/admin`
- **Usuario 1**: `coke@lacompaniadigital.com` / `demo`
- **Usuario 2**: `admin@{proyecto}.com` / `{Proyecto}2025`

---

## 🔧 Opciones del Script

Ver todas las opciones disponibles:
```bash
./scripts/setup_cd_project.sh --help
```

---

## 📚 Documentación Relacionada

- **[Paso 1: Clonar CD-System](1-comenzar-nuevo-proyecto.md)**
- **[Opciones de Simplificación](3-opciones-simplificacion-deployment.md)**
- **[Plan de Implementación](4-plan-implementacion-simplificacion.md)**