openprompt-lang 0.3.0

package/docs/SYNTAX.md

@@ -0,0 +1,359 @@
+# openPrompt-Lang — Especificación del Lenguaje de Anotaciones
+
+> **Versión:** 0.1.0
+> **Propósito:** Framework de anotaciones para desarrollo asistido por IA
+> **Inspiración:** Spring Boot annotations, JSDoc, shadcn/ui
+
+---
+
+## 1. Sintaxis General
+
+Las anotaciones se escriben como comentarios en el archivo y son interpretadas tanto por la IA como por el CLI de validación.
+
+### Formato básico
+
+```
+// @nombre(args)
+// @nombre(key: value, key2: value2)
+```
+
+### Formato bloque (múltiples anotaciones)
+
+```
+// @use(kind, contract, limit, deps, platform, scope, meta)
+// @kind(hook)
+// @limit(lines: 80, params: 2)
+// @contract(in: email, password -> out: user, token @error: AuthError)
+```
+
+### Formato multilinea
+
+```
+/*
+ * @use(kind, contract, deps)
+ * @kind(service)
+ * @contract(in: CreateUserDTO -> out: User @error: ServiceError)
+ * @deps(@external: [supabase])
+ */
+```
+
+---
+
+## 2. Sistema de Imports (@use)
+
+Todo archivo con anotaciones DEBE declarar `@use` como primer tag. Esto determina qué tags son válidos en el archivo.
+
+```
+@use(tag1, tag2, ...)
+```
+
+| Ejemplo | Significado |
+|---|---|
+| `@use(*)` | Todos los tags disponibles |
+| `@use(kind, contract)` | Solo estos tags |
+| `@use(hook, limit)` | Tags específicos para hooks |
+
+**Error si:** Se usa un tag no declarado en `@use`.
+
+---
+
+## 3. Tags de Definición
+
+### @kind — Define el tipo de elemento
+
+```
+@kind(tipo)
+```
+
+| Valor | Descripción | Tags requeridos | Tags prohibidos | Límite default |
+|---|---|---|---|---|
+| `hook` | Custom hook React | `@contract` | `@props` | 80 lines |
+| `component` | Componente UI | `@props` (recomendado) | `@contract` | 120 lines |
+| `page` | Página completa | `@compose` | — | 200 lines |
+| `service` | Servicio/API | `@contract` | `@props`, `@state` | 150 lines |
+| `store` | Estado global | `@deps(zustand)` | — | 100 lines |
+| `util` | Función utilitaria | — | `@state` | 100 lines |
+| `type` | Interfaz/tipo | — | `@limit`, `@state` | — |
+| `layout` | Componente de layout | — | — | 150 lines |
+| `feature` | Módulo completo | `@compose` | — | — |
+
+### @pattern — Define el patrón de diseño
+
+```
+@pattern(nombre)
+```
+
+Valores válidos: `compound`, `composition`, `generic`, `render-prop`, `provider`, `singleton`
+
+**Warning si:** `@pattern(inheritance)` — usar `composition` en su lugar.
+
+---
+
+## 4. Tags de Contrato
+
+### @contract — Define interfaz de función
+
+```
+@contract(in: tipos -> out: tipo @error: tipo)
+```
+
+Ejemplos:
+```
+@contract(in: email, password -> out: User @error: AuthError)
+@contract(in: ProductDTO -> out: Product @error: ValidationError)
+@contract(in: void -> out: Product[] @error: string)
+```
+
+**Errores:**
+- Sin input o sin output → error
+- `@contract(in: any -> out: any)` → warning
+- `@contract(in: string -> )` → error (falta output)
+
+### @props — Define props de componente
+
+```
+@props({ nombre: tipo, nombre2?: tipo, nombre3: tipo = default })
+```
+
+Formato JSON-like:
+```
+@props({ name: string, age?: number, label: string = "Default" })
+```
+
+### @state — Define estados visuales
+
+```
+@state(lista de estados)
+```
+
+Valores válidos: `loading`, `empty`, `error`, `success`, `idle`, `submitting`, `editing`, `disabled`
+
+Ejemplo:
+```
+@state(loading, empty, error, success)
+```
+
+**Regla:** Si declaras `@state(error)`, debería haber `@contract(@error)` también.
+
+---
+
+## 5. Tags de Restricción
+
+### @limit — Límites del archivo
+
+```
+@limit(propiedad: valor, ...)
+```
+
+| Propiedad | Tipo | Descripción |
+|---|---|---|
+| `lines` | número | Máximo de líneas |
+| `functions` | número | Máximo de funciones |
+| `params` | número | Máximo de parámetros |
+| `complexity` | número | Complejidad ciclomática |
+| `nesting` | número | Nivel de anidación |
+
+Ejemplos:
+```
+@limit(lines: 120, functions: 3)
+@limit(lines: 80, params: 2)
+```
+
+**Error si:** Valor no es número.
+**Defaults según @kind:** hook=80, component=120, page=200, service=150, store=100.
+
+### @forbidden — Prohibiciones
+
+```
+@forbidden(lista)
+```
+
+Valores válidos: `any`, `css-modules`, `class-components`, `any`, `any`
+
+Ejemplo:
+```
+@forbidden(any, css-modules)
+```
+
+---
+
+## 6. Tags de Composición
+
+### @compose — Dependencias internas
+
+```
+@compose(ComponenteA, ComponenteB, useHook)
+```
+
+**Requerido en:** `@kind(page)` — una página debe componer algo.
+
+### @deps — Dependencias externas
+
+```
+@deps(@external: [lib1, lib2], @internal: [mod1], @forbidden: [lib3], @peer: [lib4])
+```
+
+| Sub-tag | Descripción |
+|---|---|
+| `@external` | Dependencias de npm/pip/cargo |
+| `@internal` | Dependencias del mismo proyecto |
+| `@forbidden` | Librerías que NO deben usarse |
+| `@peer` | Peer dependencies |
+
+**Error si:** Misma librería en `@external` y `@forbidden`.
+
+---
+
+## 7. Tags de Plataforma
+
+### @platform — Target de ejecución
+
+```
+@platform(web, mobile, desktop)
+```
+
+**Reglas de compatibilidad:**
+| Plataforma | `@capacitor/*` | `@tauri-apps/*` |
+|---|---|---|
+| `web` | ❌ Prohibido | ❌ Prohibido |
+| `mobile` | ✅ Permitido | ❌ Prohibido |
+| `desktop` | ❌ Prohibido | ✅ Permitido |
+
+---
+
+## 8. Tags de Alcance
+
+### @scope — Impacto del módulo
+
+```
+@scope(module: nombre, affects: [mod1, mod2], breaking: boolean)
+```
+
+| Propiedad | Tipo | Descripción |
+|---|---|---|
+| `module` | string | Módulo al que pertenece |
+| `affects` | string[] | Qué módulos afecta |
+| `breaking` | boolean | Si es cambio rompiente |
+
+**Regla:** Si `breaking: true`, el commit debe indicar breaking change (`!`).
+
+---
+
+## 9. Tags de Testing
+
+### @test — Requisitos de testing
+
+```
+@test(@unit, @integration, @mock: [servicio], @coverage: 80)
+```
+
+| Sub-tag | Descripción |
+|---|---|
+| `@unit` | Test unitario requerido |
+| `@integration` | Test de integración requerido |
+| `@mock` | Servicios a mockear |
+| `@coverage` | Porcentaje mínimo de cobertura |
+
+**Error si:** `@coverage(120)` — no puede exceder 100.
+
+---
+
+## 10. Tags de Metadata
+
+### @meta — Metadatos del archivo
+
+```
+@meta(@version: "1.0.0", @author: "nombre", @tags: [tag1, tag2])
+```
+
+| Sub-tag | Descripción |
+|---|---|
+| `@version` | Versión del archivo |
+| `@author` | Autor |
+| `@tags` | Tags de búsqueda/clasificación |
+| `@created` | Fecha de creación |
+| `@updated` | Fecha de última modificación |
+
+---
+
+## 11. Dependencias y Validaciones Cruzadas
+
+### Matriz de compatibilidad
+
+```
+@kind(hook)
+  → @contract: REQUERIDO
+  → @props: PROHIBIDO
+  → @limit(lines) default: 80
+
+@kind(component)
+  → @props: RECOMENDADO
+  → @contract: PROHIBIDO
+  → @state: RECOMENDADO
+  → @limit(lines) default: 120
+
+@kind(page)
+  → @compose: REQUERIDO (debe componer subcomponentes)
+  → @limit(lines) default: 200
+
+@kind(service)
+  → @contract: REQUERIDO
+  → @props: PROHIBIDO
+  → @state: PROHIBIDO
+  → @limit(lines) default: 150
+
+@kind(store)
+  → @deps(zustand) o @deps(context): RECOMENDADO
+  → @limit(lines) default: 100
+
+@kind(type)
+  → @limit: NO APLICA
+  → @state: PROHIBIDO
+  → @docs: RECOMENDADO
+
+@platform(mobile) + @deps(@tauri-apps/*): ERROR
+@platform(desktop) + @deps(@capacitor/*): ERROR
+@scope(breaking: true) → commit debe ser breaking change
+```
+
+---
+
+## 12. Ejemplos Completos
+
+### Hook con autenticación
+
+```typescript
+// @use(kind, contract, limit, deps, platform, scope, meta)
+// @kind(hook)
+// @limit(lines: 75, params: 1)
+// @contract(in: email, password -> out: user, token @error: AuthError)
+// @deps(@external: [supabase], @forbidden: [axios])
+// @platform(web)
+// @scope(module: auth, affects: [login, register, session])
+// @meta(@version: "1.0.0", @tags: [auth, supabase])
+export function useAuth() { ... }
+```
+
+### Componente UI con variantes
+
+```typescript
+// @use(kind, props, state, limit, pattern)
+// @kind(component)
+// @props({ variant: string, size: string, children: ReactNode, disabled?: boolean })
+// @state(idle, disabled, loading)
+// @limit(lines: 90, functions: 2)
+// @pattern(composition)
+export function Button(props: ButtonProps) { ... }
+```
+
+### Página con composición
+
+```typescript
+// @use(kind, compose, state, limit, scope)
+// @kind(page)
+// @compose(Header, DataTable, Sidebar)
+// @state(loading, empty, error, success)
+// @limit(lines: 150)
+// @scope(module: dashboard, affects: [products, users])
+export function DashboardPage() { ... }
+```

