109 lines
4.0 KiB
Markdown
109 lines
4.0 KiB
Markdown
# Audit rendu — `tokenizerRendu/` (avant Vogosphere)
|
||
|
||
> Date : 2026-10-22 · Grille : [`sujet-exigences-rendu.md`](sujet-exigences-rendu.md)
|
||
|
||
## Verdict global
|
||
|
||
| Statut | Commentaire |
|
||
|--------|-------------|
|
||
| **Prêt pour push école** | Partie obligatoire couverte ; nettoyage doc + `.gitignore` effectués |
|
||
| **À faire sur machine école** | `npm install` + `npx hardhat test` ; démo MetaMask ; `git init` ou clone dédié |
|
||
|
||
---
|
||
|
||
## Conformité sujet (T1–T19)
|
||
|
||
Tous les critères obligatoires du tableau **sujet-exigences-rendu.md** sont **OK** pour FGC42Forge (nom `42`, BEP-20 testnet, 3 dossiers, README choix, deploy + adresse, doc utilisateur, code commenté, bonus documenté comme non retenu).
|
||
|
||
---
|
||
|
||
## Fichiers à **inclure** dans le dépôt Vogosphere
|
||
|
||
| Zone | Fichiers clés |
|
||
|------|----------------|
|
||
| Racine | `README.md`, `.gitignore` |
|
||
| `code/` | `contracts/FGC42Forge.sol`, tests, ignition module, `hardhat.config.ts`, `package.json`, `package-lock.json`, `.env.example`, `.gitignore`, `README.md` |
|
||
| `deployment/` | `addresses.json`, `README.md`, `BSCSCAN_VERIFICATION.md`, `FGC42Forge_flat.sol`, `addresses.json.example` |
|
||
| `documentation/` | `README.md`, `STACK-GLOSSAIRE-ET-PARCOURS.md` |
|
||
|
||
**Template Hardhat (Counter)** : présent mais documenté comme hors périmètre dans `code/README.md` — acceptable ; ne pas présenter Counter en code review.
|
||
|
||
---
|
||
|
||
## Fichiers à **ne pas** committer
|
||
|
||
| Chemin | Raison |
|
||
|--------|--------|
|
||
| `code/.env` | Clé privée |
|
||
| `code/node_modules/`, `cache/`, `artifacts/` | Générés |
|
||
| `code/ignition/deployments/` | État local Ignition (gros `build-info`) — adresses dans `deployment/addresses.json` |
|
||
| `code/.agents/`, `code/AGENTS.md` | Assistants locaux, hors sujet |
|
||
| Tout `docs/` ou `pedagogie/` | Dépôt de travail perso uniquement |
|
||
|
||
`.gitignore` racine + `code/.gitignore` mis à jour en conséquence.
|
||
|
||
---
|
||
|
||
## Écarts mineurs (non bloquants)
|
||
|
||
| Point | Action |
|
||
|-------|--------|
|
||
| `code/scripts/send-op-tx.ts` | Script template Hardhat ; ignoré à l’oral ou supprimable si tu veux un tree plus minimal |
|
||
| Tests non relancés dans cet audit (lock compilateur sandbox) | Sur ta machine : `cd code && npx hardhat test` |
|
||
| Vidéo démo | Section vide dans README — conforme (optionnel) |
|
||
|
||
---
|
||
|
||
## Liens internes rendu
|
||
|
||
Aucun lien vers `docs/pedagogie` ou dépôt parent. Liens `../deployment`, `../code` : **OK** (dans le même repo école).
|
||
|
||
## Autonomie fonctionnelle (vérification doc)
|
||
|
||
| Parcours | Suffisant dans `tokenizerRendu/` seul ? |
|
||
|----------|----------------------------------------|
|
||
| Utiliser FG42 (MetaMask + BscScan) | ✅ `documentation/README.md` |
|
||
| Comprendre stack / commandes / alternatives | ✅ `documentation/STACK-GLOSSAIRE-ET-PARCOURS.md` |
|
||
| Tests Hardhat | ✅ README racine + `code/README.md` → `cd code` + `npm install` + test |
|
||
| Token on-chain sans redeploy | ✅ adresse dans README + `deployment/addresses.json` |
|
||
| Redeploy optionnel | ✅ `deployment/README.md` + `.env.example` |
|
||
|
||
---
|
||
|
||
## Procédure Git — Vogosphere
|
||
|
||
### Option A — Dépôt **uniquement** rendu (recommandé)
|
||
|
||
Sur le PC où tu pousses vers l’intranet 42 :
|
||
|
||
```bash
|
||
cd /chemin/vers/tokenizerRendu
|
||
git init
|
||
git add README.md .gitignore code deployment documentation
|
||
git status # vérifier : pas de .env, pas de node_modules
|
||
git commit -m "Tokenizer: FGC42Forge BSC testnet"
|
||
# remote Vogosphere fourni par l’école
|
||
git remote add origin <URL_VOGOSPHERE>
|
||
git push -u origin main
|
||
```
|
||
|
||
### Option B — Même machine, dépôt perso `tokenizer/` + sous-dossier rendu
|
||
|
||
- Ne **pas** pousser la racine `tokenizer/` si elle contient `docs/`.
|
||
- Soit **Option A** dans `tokenizerRendu/`, soit branche `rendu` qui ne contient que le contenu de `tokenizerRendu/` (subtree / copie propre).
|
||
|
||
### Avant chaque push
|
||
|
||
```bash
|
||
cd code
|
||
grep -r "PRIVATE_KEY" .env 2>/dev/null && echo "STOP: .env présent" || true
|
||
git status
|
||
```
|
||
|
||
---
|
||
|
||
## Après push
|
||
|
||
1. [checklist-demo-evaluation.md](checklist-demo-evaluation.md)
|
||
2. [fiche-soutenance-tokenizer.md](fiche-soutenance-tokenizer.md) §10 (démo + oral ch. III)
|