Saltar al contenido
Todos los proyectos
En producción

ImportCol

Logística, inventario y prorrateo de costos para un importador colombiano.

Rol

Desarrollador full-stack (solo)

Año

2026

Ver el sitio en vivo
  • FastAPI
  • PostgreSQL
  • SQLAlchemy
  • React 19
  • TypeScript
  • Tailwind
  • Docker
  • Caddy
ImportCol — Logística, inventario y prorrateo de costos para un importador colombiano.

ImportCol reemplaza un libro de Excel por una plataforma de inventario y prorrateo en producción, en uso diario por el cliente.

// El problema

Un importador llevaba inventario, lotes y prorrateo de costos en un Excel frágil, propenso a errores de precio que costaban dinero real.

// Decisiones

  1. Decisión

    Motor de prorrateo determinista con Decimal y denominador congelado por lote.

    Impacto

    Costos y precios sugeridos exactos; paridad verificada contra el Excel de referencia.

  2. Decisión

    Anular una venta no borra la fila; la marca y manda el producto a "devuelto", no a "disponible". Volver a venderlo exige un restock explícito.

    Impacto

    Una anulación por error deja de ser una puerta para revender lo mismo dos veces, y el historial queda completo para auditar quién anuló y por qué.

  3. Decisión

    Ciclo de mejora continua con el cliente — 7 fases entregadas, la última pedida y desplegada el mismo día.

    Impacto

    El sistema evoluciona con el negocio; cada deploy con backup verificado y cero pérdida de datos.

// Resultados

Estado
En producción con cliente real — uso diario
Datos reales
469 productos · 86 ventas · 3 lotes de importación
Entregas
7 fases en producción · la última pedida y desplegada el mismo día
Tests
117 verdes

// El producto

Tabla de prorrateo de un lote con columnas de precio en USD, impuesto, participación porcentual, gasto asignado, costo total en COP y precios sugeridos mayorista y detal.
El motor de prorrateo, visible: cada producto lleva su participación en el lote y el gasto que le tocó. El denominador se congela al cerrar el lote, así que agregar un producto después no reescribe los costos ya calculados.
Listado de ventas con fecha, producto, cliente, precio, tipo y método de pago, y las acciones de recibo y anular.
Anular no borra la fila: la marca y manda el producto a "devuelto". Volver a venderlo exige un restock explícito, y queda el rastro de quién anuló y cuándo.
Siguiente proyecto AuditX