# Módulo: {NOMBRE}

> **Estado:** ⏳ Pending / ✅ Production-ready
> **Última auditoría:** YYYY-MM-DD
> **Doc técnica complementaria:** [`docs/backend3.0/{slug}/README.md`](../../backend3.0/{slug}/README.md)

---

## 1. Identidad

| Campo | Valor |
|-------|-------|
| **Nombre** | {Nombre} |
| **Slug** | `{slug}` |
| **Cores que lo usan** | N (lista de cores) |
| **Productos a la venta** | N de 8 |
| **Modelo principal** | `App\Modules\{Nombre}\Models\{Model}` |
| **Tabla principal** | `{tabla}` |
| **Tabla categorías (si aplica)** | `{tabla_categorias}` |
| **Vista standalone** | `/{slug}` |
| **Vista detail** | `/{slug}/{id-o-slug}` |
| **CRUD admin** | `/admin/{slug}` |

---

## 2. Defaults JSON — `database/seeders/project-data/defaults/{slug}.json`

| Campo | Cantidad | Notas |
|-------|---------:|-------|
| Items principales | N | (≥5 requerido) |
| Categorías | N | (si aplica) |
| Tags | N | (si aplica) |

**Calidad de los textos**:
- [ ] Cero placeholders `[NOMBRE]` / `Lorem ipsum`
- [ ] Cero strings en inglés
- [ ] Textos genéricos pero presentables
- [ ] Imágenes apuntan a `cd-project/img/defaults/{modulo}/`

---

## 3. Asset pack genérico — `public/cd-project/img/defaults/{slug}/`

| Archivo | Dimensión | Peso | Notas |
|---------|-----------|------|-------|
| {tipo}-1.jpg | WxH | KB | |
| {tipo}-2.jpg | | | |
| ... | | | |

---

## 4. Variables expuestas vía ViewComposer

| Variable | Origen | Dónde se usa | Notas |
|----------|--------|--------------|-------|
| `${variable}` | módulo {slug} | welcome, about, contact, frontend.* | |

---

## 5. Vistas

### Frontend
| Archivo | Líneas | Contenido |
|---------|--------|-----------|
| `resources/views/modules/{slug}/frontend/{slug}.blade.php` | N | Listing standalone |
| `resources/views/modules/{slug}/frontend/{slug}-detail.blade.php` | N | Detail page |
| `resources/views/modules/{slug}/frontend/partials/dynamic-header.blade.php` | N | Cases por demo (si aplica) |

### Admin
| Archivo | Notas |
|---------|-------|
| `resources/views/modules/{slug}/admin/index.blade.php` | DataTable + actions |
| `resources/views/modules/{slug}/admin/create.blade.php` | (o modal) |
| ... | |

---

## 6. CRUD admin

- **Ruta**: `/admin/{slug}`
- **Permisos**: `{slug}.view`, `{slug}.create`, `{slug}.edit`, `{slug}.delete`
- **Funcionalidades**: listing + create + edit + delete + toggle active + toggle featured + bulk delete

---

## 7. Comandos artisan

| Comando | Función |
|---------|---------|
| `bewpro:clean-{slug}` | Limpia datos del módulo (mantiene estructura) |
| `bewpro:refresh-{slug}` | Re-seedea desde defaults JSON |

---

## 8. Cómo cada demo lo integra (cases observados)

| Demo | Bloque embebido | Customización |
|------|-----------------|---------------|
| demo-law-firm-2 | welcome.blade L88-164 (services owl-carousel) | cards custom-card-style-1 |
| demo-architecture-2 | ... | ... |
| ... | ... | ... |

---

## 9. Auditoría — 30 items

| Bloque | Items pasan | Items fallan | Estado |
|--------|-------------|--------------|--------|
| 1. Identidad y código (4) | / | | |
| 2. Defaults JSON (6) | / | | |
| 3. Asset pack (5) | / | | |
| 4. Vistas (6) | / | | |
| 5. Integración sistema (5) | / | | |
| 6. CRUD admin (4) | / | | |
| **TOTAL** | / 30 | | |

**Veredicto**: ⏳ pending / ✅ production-ready

---

## 10. Bugs conocidos / fuera de scope

---

## 11. Referencias

- Doc técnica: `docs/backend3.0/{slug}/README.md`
- Module template: `docs/backend3.0/Module-Template/README.md`
- Demo integration pattern: `docs/bewpro2.0/modules/DEMO-INTEGRATION-PATTERN.md`
- Module checklist: `docs/bewpro2.0/modules/MODULE-CHECKLIST.md`