Sindbad~EG File Manager

# Church Membership System - Installation Guide

## Prerequisites

Before installing, ensure you have:

1. **XAMPP/WAMP/LAMP** installed with:
   - PHP 7.4 or higher
   - MySQL 5.7 or higher
   - Apache Web Server

2. **Web Browser** (Chrome, Firefox, Safari, or Edge)

## Installation Steps

### Step 1: Download and Extract

1. Extract the system files to your web server directory:
   - **XAMPP**: `C:\xampp\htdocs\copmadinaarea\`
   - **WAMP**: `C:\wamp\www\copmadinaarea\`
   - **LAMP**: `/var/www/html/copmadinaarea/`

### Step 2: Start Your Web Server

1. Open **XAMPP Control Panel** (or equivalent)
2. Start **Apache** and **MySQL** services
3. Ensure both services show green "Running" status

### Step 3: Run the Installer

1. Open your web browser
2. Navigate to: `http://localhost/copmadinaarea/install.php`
3. You will see the installation wizard

### Step 4: Database Configuration

Fill in the database details:

- **Database Host**: `localhost` (default)
- **Database Name**: `church_membership` (or your preferred name)
- **Database Username**: `root` (default for XAMPP)
- **Database Password**: (leave empty for XAMPP, or enter your password)

Click **Install System** button.

### Step 5: Installation Complete

Once installation is successful, you'll see:

**Default Superuser Credentials:**
- Email: `nabibo2@yahoo.co.uk`
- Username: `nabibo`
- Password: `password123`

⚠️ **IMPORTANT**: Change the password immediately after first login!

### Step 6: First Login

1. Click **Go to Login** button
2. Enter the default credentials
3. You'll be redirected to the dashboard

## Post-Installation Setup

### 1. Change Default Password

1. Click on your profile picture (top right)
2. Select **Profile**
3. Go to **Change Password** tab
4. Enter current password: `password123`
5. Enter and confirm new password
6. Click **Change Password**

### 2. Configure System Settings

1. Navigate to **Settings** module
2. Update:
   - Site Title
   - Timezone
   - Theme Colors (if desired)
   - Enable/Disable features

### 3. Set Up Organization Structure

#### Add Areas:
1. Go to **Administration** > **Manage Areas**
2. Click **Add New Area**
3. Fill in area details
4. Save

#### Add Districts:
1. Go to **Administration** > **Manage Districts**
2. Click **Add New District**
3. Select the parent Area
4. Fill in district details
5. Save

#### Add Assemblies:
1. Go to **Administration** > **Manage Assemblies**
2. Click **Add New Assembly**
3. Select Area and District
4. Fill in assembly details
5. Save

### 4. Create Users

1. Go to **User Management**
2. Click **Add New User**
3. Fill in user details:
   - Username, Email, Password
   - Access Level (Area, District, or Assembly)
   - Assign to appropriate location
4. Save

### 5. Add Members

1. Go to **Membership** module
2. Click **Add New Member**
3. Fill in all required fields
4. Save

## Troubleshooting

### Issue: Installation page shows blank

**Solution:**
- Ensure PHP is enabled in Apache
- Check PHP version: `php -v` (must be 7.4+)
- Restart Apache service

### Issue: Database connection failed

**Solution:**
- Verify MySQL is running
- Check database credentials
- Ensure database user has proper permissions

### Issue: Can't login after installation

**Solution:**
- Clear browser cache and cookies
- Try different browser
- Verify database was created properly
- Check if `users` table has the superuser record

### Issue: Page not found (404)

**Solution:**
- Check `.htaccess` file exists
- Ensure `mod_rewrite` is enabled in Apache
- Verify correct folder path

### Issue: Upload folder permissions

**Solution:**
```bash
# For Linux/Mac
chmod -R 755 uploads/
chmod -R 755 config/

# For Windows
Right-click folder > Properties > Security > Edit permissions
```

## System Requirements

### Minimum Requirements:
- **PHP**: 7.4 or higher
- **MySQL**: 5.7 or higher
- **RAM**: 512 MB
- **Storage**: 100 MB
- **Browser**: Modern browser with JavaScript enabled

### Recommended Requirements:
- **PHP**: 8.0 or higher
- **MySQL**: 8.0 or higher
- **RAM**: 2 GB
- **Storage**: 1 GB
- **Browser**: Latest Chrome, Firefox, or Edge

## Security Notes

1. **Change default credentials immediately**
2. **Use strong passwords** for all accounts
3. **Regularly backup** your database
4. **Keep PHP and MySQL updated**
5. **Set proper file permissions** on sensitive directories
6. **Enable SSL/HTTPS** for production environments

## File Permissions (Linux/Mac)

```bash
# Application files
chmod 644 *.php
chmod 755 modules/
chmod 755 api/

# Writable directories
chmod 755 uploads/
chmod 755 config/

# Protected files
chmod 600 config/database.php
chmod 600 config/.installed
```

## Next Steps

1. ✅ Complete installation
2. ✅ Change default password
3. ✅ Configure settings
4. ✅ Set up organization structure
5. ✅ Create user accounts
6. ✅ Start adding members
7. ✅ Generate reports

## Support

For technical support or issues:
- Check the README.md file
- Review system logs in the Audit module
- Contact your system administrator

## Version Information

- **Version**: 1.0.0
- **Release Date**: October 2025
- **PHP Version**: 7.4+
- **Database**: MySQL 5.7+

---

**Congratulations!** Your Church Membership System is now ready to use.