🍺 Control de Viáticos (PWA)

Aplicación web progresiva (PWA) para el control de viáticos, diseñada para funcionar 100% offline, sin backend y con reglas reales de operación.

---

🚀 Demo

👉 https://rmkw.github.io/ViaticosApp/

---

📱 Preview

⚠️ Screenshots reales de la app

---

🎯 Problema que resuelve

El control de viáticos suele hacerse:

• mentalmente
• en Excel
• hasta sistemas institucionales tardíos

Esto genera:

• errores de cálculo
• falta de visibilidad del saldo
• mala gestión de gastos

👉 Esta app lo resuelve en tiempo real.

---

💡 Solución

• Registro simple de viáticos
• Control de gastos
• Aplicación automática de reglas
• Visualización inmediata del saldo
• Todo local, sin dependencia de internet

🧠 Reglas de negocio

💰 Ingreso único

Solo se permite un ingreso de viáticos.

Para modificarlo, debe eliminarse primero.

---

🧾 No comprobable (20%)

Se calcula automáticamente cuando:

• Pago con tarjeta
• Categoría ≠ Hospedaje

Ejemplo: $100 → $20 no comprobable

---

🚫 Restricciones

• ❌ Hospedaje NO aplica
• ❌ Efectivo NO aplica
• ✅ Editable manualmente

---

⚙️ Funcionalidades

📥 Ingresos

• Registro de monto
• Fecha
• Descripción (default: "Viáticos")

---

📤 Gastos

• Monto
• Categoría
• Forma de pago
• Fecha
• Observaciones
• Cálculo automático de no comprobable

---

📊 Dashboard

• Total ingresos
• Total gastos
• No comprobable
• Saldo disponible
• Estado visual

---

🧾 Historial

• Lista de movimientos
• Edición de gastos
• Eliminación de registros

---

🧩 Arquitectura

Frontend: Vue 3 + Vite
Persistencia: IndexedDB
PWA: Service Worker + Manifest
Deploy: GitHub Pages

---

📦 Instalación

git clone https://github.com/rmkw/ViaticosApp.git
cd ViaticosApp
npm install
npm run dev

---

🛠️ Build

npm run build
npm run preview

---

🌐 Deploy

Configuración clave:

base: '/ViaticosApp/'

PWA:

start_url: '/ViaticosApp/'
scope: '/ViaticosApp/'

---

📱 Instalación como app

Android / Edge

✔ Instalación automática

iPhone

1. Abrir en Safari
2. Compartir
3. "Agregar a pantalla de inicio"

---

⚠️ Limitaciones

• Datos locales únicamente
• No sincronización entre dispositivos
• No backend (por diseño)

---

🔮 Roadmap

• Exportar respaldo (JSON)
• Importar respaldo
• APK Android
• Mejora de UI/UX
• Multi-viáticos (modo avanzado)

---

🍺 Apoya el proyecto

👉 https://buymeacoffee.com/lgclrmkwz/

---

👨‍💻 Autor

Luis Castañeda López Full Stack Developer INEGI – Unidad de Geografía y Medio Ambiente

---

📄 Licencia

MIT