confluent/docs/GUIDE_UTILISATION.md

Guide d'utilisation - Projet Confluent

Ce guide vous explique comment utiliser le projet Confluent, un système de langue construite pour la Civilisation de la Confluence.

Qu'est-ce que le Confluent ?

Le Confluent est une langue construite (conlang) créée pour la Civilisation de la Confluence, une civilisation fictive du projet de jeu de rôle civjdr.

La langue reflète les valeurs profondes de cette civilisation :

• L'observation : "regarder avant d'agir"
• La transmission : le savoir partagé de génération en génération
• La mémoire : ne rien oublier des ancêtres et de leur sagesse
• La confluence : la force naît de la rencontre et du mélange

Le projet comprend deux composantes :

1. Une langue complète avec phonologie, morphologie, grammaire et lexique
2. Un traducteur web (ConfluentTranslator) pour traduire entre français et confluent via LLM

Installation rapide

Prérequis

• Node.js version 14 ou supérieure
• Accès à une API LLM (Anthropic Claude ou OpenAI)

Étapes d'installation

1. Cloner le dépôt

git clone <url-du-repo>
cd confluent

2. Installer les dépendances

cd ConfluentTranslator
npm install

3. Configurer les clés API

Créer un fichier .env à la racine du projet (parent de ConfluentTranslator) :

ANTHROPIC_API_KEY=votre_cle_anthropic
OPENAI_API_KEY=votre_cle_openai

4. Lancer le serveur

npm start

Le serveur démarre sur http://localhost:3000

Utiliser l'interface web

Accès

Ouvrir http://localhost:3000 dans votre navigateur.

Configuration

1. Choisir le provider LLM : Anthropic ou OpenAI
2. Sélectionner le modèle : selon le provider choisi
3. Choisir la variante de langue :
   • Proto-Confluent : langue primitive des premiers clans (phonologie réduite, syntaxe simple)
   • Ancien Confluent : langue unifiée avec liaisons sacrées et système verbal complet

Traduire

1. Entrer votre texte français dans le champ de texte
2. Cliquer sur "Traduire"
3. Le résultat apparaît avec plusieurs niveaux d'analyse :
   • Layer 1 : Traduction directe
   • Layer 2 : Analyse contextuelle
   • Layer 3 : Traduction finale avec contexte

Votre configuration est sauvegardée automatiquement dans le navigateur.

Utiliser l'API

Exemple simple de traduction

curl -X POST http://localhost:3000/translate \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Bonjour, je suis un voyageur",
    "variant": "ancien",
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20241022"
  }'

Endpoints principaux

• POST /translate - Traduction FR → Confluent
• POST /api/translate/conf2fr - Traduction Confluent → FR
• GET /api/search - Recherche dans le lexique
• POST /api/analyze/coverage - Analyse de couverture lexicale

Pour plus de détails sur l'API, consultez docs/API.md ou CLAUDE.md.

Explorer la langue

Documentation linguistique complète

La documentation de l'Ancien Confluent se trouve dans ancien-confluent/docs/ :

1. 01-PHONOLOGIE.md - Sons, consonnes, voyelles
2. 02-MORPHOLOGIE.md - Racines et liaisons sacrées
3. 03-GRAMMAIRE.md - Verbes, conjugaisons, particules
4. 04-SYNTAXE.md - Construction de phrases, négation, questions
5. 05-VOCABULAIRE.md - Lexique complet validé
6. 06-ADJECTIFS.md - Système adjectival

Consulter le lexique

Le lexique JSON complet est disponible dans :

• ancien-confluent/lexique/lexique-ancien-complet.json
• proto-confluent/lexique/lexique-proto-complet.json

Vous pouvez également consulter :

• docs/LEXIQUE_REFERENCE_CONFLUENCE.md - Vocabulaire de référence
• ancien-confluent/docs/06-LEXIQUE-COMPLET.md - Version markdown

Formules rituelles

Consultez docs/FORMULES_RITUELLES.md pour les expressions sacrées et formules de la civilisation.

Contexte culturel

Pour comprendre la civilisation et ses valeurs, lisez docs/culture/CONTEXTE_CIVILISATION.md.

Contribuer

Structure du projet

confluent/
├── ancien-confluent/          # Langue unifiée
│   ├── docs/                  # Documentation complète
│   └── lexique/               # Fichiers JSON
├── proto-confluent/           # Langue primitive
│   ├── docs/
│   └── lexique/
├── ConfluentTranslator/       # Serveur de traduction
│   ├── src/                   # Code source organisé
│   ├── public/                # Interface web
│   └── prompts/               # Prompts système LLM
├── docs/                      # Documentation générale
│   ├── culture/               # Contexte civilisationnel
│   └── archive/
└── data/                      # Données partagées

Ajouter du vocabulaire

Pour enrichir le lexique :

1. Éditer le fichier JSON approprié :

   • ancien-confluent/lexique/lexique-ancien-complet.json
   • proto-confluent/lexique/lexique-proto-complet.json

2. Respecter la structure :

{
  "mot_francais": "traduction_confluent"
}

3. Suivre les règles linguistiques :

   • Toute racine finit par CV (consonne + voyelle)
   • ~80% racines standard (commence par consonne)
   • ~20% racines sacrées (commence par voyelle)
   • Pas de majuscules en confluent
   • Consonnes autorisées : b, k, l, m, n, p, s, t, v, z
   • Voyelles : a, e, i, o, u

4. Régénérer le lexique complet (si applicable) :

cd ancien-confluent
node generer-lexique-complet.js

5. Tester :

cd ConfluentTranslator
npm start
# Puis tester la traduction via l'interface

Tests

Pour lancer les tests :

cd ConfluentTranslator/tests
# Voir scripts disponibles

Ressources utiles

Documentation technique

• CLAUDE.md - Guide pour Claude Code
• ConfluentTranslator/STRUCTURE.md - Architecture du traducteur
• ConfluentTranslator/README.md - Documentation du serveur

Documentation linguistique

• docs/SYSTEM_PROMPT_LLM.md - Prompt système complet pour LLM
• docs/SYSTEME_NUMERIQUE_BASE12.md - Système de nombres
• docs/EMOTIONS_METAPHORES.md - Vocabulaire émotionnel

Hébergement

• HEBERGEMENT.md - Guide d'hébergement complet

Support et questions

Pour toute question ou problème :

1. Consulter la documentation dans docs/ et ancien-confluent/docs/
2. Vérifier les issues existantes
3. Créer une nouvelle issue avec tag approprié

Philosophie du projet

Le Confluent n'est pas qu'une langue : c'est un artefact multi-générationnel, comme la Grande Fresque de la civilisation. Chaque contribution ajoute une couche de sens, enrichit le système, et transmet le savoir.

Comme le disent les Siliaska : "Observer, apprendre, transmettre".