package/docs/VERSIONING.md

@@ -0,0 +1,150 @@
+# Versionado Semántico — openPrompt-Lang
+
+> Este documento define cuándo y cómo se incrementa la versión del framework openPrompt-Lang y de los proyectos generados con `init`. Sigue SemVer 2.0.0 estricto.
+
+---
+
+## Formato
+
+```
+MAJOR.MINOR.PATCH[-pre-release]
+```
+
+Ejemplos: `0.1.0`, `0.2.0`, `1.0.0-beta.1`, `1.0.0`
+
+---
+
+## Reglas de incremento
+
+### MAJOR (x.0.0) — Cambios incompatibles
+
+Se incrementa cuando hay cambios **incompatibles** en:
+
+| Cambio | Ejemplo |
+|---|---|
+| Sintaxis de anotaciones | Renombrar `@kind` a `@type`, cambiar formato de `@contract` |
+| Estructura de `prompt-lang.json` | Eliminar o renombrar campos obligatorios |
+| Comandos CLI | Eliminar un comando, cambiar flags obligatorios |
+| Comportamiento de validación | `strict` pasa de opcional a obligatorio sin flag |
+| Formato de output de `context` | Cambiar estructura del markdown generado |
+
+**Detectado por:** `!` en conventional commit (`feat!:`) o `@scope(breaking: true)` en anotaciones.
+
+### MINOR (0.x.0) — Nuevas funcionalidades (compatibles)
+
+Se incrementa cuando se **agrega** funcionalidad sin romper nada:
+
+| Cambio | Ejemplo |
+|---|---|
+| Nuevo tag de anotación | Agregar `@audit` o `@deprecated` |
+| Nuevo comando CLI | Agregar `component` |
+| Nuevo flag opcional | `--existing`, `--strict`, `--fix` |
+| Nuevo template PROMPTS | Agregar plantillas 11-17 |
+| Nueva sección en configuración | `components.source`, `components.library` |
+| Nuevo archivo de documentación | `CONVENCIONES_DB.md`, `VERSIONING.md` |
+
+**Detectado por:** `feat:` en conventional commit.
+
+### PATCH (0.0.x) — Correcciones y mejoras menores
+
+Se incrementa cuando se **corrige** o **mejora** sin agregar funcionalidad nueva:
+
+| Cambio | Ejemplo |
+|---|---|
+| Bug fix en parser | Error de parsing en caso edge |
+| Corrección de tests | Test que fallaba por fixture incorrecto |
+| Documentación | Corregir error tipográfico, mejorar ejemplo |
+| Refactor interno | Renombrar variable, extraer función sin cambiar API |
+| Actualizar dependencias | `vitest ^3.1.0` → `^4.1.6` |
+
+**Detectado por:** `fix:`, `docs:`, `refactor:`, `test:`, `chore:`, `perf:` en conventional commit.
+
+---
+
+## Pre-release (alpha, beta, RC)
+
+Se usan cuando la versión no está lista para producción:
+
+| Tag | Significado | Cuándo usarlo |
+|---|---|---|
+| `-alpha.N` | Desarrollo temprano | APIs inestables, features incompletas, solo dev |
+| `-beta.N` | Feature-complete | APIs estables, en testing, puede tener bugs |
+| `-rc.N` | Release Candidate | Listo para producción si pasa validación |
+
+**Reglas:**
+- `alpha` no tiene restricciones de breaking changes
+- `beta` congela APIs (solo bug fixes)
+- `rc` requiere pipeline de validación completo
+
+Ejemplo de progresión:
+```
+0.1.0 → 0.2.0-alpha.1 → 0.2.0-beta.1 → 0.2.0-rc.1 → 0.2.0
+```
+
+---
+
+## ¿Cuándo se bumpa la versión?
+
+La versión se actualiza **al hacer release**, no en cada commit. Los commits acumulan cambios y al publicar se determina el bump.
+
+### Flujo
+
+```
+Commit: feat: agregar comando component
+Commit: fix: corregir error en parser
+Commit: docs: actualizar README
+→ Al release: bump MINOR (0.3.0) porque hay feat
+
+Commit: fix: corregir typo en validación
+Commit: docs: mejorar ejemplos
+→ Al release: bump PATCH (0.2.1) porque solo fixes/docs
+```
+
+### Tabla de decisión
+
+| Tipo de commit | ¿Bump? | ¿Cuál? |
+|---|---|---|
+| `feat!:` o breaking | ✅ | MAJOR |
+| `feat:` | ✅ | MINOR |
+| `fix:` | ✅ | PATCH |
+| `docs:` (solo docs) | ❌ | Acumula para PATCH |
+| `refactor:` | ❌ | Acumula para PATCH |
+| `test:` | ❌ | Acumula para PATCH |
+| `chore:` | ❌ | Acumula para PATCH |
+| `perf:` | ❌ | Acumula para PATCH |
+| `style:` | ❌ | Acumula para PATCH |
+
+**Excepción:** Si es el primer commit después de un release, y no hay `feat` ni `fix`, se bumpa PATCH igual (para evitar `0.0.0`).
+
+---
+
+## Integración con commit log
+
+Cada commit en `docs/COMMITS/` debe indicar si implica bump:
+
+```markdown
+### Commit: feat(core): agregar comando component
+**Versión:** v0.3.0              ← próxima versión estimada
+**Bump:** MINOR                  ← MAJOR / MINOR / PATCH / ninguno
+```
+
+El `docs/COMMITS/INDEX.md` muestra la versión actual del proyecto:
+
+| Fecha | Versión | Descripción | Bump |
+|---|---|---|---|
+| 2026-05-14 | v0.2.0 | feat: strict, validación stack, convenciones DB | MINOR |
+
+---
+
+## Equivalencia con etiquetas git
+
+```bash
+git tag -a v0.2.0 -m "v0.2.0 — strict por defecto, validación stack, 7 templates"
+git push origin v0.2.0
+```
+
+Si hay pre-release:
+```bash
+git tag -a v0.3.0-beta.1 -m "v0.3.0-beta.1 — componente library"
+git push origin v0.3.0-beta.1
+```

