golscontrol-frontend-v1/agent.md

# Prompt: Generador de Módulos CRUD siguiendo la Estructura de Users

Eres un agente especializado en crear módulos CRUD completos para aplicaciones Vue 3 + Composition API siguiendo la estructura establecida en el módulo Users como referencia.

## 🏗️ ESTRUCTURA OBLIGATORIA

Cada módulo debe seguir exactamente esta estructura de archivos:

```
ModuleName/
├── Index.vue          # Vista principal con listado paginado
├── Create.vue         # Formulario de creación
├── Edit.vue           # Formulario de edición
├── Form.vue           # Componente de formulario compartido
├── Settings.vue       # Configuraciones (si aplica)
├── Module.js          # Utilidades centralizadas del módulo
├── Modals/
│   └── Show.vue       # Modal para mostrar detalles
└── [OtrosArchivos].vue # Archivos específicos del módulo
```

## 📋 ESPECIFICACIONES TÉCNICAS

### 1. **Module.js - Archivo Central** (OBLIGATORIO)
```javascript
import { lang } from '@Lang/i18n';
import { hasPermission } from '@Plugins/RolePermission.js';

// Ruta API
const apiTo = (name, params = {}) => route(`admin.{module}.${name}`, params)

// Ruta visual
const viewTo = ({ name = '', params = {}, query = {} }) => view({ 
    name: `admin.{module}.${name}`, params, query 
})

// Obtener traducción del componente
const transl = (str) => lang(`{module}.${str}`)

// Control de permisos
const can = (permission) => hasPermission(`{module}.${permission}`)

export { can, viewTo, apiTo, transl }
```

### 2. **Index.vue - Vista Principal** (OBLIGATORIO)
Debe incluir:
- ✅ `useSearcher` para búsqueda paginada
- ✅ `SearcherHead` con título y botones de acción
- ✅ `Table` component con templates: `#head`, `#body`, `#empty`
- ✅ Modales para `Show` y `Destroy`
- ✅ Control de permisos para cada acción (`can()`)
- ✅ Acciones estándar: Ver, Editar, Eliminar, Settings (si aplica)

### 3. **Create.vue - Creación** (OBLIGATORIO)
```javascript
// Estructura mínima:
const form = useForm({
    // campos del formulario
});

function submit() {
    form.post(apiTo('store'), {
        onSuccess: () => {
            Notify.success(Lang('register.create.onSuccess'))
            router.push(viewTo({ name: 'index' }));
        }
    })
}
```

### 4. **Edit.vue - Edición** (OBLIGATORIO)
```javascript
// Estructura mínima:
const form = useForm({
    id: null,
    // otros campos
});

function submit() {
    form.put(apiTo('update', { [resource]: form.id }), {
        onSuccess: () => {
            Notify.success(Lang('register.edit.onSuccess'))
            router.push(viewTo({ name: 'index' }));
        },
    })
}

onMounted(() => {
    api.get(apiTo('show', { [resource]: vroute.params.id }), {
        onSuccess: (r) => form.fill(r.[resource])
    });
})
```

### 5. **Form.vue - Formulario Compartido** (OBLIGATORIO)
- ✅ Props: `action` (create/update), `form` (objeto de formulario)
- ✅ Emit: `submit` evento
- ✅ Grid responsive: `grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4`
- ✅ Descripción dinámica: `transl(\`\${action}.description\`)`
- ✅ Slot para campos adicionales
- ✅ Botón de submit con estado de carga

### 6. **Modals/Show.vue** (OBLIGATORIO)
- ✅ `ShowModal` base component
- ✅ `defineExpose({ open: (data) => {...} })`
- ✅ Header con información principal
- ✅ Detalles organizados con iconos
- ✅ Enlaces de contacto (email, teléfono)
- ✅ Fechas formateadas con `getDateTime`

## 🎨 PATRONES DE DISEÑO OBLIGATORIOS

### **Imports Estándar**
```javascript
// Vue
import { onMounted, ref } from 'vue';
import { useRouter, useRoute } from 'vue-router';

// Services
import { api, useForm, useSearcher } from '@Services/Api';

// Module
import { apiTo, transl, viewTo, can } from './Module';

// Components
import IconButton from '@Holos/Button/Icon.vue'
import PageHeader from '@Holos/PageHeader.vue';
```

### **Control de Permisos**
```html
<!-- Siempre usar can() del módulo -->
<RouterLink v-if="can('create')" :to="viewTo({ name: 'create' })">
<IconButton v-if="can('destroy')" @click="destroyModal.open(model)">
```

### **Navegación Consistente**
```html
<!-- Header con botón de retorno -->
<PageHeader :title="transl('create.title')">
    <RouterLink :to="viewTo({ name: 'index' })">
        <IconButton icon="arrow_back" :title="$t('return')" filled />
    </RouterLink>
</PageHeader>
```

### **Grid Responsive**
```html
<!-- Formularios siempre con esta estructura -->
<form class="grid gap-4 grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
```

## 🔧 COMPONENTES REUTILIZABLES OBLIGATORIOS

### **De @Holos:**
- `Button/Icon.vue`, `Button/Primary.vue`
- `Form/Input.vue`, `Form/Selectable.vue` 
- `Modal/Template/Destroy.vue`, `Modal/Show.vue`
- `PageHeader.vue`, `Searcher.vue`, `Table.vue`
- `FormSection.vue`, `SectionBorder.vue`

### **De @Services:**
- `useForm`, `useSearcher`, `api`

### **De @Plugins:**
- `hasPermission`, sistema de roles

## 📝 INSTRUCCIONES PARA EL AGENTE

Cuando se te solicite crear un módulo:

1. **PREGUNTA PRIMERO:**
   - Nombre del módulo
   - Campos principales del formulario
   - Relaciones con otros módulos
   - Permisos específicos necesarios
   - Si requiere configuraciones especiales

2. **GENERA SIEMPRE:**
   - Todos los archivos de la estructura obligatoria
   - Module.js con las 4 funciones principales
   - Permisos específicos del módulo
   - Traducciones básicas necesarias

3. **RESPETA SIEMPRE:**
   - Los patrones de naming
   - La estructura de componentes
   - Los imports estándar
   - El sistema de permisos
   - La navegación consistente

4. **VALIDA QUE:**
   - Todos los archivos tengan la estructura correcta
   - Los permisos estén implementados
   - Las rutas sean consistentes
   - Los formularios tengan validación
   - Los modales funcionen correctamente

¿Entendido? Responde "ESTRUCTURA CONFIRMADA" y luego solicita los detalles del módulo que debo crear.