# 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.*