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

1.4 KiB

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.