Admin Panel Documentation

The Laravel Admin Panel is the control center of the TaskFlow ecosystem. It allows you to manage users, view detailed analytics, and configure critical system settings like AI and AdMob.

---

Technical Requirements

Before installing the backend, ensure your server meets these minimum requirements:

• PHP 8.2+ (Version 8.1 minimum, 8.2 recommended)
• Database: MySQL 8.0+, MariaDB 10.5+, or PostgreSQL 12+
• Extensions: OpenSSL, PDO, Mbstring, Tokenizer, JSON, cURL, Fileinfo, BCMath
• Composer: Dependency manager for PHP

---

Installation & Setup

1. Database Configuration

1. Open your hosting control panel (e.g., cPanel).
2. Create a new MySQL database (e.g., taskflow_db).
3. Create a database user, assign a strong password, and grant ALL PRIVILEGES to the database.

2. Uploading Files

1. Upload the contents of the task_flow_admin_panel folder to your server's root directory (e.g., public_html).
2. Extract the files if they are zipped.

3. Setup Wizard (Recommended)

TaskFlow includes a polished installation wizard to handle the setup for you.

1. Navigate to https://yourdomain.com/install in your browser.
2. Requirements: The wizard will automatically check your PHP version and extensions.
3. Permissions: It will verify that storage and bootstrap/cache are writable.
4. Environment: Enter your application name, URL, and database credentials.
5. Database: The wizard will run all migrations and seed demo data automatically.
6. Finish: Once complete, you can access your dashboard!

4. Manual Installation Fallback

If you prefer CLI or the wizard is unavailable:

1. Copy the environment template: cp .env.example .env
2. Generate an app key: php artisan key:generate
3. Update .env with your database credentials.
4. Run migrations and seeders:

   php artisan migrate --force
   php artisan db:seed --force

5. Clear caches: php artisan optimize:clear
6. Create the installation marker: php -r "file_exists('storage/installed') || touch('storage/installed');"

---

Admin Panel Features

Once logged in, you can manage the following sections:

Dashboard

• Quick Stats: Real-time overview of total users, active tasks, and system health.
• Recent Activity: Monitor latest user registrations and task trends.

User Management

• User List: View all registered users and their details.
• Moderation: Ban, edit, or delete users to maintain platform integrity.

Support & Feedback

• Contact Messages: Read and reply to support inquiries sent directly from the mobile app's contact form.

System Configuration

• General Settings: Update your site name, logo, and time zone.
• AI Settings: Centralized location to update your Google Gemini API Key.
• AdMob: Configure banner and interstitial ad unit IDs for the mobile app.

---

Demo Accounts

Use these credentials to test the system after a fresh seed:

Role	Email	Password
Administrator	admin@taskflow.com	password
User	user@taskflow.com	password

CAUTION

Security: Remember to change the administrator password immediately after your first login!