Known Issues & Limitations¶
This page serves as a transparent registry of current platform limitations, non-critical bugs, and technical constraints. Our engineering team is actively working on resolving high-priority items.
🛠️ Active Technical Limitations¶
| Issue ID | Description | Impact | Workaround / Status |
|---|---|---|---|
| SYS-001 | Dashboard Cache Lag: Analytics data on the main dashboard may have a 120-second delay. | Low | Expected behavior for performance. Use specific report pages for real-time data. |
| MAIL-002 | No WYSIWYG Editor: Email templates currently require manual HTML editing. | Medium | Use an external HTML editor and paste the code into the platform's editor. (Fix scheduled for v1.1.0) |
| API-003 | v1 Rate Limiting: Strict 60 req/min limit on the Offers API. | Low | Implement client-side caching in your application to reduce redundant requests. |
🚦 Maintenance Protocols¶
Platform Updates¶
- Minor Updates (v1.0.x): Usually zero-downtime. Can be applied via standard git pull and migration flows.
- Major Updates (v1.x.0): May require brief maintenance windows (10-15 minutes). We recommend performing these during low-traffic periods (Midnight - 4 AM UTC).
Database Scaling¶
When your network exceeds 250,000 recorded clicks, we recommend moving from file-based storage to high-performance database indexing and potentially introducing Redis if you haven't already. This ensures that the conversion retrieval remains under 100ms.
🐛 Reporting New Issues¶
If you encounter an issue not listed above, please report it immediately to our technical team:
- Capture Console Logs: Open your browser developer tools and screenshot any red error messages.
- Server Logs: Provide relevant snippets from
storage/logs/laravel.log. - Environment Data: Note your Platform Version, PHP Version, and active Addons.
- Send Report: https://t.me/hansaldev