Looking to hire Laravel developers? Try LaraJobs

metrics-dash-laravel maintained by mitantsoa1

Description
SDK Laravel pour MetricsDash Enterprise avec interface d'administration embarquée de mappage dynamique BDD (/metrics-dash)
Author
MetricsDash Team
Last update
2026/08/03 15:43 (dev-main)
License
MIT
Links
GitHub - Packagist
Downloads
0

dev-main

Last update
2026/08/03 15:43
License
MIT
Require
  • php ^8.2
  • illuminate/support ^11.0|^12.0
  • illuminate/http ^11.0|^12.0
  • illuminate/database ^11.0|^12.0
  • illuminate/routing ^11.0|^12.0
v1.0.0

Last update
2026/08/03 15:43
License
MIT
Require
  • php ^8.2
  • illuminate/support ^11.0|^12.0
  • illuminate/http ^11.0|^12.0
  • illuminate/database ^11.0|^12.0
  • illuminate/routing ^11.0|^12.0
Comments
comments powered by Disqus

MetricsDash Laravel SDK ⚡

Latest Version on Packagist Total Downloads License

MetricsDash SDK est l'extension officielle Laravel pour intégrer n'importe quelle application Laravel (SaaS, E-commerce, Marketplace) au moteur d'analyse et de tableau de bord MetricsDash Enterprise.

Il inclut une interface d'administration embarquée de mappage dynamique BDD accessible directement à l'adresse /metrics-dash sans nécessiter aucune migration ni modification de votre schéma de base de données existant.

💡 Caractéristiques Principales

  • 🔌 Intégration Sans Migration : Fonctionne sur vos tables BDD existantes (payments, orders, packs, plans, users, etc.).
  • 🎨 Interface d'Admin Embarquée (/metrics-dash) : Mappage visuel des tables et colonnes réelles en 3 clics.
  • 👤 Identification des Acheteurs : Jointure automatique avec la table des utilisateurs pour faire remonter le Nom et l'Email de l'acheteur dans /dashboard/analytics.
  • 📦 Ventilation par Offres & Packages : Analyse en temps réel du Chiffre d'Affaires (CA), MRR et Panier Moyen (AOV).
  • ⚡ Synchronisation Automatique : Commande Artisan php artisan metrics-dash:sync et déclenchement programmable pour vos tâches planifiées.

🛠️ Installation

Installez le package via Composer dans votre projet Laravel client :

composer require metrics-dash/laravel

1. Publier la configuration (Optionnel)

php artisan vendor:publish --tag=metrics-dash-config

Cela créera le fichier de configuration config/metrics-dash.php.

⚙️ Configuration Environment (.env)

Ajoutez vos clés d'API dans votre fichier .env :

METRICSDASH_API_URL=https://votre-instance-metricsdash.com
METRICSDASH_PUSH_KEY=votre_cle_secret_push
METRICSDASH_SDK_KEY=votre_cle_sdk_client

🖥️ Utilisation de l'Interface de Mappage (/metrics-dash)

  1. Accédez à l'URL d'administration de votre application backend :

    http://votre-domaine-backend/metrics-dash

  2. Sélectionnez vos 3 tables BDD réelles :

    • Table 1 : Paiements & Transactions (ex: payments, amount, currency, status=paid, user_id, pack_id).
    • Table 2 : Packages & Abonnements (ex: packs, id, name, price).
    • Table 3 : Utilisateurs & Clients (ex: users, id, name, email).

  3. Cliquez sur "Sauvegarder & Prévisualiser" puis "Synchroniser les Ventes Vers MetricsDash".

⚡ Synchronisation Planifiée (Cron / Scheduler)

Vous pouvez exécuter la synchronisation des données financières en tâche de fond via la commande Artisan :

php artisan metrics-dash:sync

Ou l'ajouter dans app/Console/Kernel.php ou routes/console.php :

use Illuminate\Support\Facades\Schedule;

Schedule::command('metrics-dash:sync')->hourly();

🧪 Tests

vendor/bin/phpunit

📜 Licence

Ce package est sous licence MIT.