Saltar al contenido
AÑO // 2026 EN PRODUCCIÓN

// 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.

app.tilyshop.internal //dashboard
01 / 04
Panel general de TilyShop con métricas de unidades, pendientes y registro de venta

Panel General & Ventas

Resumen de unidades, pendientes por surtir y registro rápido de ventas desde una sola vista.

Resumen OperativoRegistro de VentasStock
// 01. EL DESAFÍO TÉCNICO & AUDITORÍA

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.

  1. Stock agregado por referencia: sin granularidad por talla, color o lote, el inventario físico y el digital divergían de forma silenciosa.

  2. Escrituras no atómicas: dos terminales podían vender la misma unidad y sobrescribir existencias sin bloqueo ni reconciliación.

  3. 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 VERIFICADA

DIAGNÓ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.

// 02. ARQUITECTURA DE SOFTWARE

// ARCHITECTURE // MODULES

Arquitectura Modular

Tres capas verificables: reactividad en la interfaz, estado predictible y persistencia transaccional.

MODULE 01/03

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
MODULE 02/03

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
MODULE 03/03

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