# Manual de Aprovisionamiento Multi-tenant - Sireco 2.0

Este documento detalla los comandos necesarios para dar de alta a un nuevo cliente en la plataforma Sireco 2.0.

---

## 1. Aprovisionamiento de Nueva Empresa
Este comando inicia el flujo interactivo. Creará el registro en la base de datos maestra, creará la base de datos física del cliente en AWS, ejecutará las migraciones operativas y cargará los datos maestros (DANE, Marcas, Roles).

**Comando:**
```bash
/usr/local/bin/ea-php83 artisan tenant:provision new
```

**Flujo interactivo:**
1.  Ingresa el **Nombre o Razón Social** de la empresa.
2.  Ingresa el **NIT** de la empresa.
3.  Confirma con `yes` cuando el sistema te pregunte si deseas proceder.
4.  **IMPORTANTE:** Al finalizar, el comando te mostrará el **ID de la Empresa** (ej: ID: 10). Anótalo para el siguiente paso.

---

## 2. Creación del Usuario Administrador
Una vez que la empresa está provisionada, debes crear su primer usuario para que puedan acceder al sistema.

**Comando:**
```bash
/usr/local/bin/ea-php83 artisan tenant:create-admin [ID_DE_LA_EMPRESA]
```
*(Reemplaza `[ID_DE_LA_EMPRESA]` por el número que obtuviste en el paso anterior).*

**Datos que te pedirá:**
*   Nombre del Administrador.
*   Correo electrónico (será su login).
*   Contraseña (mínimo 8 caracteres).

---

## 3. Comandos de Mantenimiento (Opcionales)

### Sincronizar Base Maestra (Landlord)
Si en el futuro agregas migraciones a la carpeta `database/migrations/landlord`:
```bash
/usr/local/bin/ea-php83 artisan migrate --database=landlord --path=database/migrations/landlord
```

### Ejecutar Migraciones en TODOS los clientes
Si agregas una nueva funcionalidad que requiere una tabla nueva en todos los clientes existentes:
```bash
/usr/local/bin/ea-php83 artisan tenants:migrate
```

---

## Notas de Configuración
*   **IP AWS:** Asegúrate de que tu IP esté habilitada en el **Security Group de AWS** (Puerto 5432) antes de correr estos comandos.
*   **Caché:** Si cambias el archivo `.env`, recuerda correr siempre:
    ```bash
    /usr/local/bin/ea-php83 artisan config:clear
    ```

---
*Generado automáticamente por Antigravity - Sireco 2.0 Automation Engine*