https://github.com/kiritocode1/gei
https://github.com/kiritocode1/gei
Last synced: 20 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/kiritocode1/gei
- Owner: kiritocode1
- Created: 2025-11-15T14:36:34.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-11-15T14:38:55.000Z (8 months ago)
- Last Synced: 2025-12-11T13:57:49.354Z (8 months ago)
- Language: TypeScript
- Size: 106 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-QUICK-TEST.md
Awesome Lists containing this project
README
# 🧪 Quick Testing Guide
## Test the Multi-Store POS System Online
I cannot directly host the application online from this environment, but here are several ways you can test it quickly:
## 🚀 **Option 1: Docker Compose (Fastest)**
```bash
# Clone the project
git clone
cd hm-erp
# One command to start everything
npm run docker:up
# Wait 2-3 minutes, then visit:
# Frontend: http://localhost:3000
# Backend: http://localhost:3001
```
## 🌐 **Option 2: Online IDE (Gitpod/GitHub Codespaces)**
### Using Gitpod:
1. Push code to GitHub
2. Open https://gitpod.io/#https://github.com/your-username/hm-erp
3. Wait for environment to load
4. Run: `npm run docker:up`
### Using GitHub Codespaces:
1. Push code to GitHub
2. Go to your repo on GitHub
3. Click "Code" → "Codespaces" → "Create codespace"
4. Run: `npm run docker:up`
## 🔧 **Option 3: Railway.app (Quick Deploy)**
1. Fork this repository on GitHub
2. Go to [railway.app](https://railway.app)
3. Click "New Project" → "Deploy from GitHub repo"
4. Select your forked repository
5. Railway will automatically detect the services
6. Configure environment variables
7. Deploy!
## ⚡ **Option 4: Render.com (Free Tier)**
1. Push code to GitHub
2. Go to [render.com](https://render.com)
3. Click "New" → "Web Service"
4. Connect your GitHub repo
5. Configure:
- Build Command: `npm install && cd backend && npm install`
- Start Command: `cd backend && npm start`
- Environment variables from `.env.example`
## 🐳 **Option 5: Play with Docker (One-Liner)**
If you have Docker installed, run this single command:
```bash
curl -sSL https://raw.githubusercontent.com/your-username/hm-erp/main/docker-compose.yml | docker-compose up
```
## 📱 **What You Can Test Online**
### 🔐 **Authentication**
- User registration and login
- Role-based access control
- Profile management
- Password changes
### 📋 **Order Management**
- Create custom orders from vendors
- Order approval workflow
- Order status tracking
- Order search and filtering
### 🏭 **Production Management**
- Production dashboard with real-time stats
- Task assignment and tracking
- Worker productivity metrics
- Multi-stage production workflow
### 📦 **Material Management**
- Material inventory tracking
- Low stock alerts
- Stock level updates
- Material consumption tracking
### 🛒 **Point of Sale**
- Complete POS interface
- Product search and barcode scanning
- Shopping cart management
- Multiple payment methods
- Receipt generation
### 📊 **Inventory Management**
- Multi-location inventory tracking
- Stock transfers between locations
- Real-time inventory updates
- Inventory valuation
## 🎯 **Demo Users for Quick Testing**
### Admin Account
- **Email**: admin@hmerp.com
- **Password**: Admin123!
- **Access**: All system features
### Store Manager
- **Email**: manager@hmerp.com
- **Password**: Manager123!
- **Access**: Store operations, inventory, sales
### Cashier
- **Email**: cashier@hmerp.com
- **Password**: Cashier123!
- **Access**: POS operations, basic reports
## 🔗 **Quick Access Links**
Once deployed, you'll have access to:
- **Main Dashboard**: Overview of all operations
- **Order Management**: Handle vendor orders
- **Production**: Track manufacturing workflow
- **Materials**: Manage raw materials
- **POS**: Process customer sales
- **Inventory**: Multi-location stock management
- **Reports**: Analytics and insights
## ⚡ **Performance Expectations**
The system is designed to handle:
- ✅ 100+ concurrent users per store
- ✅ Real-time inventory updates
- ✅ Multi-location operations
- ✅ Mobile-responsive design
- ✅ Complete business workflow
## 🎉 **What Makes This Special**
This is a **complete manufacturing + retail ERP** that handles:
- 🏪 **Custom order intake** from vendors
- 🔨 **Multi-stage production tracking**
- 📦 **Material and inventory management**
- 🏬 **Multi-store POS operations**
- 📊 **Real-time analytics**
- 🔐 **Role-based permissions**
It's essentially a mini-SAP/Oracle system built for manufacturing businesses that sell through multiple retail locations!
---
**Choose the option above that works best for you. Docker Compose (Option 1) is usually the fastest way to get everything running locally!** 🚀