Skip to content

CARGE_SYSTEM_OVERVIEW.md

Latest commit

 

History

History
94 lines (75 loc) · 4.33 KB

CARGE_SYSTEM_OVERVIEW.md

File metadata and controls

94 lines (75 loc) · 4.33 KB

Carge - Système de Workflows Décentralisés avec Garanties Cryptographiques

Vue d'ensemble

Carge est une plateforme décentralisée qui permet aux humains et aux IA de collaborer sur des workflows réglementaires avec des garanties cryptographiques vérifiables.

Architecture

1. Carge.fr - L'Interface DApp

  • Nature : Application web décentralisée (DApp) qui s'exécute entièrement en local dans le navigateur
  • Technologie : React avec Helia (IPFS en JavaScript) pour le stockage décentralisé
  • Localisation : /home/polycrate/projets/carge-react/src/lib/core
  • Particularité : Pas de serveur backend traditionnel - la blockchain est le backend

2. RagChain - La Blockchain Backend

  • Rôle : Stocke les réglementations sous forme de RAG (Retrieval-Augmented Generation)
  • Localisation : /home/polycrate/projets/RagChain
  • Concept clé : Une "source de vérité unique" pour les règles réglementaires
  • Contenu :
    • Métadonnées RAG (instructions, ressources, schémas JSON)
    • CIDs IPFS pointant vers le contenu
    • Trails cryptographiques des exécutions

3. Human Context Protocol - Le MCP

  • Fonction : Traduit l'information humaine en données structurées via RAG on-chain
  • Localisation : /home/polycrate/projets/human-context-protocol
  • Technologie :
    • MCP Server (Model Context Protocol)
    • Helia 5.x pour IPFS/P2P
    • Blockstore-level pour la persistance
    • @dedot/api pour la connexion blockchain
  • Outils MCP :
    • Gestion des workflows (start_workflow, complete_step)
    • Stockage/récupération IPFS (ipfs_depose, ipfs_retrieve)
    • Recherche de RAG (search_rag_by_tags)
    • Élicitations maïeutiques (send_elicitation, process_elicitation)

Fonctionnement

Le Concept de RAG On-Chain

  • Les réglementations sont déposées sur la blockchain sous forme de RAG metadata
  • Chaque RAG contient :
    • Instructions : Guide pour les humains/IA
    • Ressources : Documentation, exemples, FAQ
    • Schéma JSON : Structure de données attendue
  • Cela garantit que tous (humains et IA) suivent les mêmes règles

Workflows Humain-IA

  1. Un workflow réglementaire est déclenché (ex: enregistrement de copyright)
  2. L'IA (via Claude Desktop + MCP) guide l'humain à travers les étapes
  3. L'IA utilise les RAG on-chain pour structurer les réponses de l'humain
  4. Chaque étape génère une preuve cryptographique vérifiable
  5. Le résultat final est stocké sur IPFS et enregistré dans la blockchain

Garanties Cryptographiques

  • Traçabilité : Chaque action génère un "crypto trail" sur la blockchain
  • Preuves : Fichiers JSON avec signatures, CIDs IPFS, et hashes blockchain
  • Audit : Toutes les étapes sont vérifiables a posteriori
  • Intégrité : IPFS garantit que le contenu n'a pas été modifié

Cas d'usage typique : Copyright Registration

1. Claude (via MCP) cherche le RAG "copyright" on-chain
2. Claude demande : "Quel est le titre de votre œuvre ?"
3. Humain répond : "Mon Application"
4. Claude structure la réponse selon le schéma JSON du RAG
5. L'étape est complétée, une preuve est générée
6. Le workflow continue automatiquement vers l'étape suivante
7. À la fin, le copyright est enregistré avec preuves blockchain

Points Clés

  • ✅ Décentralisé : Pas de serveur central, tout est distribué
  • ✅ Local-first : L'application s'exécute dans le navigateur
  • ✅ Blockchain = Backend : RagChain stocke les règles et les preuves
  • ✅ RAG = Réglementation : Format structuré pour instructions + schémas
  • ✅ Humain + IA : Collaboration guidée par des workflows
  • ✅ Vérifiable : Chaque action a une preuve cryptographique
  • ✅ IPFS : Stockage permanent et immuable du contenu

Technologies

  • Frontend : React, Helia (IPFS), WebRTC
  • Blockchain : Substrate (RagChain)
  • MCP : TypeScript, @dedot/api, libp2p
  • Persistance : blockstore-level (LevelDB)
  • Cryptographie : @noble/curves, @noble/hashes, chacha20poly1305

Avantage Principal

Conformité réglementaire vérifiable : Quand un humain ou une IA exécute un processus réglementaire (déclaration, enregistrement, certification), le RAG on-chain garantit que les bonnes règles sont suivies, et la blockchain prouve que ça a été fait correctement.