Mac Mini M4 Software Repository

A comprehensive web platform for Mac Mini M4 users to discover, request, and download premium macOS applications optimized for Apple Silicon M4 chip performance.

🚀 Features

Core Features

• 🗂️ Software Catalog: Curated collection of Mac M4 compatible software
• 💳 Multi-Payment Donation System: Support via PipraPay and UddoktaPay
• 📝 Software Request System: Users can request specific software
• 🏆 Top Donors Recognition: Showcase top contributors on homepage
• 📱 Responsive Design: Mobile-friendly interface
• 🔐 Admin Panel: Complete administration system

Payment System

• Dual Gateway Support: PipraPay and UddoktaPay integration
• Smart Fallback: Automatic switching to available payment methods
• Development Mode: Local testing without real API calls
• Transaction Management: Complete donation tracking and verification
• Admin Controls: Enable/disable payment methods, edit API settings

Admin Features

• Donation Dashboard: View, edit, and delete transaction records
• Payment Method Management: Configure API keys and toggle payment gateways
• Contact Management: Handle user inquiries and feedback
• Request Management: Process software requests from users
• User Authentication: Secure admin login system

🛠️ Technology Stack

• Frontend: HTML5, CSS3, JavaScript (Vanilla)
• Backend: PHP 8.0+
• Database: MySQL 8.0+
• Payment APIs: PipraPay, UddoktaPay
• Development: Laravel Herd (local), DBngin (database)

📋 Requirements

• PHP 8.0 or higher
• MySQL 8.0 or higher
• Web server (Apache/Nginx)
• cURL extension enabled
• JSON extension enabled

🔧 Installation

Local Development Setup

1. Clone the repository

   git clone https://github.com/yourusername/mac-mini-m4.git
   cd mac-mini-m4

2. Database Setup

   • Create a MySQL database named mac_software
   • Import the database structure:

   mysql -u root -p mac_software < database_backup.sql

3. Environment Configuration Create a .env file in the project root:

   DB_HOST=127.0.0.1
   DB_DATABASE=mac_software
   DB_USERNAME=root
   DB_PASSWORD=
   DB_PORT=3306
   
   # PipraPay Configuration
   PIPRAPAY_API_KEY=your_piprapay_api_key
   PIPRAPAY_BASE_URL=https://payment.webservicebd.com/api
   PIPRAPAY_ENABLED=true
   
   # UddoktaPay Configuration
   UDDOKTAPAY_API_KEY=your_uddoktapay_api_key
   UDDOKTAPAY_BASE_URL=https://pay.webservicebd.com/api
   UDDOKTAPAY_ENABLED=true

4. Admin Setup

   • Access /admin/setup-donations.php to create admin user
   • Configure payment settings in admin panel

5. Local Server

   • Use Laravel Herd: Access via https://mac-mini-m4.test
   • Or use PHP built-in server: php -S localhost:8000

📊 Database Schema

Core Tables

donations

CREATE TABLE donations (
    id INT AUTO_INCREMENT PRIMARY KEY,
    reference_id VARCHAR(100) UNIQUE NOT NULL,
    payment_id VARCHAR(100),
    amount DECIMAL(10,2) NOT NULL,
    currency VARCHAR(3) DEFAULT 'BDT',
    payment_method VARCHAR(50) DEFAULT 'unknown',
    transaction_id VARCHAR(255),
    metadata TEXT,
    donor_name VARCHAR(100) NOT NULL,
    donor_email VARCHAR(150),
    donor_phone VARCHAR(20),
    message TEXT,
    status ENUM('pending','completed','failed','cancelled') DEFAULT 'pending',
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    verified_at TIMESTAMP NULL
);

admin_users

CREATE TABLE admin_users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) UNIQUE NOT NULL,
    password VARCHAR(255) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

software_requests

