From c7c32d8c54e26db24cb3114fccd823828a5b2135 Mon Sep 17 00:00:00 2001
From: josedario87 <jodarioel87@gmail.com>
Date: Tue, 25 Nov 2025 01:57:24 -0600
Subject: [PATCH] =?UTF-8?q?feat:=20Variables=20program=C3=A1ticas=20en=20t?=
 =?UTF-8?q?emplates?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Permite definir variables en templates con sintaxis {{nombre:label:default}}
- Auto-detección de variables al guardar templates
- Drawer para completar valores al cargar template con variables
- Badge mostrando cantidad de variables en tarjeta de template
- Resolución de variables antes de cargar en cola
---
 app/components/templates/TemplateCard.vue    |  5 +-
 app/components/templates/TemplateList.vue    | 43 +++++++++-
 app/components/templates/VariablesDrawer.vue | 88 ++++++++++++++++++++
 app/composables/useTemplates.ts              | 29 ++++++-
 app/pages/index.vue                          | 12 ++-
 server/utils/templates.ts                    | 50 ++++++++++-
 6 files changed, 214 insertions(+), 13 deletions(-)
 create mode 100644 app/components/templates/VariablesDrawer.vue

diff --git a/app/components/templates/TemplateCard.vue b/app/components/templates/TemplateCard.vue
index 16e3f47..5aa3ad8 100644
--- a/app/components/templates/TemplateCard.vue
+++ b/app/components/templates/TemplateCard.vue
@@ -51,10 +51,13 @@ function formatDate(date: string | number) {
         >
           {{ template.description }}
         </p>
-        <div class="flex items-center gap-2 mt-2">
+        <div class="flex items-center gap-2 mt-2 flex-wrap">
           <UBadge variant="subtle" size="xs">
             {{ template.operations.length }} comandos
           </UBadge>
+          <UBadge v-if="template.variables?.length" variant="subtle" size="xs" color="primary">
+            {{ template.variables.length }} {{ template.variables.length === 1 ? 'variable' : 'variables' }}
+          </UBadge>
           <span class="text-xs text-gray-400 dark:text-gray-500">
             {{ formatDate(template.updatedAt) }}
           </span>
diff --git a/app/components/templates/TemplateList.vue b/app/components/templates/TemplateList.vue
index 837da88..4e583e3 100644
--- a/app/components/templates/TemplateList.vue
+++ b/app/components/templates/TemplateList.vue
@@ -1,21 +1,48 @@
 <script setup lang="ts">
+import type { PrintTemplate } from '~/composables/useTemplates'
+import { resolveVariables } from '~/composables/useTemplates'
+
 const templates = useTemplates()
 const queue = usePrintQueue()
 const toast = useToast()
 
+// Estado para el drawer de variables
+const variablesDrawerOpen = ref(false)
+const selectedTemplate = ref<PrintTemplate | null>(null)
+
 // Cargar templates al montar
 onMounted(() => {
   templates.fetchTemplates()
 })
 
 function loadTemplate(id: string) {
-  const ops = templates.loadTemplate(id)
-  if (ops) {
-    queue.loadFromTemplate(ops)
-    toast.add({ title: 'Template cargado en la cola', color: 'success' })
+  const template = templates.templates.value.find(t => t.id === id)
+  if (!template) return
+
+  // Si tiene variables, abrir el drawer
+  if (template.variables && template.variables.length > 0) {
+    selectedTemplate.value = template
+    variablesDrawerOpen.value = true
+  } else {
+    // Sin variables, cargar directo
+    const ops = templates.loadTemplate(id)
+    if (ops) {
+      queue.loadFromTemplate(ops)
+      toast.add({ title: 'Template cargado en la cola', color: 'success' })
+    }
   }
 }
 
+function handleLoadWithVariables(values: Record<string, string>) {
+  if (!selectedTemplate.value) return
+
+  const ops = resolveVariables(selectedTemplate.value.operations, values)
+  queue.loadFromTemplate(ops)
+  toast.add({ title: 'Template cargado en la cola', color: 'success' })
+  variablesDrawerOpen.value = false
+  selectedTemplate.value = null
+}
+
 async function duplicateTemplate(id: string) {
   const result = await templates.duplicateTemplate(id)
   if (result) {
@@ -72,5 +99,13 @@ async function deleteTemplate(id: string) {
         @delete="deleteTemplate"
       />
     </div>
+
+    <!-- Drawer para completar variables -->
+    <TemplatesVariablesDrawer
+      :template="selectedTemplate"
+      :open="variablesDrawerOpen"
+      @update:open="variablesDrawerOpen = $event"
+      @load="handleLoadWithVariables"
+    />
   </div>
 </template>
diff --git a/app/components/templates/VariablesDrawer.vue b/app/components/templates/VariablesDrawer.vue
new file mode 100644
index 0000000..bdb2f67
--- /dev/null
+++ b/app/components/templates/VariablesDrawer.vue
@@ -0,0 +1,88 @@
+<script setup lang="ts">
+import type { PrintTemplate } from '~/composables/useTemplates'
+
+const props = defineProps<{
+  template: PrintTemplate | null
+  open: boolean
+}>()
+
+const emit = defineEmits<{
+  'update:open': [value: boolean]
+  load: [values: Record<string, string>]
+}>()
+
+const values = ref<Record<string, string>>({})
+
+// Inicializar con valores por defecto cuando cambia el template
+watch(() => props.template, (t) => {
+  if (t) {
+    values.value = {}
+    for (const v of t.variables || []) {
+      values.value[v.name] = v.defaultValue || ''
+    }
+  }
+}, { immediate: true })
+
+function handleLoad() {
+  emit('load', { ...values.value })
+}
+
+function handleDrawerUpdate(value: boolean) {
+  emit('update:open', value)
+}
+
+function handleClose() {
+  emit('update:open', false)
+}
+
+// Validar que todos los campos requeridos estén completos
+const canLoad = computed(() => {
+  if (!props.template?.variables) return false
+  return props.template.variables.every(v => values.value[v.name]?.trim())
+})
+</script>
+
+<template>
+  <UDrawer
+    :open="open"
+    direction="bottom"
+    title="Completar variables"
+    description="Ingresa los valores para las variables del template"
+    @update:open="handleDrawerUpdate"
+  >
+    <template #body>
+      <div class="space-y-4 p-4">
+        <p class="text-sm text-gray-500 dark:text-gray-400">
+          Template: <strong>{{ template?.name }}</strong>
+        </p>
+
+        <UFormField
+          v-for="v in template?.variables || []"
+          :key="v.name"
+          :label="v.label || v.name"
+          required
+        >
+          <UInput
+            v-model="values[v.name]"
+            :placeholder="v.defaultValue || `Ingrese ${v.label || v.name}`"
+          />
+        </UFormField>
+      </div>
+    </template>
+
+    <template #footer>
+      <div class="flex gap-2 justify-end p-4">
+        <UButton variant="ghost" @click="handleClose">
+          Cancelar
+        </UButton>
+        <UButton
+          color="primary"
+          :disabled="!canLoad"
+          @click="handleLoad"
+        >
+          Cargar en cola
+        </UButton>
+      </div>
+    </template>
+  </UDrawer>
+</template>
diff --git a/app/composables/useTemplates.ts b/app/composables/useTemplates.ts
index 70c9f7c..b7ff2fe 100644
--- a/app/composables/useTemplates.ts
+++ b/app/composables/useTemplates.ts
@@ -1,14 +1,40 @@
 import type { Operation } from './usePrintQueue'
 
+export interface TemplateVariable {
+  name: string
+  label?: string
+  defaultValue?: string
+}
+
 export interface PrintTemplate {
   id: string
   name: string
   description?: string
   operations: Operation[]
+  variables: TemplateVariable[]
   createdAt: string
   updatedAt: string
 }
 
+// Regex para detectar variables en templates
+const VARIABLE_REGEX = /\{\{(\w+)(?::([^:}]+))?(?::([^}]+))?\}\}/g
+
+// Resolver variables en operaciones
+export function resolveVariables(
+  operations: Operation[],
+  values: Record<string, string>
+): Operation[] {
+  return JSON.parse(JSON.stringify(operations)).map((op: Operation) => {
+    for (const [key, val] of Object.entries(op)) {
+      if (typeof val === 'string') {
+        // Reemplazar {{nombre:label:default}} con el valor proporcionado
+        op[key] = val.replace(VARIABLE_REGEX, (_, name) => values[name] ?? '')
+      }
+    }
+    return op
+  })
+}
+
 export function useTemplates() {
   const templates = useState<PrintTemplate[]>('templates', () => [])
   const loading = useState('templatesLoading', () => false)
@@ -119,6 +145,7 @@ export function useTemplates() {
     updateTemplate,
     deleteTemplate,
     loadTemplate,
-    duplicateTemplate
+    duplicateTemplate,
+    resolveVariables
   }
 }
diff --git a/app/pages/index.vue b/app/pages/index.vue
index 134b74d..cf487a9 100644
--- a/app/pages/index.vue
+++ b/app/pages/index.vue
@@ -71,7 +71,9 @@ onMounted(() => {
           </template>
 
           <template v-else-if="activeTab === 'templates'">
-            <TemplatesTemplateList />
+            <ClientOnly>
+              <TemplatesTemplateList />
+            </ClientOnly>
           </template>
 
           <template v-else-if="activeTab === 'printers'">
@@ -79,9 +81,11 @@ onMounted(() => {
           </template>
 
           <!-- En desktop: mostrar templates debajo del constructor -->
-          <template v-if="isDesktop">
-            <TemplatesTemplateList />
-          </template>
+          <ClientOnly>
+            <template v-if="isDesktop">
+              <TemplatesTemplateList />
+            </template>
+          </ClientOnly>
         </div>
       </main>
     </div>
diff --git a/server/utils/templates.ts b/server/utils/templates.ts
index bb4f700..9e059b6 100644
--- a/server/utils/templates.ts
+++ b/server/utils/templates.ts
@@ -4,9 +4,14 @@ import { existsSync } from 'fs'
 import { join } from 'path'
 
 export interface Operation {
-  id: string
-  type: 'text' | 'feed' | 'cut' | 'pulse' | 'image' | 'barcode' | 'qrcode'
-  params: Record<string, unknown>
+  op: string
+  [key: string]: any
+}
+
+export interface TemplateVariable {
+  name: string
+  label?: string
+  defaultValue?: string
 }
 
 export interface PrintTemplate {
@@ -14,10 +19,42 @@ export interface PrintTemplate {
   name: string
   description?: string
   operations: Operation[]
+  variables: TemplateVariable[]
   createdAt: string
   updatedAt: string
 }
 
+// Regex para detectar {{nombre}}, {{nombre:label}}, {{nombre:label:default}}
+const VARIABLE_REGEX = /\{\{(\w+)(?::([^:}]+))?(?::([^}]+))?\}\}/g
+
+// Extraer variables de las operaciones
+export function extractVariables(operations: Operation[]): TemplateVariable[] {
+  const variablesMap = new Map<string, TemplateVariable>()
+
+  for (const op of operations) {
+    // Buscar en campos que pueden contener variables
+    const searchFields = ['value', 'data']
+    for (const field of searchFields) {
+      if (typeof op[field] === 'string') {
+        const matches = op[field].matchAll(VARIABLE_REGEX)
+        for (const match of matches) {
+          const [, name, label, defaultValue] = match
+          // Solo guardar la primera definición de cada variable
+          if (!variablesMap.has(name)) {
+            variablesMap.set(name, {
+              name,
+              label: label || undefined,
+              defaultValue: defaultValue || undefined
+            })
+          }
+        }
+      }
+    }
+  }
+
+  return Array.from(variablesMap.values())
+}
+
 export interface TemplatesStore {
   templates: PrintTemplate[]
 }
@@ -84,6 +121,7 @@ export async function createTemplate(data: {
     name: data.name,
     description: data.description || '',
     operations: data.operations,
+    variables: extractVariables(data.operations),
     createdAt: now,
     updatedAt: now
   }
@@ -103,9 +141,15 @@ export async function updateTemplate(id: string, data: Partial<{
 
   if (index === -1) return null
 
+  // Si se actualizan las operaciones, recalcular las variables
+  const variables = data.operations
+    ? extractVariables(data.operations)
+    : store.templates[index].variables
+
   store.templates[index] = {
     ...store.templates[index],
     ...data,
+    variables,
     updatedAt: new Date().toISOString()
   }