// STOCK AUDIT // 2026
TILYSHOP INVENTORY
Sistema de inventario offline-first para puntos de venta: cálculo de stock efectivo en cliente, trazabilidad atómica de lotes y sincronización transaccional.
- // PROBLEMA
- Puntos de venta con conectividad inestable y riesgo de sobreventa por terminales concurrentes. El sistema previo no garantizaba atomicidad ni auditoría de ajustes.
- // STACK TÉCNICO
- Vue 3
- TypeScript
- Node.js
- PostgreSQL
- Pinia
- Tailwind CSS
- // IMPACTO
- 0.00% Descuadre — INTEGRIDAD DE STOCK
- Locks Optimistas — CONCURRENCIA POS
- PostgreSQL ACID — PERSISTENCIA
- ROLDesarrollador Full-Stack (Frontend, Backend & Base de Datos)
- CLIENTEConfecciones TilyShop
- DURACIÓN6 Semanas // Octubre 2026 – Noviembre 2026
Especificaciones del proyecto
01 // ROL
Desarrollador Full-Stack (Frontend, Backend & Base de Datos)
STOCK AUDIT
02 // CLIENTE
Confecciones TilyShop
PROYECTO 2026
03 // DURACIÓN
6 Semanas // Octubre 2026 – Noviembre 2026
STATUS // EN PRODUCCIÓN
04 // STACK
Vue 3 • Node.js • PostgreSQL
Vue 3 • TypeScript • Node.js • PostgreSQL • Pinia • Tailwind CSS
// 00. REGISTRO VISUAL & CAPTURAS DE INTERFAZ
Capturas del Sistema
Interfaces reales del flujo operativo: panel general, administración de inventario, historial de ventas y seguridad del perfil.

Panel General & Ventas
Resumen de unidades, pendientes por surtir y registro rápido de ventas desde una sola vista.
El Desafío
Antes del rediseño, el inventario agregaba existencias por referencia e ignoraba la granularidad por talla, color y lote. Cada terminal escribía de forma independiente sobre la misma fila, sin bloqueo optimista ni una fuente única de verdad.
Stock agregado por referencia: sin granularidad por talla, color o lote, el inventario físico y el digital divergían de forma silenciosa.
Escrituras no atómicas: dos terminales podían vender la misma unidad y sobrescribir existencias sin bloqueo ni reconciliación.
Lecturas N+1 y ausencia de índices compuestos: el panel de telemetría tardaba hasta 4,820 ms en responder.
Reporte de Auditoría
ARQUITECTURA VERIFICADADIAGNÓSTICO // HALLAZGO CRÍTICO
El inventario previo conciliaba stock mediante procesos manuales y escrituras no atómicas. Los lotes se agrupaban por referencia, sin granularidad por talla, y las operaciones concurrentes sobrescribían existencias sin bloqueo optimista.
RESOLUCIÓN // SOLUCIÓN TÉCNICA
Se rediseñó el modelo de datos con lotes atómicos por SKU y talla, se introdujo un ledger transaccional inmutable y una capa reactiva offline-first con locks optimistas. Las consultas críticas se indexaron y se eliminaron las lecturas N+1.
INTEGRIDAD DE STOCK
0.00% Descuadre
Ledger transaccional inmutable
CONCURRENCIA POS
Locks Optimistas
Idempotencia por client_txn_id
PERSISTENCIA
PostgreSQL ACID
Consultas indexadas sin N+1
Sincronización idempotente con client_txn_id y transacciones atómicas validadas localmente y documentadas en el whitepaper técnico del repositorio.
// ARCHITECTURE // MODULES
Arquitectura Modular
Tres capas verificables: reactividad en la interfaz, estado predictible y persistencia transaccional.
MOD-A // Reactividad
Capa Reactiva con Vue 3 & Composition API
Componentes desacoplados, estado derivado y watchers quirúrgicos para telemetría en vivo sin re-renderizados innecesarios.
- Composables tipados por dominio
- Estado derivado sin duplicación
- Vistas lazy con Suspense
MOD-B // Estado Global
Gestión de Estado Predictible con Pinia
Stores por dominio con persistencia offline-first y locks optimistas para operaciones concurrentes de almacén.
- Offline-first con cola de sincronización
- Optimistic locks por SKU y lote
- Devtools y trazabilidad de acciones
MOD-C // Persistencia
Integridad Transaccional & Base de Datos
PostgreSQL en modo ACID estricto, migraciones versionadas y constraints que hacen imposible el descuadre silencioso.
- Transacciones ACID por movimiento
- Índices compuestos y query tuning
- Migraciones y seeds reproducibles