CREATE TABLE software_requests (
    id INT AUTO_INCREMENT PRIMARY KEY,
    software_name VARCHAR(255) NOT NULL,
    software_version VARCHAR(50),
    additional_info TEXT,
    visitor_email VARCHAR(150) NOT NULL,
    date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    status ENUM('pending','completed','rejected') DEFAULT 'pending',
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

contact_messages

CREATE TABLE contact_messages (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    email VARCHAR(150) NOT NULL,
    message TEXT NOT NULL,
    date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

🔗 API Endpoints

Donation System

• POST /api/donate-multi.php - Process donations with multiple payment methods
• GET /api/get-payment-methods.php - Retrieve available payment methods
• GET /api/get-top-donors.php - Fetch top 5 donors for homepage display
• POST /api/verify-donation.php - Verify payment status

Request System

• POST /admin/process_request.php - Handle software requests
• POST /admin/process_contact.php - Process contact form submissions

Admin API

• POST /admin/donation-dashboard.php - Manage donations (CRUD operations)
• POST /admin/manage-payment-methods.php - Configure payment settings

🎨 Frontend Structure

Main Pages

• index.html - Homepage with software catalog and top donors
• donate.html - Donation form with payment method selection
• contact-us.html - Contact form for user inquiries
• dmca.html - DMCA takedown policy
• terms-of-service.html - Terms of service
• privacy-policy.html - Privacy policy

Admin Panel

• admin/login.php - Admin authentication
• admin/dashboard.php - Main admin dashboard
• admin/donation-dashboard.php - Donation management
• admin/manage-payment-methods.php - Payment configuration

💳 Payment Integration

PipraPay Setup

1. Obtain API key from PipraPay
2. Configure in admin panel or environment file
3. Set webhook URL: /api/webhook-piprapay.php

UddoktaPay Setup

1. Get API credentials from UddoktaPay
2. Update configuration in admin settings
3. Webhook endpoint: /api/webhook-uddoktapay.php

Development Mode

The system automatically detects local development environments and simulates payments:

• Domains: localhost, 127.0.0.1, *.local
• Excluded: mac-mini-m4.test (for real API testing)
• Test donations redirect to success page with test parameters

🔒 Security Features

• SQL Injection Protection: Prepared statements for all queries
• XSS Prevention: HTML escaping for user inputs
• Admin Authentication: Secure login with bcrypt password hashing
• Input Validation: Server-side validation for all forms
• CSRF Protection: Form token validation (recommended to implement)

📱 Mobile Responsiveness

The website is fully responsive with:

• Mobile-first design approach
• Touch-friendly interface elements
• Responsive grid layouts
• Mobile navigation menu
• Optimized images and assets

🚦 Development Mode

Local Testing Features

• Automatic test mode detection for *.test domains
• Simulated payment responses
• Test donation tracking
• Development logging
• No real API charges during testing

Read more: Development Mode Documentation

📁 Directory Structure

mac-mini-m4/
├── admin/                 # Admin panel files
│   ├── dashboard.php
│   ├── donation-dashboard.php
│   ├── manage-payment-methods.php
│   └── ...
├── api/                   # API endpoints
│   ├── donate-multi.php
│   ├── get-top-donors.php
│   ├── PipraPay.php
│   ├── UddoktaPay.php
│   └── ...
├── config/                # Configuration files
│   ├── db_config.php
│   ├── donation_config.php
│   └── ...
├── images/                # Software images and assets
├── logs/                  # Application logs
├── utils/                 # Utility scripts
├── index.html            # Homepage
├── donate.html           # Donation page
└── README.md

🔧 Configuration

Payment Methods

Access admin panel → Payment Methods to configure:

• API keys for each payment gateway
• Enable/disable payment methods
• Test payment settings

Donation Settings

• Minimum donation amount
• Currency settings (default: BDT)
• Success/cancel redirect URLs
• Webhook configurations

📊 Analytics & Logging

Log Files

• logs/donations.log - All donation attempts
• logs/donation_errors.log - Payment errors and issues
• logs/admin_actions.log - Admin panel activities
• logs/php_error.log - PHP errors and warnings

Monitoring

• Real-time donation tracking
• Payment method availability
• Error rate monitoring
• Admin activity logging

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Commit changes: git commit -am 'Add feature'
4. Push to branch: git push origin feature-name
5. Submit a pull request

📄 License

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

⚠️ Disclaimer

Educational Purpose: This software is shared purely for educational purposes. Please consider purchasing software to support developers. The repository creator does not host or store copyrighted software and found these resources online for learning purposes only.

📞 Support

• Website: https://mac-mini-m4.test (local development)
• Email: rabbi@solveez.com
• Issues: GitHub Issues

🏆 Top Contributors

The homepage showcases top donors who support the project. Become a contributor by:

• Making donations through the platform
• Contributing to the codebase
• Reporting bugs and suggesting improvements

📋 Recent Updates (v2.0)

✨ Latest Features (September 2024)

• 🎯 Multi-Payment Gateway: Added UddoktaPay alongside PipraPay
• 🏠 Homepage Redesign: Two-column layout with top donors showcase
• 📱 Phone Number Field: Added optional phone collection in donation form
• ✅ Required Fields: Made donor name and email mandatory
• 🔧 Admin Enhancements:
  • Edit donation status functionality
  • Delete transaction records
  • Payment method toggle controls
  • Real-time payment gateway configuration
• 🧪 Development Mode: Smart local testing without API charges
• 📊 Top Donors Display: Homepage recognition for contributors
• 🔒 Enhanced Security: Improved validation and error handling

🐛 Bug Fixes

• Fixed PipraPay API endpoint URL issues
• Resolved local development detection problems
• Improved mobile responsiveness
• Enhanced error messages and user feedback

🛠️ Technical Improvements

• Database schema updates for phone numbers
• Admin action logging system
• Improved AJAX error handling
• Better responsive design implementation
• Code optimization and cleanup

📊 Current Statistics

• Active Payment Methods: 1 (PipraPay)
• Supported Software: 27 applications
• Total Donors: 7+ registered donors
• Admin Features: 15+ management tools

🔮 Roadmap

Upcoming Features

• Software auto-update notifications
• User account system
• Advanced donation analytics
• Email newsletter integration
• Mobile app development
• Multi-language support

---

Made with ❤️ for the Mac M4 community