package/docs/referencia-metodologia/Anexos Finales Documentos de Respaldo y Estandarizaci/303/263n.md"

@@ -0,0 +1,90 @@
+
+---
+
+> [!info] Sobre estos anexos
+> Estas plantillas y tablas están diseñadas para estandarizar el aspecto comercial y legal de tus proyectos. Te ahorrarán horas de redacción y te protegerán de clientes abusivos o alcances no definidos ("Scope Creep").
+
+---
+
+## 💰 Anexo A: Tabla de Precios de Referencia (UF / CLP)
+
+> [!abstract] Referencia de Cálculo
+> Valores calculados en base a la Unidad de Fomento (UF) al **25 de Abril de 2026** (Valor ref: **$40.053,72 CLP**). Los valores en pesos son aproximados para facilitar la lectura al cliente.
+
+| Servicio / Tarea | Valor en UF | Valor Aprox en CLP | Descripción del Servicio |
+| :--- | :--- | :--- | :--- |
+| **Hora de Consultoría Técnica** | 1.0 - 1.5 UF | $40.000 - $60.000 | Reuniones extra fuera de contrato, asesoría arquitectónica o revisión de código de terceros. |
+| **Soporte de Emergencia** | 2.5 UF / hora | $100.000 / hora | Caídas críticas, intervenciones urgentes fuera de horario laboral (fines de semana, festivos o madrugada). |
+| **Funcionalidad Extra (Micro)** | 3.0 - 5.0 UF | $120.000 - $200.000 | Desarrollo de un nuevo endpoint básico, adición de un reporte simple o una vista extra no contemplada en el MVP. |
+| **Mantención Mensual (SaaS)** | 2.0 - 4.0 UF / mes| $80.000 - $160.000 / mes | Soporte estándar, monitoreo preventivo de servidor (Railway/Netlify) y corrección de bugs menores. |
+| **Upgrade de Infraestructura** | 3.0 UF | $120.000 | Configuración técnica (pago único de Setup) para escalar recursos de servidor y soportar mayor tráfico. |
+
+---
+
+## 📄 Anexo B: Plantilla - Propuesta Inicial de Desarrollo
+
+> [!tip] Instrucciones de uso
+> Copia el texto a continuación, rellena los campos entre corchetes `[ ]` y expórtalo como PDF para enviarlo al cliente después de la Fase 1.
+
+**DOCUMENTO DE PROPUESTA TECNOLÓGICA Y COMERCIAL**
+**Fecha:** [DD/MM/AAAA]
+**Cliente:** [NOMBRE DEL CLIENTE / EMPRESA]
+**Proyecto:** [NOMBRE DEL SISTEMA - MVP]
+**Desarrollador:** Matías Retamal
+
+**1. Entendimiento del Problema:**
+De acuerdo a nuestro levantamiento inicial, el principal desafío actual en su operación es [DESCRIBIR EL DOLOR. Ej: La pérdida de dinero y tiempo debido a la falta de un control de inventario sincronizado con las ventas por WhatsApp].
+
+**2. Solución Propuesta (Alcance del MVP):**
+Se desarrollará una aplicación web adaptativa ("Mobile-First") que incluirá *exclusivamente* los siguientes módulos:
+- **Módulo 1:** [Ej: Panel de administración de productos y stock]
+- **Módulo 2:** [Ej: Interfaz de cajero para toma rápida de pedidos]
+- **Módulo 3:** [Ej: Generación de reporte de cierre de caja diario]
+*(Cualquier requerimiento, vista o integración fuera de este listado explícito será cotizado de forma independiente como una Fase 2).*
+
+**3. Modelo de Negocio e Inversión:**
+*   **Opción Elegida:** [SaaS Mensual / Llave en Mano]
+*   **Costo de Desarrollo (Setup):** [X] UF. Pagadero en 3 hitos: 30% al inicio, 40% a la validación del prototipo visual, 30% a la entrega en producción.
+*   **Costo Recurrente (Si aplica):** Suscripción mensual de [Y] UF, que incluye alojamiento web, base de datos y soporte técnico básico.
+
+**4. Tiempos Estimados:**
+El desarrollo de esta primera versión tomará aproximadamente **[X] SEMANAS** a partir de la firma de este documento, la entrega de los accesos necesarios y el pago del anticipo inicial.
+
+**Aceptación Conforme del Cliente:** 
+Nombre: ___________________________
+Firma: ___________________________ 
+Fecha: ___________________________ 
+
+---
+
+## 🤝 Anexo C: Plantilla - Acta de Entrega Final y Descargos de Responsabilidad
+
+> [!warning] Documento Crítico
+> Nunca entregues las llaves de producción ni el código fuente sin que el cliente te firme o apruebe por escrito este documento. Es tu escudo legal.
+
+**ACTA DE RECEPCIÓN CONFORME Y CIERRE DE PROYECTO**
+**Fecha:** [DD/MM/AAAA]
+**Proyecto:** [NOMBRE DEL SISTEMA]
+**Versión Entregada:** v1.0.0
+
+Por medio del presente documento, **[NOMBRE DEL CLIENTE]** declara haber recibido a entera satisfacción el sistema de software especificado en la Propuesta Inicial, validando en producción que cumple con los requerimientos funcionales, visuales y técnicos acordados durante la Fase 4 de Especificación.
+
+**1. Condiciones de Garantía:**
+El desarrollador otorga una garantía técnica de **[X DÍAS/MESES]** a partir de la fecha de este documento. Esta garantía está destinada *exclusivamente* a la corrección de errores lógicos o de código (Bugs) imputables al desarrollo. No incluye modificaciones estéticas, cambios de flujo, ni la adición de nuevas funcionalidades.
+
+**2. Descargos de Responsabilidad Legal y Operativa:**
+El desarrollador **NO** asume responsabilidad legal, civil ni financiera en los siguientes escenarios:
+*   Pérdida, robo o corrupción de datos causada por mal manejo operativo de los usuarios del cliente (Ej: eliminación accidental de registros, compartir contraseñas, phishing al personal).
+*   Caídas del servicio, latencia o pérdida de datos originadas por los proveedores externos de infraestructura (Ej: fallas en servidores de Netlify, Railway, Supabase o caídas en la pasarela de pagos de Transbank/Webpay).
+*   Consecuencias comerciales derivadas de la inoperatividad temporal del sistema por causas de fuerza mayor o bloqueos de terceros.
+
+**3. Finalización de Servicios y Soporte Continuo:**
+Con la firma de este documento, finaliza la obligación de desarrollo activo del proyecto inicial. A partir de este momento, toda intervención técnica, capacitación extra, recuperación de datos o soporte fuera del periodo de garantía será cotizado bajo las tarifas vigentes por hora o tarea.
+
+**Recepción Conforme (Cliente):** 
+Nombre: ___________________________
+Firma: ___________________________ 
+
+**Entrega Oficial (Desarrollador):** 
+Nombre: Matías Retamal
+Firma: ___________________________ 

