# 📖 INSTALLATION GUIDE
## ProductionPlannerPro - Complete Setup Instructions

**Version:** 1.0.0  
**Package Value:** $2,000  
**License:** Lifetime  

---

## 📋 TABLE OF CONTENTS

1. [System Requirements](#system-requirements)
2. [Pre-Installation Checklist](#pre-installation-checklist)
3. [Step-by-Step Installation](#step-by-step-installation)
4. [Database Configuration](#database-configuration)
5. [First Login](#first-login)
6. [Post-Installation Setup](#post-installation-setup)
7. [Troubleshooting](#troubleshooting)
8. [Security Recommendations](#security-recommendations)

---

## 🖥️ SYSTEM REQUIREMENTS

### **Server Requirements:**
- **PHP:** 7.2 or higher (7.4+ recommended)
- **MySQL:** 5.7 or higher (8.0+ recommended)
- **Web Server:** Apache or Nginx
- **Disk Space:** Minimum 50MB (100MB+ recommended)
- **SSL Certificate:** Recommended for production

### **PHP Extensions Required:**
- PDO (PDO_MYSQL)
- JSON
- mbstring
- OpenSSL
- cURL (optional, for future features)

### **Hosting Requirements:**
- cPanel or similar control panel
- PHPMyAdmin access
- File Manager or FTP access
- Ability to create MySQL databases

### **Browser Compatibility:**
- Chrome/Edge (latest)
- Firefox (latest)
- Safari (latest)
- Internet Explorer 11+ (limited support)

---

## 🔐 DEFAULT LOGIN CREDENTIALS

**After installation, login with:**

```
URL: https://yourdomain.com/app/system-login.html

Email: admin@productionplannerpro.com
Password: Admin@123456
```

**⚠️ CRITICAL: Change this password immediately after first login!**

---

## ✅ PRE-INSTALLATION CHECKLIST

Before you begin, ensure you have:

- [ ] Access to cPanel or hosting control panel
- [ ] Database name, username, and password ready
- [ ] FTP client (optional) or File Manager access
- [ ] Text editor for configuration files
- [ ] 15-30 minutes of uninterrupted time

---

## 🚀 STEP-BY-STEP INSTALLATION

### **STEP 1: Create MySQL Database**

**Via cPanel:**
1. Login to cPanel
2. Find **"MySQL Databases"**
3. Create new database: `productionplanner`
4. Create new user with strong password
5. Add user to database with ALL PRIVILEGES

**Save these credentials - you'll need them in Step 3!**

---

### **STEP 2: Upload Files**

1. Login to cPanel File Manager
2. Navigate to `/public_html/`
3. Upload `ProductionPlannerPro_v1.0_Complete.zip`
4. Extract the ZIP file
5. Delete the ZIP after extraction

**Verify these folders exist:**
- `/public_html/backend/`
- `/public_html/admin/`
- `/public_html/app/`

---

### **STEP 3: Import Database**

1. Open phpMyAdmin in cPanel
2. Select your database
3. Click **Import** tab
4. Choose `database.sql` from package
5. Click **Go**
6. Wait for import to complete

---

### **STEP 4: Configure Database Connection**

1. Edit file: `/public_html/backend/config/database.php`

2. Update these lines:
   ```php
   private const DB_HOST = 'localhost';
   private const DB_NAME = 'productionplanner';      // Your database name
   private const DB_USER = 'prod_user';              // Your database username
   private const DB_PASS = 'YourDatabasePassword';   // Your database password
   ```

3. Save the file

---

### **STEP 5: Test Installation**

1. Go to: `https://yourdomain.com/app/system-login.html`
2. Enter credentials:
   - Email: `admin@productionplannerpro.com`
   - Password: `Admin@123456`
3. Click **Sign In**
4. You should be redirected to admin dashboard!

---

## ⚙️ POST-INSTALLATION SETUP

### **1. Change Default Password (Do This First!)**

1. Login to admin dashboard
2. Click **Users** → Find `admin@productionplannerpro.com`
3. Click **Edit** → Enter new password
4. Click **Update User**

### **2. Create Your Admin Account**

1. Click **+ New User**
2. Enter your details
3. ✅ Check "Super Admin Privileges"
4. Click **Create User**

### **3. Delete Default Admin**

1. Login with YOUR account
2. Go to Users
3. Delete `admin@productionplannerpro.com`

---

## 🐛 TROUBLESHOOTING

### **Can't Login?**

**Check:**
- Email: `admin@productionplannerpro.com` (exact spelling)
- Password: `Admin@123456` (case-sensitive!)
- Database imported successfully
- Database config correct in `database.php`

**Solution:**
Run this SQL in phpMyAdmin:
```sql
SELECT * FROM users WHERE email = 'admin@productionplannerpro.com';
```

If no result, import `SETUP_DEFAULT_ADMIN.sql`

---

### **Database Connection Failed?**

**Check:**
1. Database credentials in `/backend/config/database.php`
2. Database exists in phpMyAdmin
3. Database user has correct permissions

---

### **500 Server Error?**

**Check:**
1. PHP version (needs 7.2+)
2. File permissions (folders: 755, files: 644)
3. Server error logs in cPanel

---

## 🔒 SECURITY RECOMMENDATIONS

**Immediate Actions:**
- [ ] Change default admin password
- [ ] Delete default admin account
- [ ] Enable SSL/HTTPS
- [ ] Regular database backups

**Ongoing:**
- Use strong passwords
- Keep PHP/MySQL updated
- Monitor login activity
- Backup weekly

---

## 📞 SUPPORT

**Email:** dktrading1985@gmail.com  
**Phone:** +94 77 7268284  

**Support Included:**
- Installation assistance (1 hour)
- Bug fixes (lifetime)
- Email support (90 days)

---

## 🎯 QUICK REFERENCE

| Task | URL/Location |
|------|--------------|
| Login | /app/system-login.html |
| Admin Dashboard | /admin/dashboard.html |
| Database Config | /backend/config/database.php |

**Default Admin:**
```
Email: admin@productionplannerpro.com
Password: Admin@123456
```

**Change this password immediately after login!**

---

## ✅ INSTALLATION COMPLETE!

You now have a fully functional $2,000 manufacturing ERP system!

**Next Steps:**
1. Change default password
2. Create your admin account
3. Add team members
4. Start using the system!

**Questions?** Contact support anytime!

---

**Congratulations on your purchase! 🎉**

_Last Updated: February 18, 2026_