mpa/logisticsAPI
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0b8c8794c62bab0e5b55d92363c693e0c6416fcd
logisticsAPI/README.md
Marvin 4b2f172e2a Enhance documentation and improve API configuration 
- Added VPN connection requirement to README.md for local access to the Logistics API.
- Updated documentation_api_logistics.md to clarify usage environments and provide detailed connection instructions.
- Modified update-documentation.mdc to include guidelines on handling sensitive information in examples.
- Implemented automatic heading ID generation in Documentation.php for better navigation in the documentation.
- Updated logistics.php configuration to include default values for base URL, API key, and folder.
- Added support contact information in the dashboard view for API-related issues.
2026-02-20 14:56:38 +01:00

2.5 KiB
Raw Blame History

API Logistics

Application Laravel 12 de test pour comprendre et documenter l'API Logistics (Flex/ESI Gescom). Elle fournit un dashboard Filament v5 permettant d'interroger les différents endpoints de l'API.

Prérequis

  • PHP 8.4+
  • Composer
  • Node.js et npm
  • MySQL
  • Connexion VPN vers ESI Cloud (obligatoire pour communiquer avec le serveur Logistics depuis un poste local)

Installation

git clone <repo-url>
cd api-logistics
composer install
npm install
cp .env.example .env
php artisan key:generate

Configuration

Base de données

Créer une base de données MySQL nommée api_logistics, puis configurer le fichier .env :

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=api_logistics
DB_USERNAME=root
DB_PASSWORD=

Exécuter les migrations :

php artisan migrate

API Logistics

Configurer la connexion à l'API Logistics dans le fichier .env :

LOGISTICS_API_BASE_URL=http://tse-10-test.esiweb.pro
LOGISTICS_API_KEY=votre-cle-api
LOGISTICS_API_FOLDER=esigescom
  • LOGISTICS_API_BASE_URL : URL de base du serveur Logistics
  • LOGISTICS_API_KEY : Clé API transmise via le header X-API-KEY
  • LOGISTICS_API_FOLDER : Nom du dossier (en minuscules) utilisé dans les routes de l'API

Démarrage

npm run build

L'application est disponible à l'adresse http://api-logistics.test.

Le dashboard Filament est accessible à l'adresse http://api-logistics.test/admin.

Structure du dashboard

Le dashboard Filament propose les pages suivantes :

  • Documentation : Documentation de l'API Logistics
  • Tables : Explorer les tables disponibles dans l'API et visualiser leurs colonnes
  • Articles : Rechercher des articles et vérifier le stock
  • Documents : Lister des documents et consulter leurs détails
  • Journaux : Rechercher et lister les journaux
  • Tiers : Rechercher des tiers et consulter l'historique des articles

Architecture technique

  • config/logistics.php : Configuration de l'API Logistics
  • app/Services/LogisticsService.php : Service centralisé pour les appels HTTP vers l'API
  • app/Filament/Pages/ : Pages Filament du dashboard
  • database/migrations/ : Migrations incluant la table api_request_logs pour le suivi des requêtes

Documentation de l'API

Tests

php artisan test --compact

Formatage du code

vendor/bin/pint