cotizador-helgen/GUIA.md

Guía: poner en marcha el Cotizador Helgen con Claude Code

Tiempo estimado: 45–60 min la primera vez.

Cómo funciona (en una línea)

Formulario web → Apps Script asigna folio HLG-2026-0001 → recalcula subtotal/IVA/total → genera PDF → lo guarda en Drive → registra la fila en una hoja de Google.

[Navegador del equipo] ──► [Apps Script: Code.gs] ──► Google Sheets (registro, catálogo, config)
                                     └──────────────► Google Drive /Cotizaciones Helgen (PDF)/2026/

---

Paso 1 · Instalar herramientas (una sola vez, en tu Mac)

Abre Terminal y ejecuta:

# Node.js (si no lo tienes): descárgalo de https://nodejs.org (versión LTS)
node -v

# Claude Code
npm install -g @anthropic-ai/claude-code

# clasp: la herramienta oficial de Google para subir código a Apps Script
npm install -g @google/clasp

Activa la API de Apps Script en tu cuenta: entra a https://script.google.com/home/usersettings y enciende "Google Apps Script API".

Paso 2 · Crear la carpeta del proyecto

1. Descarga los archivos de esta carpeta (Code.gs, Index.html, appsscript.json, CLAUDE.md) a una carpeta, por ejemplo ~/Helgen/cotizador-helgen.
2. En Terminal:

cd ~/Helgen/cotizador-helgen
clasp login            # se abre el navegador: entra con tu cuenta @helgen.tech
clasp create --type standalone --title "Cotizador Helgen"

clasp create puede sobrescribir appsscript.json. Si pasa, vuelve a copiar el que te di.

Paso 3 · Abrir Claude Code y subir el código

claude

Claude Code lee CLAUDE.md automáticamente, así ya entiende el proyecto. Escríbele:

Sube el proyecto con clasp push y ábreme el editor.

Paso 4 · Instalación inicial (en el editor de Apps Script)

1. En el editor, elige la función setup y pulsa Ejecutar.
2. Acepta los permisos (Drive y Sheets).
3. En Registro de ejecución verás dos links: la hoja de base de datos y la carpeta de PDF.

Paso 5 · Configurar tus datos

Abre la hoja de base de datos:

• Config → llena nombre, RFC, dirección, teléfono, correo, prefijo del folio y términos.
• Logo → sube tu logo (PNG con fondo transparente, ~600 px de ancho) a Drive. Copia su ID (la parte larga del link entre /d/ y /view) y pégalo en LOGO_FILE_ID.
• Catalogo → captura tus productos/servicios frecuentes con su precio. Aparecerán como autocompletado.

Paso 6 · Publicar para el equipo

Pídele a Claude Code:

Publica la app web con clasp deploy y dame la URL.

O manualmente en el editor: Implementar → Nueva implementación → App web

• Ejecutar como: Yo (así todos los PDF quedan en una sola carpeta)
• Quién tiene acceso: Cualquier usuario de helgen.tech

Comparte la URL con el equipo y agrégala a favoritos.

Paso 7 · Prueba de aceptación

• Crear una cotización de prueba → aparece el folio HLG-2026-0001.
• El PDF se abre, muestra el logo y los totales coinciden con la calculadora.
• Aparece la fila en la hoja Cotizaciones y el PDF en Drive/2026.
• Dos personas guardan casi al mismo tiempo → folios distintos.
• Borrar la fila de prueba (el contador NO retrocede; es intencional para no repetir folios).
• Doble clic rápido en "Guardar" → se crea un solo folio y un solo PDF.

Protección de folios: el folio sale del mayor entre el contador (CONSECUTIVO_AAAA) y el último folio en la hoja Cotizaciones, dentro de un candado (LockService). Aunque alguien borre el contador, no se repite.

---

Cómo pedirle cambios a Claude Code (ejemplos de prompts)

Usa frases concretas; Claude Code edita, prueba y sube por ti.

Quiero…	Prompt
Ajustar el diseño al PDF de referencia	"Adjunto referencia.pdf. Ajusta construirHtmlPdf para que se parezca: mismo orden de secciones y tipografía. Genera un PDF de prueba local con Playwright antes de subir."
Descuento por renglón	"Agrega una columna de descuento % por concepto, en el formulario y en el PDF. El cálculo debe hacerse en el servidor."
Enviar por correo	"Agrega un botón 'Enviar al cliente' que mande el PDF por Gmail al correo del cliente con copia a mí."
Duplicar una cotización	"En el historial agrega un botón 'Duplicar' que cargue los datos en el formulario con un folio nuevo."
Estatus	"Agrega una columna Estatus (Enviada, Aceptada, Rechazada) editable desde el historial."
Corregir un error	"Al guardar sale este error: [pega el mensaje]. Revisa clasp logs y corrígelo."

Flujo de cada cambio: pides → Claude Code edita → prueba local → clasp push → clasp deploy --deploymentId <ID> (misma URL para el equipo).

Recomendación: inicializa git en la carpeta (git init, o pídeselo a Claude Code) para poder deshacer cualquier cambio.

---

Por qué esta arquitectura

Criterio	Resultado
Costo	$0 — usa Google Workspace que ya pagan
Servidores	Ninguno que mantener
Acceso	Solo cuentas @helgen.tech
Respaldo	Drive + historial de versiones de Sheets
Folios	Consecutivos y sin duplicados aunque varios usuarios guarden a la vez
Límite	~cientos de cotizaciones/día sin problema. Si algún día necesitan CRM, facturación o app móvil, se migra a Next.js + base de datos y se importa el historial desde la hoja.