This is a comprehensive retail management application designed to streamline inventory, product, and store operations for small to medium-sized businesses.
- Create and manage product catalogs
- Track detailed product information
- Support multiple product packaging
- Barcode generation
- Real-time stock monitoring
- Multiple tracking modes (total and lot-based)
- Detailed stock movement logging
- Demand stock forecasting
- Hierarchical category structure
- Customizable category attributes
- Flexible product categorization
- Multiple storage location support
- Inventory allocation tracking
- Primary and secondary storage management
- Language: TypeScript
- Runtime: Node.js
- ORM: Prisma
- Logging: Winston
- Error Tracking: Sentry
- Framework: React
- State Management: Custom stores
- Internationalization: i18n
- Build Tool: Vite
- Containerization: Docker
- Deployment: Docker Compose
- CI/CD: GitHub Actions
- Node.js (v24+)
- bun runtime
- npm for package manager
- Docker for deployment
- go task for script start
# Clone the repository
git clone https://github.com/yourusername/retail-management-system.git
# Navigate to project directory
cd retail-management-system
# Install dependencies
npm install
# Copy environment template
cp .env.example .env
# Run database migrations
task prisma-all
# Start development servers
task fullstack-
Product Management
- Detailed product tracking
- Flexible pricing
- Multiple packaging support
-
Inventory Control
- Real-time stock monitoring
- Lot-based and total tracking
- Movement history
-
Category System
- Hierarchical categories
- Customizable attributes
- Easy product classification
-
Multi-Store Support
- Manage multiple business locations
- Centralized configuration
- Individual store tracking
- Store-based multi-tenancy
- Comprehensive error handling
- Efficient query optimization
- Scalable architecture
MIT
This is an open-source project. While designed with best practices, always ensure proper security and testing before production use.