🚀 Aeris - Dropshipping Business Management System

A modern, lightweight dropshipping business management system designed for solo entrepreneurs. Built with PHP, MySQL, and TailwindCSS.

✨ Features

• 📦 Product Management - Organize inventory with SKUs, pricing, and supplier information
• 📋 Order Tracking - Complete order lifecycle management from placement to delivery
• 🚚 Supplier Coordination - Track supplier orders and delivery schedules
• 📊 Analytics Dashboard - Business insights with order trends and top products
• 🔒 Secure Authentication - Username/password login with optional "remember me"
• 🛡️ Password Recovery - Security question-based password reset system
• 📱 Mobile Responsive - Works seamlessly on desktop, tablet, and mobile
• 🎨 Modern UI - Clean, intuitive interface built with TailwindCSS
• 🔍 Advanced Filtering - Powerful search and filter capabilities
• 👤 User-Specific Data - Complete data isolation between users

🎯 Target Audience

Perfect for:

• Solo dropshipping entrepreneurs
• Small e-commerce businesses
• Anyone needing simple inventory and order management
• Developers looking for a clean PHP application structure

🛠️ Technology Stack

• Backend: PHP 7.4+
• Database: MySQL 5.7+ / MariaDB 10.3+
• Frontend: HTML5, TailwindCSS, Vanilla JavaScript
• Icons: Feather Icons
• Charts: Chart.js (for analytics)

📋 Requirements

• PHP 7.4 or higher
• MySQL 5.7+ or MariaDB 10.3+
• Web server (Apache/Nginx)
• PDO PHP extension
• mod_rewrite (for Apache)

🚀 Quick Start

Option 1: Automated Setup (Recommended)

Linux/Mac:

git clone https://github.com/yourusername/aeris.git
cd aeris
chmod +x setup.sh
./setup.sh

Windows:

git clone https://github.com/yourusername/aeris.git
cd aeris
setup.bat

The setup script will:

• Create the database
• Import the schema
• Optionally add sample data
• Generate the configuration file

Option 2: Manual Setup

1. Clone the Repository

git clone https://github.com/yourusername/aeris.git
cd aeris

2. Database Setup

-- Create database
CREATE DATABASE aeris_db;

-- Import schema
mysql -u your_username -p aeris_db < database/schema.sql

-- Optional: Import sample data
mysql -u your_username -p aeris_db < examples/sample-data.sql

3. Configuration

Create config/database.php with your database credentials:

<?php
$host = 'localhost';
$port = '3306';
$dbname = 'aeris_db';
$username = 'your_username';
$password = 'your_password';

try {
    $pdo = new PDO("mysql:host=$host;port=$port;dbname=$dbname;charset=utf8mb4", $username, $password);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
} catch (PDOException $e) {
    die("Database connection failed: " . $e->getMessage());
}
?>

4. Web Server Setup

• Point your web server document root to the Aeris directory
• Copy .htaccess.example to .htaccess if using Apache
• Ensure PHP and MySQL extensions are enabled

5. First Login

• Open your browser and navigate to your domain
• If you imported sample data, login with: admin / password
• Otherwise, create your first user account through the signup page

📚 Documentation

• Installation Guide - Detailed setup instructions
• Project Overview - Architecture and design decisions

🔧 Configuration

The configuration is automatically generated by the setup scripts, but you can manually edit config/database.php if needed.

Security Features

• Password hashing with PHP's password_hash()
• SQL injection protection with prepared statements
• CSRF protection on all forms
• Security question-based password recovery
• Session security with regeneration
• Secure file uploads (if implemented)

📊 Features Overview

Product Management

• Add, edit, delete products
• SKU management
• Cost and selling price tracking
• Stock level monitoring
• Supplier information
• Product images via URLs

Order Management

• Customer order tracking
• Order status workflow
• Automatic stock updates
• Order filtering and search
• Bulk operations
• Order history

Supplier Management

• Supplier order coordination
• Delivery tracking
• Order references
• Status updates

Analytics

• Daily/monthly order statistics
• Top-performing products
• Revenue tracking
• Order status breakdown
• Visual charts and graphs

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

# Clone the repository
git clone https://github.com/yourusername/aeris.git

# Set up local development environment
# Follow installation instructions above

# Make your changes
# Submit a pull request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🐛 Bug Reports

Found a bug? Please open an issue on GitHub with:

• Clear description of the problem
• Steps to reproduce
• Expected vs actual behavior
• Your PHP/MySQL versions

💡 Feature Requests

Have an idea for a new feature? Open an issue with:

• Clear description of the feature
• Use case explanation
• Any mockups or examples

🙏 Acknowledgments

• TailwindCSS - For the beautiful UI framework
• Feather Icons - For the clean icon set
• Unsplash - For product placeholder images
• All contributors and users of Aeris

📧 Support

• 📖 Documentation: Check the docs/ directory
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

🔄 Version History

v1.0.0 (Current)

• ✅ Complete dropshipping management system
• ✅ User authentication with password recovery
• ✅ Product, order, and supplier management
• ✅ Analytics dashboard
• ✅ Advanced filtering system
• ✅ Mobile-responsive design

---

Built with ❤️ for the dropshipping community

Aeris - Streamline Your Dropshipping Business