# QUICK START GUIDE - Kreme Donuts POS System

## ⚡ Quick Setup (5 minutes)

### 1. Start XAMPP
```
- Open XAMPP Control Panel
- Click "Start" on Apache
- Click "Start" on MySQL
```

### 2. Initialize Database
- Open browser: `http://localhost/phpmyadmin`
- Click "New" on left sidebar
- Create database: `kreme_donuts_db`
- Keep defaults, click Create

### 3. Initialize Tables
- Open browser: `http://localhost/kreme_donuts/config/init_db.php`
- You should see: `{"success": true, "message": "Database initialized successfully"}`
- If error: Check MySQL is running

### 4. Access System
- Open: `http://localhost/kreme_donuts/public/login.php`
- Use demo credentials below
- Done! 🎉

---

## 👥 Demo Login Credentials

```
┌─────────────────────────────────────────┐
│ ADMIN USER                              │
├─────────────────────────────────────────┤
│ Username: admin                         │
│ Password: admin123                      │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│ CASHIER                                 │
├─────────────────────────────────────────┤
│ Username: cashier1                      │
│ Password: cashier123                    │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│ KITCHEN STAFF                           │
├─────────────────────────────────────────┤
│ Username: kitchen1                      │
│ Password: kitchen123                    │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│ INVENTORY MANAGER                       │
├─────────────────────────────────────────┤
│ Username: inventory1                    │
│ Password: inventory123                  │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│ SOCIAL MEDIA MANAGER                    │
├─────────────────────────────────────────┤
│ Username: social1                       │
│ Password: social123                     │
└─────────────────────────────────────────┘
```

---

## 🔄 Main Workflows

### 📝 Creating a Walk-in Order (Cashier)
1. Click **New Order**
2. Select "Walk-in" as order type
3. Click products to add to cart
4. Adjust quantities in cart
5. Select payment method
6. Click **Complete Order**
7. Print receipt if needed

### 🌐 Creating an Online Order (Social Media Manager)
1. Click **Online Orders**
2. Click **New Online Order**
3. Enter customer details
4. Add products to order
5. Set delivery address
6. Click **Submit Order**
7. Kitchen will see order automatically

### 👨‍🍳 Kitchen Display (Kitchen Staff)
1. Login as kitchen1
2. Kitchen orders appear automatically
3. Click order to see details
4. Click **Start Preparing** when ready
5. Click **Mark as Done** when finished
6. Order moves to "Ready" status
7. Ingredients automatically deducted

### 📦 Managing Inventory (Inventory Manager)
1. Click **Inventory**
2. See all ingredients and stock levels
3. Red = Out of Stock | Orange = Low Stock
4. Click **+** button to restock
5. Enter quantity to add
6. Click **Restock**
7. Check **Low Stock Alerts** for urgent items

### 📊 Viewing Reports (Admin)
1. Click **Reports**
2. Select date range
3. Choose report type (Daily/Monthly/Yearly)
4. Click **Generate Report**
5. View statistics and charts
6. Export to CSV if needed

---

## 🗂️ File Locations

```
C:\xampp\htdocs\kreme_donuts\
├── public/login.php          ← START HERE
├── public/dashboard.php      ← Main dashboard
├── public/orders.php         ← View orders
├── public/new_order.php      ← Create order
├── public/kitchen.php        ← Kitchen display
├── public/inventory.php      ← Inventory mgmt
├── public/reports.php        ← Reports
├── public/low_stock.php      ← Stock alerts
├── config/database.php       ← DB settings
├── config/init_db.php        ← Initialize DB
└── README.md                 ← Full documentation
```

---

## 🎨 Features by Role

### ADMIN
- ✅ Full system access
- ✅ View all branches
- ✅ Generate reports
- ✅ Manage users
- ✅ Manage products/inventory
- ✅ View dashboards

### CASHIER
- ✅ Create walk-in orders
- ✅ View order status
- ✅ Print receipts
- ❌ Cannot modify inventory

### KITCHEN STAFF
- ✅ View orders on tablet
- ✅ Update order status
- ✅ See special instructions
- ✅ Track ingredient deductions
- ❌ Cannot modify inventory

### INVENTORY MANAGER
- ✅ Manage ingredients
- ✅ Restock items
- ✅ View alerts
- ✅ Track inventory history
- ❌ Cannot create orders

### SOCIAL MEDIA MANAGER
- ✅ Create online orders
- ✅ Assign to branches
- ✅ Track delivery status
- ✅ View order status
- ❌ Cannot modify products

---

## 💡 Common Tasks

### How to Add a New Product?
1. Login as admin
2. Go to **Products**
3. Click **+ New Product**
4. Enter name, price, category
5. Set recipe (which ingredients needed)
6. Click Save

### How to Add Ingredients?
1. Go to **Inventory**
2. Click **+ Add Ingredient**
3. Enter name, unit (kg/liter/pieces)
4. Set minimum threshold (alert level)
5. Click Save

### How to Restock Ingredients?
1. Go to **Inventory**
2. Find ingredient needing restock
3. Click **+** button
4. Enter quantity to add
5. Click **Restock**

### How to Print Receipt?
1. Open order details
2. Click **Print** button
3. Select printer
4. Click **Print**

### How to Export Report?
1. Generate desired report
2. Click **Export CSV** or **Export PDF**
3. Choose save location
4. Done!

---

## ⚠️ Troubleshooting

### "Database Connection Error"
✓ Make sure MySQL is running in XAMPP
✓ Open phpMyAdmin to verify

### "Login Page Shows Blank"
✓ Clear browser cache (Ctrl+Shift+Delete)
✓ Restart XAMPP
✓ Try different browser

### "Orders Not Showing"
✓ Refresh page
✓ Check user's branch assignment
✓ Verify order date filters

### "Inventory Not Deducting"
✓ Ensure recipe is set for product
✓ Check ingredient stock levels
✓ Review transaction logs

---

## 🔐 Security Tips

- **Change default passwords immediately**
- **Regular database backups**
- **Restrict user access by role**
- **Keep XAMPP updated**
- **Use strong passwords (8+ chars)**

---

## 📞 Support

For detailed documentation, see **README.md**

For issues:
1. Check browser console (F12)
2. Check XAMPP error logs
3. Verify database connection
4. Review user permissions

---

## 🎯 Next Steps

1. ✅ Setup complete - login with demo credentials
2. ✅ Create a test walk-in order
3. ✅ Go to kitchen and mark order as done
4. ✅ Check inventory to verify deduction
5. ✅ View dashboard to see sales
6. ✅ Generate a daily report

---

**Ready to use Kreme Donuts POS System!** 🍩

Version: 1.0.0 | January 2026