InvestorTracker - Professional Investment Manageme

Key Features

• Smart Analytics Dashboard: Real-time visual overview of total investments, profit margins, and asset performance.
• Transaction Management: Comprehensive tracking of deposits, withdrawals, and recurring investment logs.
• Automated PDF Reporting: Generate professional investment statements with built-in Bangla Unicode support and custom formatting.
• Hybrid One-Click Installer: A resilient setup wizard that automatically detects server capabilities (Spark CLI vs. Direct SQL Import) to prevent installation crashes.
• Database Prefix Support: Safely install InvestTracker into a shared database without affecting existing tables (e.g., WordPress or POS systems).
• Security & Performance: CSRF protection, AES-256 encryption for sensitive data, and optimized database indexing for lightning-fast queries.

Core Server Requirements

• PHP Version: PHP 8.1 or higher (PHP 8.2 / 8.3 recommended).
• Database: MySQL 5.7+ or MariaDB 10.3+.
• Web Server: Apache (with mod_rewrite enabled) or Nginx.

Required PHP Extensions

The following extensions must be enabled in your php.ini for CodeIgniter 4 and mPDF to function:

• intl: Essential for time/date localization and CI4 core operations.
• mbstring: (Critical) Required for processing Bangla Unicode and multi-byte text in reports.
• gd: Required for image handling and chart rendering within PDF reports.
• mysqli: For database connectivity.
• openssl: For secure data encryption and session handling.
• curl: For system updates or external API communication.
• zlib: Required by mPDF for PDF compression.
• dom & xml: Critical for document structure rendering.

System Configuration (php.ini)

To avoid "Blank Page" or "Timeout" errors during PDF generation or database setup:

• Memory Limit: Minimum 256MB (mPDF is resource-intensive).
• Execution Time: 60-120 seconds (Recommended for generating large reports).
• Allow_url_fopen: Should be On (for fetching logos or remote assets).
• Upload Max Filesize: 10MB+.

Directory Permissions

The following folders must have write permissions (755 or 775) for the installer and logging system:

• /writable/ (Includes cache, logs, session, uploads).
• /.env (The installer must be able to create this file).
• /install/ (The script must be able to delete this folder after completion).

Installation Instructions

Follow these 4 simple steps to get InvestTracker up and running in less than 2 minutes:

Step 1: Upload & Extract

1. Upload thesource-code.zip file to your server’s root directory (usually public_html or a subdomain folder).
2. Extract the contents of the ZIP file.
3. Ensure the /install/ folder and database.sql are present in your file manager.

Step 2: Create a Database

1. Log in to your cPanel (or hosting dashboard).
2. Go to MySQL® Databases and create a new database (e.g., invest_db).
3. Create a Database User and assign it to the database with All Privileges.
4. Keep your Database Name, Username, and Password ready.

Step 3: Update The Domain Directory

For cPanel:

1. Go to Domains.
2. Click Manage next to your domain.
3. Update the Document Root field from public_html to public_html/public.
4. Click Update.

Step 4: Run the Smart Installer

1. Open your web browser and navigate to: https://yourdomain.com/install
2. Follow the on-screen prompts:
   • Database Info: Enter the host (usually localhost), database name, user, and password.
   • Admin Settings: Provide your email and a secure password for the dashboard.
3. Click Install Now.

Step 5: Finalize & Secure

1. Once you see the "Installation Success" message, the /install/ folder will be automatically deleted for security.
2. You will be redirected to the login page.
3. Log in with your admin credentials and start tracking your investments!

Troubleshooting & Tips

• 404 Error on Login: If you get a 404 error after installation, ensure that mod_rewrite is enabled on your server and that the .htaccess file exists in your root folder.
• Blank PDF Reports: If PDF generation fails, check your PHP Memory Limit (must be 256MB+) and ensure the mbstring extension is enabled for Bangla font rendering.
• Manual Setup: If your server blocks the automated installer, a database.sql file is included in the SQL/ folder for manual import via phpMyAdmin.