Producto propio
Pullstok: ERP y tienda online para pequeños comercios
Producto SaaS multi-tenant para gestionar un comercio de punta a punta: stock, ventas, facturación, presupuestos, clientes y tienda online. Front en React con Vite y API en Express con Prisma y PostgreSQL.
Stack tecnológico
Las tecnologías usadas y por qué.
Capturas
El producto
Pullstok es un producto propio: un SaaS multi-tenant que le permite a un pequeño comercio (un bazar, una ferretería, un kiosco, un local de limpieza) manejar toda su operación desde un solo lugar. Cada comercio tiene su propio espacio aislado, con sus productos, sus clientes y sus ventas, sobre la misma plataforma.
La idea nació de un problema concreto y muy común: los comercios chicos suelen llevar el stock en un cuaderno o en una planilla, facturan por fuera y no tienen visibilidad real de lo que venden. Pullstok junta todo eso en una herramienta simple, pensada para gente que no es técnica.
Arquitectura
El sistema está partido en piezas claras:
- App (panel de gestión): una SPA en React con Vite, React Router para la navegación y TanStack Query para el manejo de datos del servidor (caché, revalidación, estados de carga). Estilos con Tailwind y todo en TypeScript.
- API: un backend en Express con Prisma como ORM sobre PostgreSQL. Autenticación con JWT y validación de entrada con Zod en cada endpoint. El modelo es multi-tenant: cada request se resuelve dentro del comercio al que pertenece.
- Landing y tienda: sitios en Astro, estáticos y rápidos, separados de la app para no cargar la web pública con el peso del panel.
Todo corre en un VPS propio, con deploy controlado y base de datos gestionada por fuera del ciclo de vida de los contenedores.
Los módulos
El panel cubre el ciclo completo de un comercio:
- Productos y stock: alta, edición y control de existencias, con categorías administrables después del alta inicial.
- Presupuestos, pedidos y ventas: del presupuesto al pedido y de ahí a la venta, con remitos cuando hace falta.
- Clientes: gestión de la cartera de clientes de cada comercio.
- Facturación: módulo de facturas de servicios y un puente que convierte una venta en factura automáticamente, para no cargar los datos dos veces.
- Tienda online: un e-commerce conectado al mismo catálogo, así lo que está en stock se puede vender también por la web.
- Superadmin: una capa por encima para administrar los comercios de la plataforma.
Onboarding y calidad
El alta de un comercio nuevo se hace con un wizard paso a paso que deja el negocio listo para operar sin fricción. Del lado de la calidad, la API tiene tests end to end con Jest corriendo contra una base de datos real en Docker, lo que me permite tocar el modelo de datos con confianza y detectar regresiones antes de que lleguen a producción.
Estado
Pullstok está en producción y en desarrollo activo. Es un producto vivo: cada nueva funcionalidad (categorías, facturación, el puente venta a factura) sale de necesidades reales de los comercios que ya lo usan.