From 834c220d316e80d2ccd8671620995d433bf79944 Mon Sep 17 00:00:00 2001
From: Hamza-Ayed <hamzaayedflutter@gmail.com>
Date: Thu, 16 Apr 2026 19:43:25 +0300
Subject: [PATCH] Commercial Roadmap & Future Enhancements 04-16-4

---
 COMMERCIAL_ROADMAP.md | 55 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 COMMERCIAL_ROADMAP.md

diff --git a/COMMERCIAL_ROADMAP.md b/COMMERCIAL_ROADMAP.md
new file mode 100644
index 0000000..54dbd0a
--- /dev/null
+++ b/COMMERCIAL_ROADMAP.md
@@ -0,0 +1,55 @@
+# Commercial Roadmap & Future Enhancements (Intaleq Map Platform)
+
+This document outlines the planned improvements to transition the Intaleq Map Platform into a high-performance, commercial-grade SaaS product.
+
+---
+
+## 🔒 Phase 1: API Security & Granular Scoping
+
+### Goal: Enhance security by limiting API key access and hardening administrative endpoints.
+
+- **API Key Scopes:** Add a `scopes` column to the `api_keys` table.
+  - Supported scopes: `maps`, `geocoding`, `routing`, `telemetry`.
+  - Enforcement: Update `ApiKeyGuard` to check for required scopes before allowing access.
+- **Admin Hardening:** Ensure sensitive telemetry and data-sync endpoints are restricted to users with the `ADMIN` role.
+- **Key Rotation:** Implement a system to allow users to rotate their API secrets without downtime.
+
+---
+
+## 📊 Phase 2: Proactive Usage Management
+
+### Goal: Improve customer engagement and prevent service interruption through automated alerts.
+
+- **Notification Service:** Implement a service to monitor tenant usage in real-time.
+- **Threshold Alerts:** Automatically send emails when a tenant reaches specific usage milestones:
+  - **80%:** Warning – "You are approaching your limit."
+  - **90%:** Urgent – "Action required to avoid service disruption."
+  - **100%:** Critical – "Quota exceeded. Service paused until upgrade or reset."
+- **Admin Notifications:** Send high-priority alerts to the Intaleq Admin team when Enterprise tenants hit critical thresholds.
+
+---
+
+## 💼 Phase 3: Commercial & Billing Enhancements
+
+### Goal: Streamline monetization and professionalize the subscription lifecycle.
+
+- **Automated Invoicing:** Generate professional PDF invoices after every successful payment via PayMob or Binance.
+- **Subscription Lifecycle:** Add support for plan downgrades, cancellations, and grace periods for failed payments.
+- **Public Status Page:** Build a simple public page (e.g., `status.intaleq.com`) to display real-time API health and uptime.
+
+---
+
+## 🚀 Phase 4: SDK Polish & Developer Experience
+
+### Goal: Make it "effortless" for developers to build with Intaleq.
+
+- **JS SDK Enhancements:**
+  - Add native support for **Marker Clustering**.
+  - Add **Heatmap** helpers for traffic and congestion visualization.
+  - Implement a cleaner event handling system.
+- **Flutter SDK:** Bring the Flutter SDK to feature parity with the JS SDK.
+- **Interactive Documentation:** Update the portal to allow users to generate code snippets directly from their dashboard settings.
+
+---
+
+*This roadmap is a living document. We will execute these phases based on priority and user feedback.*