majdocrendu

tokenizerRendu/documentation/README.md

@@ -72,6 +72,11 @@ Obtenir du **tBNB** : faucet BNB Chain testnet ou canaux officiels (Telegram @bn
 
 ## 3. Guide d’utilisation
 
+### MetaMask — rôle dans ce projet
+
+**MetaMask** est une extension navigateur qui joue le rôle de **portefeuille (wallet)** : elle stocke tes comptes (adresses `0x…`), te permet de **signer** des transactions et d’afficher les soldes (tBNB pour le gas, FG42 après import du token).  
+Hardhat, dans `code/`, sert au **développement** (compile, tests, deploy) ; MetaMask sert à la **démo utilisateur** réelle sur BSC Testnet. Les deux utilisent le même type d’adresses EVM, mais ce dépôt ne met **jamais** la seed MetaMask dans Git — seule la clé du compte de deploy peut aller dans `code/.env` local pour Ignition.
+
 ### 3.1 Importer FG42 dans MetaMask
 
 1. Ouvrir MetaMask sur le réseau **BNB Smart Chain Testnet**.
@@ -117,6 +122,39 @@ Pour le modèle technique (Hardhat, OpenZeppelin, choix BSC), voir le [README ra
 
 ---
 
-## 5. Whitepaper (optionnel)
+## 5. Whitepaper léger (rôle, fonctionnalités, limites)
 
-Un document `WHITEPAPER.md` peut compléter cette page (vision, limites, public cible). Non requis si cette documentation reste complète.
+### Vision
+
+**FGC42Forge (FG42)** est un jeton **BEP-20** pédagogique : il montre comment un actif numérique **fongible** vit on-chain (supply, transfers, lecture via wallet et explorateur), dans le respect du sujet 42 *Tokenizer* (testnet, nom avec **42**, pas d’argent réel).
+
+### Fonctionnalités
+
+| Fonction | Disponible | Détail |
+|----------|------------|--------|
+| `name` / `symbol` / `decimals` | Oui | FGC42Forge, FG42, 18 |
+| `totalSupply` / `balanceOf` | Oui | Supply fixe 1 000 000 |
+| `transfer` / `approve` / `transferFrom` | Oui | Standard ERC-20 (BEP-20 sur BSC) |
+| Mint public après deploy | **Non** | Offre figée au constructeur |
+| Burn | Non | Non implémenté |
+| Pause / blacklist | Non | Hors périmètre |
+| Multisig (bonus sujet) | Non | Non retenu — voir README racine |
+
+### Public cible
+
+- Évaluateurs et pairs : vérifier le contrat sur BscScan et tester un transfer.
+- Développeurs : cloner le dépôt, lire [`STACK-GLOSSAIRE-ET-PARCOURS.md`](STACK-GLOSSAIRE-ET-PARCOURS.md), exécuter les tests dans `code/`.
+
+### Limites
+
+- **Testnet uniquement** — aucune valeur marchande ; tBNB et FG42 sont jetons d’essai.
+- **Pas de gouvernance on-chain** avancée : seul le modèle `Ownable` OpenZeppelin (sans mint).
+- **Dépendance wallet** : l’usage humain passe par MetaMask (ou tout wallet EVM compatible) ; le gas reste en **tBNB**, pas en FG42.
+
+### Où aller plus loin dans ce dépôt
+
+| Besoin | Fichier |
+|--------|---------|
+| Outils (Hardhat, Solidity, alternatives) | [`STACK-GLOSSAIRE-ET-PARCOURS.md`](STACK-GLOSSAIRE-ET-PARCOURS.md) |
+| Choix techniques et pourquoi | [README racine](../README.md#choix-techniques) |
+| Code source commenté | [`../code/contracts/FGC42Forge.sol`](../code/contracts/FGC42Forge.sol) |