package/docs/referencia-metodologia/Cotizaciones.md

@@ -0,0 +1,84 @@
+---
+title: Calculadora y Tarifario de Proyectos (Advanced Tables)
+type: tool
+tags:
+  - finanzas
+  - cotizacion
+  - freelance
+  - saas
+uf_referencia: 40053.72
+fecha_actualizacion: 2026-04-25
+---
+# 🧮 Calculadora de Cotizaciones y Tarifario
+
+> [!info] Parámetro Base (Actualizar mensualmente)
+> **Valor UF Actual:** $40.053,72 CLP (Referencia: 25 de Abril de 2026)
+> *Para esta tabla usaremos un valor cerrado de UF = 40000 para simplificar los cálculos.*
+
+---
+
+## 1. Tarifario Base por Hora / Rol
+*Antes de cotizar módulos, define cuánto vale tu tiempo según la tarea.*
+
+| Tipo de Trabajo | Valor UF / Hora | Valor CLP (Aprox) | Descripción |
+| :--- | :--- | :--- | :--- |
+| Desarrollo Puro (Code) | 0.8 | 32000 | Programación sin interrupciones (Backend/Frontend). |
+| Reunión / Consultoría | 1.2 | 48000 | Levantamiento de requisitos, diseño UI/UX en vivo con cliente. |
+| Soporte de Emergencia | 2.5 | 100000 | Intervenciones fuera de horario (noches, fines de semana). |
+
+---
+
+## 2. Calculadora de Proyecto (Plantilla a duplicar por cliente)
+
+> [!tip] Cómo usar esta tabla con "Advanced Tables"
+> 1. Llena las columnas de **Horas Estimadas** y **Tarifa UF/hr**.
+> 2. Abre el menú de comandos de Obsidian (Ctrl/Cmd + P) y busca: `Advanced Tables: Evaluate table formulas`.
+> 3. Las columnas de **Subtotal UF** y **Subtotal CLP** se calcularán automáticamente.
+
+### Nombre del Proyecto: `[Nombre del Cliente]`
+
+| Módulo / Ítem del Backlog          | Horas Estimadas | Tarifa UF/hr | Subtotal UF | Subtotal CLP |
+| :--------------------------------- | :-------------- | :----------- | :---------- | :----------- |
+| Fase 1 a 3 (Levantamiento y UI)    | 10              | 1.2          | 0           | 0            |
+| Setup Inicial (BD, Repositorios)   | 4               | 0.8          | 0           | 0            |
+| Módulo Auth (Login, JWT, RLS)      | 8               | 0.8          | 0           | 0            |
+| Módulo CRUD Productos              | 12              | 0.8          | 0           | 0            |
+| Módulo Carrito / Pedidos           | 15              | 0.8          | 0           | 0            |
+| Integración Pasarela (Webpay)      | 12              | 0.8          | 0           | 0            |
+| Fase 8 (Capacitación y Entrega)    | 4               | 1.2          | 0           | 0            |
+| **SUBTOTAL HORAS**                 | 0               | 0            | 0           | 0            |
+| **Margen de Riesgo / QA (20%)**    | 0               | 0            | 0           | 0            |
+| **TOTAL PROYECTO (LLAVE EN MANO)** | 0               | 0            | 0           | 0            |
+<!-- TBLFM: @2$4..@8$4=($2*$3) :: @2$5..@8$5=($4*40000) :: @9$2=sum(@2$2..@8$2) :: @9$4=sum(@2$4..@8$4) :: @9$5=sum(@2$5..@8$5) :: @10$4=(@9$4*0.2) :: @10$5=(@9$5*0.2) :: @11$4=(@9$4+@10$4) :: @11$5=(@9$5+@10$5) -->
+
+> [!warning] *Sobre el Margen de Riesgo (20%)
+> **NUNCA** cobres exactamente las horas que estimaste. En software siempre hay errores, cambios de librería o dependencias que fallan. Agrega siempre un 15% a 20% de "Margen de Riesgo" al total. Si el proyecto sale perfecto, ese 20% es tu bono de eficiencia. Si hay problemas, ese 20% cubre tus horas extra para no trabajar gratis.
+
+---
+
+## 3. Calculadora de Modelo SaaS (Suscripción Mensual)
+
+Si en lugar de vender el proyecto de una vez (Llave en mano), vas a cobrar una mensualidad, utiliza este esquema para calcular cuánto cobrar:
+
+> [!example] Fórmula SaaS: Setup Fee + (Hosting + Soporte + Licencia)
+
+**A. Cobro Inicial de Instalación (Setup Fee):**
+- Normalmente se cobra entre un **30% y un 50%** del Total del Proyecto (Llave en mano) para cubrir tus horas base de desarrollo.
+- *Ejemplo:* Si el proyecto total valía 69 UF, cobras **25 UF de Setup** ($1.000.000 CLP) al iniciar.
+
+**B. Cálculo de Mensualidad (Costos Fijos + Tu Ganancia):**
+
+| Ítem de Costo Mensual | Costo Real CLP | Precio Cobrado CLP | Ganancia |
+| :--- | :--- | :--- | :--- |
+| Hosting Frontend (Netlify) | 0 | 15000 | 0 |
+| Hosting Backend (Railway) | 5000 | 20000 | 0 |
+| Base de Datos (Supabase) | 0 | 35000 | 0 |
+| Mantenimiento y Soporte Base | 64000 | 80000 | 0 |
+| Uso de Licencia del Software | 0 | 50000 | 0 |
+| **TOTALES** | 0 | 0 | 0 |
+<!-- TBLFM: @2$4..@6$4=($3-$2) :: @7$2=sum(@2$2..@6$2) :: @7$3=sum(@2$3..@6$3) :: @7$4=sum(@2$4..@6$4) -->
+
+> [!success] Resumen para el Cliente (Modelo SaaS)
+> **Cotización Final a Presentar:**
+> - Pago único de instalación y adaptación: **25 UF** ($1.000.000 CLP)
+> - Suscripción Mensual (Hosting, Soporte, Mejoras): **5 UF / mes** ($200.000 CLP)

