New Overseas APP Order Grabbing System | Complete Setup Guide for Chain Lock, Check-in, and Agent Permissions

Just finished deploying the new overseas APP order grabbing system for a client in Manila. This system is built with UniApp frontend and PHP backend, fully open source. The standout features include chain lock, daily check-in, task rewards, and multi-level agent permissions. This article walks through the entire deployment process including the issues I hit and how to solve them.

1. New Version System Features and Architecture

New Version APP Order Grabbing System Interface

The new version uses UniApp for cross-platform compatibility, which means one codebase deploys to iOS, Android, and H5 simultaneously. The backend is PHP with full open source, no encryption anywhere. Key features include:

  1. Check-in System: Daily check-in rewards with streak bonuses. Users who sign in 7 consecutive days unlock higher-value orders.
  2. Task System: Configurable tasks with rewards. Admins can create new task types through the backend dashboard without code changes.
  3. Chain Lock (Lian Dan Ka Dan): Multi-step order completion with incremental rewards. Users must complete orders in sequence to unlock the payout.
  4. Permission Agent: Multi-level agent system where users can become agents and earn commissions from their downline.

The agent permission system is what makes this version stand out. Unlike the previous version, agents now have granular control over commission rates, user assignment, and withdrawal limits.

2. Server Requirements and Initial Setup

Server Configuration

Here is what you need before starting the deployment:

  • PHP 8.0+ with Redis, Swoole, and fileinfo extensions
  • MySQL 8.0 or MariaDB 10.5+
  • Redis 6.0+ for session storage and queue management
  • UniApp build environment with HBuilderX
  • SSL certificate for both the API server and admin panel
  • Recommended: 4 CPU cores, 8GB RAM minimum

I used CentOS 7 with PHP 8.1 and Redis 7.0. The client wanted the APP to launch on both Android and iOS, so I set up the UniApp project with HBuilderX and configured both cloud packaging and local builds. One thing that bit me: the PHP fileinfo extension is required for image uploads but is not enabled by default on minimal PHP installations. Always run php -m | grep fileinfo to verify.

3. Troubleshooting Common Issues

3.1 UniApp build fails on Android platform

The most common issue I saw was the UniApp Android build failing with Gradle build failed errors. This usually happens when the Java JDK version is incompatible. Use JDK 11 specifically, not JDK 8 or JDK 17. I spent half a day figuring this out before downgrading to JDK 11.

3.2 Check-in reward calculation mismatch

If the check-in reward does not match the configured value, check the timezone settings in config/app.php. The default is UTC, but for Southeast Asian markets you need to set it to Asia/Manila or Asia/Bangkok. I had a bug where users were signing in twice and getting double rewards because the day boundary was at the wrong time.

3.3 Agent commission not distributing correctly

The agent commission logic uses a recursive calculation across multiple levels. If commissions are not appearing, enable SQL query logging and trace the calculation. In my case, the commission rate was being read from a cached config file instead of the database, so updates in admin panel were not taking effect.

4. Customization and Extension Options

System Extension Options

Since the full source is open, you can extend the system in many ways:

  • Push notifications: Integrate Firebase Cloud Messaging for Android or APNs for iOS to remind users about sign-in streaks.
  • Social login: Add Google, Facebook, or LINE login for easier onboarding in target markets.
  • Multi-currency: The system supports USD by default but you can add PHP, IDR, VND, or THB through the currency configuration.
  • Custom task types: Beyond check-in and orders, add video watching tasks, survey tasks, or referral tasks.

Pro Tip: Before launching, run a load test with at least 500 concurrent users. The chain lock logic creates database locks that can slow down under high concurrency. I used Apache JMeter to simulate the load and found a bottleneck in the order dispatch queue.

5. FAQ

Q1: Does UniApp support iOS App Store submission?
A: Yes. You can use cloud packaging in HBuilderX to generate IPA files, or build locally with Xcode. For App Store submission, you will need an Apple Developer account ($99/year) and to comply with their guidelines regarding in-app purchases.

Q2: Can I run this system on a Windows server?
A: While technically possible, I strongly recommend Linux (Ubuntu or CentOS) for production. Windows has compatibility issues with some PHP extensions and Redis. Most of my clients had issues when they tried Windows first and had to migrate.

Q3: How is the agent commission calculated?
A: The system uses a multi-level commission structure. Level 1 agents earn 10% of their direct downline’s task rewards. Level 2 earn 5%, and Level 3 earn 2%. These rates are configurable in the admin panel under Agent Settings.


#UniAppOrderSystem #OverseasAPPGrabbing #ChainLockAPP #AgentCommissionSystem #SigninRewardSystem