✨ Overview #

We’re excited to introduce the Status Customization Feature, designed to provide advanced control over the system’s order status flow. Due to the critical nature of status transitions and workflow integrity, access to this feature is strictly limited to Super Admins and the Parallax Team.

---

🔐 1. Restricted Access Control #

To ensure secure system management:

• Access to “Add New” and “Manage” status functions is protected by strict security protocols.
• The system validates the logged-in user’s email against a secure whitelist configured in the .env file.
• Only authorized administrators can view and use status configuration controls.

---

🆕 2. Custom Status Creation #

Authorized users can now create fully customized statuses with powerful configuration options:

📝 Basic Information #

• Add a Status Name
• Add a Detailed Description

📂 Status Categorization #

Assign statuses to specific logistics phases:

• 🚚 First Mile
• 🚛 Middle Mile
• 📦 Last Mile
• 🏪 Merchant

🎨 Visual Customization #

Improve UI visibility with:

• Custom Status Colors (Success, Info, Warning, Danger, etc.)
• Custom Icons for better recognition

🔄 Status Logic (Transitions) #

Define workflow rules clearly:

• Set Before Statuses (which statuses can come before)
• Set After Statuses (which statuses can come after)

⚙️ Activation Controls #

• Mark status as Active / Inactive
• Set a Default Status for new entries

---

🛠️ 3. Advanced Status Management #

Existing statuses can now be enhanced and updated through the Manage Settings Modal:

🏷️ Custom Display Names #

• Update the Custom Name shown to users without affecting backend logic

✅ System Validation Rules #

Configure critical workflow validations such as:

• Allow / Restrict Branch Updates
• Bypass selected Status Flow Rules when needed

📌 Required Action Settings #

Make data mandatory when a status is triggered:

• 📝 Require a Reason
• ⚖️ Capture Weight
• 🛵 Assign a Rider / Delivery Rider
• 🌍 Specify Origin / Destination Cities
• 🏬 Select Origin / Destination Warehouses

---

⚠️ Important Technical Note #

To maintain a smooth and functional status workflow, Before / After statuses must always be cross-linked correctly:

• If Status B follows Status A:
  • Status A must be listed in the Before Statuses of Status B
  • Status B must be listed in the After Statuses of Status A

✅ Proper cross-linking is essential to avoid broken workflow loops and ensure system stability.

---

👥 Target Audience #

• 🛡️ Super Administrators
• 🧑‍💻 Technical Support / Parallax Backend Team

---

📍 Location #

Administration > Settings > Status