╔════════════════════════════════════════════════════════════════════════╗
║            UOMS ERP PROFESSIONAL INSTALLER - INSTALLATION GUIDE       ║
║                                                                        ║
║  Security Code: Mas@001                                              ║
║  No Composer Required - Standalone Installer                         ║
╚════════════════════════════════════════════════════════════════════════╝

═════════════════════════════════════════════════════════════════════════════

📋 INSTALLATION OVERVIEW

This professional installer will:
✓ Verify security code (Mas@001)
✓ Check system compatibility (PHP, extensions, directories)
✓ Accept database configuration
✓ Download & install CodeIgniter 4 automatically
✓ Create all 14 microservices
✓ Create all 14 databases
✓ Install selected plugins
✓ Provide complete dashboard

═════════════════════════════════════════════════════════════════════════════

📦 PACKAGE CONTENTS

Files Included:
1. install.php              - Main web-based installer
2. dashboard.php            - Service monitoring dashboard
3. database_setup.sql       - Complete database schema
4. INSTALLATION_GUIDE.txt   - This file
5. README.txt               - Quick reference

═════════════════════════════════════════════════════════════════════════════

🚀 QUICK START (5 MINUTES)

STEP 1: Upload Files
─────────────────────
Upload these files to your web server:
- install.php
- dashboard.php
- database_setup.sql

Example:
  scp *.php user@server:/home/username/public_html/
  scp *.sql user@server:/home/username/public_html/

STEP 2: Open Installer in Browser
──────────────────────────────────
Visit: http://yourdomain.com/install.php

STEP 3: Enter Security Code
─────────────────────────────
Enter: Mas@001

STEP 4: Check Compatibility
────────────────────────────
The installer will verify:
✓ PHP Version (requires 8.1+)
✓ Required Extensions (mysqli, pdo, json, curl, etc.)
✓ Directory Permissions
✓ Write Permissions

STEP 5: Database Configuration
───────────────────────────────
Enter your database details:
- Hostname: localhost (or your DB server)
- Port: 3306 (default)
- Username: root (or your DB user)
- Password: (your password)

STEP 6: Auto-Install
────────────────────
The installer will automatically:
1. Download CodeIgniter 4
2. Extract it to services folder
3. Create 14 microservices
4. Create 14 databases
5. Set up all configurations

STEP 7: Select Plugins
─────────────────────
Choose which plugins to install:
✓ Reports & Analytics
✓ Payment Gateway Integration
✓ SMS Notifications
✓ Email Campaigns
✓ Automatic Backup
✓ Advanced API Tools
✓ Mobile App Support
✓ Enhanced Security

STEP 8: Complete
────────────────
Installation finished! Access dashboard at:
http://yourdomain.com/dashboard.php

═════════════════════════════════════════════════════════════════════════════

💾 SYSTEM REQUIREMENTS

Minimum:
- PHP 8.1 or higher
- MySQL 5.7 or higher
- 50MB free disk space
- 256MB memory

Recommended:
- PHP 8.2+
- MySQL 8.0+
- 500MB free disk space
- 512MB+ memory

Required PHP Extensions:
✓ mysqli
✓ pdo
✓ pdo_mysql
✓ json
✓ curl
✓ gd
✓ mbstring
✓ openssl

═════════════════════════════════════════════════════════════════════════════

🔐 SECURITY INFORMATION

Security Code: Mas@001
─────────────────────

This code protects your installation from unauthorized access.

After Installation:
1. Delete or rename install.php
2. Delete or rename this guide file
3. Secure your dashboard with authentication
4. Change default database password

═════════════════════════════════════════════════════════════════════════════

📊 DATABASE INFORMATION

Automatic User Creation:
Username: uoms_user
Password: Mas@001 (changeable)

Databases Created (14):
- uoms_settings      (Users, Roles, Configuration)
- uoms_accounting    (Financial Management)
- uoms_employee      (HR & Payroll)
- uoms_inventory     (Stock Management)
- uoms_sales         (Revenue & Invoicing)
- uoms_purchasing    (Procurement)
- uoms_projects      (Project Management)
- uoms_compliance    (Tickets & Complaints)
- uoms_document      (Document Management)
- uoms_quotations    (Quotes & Pricing)
- uoms_tasks         (Task Management)
- uoms_crm           (Customer Relations)
- uoms_collaboration (Chat & Calendar)
- uoms_pos           (Point of Sale)

═════════════════════════════════════════════════════════════════════════════

🎯 14 MICROSERVICES

Each service runs on its own port and includes:
✓ BaseServiceModel & Controller
✓ Database configuration
✓ Complete directory structure
✓ Ready for customization

Port Assignments:
3001 - Settings Service
3002 - Accounting Service
3003 - Employee Service
3004 - Inventory Service
3005 - Sales Service
3006 - Purchasing Service
3007 - Projects Service
3008 - Compliance Service
3009 - Document Service
3010 - Quotations Service
3011 - Tasks Service
3012 - CRM Service
3013 - Collaboration Service
3014 - POS Service

═════════════════════════════════════════════════════════════════════════════

⚙️ AFTER INSTALLATION

STEP 1: Access Dashboard
────────────────────────
Go to: http://yourdomain.com/dashboard.php

STEP 2: Monitor Services
────────────────────────
Check which services are running
View system information
Access service logs

STEP 3: Start Using
───────────────────
Access each service:
- Settings: http://localhost:3001
- Accounting: http://localhost:3002
- (and so on...)

STEP 4: Secure Installation
────────────────────────────
☐ Delete install.php
☐ Delete installation guide
☐ Change database password
☐ Set up SSL/HTTPS
☐ Configure firewall
☐ Set up backups

═════════════════════════════════════════════════════════════════════════════

🐛 TROUBLESHOOTING

Problem: Security code rejected
Solution: Ensure you enter: Mas@001 (case-sensitive)

Problem: Compatibility check fails
Solution: Check your PHP version and install missing extensions

Problem: Database connection fails
Solution: Verify database credentials and ensure MySQL is running

Problem: CodeIgniter not downloaded
Solution: Check internet connection and firewall settings

Problem: Permission denied errors
Solution: Ensure directories are writable (chmod 755)

═════════════════════════════════════════════════════════════════════════════

📞 SUPPORT

For technical support:
1. Check this guide
2. Review error messages in logs
3. Verify system requirements
4. Check file permissions
5. Review database credentials

═════════════════════════════════════════════════════════════════════════════

✅ INSTALLATION COMPLETE!

Your UOMS ERP system is now ready to use.

Next Steps:
1. Access dashboard
2. Configure settings
3. Create users
4. Start using services

═════════════════════════════════════════════════════════════════════════════

Version: 1.0.0
Date: 2024