package/docs/referencia-metodologia/Example.md

@@ -0,0 +1 @@
+goal: Transformar PWA Inmobiliaria en arquitectura React enterprise-grade constraints: - NO romper funcionalidad actual (mocks/offline OK) - Respeta Supabase fat-DB philosophy [docs/supabase-architecture.md] - shadcn/ui + Tailwind conventions 100% - Vitest coverage >80% artifacts: - /docs/REFACTOR-PLAN.md (diffs + métricas) - src/hooks/useSupabaseTable.ts<T> (genérico CRUD) - src/components/ui/DataTable.tsx (TanStack genérico) - src/features/properties/List.tsx (120LOC vs 502) - package.json (deps + scripts) - vitest.config.ts + tests/ - /coverage/lcov-report/index.html phases: 1. audit: run: npx eslint . --ext ts,tsx analyze: bundle size (vite-bundle-visualizer), reusability % write: /docs/REFACTOR-PLAN.md 2. hooks: create: useSupabaseTable<T>(table: string) features: query/mutate/subscribe/realtime test: vitest src/hooks/useSupabaseTable.test.ts 3. ui-primitives: add: npm i @tanstack/react-table clsx create: DataTable<T>, TableSkeleton export: src/components/ui/index.ts (barrel) 4. refactor-features: target: src/features/properties/Publicaciones.tsx split: PropertyList → DataTable<Property> + FilterTabs metrics: LOC -75%, reusability +30% 5. tests-coverage: setup: vitest.config.ts + @testing-library/react run: npm test --coverage goal: 82%+ coverage 6. verify: run: npm run dev test: Browser: Dashboard loads, offline banner, CRUD mocks bundle: npx vite-bundle-visualizer > /docs/bundle-pre-post.png success_criteria: - Reusability: 85% (DataTable usado 3+ features) - Tests: 82% coverage - Bundle: <1.2MB gzipped - No regressions: Manual QA checklist [docs/AUDITORIA.md]