# 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