story-research-zapwall/docs/author-funds-specification.md
2026-01-06 20:59:59 +01:00

50 lines
1.8 KiB
Markdown

# Author Funds Collection Specification
**Author**: Équipe 4NK
**Date**: 2026-01-14
## Objectifs
1. Pour chaque auteur, collecter :
- Fonds perçus sur le mempool (Bitcoin mainnet pour sponsoring)
- Fonds perçus par la plateforme (commission)
2. Créer un lien entre :
- Paiement (zap receipt) ↔ Note de paiement ↔ Objet (publication/avis/auteur)
3. Clarification de la structure :
- **Publications** (plusieurs pages d'une série) sont les objets achetés
- **Séries** sont les objets commentés (reviews)
- **Avis/Commentaires** sont les objets récompensés (review tips)
- **Auteurs** sont les objets sponsorisés
- Les **publications** sont des notes (kind 1)
- Les **pages** sont dans le JSON des notes de publications (pas de notes séparées)
## Tags à ajouter
### Payment Notes (kind 1, type='payment')
- `publication_id` ou `article`: ID de la publication (pour achat)
- `series_id` ou `series`: ID de la série (si applicable)
- `review_id`: ID de l'avis (pour review tip)
- `author`: Pubkey de l'auteur (receveur)
- `zap_receipt`: ID du zap receipt (si Lightning)
- `transaction_id`: ID de la transaction Bitcoin (si mainnet sponsoring)
- `platform_commission`: Montant de la commission
- `author_funds`: Fonds reçus par l'auteur
### Zap Receipts (kind 9735)
Déjà présents :
- `#e`: Event ID (article ID pour purchases)
- `#p`: Pubkey (author pubkey)
- `kind_type`: Type de paiement
- `review_id`: Review ID (pour review tips)
- `series`: Series ID (optionnel)
## Prochaines étapes
1. ✅ Document de spécification créé
2. ⏳ Modifier les payment notes pour inclure les tags de liaison
3. ⏳ Créer un service pour collecter les fonds par auteur
4. ⏳ Intégrer la collecte des fonds du mempool pour sponsoring Bitcoin
5. ⏳ Créer une interface pour afficher les fonds par auteur