# Criterios UX/UI para las calculadoras del Maletín Tributario

> Guardado por Roberto + Claude. Ubicación: `droplet3:/var/www/h.lexova.work/maletin/CRITERIOS-UX-CALCULADORAS.md`
> Aplica sobre todo a: `fap-alivio.php`, `reprogramacion.php`, `fap.php`, `deudas.php` (y toda calculadora tributaria nueva).
> Estos criterios salieron del ir y venir real construyendo las calculadoras FAP / Alivio / Reprogramación (Ley 1733).

---

## 0. Principio rector
**UI/UX siempre. No hacer de memoria, no suponer.** Cada monto y cada regla se calcula con el motor o se cita de la norma real (RND, Ley). Si no sé de dónde sale un número, lo averiguo (leer la RND en PDF, correr el motor), no lo invento.

---

## 1. Transparencia total: "¿de dónde sale cada monto?"
- **Mostrar TODOS los cálculos**, no solo el resultado. Memoria de cálculo con **las fórmulas Y los números reemplazados** (no "según la UFV", sino `MV = TO × (UFVpago ÷ UFVvenc) − TO = 10.000 × (3,29 ÷ 2,74) − 10.000 = 2.007`).
- El contribuyente tiene que poder **verificar contra "Mi Situación Tributaria" del SIN**. Si el SIN muestra sanción 60%, la calculadora debe poder cuadrar ese mismo monto (toggle de sanción).
- Nada de **barras/gráficos sin cifras**. Toda barra lleva su número. Si una barra no aporta dato, se elimina.
- La memoria detallada larga va en **`<details>` colapsable** para no saturar, pero disponible.

## 2. Estructura: respuesta arriba, explicación abajo (narrativa por pasos)
- **Primero la respuesta** (hero con el número clave + tarjetas de comparación). El titular NUNCA se entierra en medio de otro bloque.
- Luego el **"de dónde sale" en pasos numerados**, un concepto por paso, en orden lógico:
  1. Tu deuda hoy (sin alivio) — waterfall con cifras.
  2. Qué condona la ley — "antes → después" (la resta clara).
  3. Cómo la pagas — derivación base → inicial/garantía → saldo → cuotas.
  4. Valor presente vs. valor futuro — línea de tiempo.
  5. ¿Conviene? — comparación final.
- **No mezclar "sin alivio" con "con alivio"**: cada uno es su propio paso/bloque.

## 3. Valor presente vs. valor futuro (clave conceptual)
- El SIN muestra la **base de HOY**, pero pagando en cuotas se desembolsa **más** porque cada cuota se reactualiza (UFV + interés de facilidades, Art. 8.IV).
- Mostrar **el total acumulado final** (suma de todas las cuotas), no solo el monto de hoy. La conveniencia se decide con el total final.
- Visual: **línea de tiempo con flecha curva** de "HOY" (valor presente) a "última cuota" (valor futuro), con la diferencia anotada.
- La UFV es un **interés implícito** (~19,83–20% anual en la crisis actual). Enlazar a `boliviaimpuestos.com/ufv-como-interes/`. Regla: **a menos cuotas, menos se paga en total**.

## 4. Distribución del espacio (acomodar, no scroll infinito)
- Resultados en **2 columnas** cuando ayuda; evitar la lectura larga de una sola columna hasta abajo.
- **Fuente base legible** (comparar con el blog al 100% de zoom; subimos body a 16px).
- Sin espacios vacíos grandes: distribuir el contenido en la página.

## 5. Entradas: comodidad y validación
- **Último dígito del NIT** → sugiere automáticamente la fecha de vencimiento (calendario SIN).
- **Restringir lo ilógico**: p. ej. no permitir más cuotas pagadas que las del plan (auto-ajuste + aviso). Solo enteros donde corresponde. Nada de estados imposibles.
- Slider de cuotas: **por defecto arranca en el máximo del cálculo** (no un valor fijo); respeta la cuota mínima de 200 UFV; la etiqueta se sincroniza SIEMPRE con el valor real.

## 6. Varias deudas
- Opción **Una / Varias**. Varias = **un solo plan unido**, no planes separados (el motor consolida; la cuota mínima 200 UFV aplica al TOTAL, así "Una" y "Varias" coinciden).
- **Discriminar cada deuda en cada cuota** (cronograma expandible por cuota mostrando cuánto va a cada impuesto).
- Presentación **estilo hoja de cálculo / Excel** (filas por deuda, columnas por componente) — los contadores se manejan mejor así.

## 7. Citar la norma
- Donde haya una regla (plazos, %, límites), **citar la RND/Ley**: número de RND, artículo, parágrafo.
- Incluir un bloque de **condiciones y límites** con su fuente (ej. 4 cuotas impagas = incumplimiento, Art. 8.b RND 102600000019; máx. 36 cuotas Art. 8.a; cuota ≥ 200 UFV).

## 8. Idioma y estilo
- **Español neutro boliviano** ("presione", no "presioná"; sin voseo rioplatense).
- Tono claro, para el contribuyente común; explicar el "por qué", no solo el "cuánto".

## 9. Método de trabajo (para Claude)
- Leer el código real (motor, endpoints, calculadora existente) antes de tocar — **reutilizar** patrones probados, no reinventar.
- Leer la norma real (descargar el PDF de la RND, `pdftotext`) — no citar de memoria.
- **Correr el motor** para obtener montos reales y verificar coherencia (que el condonado = adeudado − base, que VP < VF, etc.).
- Mirar **cómo resuelven otras apps del mundo** este tipo de calculadoras (finanzas/préstamos): waterfall, valor presente/futuro, líneas de tiempo, tablas de amortización.

---

## Referencias normativas usadas (Ley 1733 / Alivio Tributario)
- **RND 102600000019** (procedimiento del Alivio): Art. 7 (contado), Art. 8 (facilidades: 8.a máx 36 cuotas, 8.b 4 cuotas impagas = incumplimiento, 8.c saldo final impago, 8.II plan caído = nueva solicitud con inicial 5% + garantía 5%, 8.III plan vigente reprograma sin inicial ni garantía, 8.IV actualización a UFV publicación 27/05/2026 + reactualización de cuotas), Art. 9 (efectos del incumplimiento).
- **RND 102600000022**: fondos retenidos por medida coactiva se pueden imputar a pago inicial / garantía.
- **RND 102600000023**: prórroga de cuotas mayo/junio 2026 al 10/07/2026 (bloqueos).
- **RND 102500000019**: Reglamento de Facilidades de Pago (base; cuota mín. 200 UFV).
- PDFs leídos con `pdftotext`; UFV real vía `deudas.php?action=get_ufv&fecha=` (UFV publicación 27/05/2026 = 3,25566).

_Última actualización: 2026-07-03._