story-research-zapwall/docs/commissions.md
Nicolas Cantu f7bd7faa73 fix: Correction erreurs TypeScript, nettoyage et réorganisation documentation
- Correction toutes erreurs TypeScript :
  - Variables non utilisées supprimées
  - Types optionnels corrigés (exactOptionalPropertyTypes)
  - Imports corrigés (PLATFORM_BITCOIN_ADDRESS depuis platformConfig)
  - Gestion correcte des propriétés optionnelles

- Suppression fichiers obsolètes :
  - code-cleanup-summary.md (redondant)
  - todo-implementation*.md (todos obsolètes)
  - corrections-completed.md, fallbacks-found.md (corrections faites)
  - implementation-summary.md (redondant)
  - documentation-plan.md (plan, pas documentation)

- Suppression scripts temporaires :
  - add-ssh-key.sh
  - add-ssh-key-plink.sh

- Réorganisation documentation dans docs/ :
  - architecture.md (nouveau)
  - commissions.md (nouveau)
  - implementation-summary.md
  - remaining-tasks.md
  - split-and-transfer.md
  - commission-system.md
  - commission-implementation.md
  - content-delivery-verification.md

Toutes erreurs TypeScript corrigées, documentation centralisée.
2025-12-27 21:25:19 +01:00

43 lines
1.4 KiB
Markdown

# Système de commissions
**Auteur** : Équipe 4NK
## Configuration
Les commissions sont centralisées dans `lib/platformCommissions.ts` :
- **Articles** : 800 sats total (700 auteur, 100 plateforme)
- **Avis** : 70 sats total (49 reviewer, 21 plateforme)
- **Sponsoring** : 0.046 BTC total (0.042 auteur, 0.004 plateforme)
## Implémentation
### Articles
- Validation du montant à chaque étape
- Tracking avec `author_amount` et `platform_commission`
- Récupération automatique de l'adresse Lightning de l'auteur
- Transfert automatique déclenché (nécessite nœud Lightning)
### Sponsoring
- Vérification des transactions Bitcoin via mempool.space
- Validation des sorties (auteur + plateforme)
- Tracking sur Nostr avec confirmations
### Avis
- Mise à jour de l'événement Nostr avec tags `rewarded` et `reward_amount`
- Récupération automatique de l'adresse Lightning du reviewer
- Transfert automatique déclenché (nécessite nœud Lightning)
## Tracking
Tous les paiements sont trackés sur Nostr via des événements personnalisés :
- **Kind 30078** : Livraisons de contenu
- **Kind 30079** : Paiements de sponsoring
Ces événements permettent un audit complet et une traçabilité totale.
## Limitations actuelles
Les transferts Lightning automatiques nécessitent un nœud Lightning de la plateforme. Actuellement, les transferts sont loggés et peuvent être exécutés manuellement.