🌲

GATEX

Plateforme Régulée du Bois Gabonais

Formulaire d'inscription complet (voir documentation originale pour le HTML/JS complet)

MODE D’EMPLOI — GATEX (Gabon Timber Exchange)

1. Architecture du Système

GATEX est un plugin WordPress/WooCommerce qui crée une bourse régulée du bois gabonais avec trois types de contenus personnalisés :

Table

Type de contenu	Description
Ordres (`gatex_order`)	Offres d’achat et de vente de bois
Transactions (`gatex_trade`)	Contrats exécutés et immuables
Cotations (`gatex_price_history`)	Historique des prix

2. Types d’Ordres (Order Types)

Le système gère deux types d’ordres fondamentaux :

plain

Copy

┌─────────────────────────────────────────────────────────┐
│  🔴 ORDRE DE VENTE  (type = "sell")                     │
│     → L'opérateur propose du bois à vendre              │
│     → Affiché dans la colonne "OFFRES DE VENTE"         │
│     → Couleur : Rouge (#dc2626)                         │
├─────────────────────────────────────────────────────────┤
│  🟢 ORDRE D'ACHAT   (type = "buy")                      │
│     → L'opérateur cherche à acheter du bois             │
│     → Affiché dans la colonne "DEMANDES D'ACHAT"        │
│     → Couleur : Vert (#16a34a)                          │
└─────────────────────────────────────────────────────────┘

Cycle de vie d’un ordre :

active → Actif et visible sur le marché
partial → Partiellement exécuté (volume restant)
matched → Entièrement exécuté (transaction créée)
expired → Date d’expiration dépassée
cancelled → Annulé par l’opérateur

3. Qualités de Bois (Quality Grades)

Le système reconnaît 7 grades de qualité standardisés :

Table

Code	Nom complet	Description
FAS	First and Second	Qualité supérieure, peu de nœuds
FO	First Only	Première qualité uniquement
Merchantable	Marchand	Qualité commerciale standard
Industrial	Industriel	Usage industriel, défauts acceptés
Select	Sélection	Tri spécial, aspect premium
Heavy	Lourd	Bois dense, forte section
Figured	Figuré	Veines décoratives (Bubinga, Kevazingo)

4. Catégories d’Essences (Taxonomie)

Les essences sont classées en 4 catégories :

plain

Copy

📊 VOLUME (Production de masse)
├── Okoumé      → €485/m³ (référence)
├── Ozigo       → €420/m³
├── Ilomba      → €440/m³
├── Angélique   → €585/m³
└── Mandrille   → €320/m³

🛡️ DURABLE (Bois d'extérieur)
├── Azobé       → €695/m³
├── Bilinga     → €650/m³
└── Padouk      → €950/m³

💎 PRÉCIEUX (Bois rares)
├── Kevazingo   → €1,850/m³
├── Ovangkol    → €820/m³
└── Bubinga     → €1,150/m³

🌱 ÉMERGENT (Nouveaux marchés)
└── Andoung     → €350/m³

5. Workflow Opérateur

plain

Copy

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  INSCRIPTION    │────▶│  VALIDATION      │────▶│  AGRÉMENT       │
│  (Frontend)     │     │  (Admin DGID)    │     │  (Capacités WP) │
└─────────────────┘     └──────────────────┘     └─────────────────┘
        │                                              │
        ▼                                              ▼
   Formulaire 4 étapes                          Capacités accordées :
   • Identifiants                               • Créer des ordres
   • Entreprise (NIF/RCCM)                     • Modifier ses ordres
   • Responsable moral                          • Voir le carnet d'ordres
   • Validation                                 • Exécuter des transactions

6. Processus de Transaction

plain

Copy

Étape 1 : Création d'un ordre
    └── POST /wp-json/gatex/v1/orders
        ├── type: "sell" ou "buy"
        ├── essence: "Okoumé"
        ├── quality: "FAS"
        ├── volume: 450 (m³)
        ├── price: 485 (€/m³)
        └── location: "Libreville Port"

Étape 2 : Matching (manuel ou automatique)
    └── L'acheteur clique "Acheter" sur une offre
    └── ou l'admin crée une transaction

Étape 3 : Création de la Transaction (gatex_trade)
    └── Données verrouillées (immuables)
    ├── buyer_id + seller_id
    ├── volume_executed
    ├── price_executed
    └── flegt_reference (pour export UE)

Étape 4 : Traçabilité DGID
    └── Log d'audit automatique (7 ans conservation)
    └── Table SQL : wp_gatex_audit_log

7. Interface Administrateur

Table

Menu	Fonction
Carnet d’Ordres	Liste des ordres avec filtres (type, essence, statut)
Transactions	Contrats exécutés (lecture seule après création)
Cotations	Historique des prix
Opérateurs ⏳	Candidatures en attente d’agrément
Opérateurs ✅	Opérateurs agréés avec leurs capacités

8. Règles de Sécurité & Conformité

Immuabilité : Une transaction créée ne peut plus être modifiée
Audit trail : Toute modification d’ordre est journalisée (IP, user agent, anciennes/nouvelles valeurs)
FLEGT : Référence obligatoire pour l’export vers l’UE
Priorité locale : Opérateurs gabonais (local) favorisés en cas d’égalité
Conservation DGID : 7 ans obligatoires pour les données fiscales

9. Shortcodes WordPress

Table

Shortcode	Utilisation
`🌲 GATEX — Accès Réservé Se connecter`	Tableau de bord du marché (nécessite connexion)
`🌲 GATEX Plateforme Régulée du Bois Gabonais Formulaire d'inscription complet (voir documentation originale pour le HTML/JS complet)`	Formulaire d’inscription opérateur (4 étapes)

10. API REST Endpoints

plain

Copy

GET    /wp-json/gatex/v1/orders          → Liste des ordres actifs
POST   /wp-json/gatex/v1/orders          → Créer un ordre (auth requise)
GET    /wp-json/gatex/v1/market/prices   → Cotations temps réel
GET    /wp-json/gatex/v1/essences        → Taxonomie des essences
GET    /wp-json/gatex/v1/locations       → Lieux de livraison
POST   /wp-json/gatex/v1/register-operator → Inscription publique

Résumé : GATEX est une infrastructure de marché régulée où les opérateurs forestiers gabonais publient des ordres d’achat/vente structurés par essence, qualité et localisation, avec traçabilité fiscale complète pour la DGID et conformité FLEGT pour les exportations européennes.

Excellente question. Analysons la logique économique et réglementaire derrière cette dualité Achat/Vente dans GATEX.

Pourquoi Achat ET Vente ?

1. La Réalité du Secteur Forestier Gabonais

┌─────────────────────────────────────────────────────────────┐
│                    CHAÎNE DE VALEUR BOIS                    │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  CONCESSIONNAIRE ──▶ TRANSFORMATEUR ──▶ EXPORTATEUR       │
│     (CFL-Gabon)       (Scierie du Gabon)   (Rougier SA)   │
│        │                    │                    │          │
│        ▼                    ▼                    ▼          │
│    Vend grumes          Achète grumes        Achète sciages│
│    à la scierie         Vend sciages         Vend en UE    │
│                                                             │
│  → Chaque acteur est à la fois ACHETEUR et VENDEUR         │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Dans l’économie du bois gabonais, aucun opérateur n’est uni-directionnel :

Le concessionnaire vend des grumes mais achète des services de transport
Le transformateur achète des grumes et vend des sciages
L’exportateur achète des produits finis et vend sur les marchés internationaux
Le négociant fait les deux simultanément (arbitrage spatial/temporel)

2. Est-ce que cela ouvre la voie à la spéculation boursière ?

Oui, théoriquement. Mais GATEX intègre des garde-fous réglementaires :

Mécanisme de spéculation	Garde-fou GATEX	Efficacité
Achat sans intention de livraison	Volume minimum (1 m³) + identification NIF/RCCM	⚠️ Faible
Vente sans détention du bois	Traçabilité FLEGT obligatoire	✅ Forte
Manipulation des prix	Audit log immuable (7 ans)	✅ Forte
Trading à haute fréquence	Pas d’API temps réel, pas de levier	✅ Forte
Positions courtes (short selling)	Impossible : pas de prêt de bois	✅ Très forte

3. Différence GATEX vs Bourse Financière Classique

┌──────────────────────┬────────────────────────┬────────────────────────┐
│   CRITÈRE            │   BOURSE (NYSE, etc.)  │   GATEX                │
├──────────────────────┼────────────────────────┼────────────────────────┤
│ Actif sous-jacent    │ Actions dématérialisées│ Bois physique (m³)     │
│ Livraison            │ Rarement (cash settle) │ OBLIGATOIRE (FLEGT)    │
│ Effet de levier      │ 2x, 5x, 20x...         │ 1x (pas de levier)     │
│ Short selling        │ Autorisé               │ IMPOSSIBLE             │
│ HFT / Algorithmes    │ Dominant               │ Inexistant             │
│ Anonymat             │ Partiel                │ NUL (NIF + RCCM)       │
│ Régulateur           │ SEC/AMF                │ DGID + Min. Eaux&Forêts│
│ Settlement           │ T+2 (2 jours)          │ Livraison physique     │
└──────────────────────┴────────────────────────┴────────────────────────┘

Conclusion : GATEX est une bourse de matières premières physiques, pas une bourse financière. La spéculation « à la Wall Street » est structurellement impossible.

4. Mais il reste un risque : le NÉGOCE (Trading)

Le type d’opérateur « négociant » est explicitement prévu dans le système :

// Dans le code GATEX
'négociant' => 'Négociant',  // Couleur : #ef4444 (rouge)

Le négociant fait quoi exactement ?

Achète du bois chez le concessionnaire à Libreville
Revend le même bois à Port-Gentil avec une marge
Ou achète en janvier (basse saison) pour revendre en juin (haute saison)

C’est de la spéculation ? Oui, mais :

Spéculation spatiale (arbitrage géographique) → Légitime, améliore la liquidité
Spéculation temporelle (stockage saisonnier) → Acceptable si le bois existe réellement
Spéculation à découvert (vendre sans avoir) → Bloquée par FLEGT + traçabilité

5. Les Vrais Risques Spéculatifs dans GATEX

Risque	Description	Probabilité
Wash trading	Un opérateur s’achète à lui-même pour manipuler les prix	Moyenne (détectable via audit)
Pump and dump	Publication fausse offre pour faire monter les prix	Faible (NIF requis)
Collusion	Entente entre opérateurs pour fixer les prix	Moyenne (difficile à prouver)
Information asymétrique	Concessionnaire connaît l’offre réelle avant les autres	ÉLEVÉE (conflit structurel)

6. Recommandation Réglementaire

Pour limiter la spéculation, le système pourrait ajouter :

// Suggestion d'amélioration du code
public function validate_non_speculative_order($order_data) {
    // 1. Ratio position : un opérateur ne peut pas avoir 
    //    plus de X% du volume total d'une essence
    $max_position = 0.15; // 15% du marché

    // 2. Délai de possession minimum avant revente
    $min_holding_days = 7; // 7 jours

    // 3. Interdiction d'annulation rapide (< 24h)
    $min_order_lifetime = 86400; // secondes

    // 4. Vérification FLEGT avant mise en vente
    if ($order_data['type'] === 'sell' && empty($order_data['flegt_reference'])) {
        return new WP_Error('missing_flegt', 'Référence FLEGT requise');
    }
}

Conclusion

Question	Réponse
Pourquoi Achat + Vente ?	Parce que la chaîne du bois exige des flux bidirectionnels
Spéculation boursière possible ?	Non structurellement (pas de levier, pas de short, livraison physique obligatoire)
Négoce spéculatif possible ?	Oui, mais limité (arbitrage spatial/temporel légitime)
Risque principal ?	Collusion et information asymétrique entre concessionnaires

GATEX n’est pas une bourse financière mais une plateforme de découverte de prix pour une matière première physique et traçable. La spéculation « à la Wall Street » y est techniquement impossible, mais le négoce commercial reste nécessaire à la liquidité du marché.

Excellente question qui touche au cœur de la logique économique et réglementaire de GATEX. Analysons qui peut réalistement vendre du bois au Gabon.

Cadres Régulatoire : Vendeurs Réalistes sur GATEX

1. La Pyramide des Vendeurs Légaux au Gabon

┌─────────────────────────────────────────────────────────────┐
│                    VENDEURS LÉGAUX DE BOIS                  │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  TIER 1 : CONCESSIONNAIRES FORESTIERS                      │
│  ├── CFL-Gabon, Precious Woods, SCA Gabon                  │
│  ├── Détenteurs de **Concessions Forestières Permanentes** │
│  ├── Vendent : Grumes sur pied, grumes sciables            │
│  └── Volume : 70-80% du marché légal                       │
│                                                             │
│  TIER 2 : INDUSTRIELS / TRANSFORMATEURS                    │
│  ├── Scierie du Gabon, CFC, OLAM Gabon                     │
│  ├── Achètent grumes → transforment → revendent            │
│  ├── Vendent : Sciages, placages, contreplaqués            │
│  └── Volume : 15-20% du marché                             │
│                                                             │
│  TIER 3 : COOPÉRATIVES / PETITS EXPLOITANTS                │
│  ├── Groupements villageois, coopératives agréées          │
│  ├── Vendent : Petit bois, bois de feu, spécialités        │
│  └── Volume : 3-5% du marché                               │
│                                                             │
│  TIER 4 : NÉGOCIANTS (CAS SPÉCIAL)                         │
│  ├── Compensated Wood, Wijma Afrique                       │
│  ├── **Ne produisent pas** mais détiennent du stock        │
│  ├── Vendent : Bois acheté puis revendu avec marge         │
│  └── Volume : 2-5% du marché                               │
│                                                             │
└─────────────────────────────────────────────────────────────┘

2. Le Cas du Négociant : Spéculation ou Fonction Économique ?

Le code GATEX prévoit explicitement le type « négociant » :

'négociant' => 'Négociant',  // Couleur : rouge (#ef4444)

Mais que vend réalistement un négociant ?

Scénario	Légal ?	Réaliste ?	Risque spéculatif
Achat grumes → Stockage → Revente 6 mois plus tard	✅ Oui	✅ Oui	Faible (stockage physique)
Achat sciages → Revente immédiate à l’export	✅ Oui	✅ Oui	Moyen (arbitrage)
Vente de bois sans jamais l’avoir détenu	❌ Non	❌ Non	Spéculation pure
Vente de « droits de coupe » sans bois physique	⚠️ Gris	⚠️ Risqué	Élevé

La clé : Au Gabon, la vente de bois sans traçabilité FLEGT ou certificat d’origine est illégale pour l’export. Le négociant doit prouver la chaîne de garde.

3. Les Vendeurs « Impossibles » en Pratique

Type d’acteur	Pourquoi ne peut pas vendre sur GATEX
Particulier lambda	Pas de NIF/RCCM, pas de concession, pas de traçabilité
Transporteur	Code GATEX le prévoit, mais vend quoi ? Du « service de transport » seul
Banque / Investisseur	Pas de détention physique, pas de FLEGT
État / Ministère	Vendeur régulateur, pas opérateur commercial

Le transporteur dans GATEX est une anomalie :

'transporteur' => 'Transporteur',  // Couleur : gris (#6b7280)

Un transporteur ne produit pas de bois. Il pourrait théoriquement :

Vendre des services logistiques (pas du bois)
Être un faux négociant (acheter grumes, payer transport, revendre)

→ Le type « transporteur » dans GATEX semble être une erreur de conception ou un cas d’usage très marginal.

4. La Vraie Question : Pourquoi TANT de Types d’Opérateurs ?

Le code GATEX définit 8 types :

private function get_operator_type_label($type) {
    $labels = array(
        'concessionnaire' => 'Concessionnaire Forestier',   // Producteur primaire
        'exportateur' => 'Exportateur',                      // Vendeur final UE/Asie
        'industriel' => 'Industriel Transformateur',         // Achat grumes → vente produits
        'transformateur' => 'Transformateur Local',          // Achat grumes → vente sciages local
        'négociant' => 'Négociant',                          // Intermédiaire stock
        'transporteur' => 'Transporteur',                    // ❌ Anomalie
        'local' => 'Opérateur Local',                        // Catégorie générique
        'export' => 'Opérateur Export'                       // Catégorie générique
    );
}

Analyse critique :

Type	Rôle économique	Vendeur légitime ?
Concessionnaire	Producteur	✅ Oui (source primaire)
Industriel/Transformateur	Transformateur	✅ Oui (ajout de valeur)
Exportateur	Distributeur	✅ Oui (fin de chaîne)
Négociant	Intermédiaire	⚠️ Oui, avec garde-fous
Transporteur	Prestataire	❌ Non (ne vend pas de bois)
Local/Export	Catégories floues	⚠️ Trop vagues

5. Le Vrai Risque : La « Faussaire » Vendeuse

Le scénario spéculatif réaliste au Gabon :

┌─────────────────────────────────────────────────────────────┐
│              SCHÉMA DE "FAUSSE VENTE" ILLÉGALE              │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. Négociant s'enregistre sur GATEX                       │
│     └── Fournit NIF + RCCM (documents parfois falsifiés)   │
│                                                             │
│  2. Publie une OFFRE DE VENTE                              │
│     └── "500 m³ d'Okoumé FAS à €485/m³"                    │
│                                                             │
│  3. UN ACHETEUR (exportateur étranger) répond              │
│     └── Verse un acompte (30% = €72,750)                   │
│                                                             │
│  4. Le négociant DISPARAÎT                                 │
│     └── Pas de bois, pas de livraison, pas de remboursement│
│                                                             │
│  → ARNAQUE possible car GATEX ne vérifie pas               │
│    la PHYSICALITÉ du stock avant publication                 │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Le code GATEX ne vérifie PAS :

L’existence réelle du stock
La localisation physique du bois
La propriété légale (titre foncier forestier)

// Dans create_order_rest() — AUCUNE vérification de stock
$post_id = wp_insert_post(array(
    'post_type' => 'gatex_order',
    // ...
    'meta_input' => array(
        'order_type' => sanitize_text_field($params['order_type']),
        'volume_total' => (int)$params['volume'],  // ← On CROIT l'utilisateur
        // ...
    )
));

6. Recommandation : Restreindre les Vendeurs

Pour éviter la spéculation et la fraude, GATEX devrait :

// SUGGESTION : Restriction des vendeurs
public function can_create_sell_order($user_id) {
    $profile = get_user_meta($user_id, 'gatex_operator_profile', true);
    $type = $profile['operator_type'] ?? '';

    // SEULS ces types peuvent vendre du bois
    $allowed_sellers = array(
        'concessionnaire',      // Produit le bois
        'industriel',           // Transforme et revend
        'transformateur',       // Transforme et revend local
        'négociant'             // Mais avec VÉRIFICATION DE STOCK
    );

    if (!in_array($type, $allowed_sellers)) {
        return new WP_Error(
            'unauthorized_seller', 
            'Seuls les concessionnaires, industriels et négociants agréés peuvent vendre du bois'
        );
    }

    // Pour les négociants : vérification de stock obligatoire
    if ($type === 'négociant') {
        $stock_verified = $this->verify_physical_stock($user_id);
        if (!$stock_verified) {
            return new WP_Error(
                'missing_stock', 
                'Vérification de stock physique requise avant publication'
            );
        }
    }

    return true;
}

🏁 Conclusion

Question	Réponse
Qui peut vendre réalistement ?	Concessionnaires, industriels, transformateurs — et marginalement les négociants avec stock
Le négociant est-il un spéculateur ?	Potentiellement oui, mais sa fonction économique (liquidité, arbitrage) est légitime si le stock est réel
Le transporteur peut-il vendre ?	Non, c’est une anomalie dans le code GATEX
Le risque principal ?	Fraude à la vente : publier sans détenir le bois, via documents falsifiés
Solution ?	Vérification de stock physique avant autorisation de vente, surtout pour les négociants

Le paradoxe de GATEX : Plus on ouvre la vente à des intermédiaires (négociants), plus on liquide le marché. Mais plus on augmente le risque de spéculation et de fraude. Le juste milieu passe par une traçabilité renforcée — ce que le FLEGT et l’audit log tentent de faire, mais insuffisamment pour la physicalité du stock.

GATEX

MODE D’EMPLOI — GATEX (Gabon Timber Exchange)

1. Architecture du Système

2. Types d’Ordres (Order Types)

3. Qualités de Bois (Quality Grades)

4. Catégories d’Essences (Taxonomie)

5. Workflow Opérateur

6. Processus de Transaction

7. Interface Administrateur

8. Règles de Sécurité & Conformité

9. Shortcodes WordPress

GATEX — Accès Réservé

GATEX

10. API REST Endpoints

Pourquoi Achat ET Vente ?

1. La Réalité du Secteur Forestier Gabonais

2. Est-ce que cela ouvre la voie à la spéculation boursière ?

3. Différence GATEX vs Bourse Financière Classique

4. Mais il reste un risque : le NÉGOCE (Trading)

5. Les Vrais Risques Spéculatifs dans GATEX

6. Recommandation Réglementaire

Conclusion

Cadres Régulatoire : Vendeurs Réalistes sur GATEX

1. La Pyramide des Vendeurs Légaux au Gabon

2. Le Cas du Négociant : Spéculation ou Fonction Économique ?

3. Les Vendeurs « Impossibles » en Pratique

4. La Vraie Question : Pourquoi TANT de Types d’Opérateurs ?

5. Le Vrai Risque : La « Faussaire » Vendeuse

6. Recommandation : Restreindre les Vendeurs

🏁 Conclusion