pos-shoestore
POS and inventory platform for a shoe store with photo-first stock capture, variants, and operations-ready deployment.
Overview
pos-shoestore is a point-of-sale and inventory system built for a real shoe retail context. It is designed around practical store operations, especially fast inventory intake, searchable variants, and dependable checkout flows.
Problem / Context
Small retail teams often have incomplete inventory records and low tolerance for complex software. The system needed to support quick capture from mobile devices, track stock movement clearly, and remain deployable on low-cost VPS infrastructure.
What I built (your responsibilities)
- Defined and implemented MVP architecture for POS, inventory, purchasing, and reporting paths.
- Built backend routes/services with Fastify + Prisma and PostgreSQL-based data modeling.
- Supported frontend UX for operator-first workflows (inventory capture, checkout, and dashboards).
- Documented deployment and operations on VPS with Nginx, system services, and backup considerations.
Architecture
Clients (cashier + mobile inventory workflow) call Fastify APIs for inventory and sales operations. Data is modeled in PostgreSQL with Prisma; media and deployment infrastructure are documented for VPS operation.
Tech stack
- React (Vite) + TypeScript
- Fastify + Prisma
- PostgreSQL
- Tailwind and PWA capabilities
- VPS deployment with Nginx and service scripts
Key challenges & solutions
- Challenge: Inventory data starts incomplete and inconsistent. Solution: Emphasized photo-first capture and incremental enrichment workflow.
- Challenge: Shoe inventory needs variants (size/color) and accurate stock state. Solution: Modeled product/variant with stock-ledger entries for each movement.
- Challenge: Checkout needs resilience in constrained environments. Solution: Planned/implemented offline-tolerant PWA behavior and pragmatic cashier flows.
- Challenge: Transition from prototype to daily operation. Solution: Added deployment docs, system service configs, and operational procedures.
Outcomes / current status
The project is active and includes both implementation and operational documentation, with clear progression from MVP scope toward broader retail workflow coverage.