Testing Alpha

docs/seeder/config.md

@@ -0,0 +1,32 @@
+# ⚙️ Configuración del sistema de seeders
+
+El archivo `config/seeder.php` permite controlar el comportamiento global de todos los módulos.
+
+## 🔑 Opciones principales
+
+| Opción         | Tipo    | Descripción |
+|----------------|---------|-------------|
+| `env`          | string  | Entorno actual (local, demo, etc.) |
+| `modules`      | array   | Lista de módulos con su configuración individual |
+| `defaults`     | array   | Valores por defecto para todos los seeders |
+| `clear_assets` | array   | Define qué carpetas se borran antes de iniciar |
+
+## 🧩 Configuración por módulo
+
+Cada módulo acepta:
+
+```php
+'users' => [
+  'enabled' => true,
+  'seeder' => UserSeeder::class,
+  'file' => 'users.json',
+  'depends_on' => ['permissions'],
+  'truncate' => true,
+  'faker_only' => false,
+  'fake' => [
+    'min' => 5,
+    'max' => 100,
+    'images' => [...]
+  ],
+],
+```

docs/seeder/create-new-seeder.md

@@ -0,0 +1,33 @@
+# 🧱 Cómo crear un nuevo Seeder compatible
+
+## 1. Crear el Seeder
+
+```php
+class ProductoSeeder extends AbstractDataSeeder
+{
+    use HasSeederFactorySupport;
+    use HandlesFileSeeders;
+
+    public function run(array $config = []): void
+    {
+        $this->seedFromJson('productos.json');
+    }
+
+    public function runFake(int $total, array $config = []): void
+    {
+        Producto::factory()->count($total)->create();
+    }
+}
+```
+
+## 2. Registrar en `config/seeder.php`
+
+```php
+'products' => [
+  'enabled' => true,
+  'seeder' => ProductoSeeder::class,
+  'file' => 'products.json',
+  'faker_only' => false,
+  'fake' => ['min' => 5, 'max' => 100],
+],
+```

docs/seeder/index.md

@@ -0,0 +1,10 @@
+# 🌱 Koneko ERP - Sistema de Seeders Modular
+
+Este sistema permite poblar la base de datos del ERP de forma controlada, desde archivos CSV/JSON o mediante generación con Faker, incluyendo soporte para:
+
+- Seeders con dependencias (`depends_on`)
+- Modo `dry-run` (simulación sin afectar BD)
+- Reportes en formato Markdown y JSON
+- Limpieza automática de assets (ej. avatares)
+- Soporte para múltiples entornos (`SEEDER_ENV`)
+- Generación de imágenes y datos falsos

docs/seeder/usage.md

@@ -0,0 +1,30 @@
+# 🚀 Cómo ejecutar los seeders
+
+## 🧪 Modo normal
+
+```bash
+php artisan migrate:fresh --seed
+```
+
+## 🎯 Ejecutar módulo específico
+
+```bash
+php artisan db:seed --class=DatabaseSeeder --only=users
+```
+
+## 🧹 Activar limpieza de assets
+
+Controlado por `config/seeder.php > clear_assets`.
+
+## 🧼 Dry run
+
+```php
+$orchestrator->run(only: 'users', options: ['dry-run' => true]);
+```
+
+## 📁 Reportes
+
+Se generan automáticamente:
+
+- `database/seeders/reports/local/seed-report-*.md`
+- `database/seeders/reports/local/seed-report-*.json`