# Guide de publication d'articles

Ce guide vous explique comment publier un article sur Nostr Paywall avec un aperçu gratuit et un contenu payant.

## Prérequis

Avant de publier un article, vous devez avoir :

1. ✅ **Un portefeuille Nostr** (pour vous connecter et signer les événements)
2. ✅ **Alby installé** (pour créer l'invoice Lightning)
3. ✅ **Des fonds dans votre portefeuille Lightning** (optionnel, mais recommandé pour tester)

## Étapes de publication

### 1. Se connecter avec Nostr

1. Cliquez sur **"Connect with Nostr"** en haut à droite
2. Autorisez la connexion avec votre portefeuille Nostr
3. Vérifiez que votre profil s'affiche correctement

### 2. Accéder à la page de publication

1. Cliquez sur **"Publish Article"** dans le menu principal
2. Vous serez redirigé vers la page `/publish`

### 3. Remplir le formulaire

Le formulaire contient 4 champs :

#### Titre (obligatoire)
- Le titre de votre article
- Visible par tous dans la liste des articles
- Exemple : "Introduction à Nostr"

#### Preview / Aperçu (obligatoire)
- Le contenu gratuit visible par tous
- C'est ce que les lecteurs verront avant de payer
- Doit être suffisamment intéressant pour inciter à payer
- Exemple : "Découvrez les bases du protocole Nostr et comment il révolutionne les réseaux sociaux décentralisés..."

#### Content / Contenu complet (obligatoire)
- Le contenu complet qui sera débloqué après paiement
- Envoyé via message privé chiffré (NIP-04) après paiement
- Peut contenir du texte, des images (liens), etc.
- Exemple : "Nostr est un protocole de réseau social décentralisé basé sur des clés cryptographiques..."

#### Sponsoring / Montant de sponsoring
- Le montant de sponsoring est fixe : **800 sats** (satoshi)
- 1 BTC = 100 000 000 sats
- 800 sats = environ 0,000008 BTC
- Tous les articles ont le même montant de sponsoring

### 4. Publier l'article

1. Cliquez sur le bouton **"Publish"**
2. Si Alby n'est pas installé, vous serez invité à l'installer
3. **Autorisez la création de l'invoice Lightning** dans Alby
4. L'invoice sera créée automatiquement
5. Votre article sera publié sur le relay Nostr

### 5. Confirmation

Une fois publié, vous verrez :
- ✅ Un message de confirmation "Article Published!"
- Vous serez automatiquement redirigé vers la page d'accueil après 2 secondes
- Votre article apparaîtra dans la liste des articles

## Comment ça fonctionne techniquement

### 1. Publication de l'aperçu

L'aperçu est publié comme un **événement Nostr de type 1** (note textuelle) avec les tags suivants :
- `title` : Le titre de l'article
- `preview` : L'aperçu gratuit
- `zap` : Le montant de sponsoring en sats (800 sats)
- `content-type` : "article"
- `invoice` : L'invoice Lightning (BOLT11)
- `payment_hash` : Le hash de l'invoice

### 2. Création de l'invoice

L'invoice Lightning est créée via Alby/WebLN lors de la publication :
- **Montant** : 800 sats (montant fixe pour tous les articles)
- **Description** : "Payment for article: {titre}"
- **Expiration** : 24 heures

### 3. Stockage du contenu complet

Le contenu complet est stocké localement dans votre navigateur (IndexedDB) :
- Associé à l'ID de l'article
- Expire après 30 jours
- Utilisé pour envoyer le contenu après paiement

### 4. Envoi du contenu après paiement

Quand un lecteur paie :
1. Le paiement est vérifié via les reçus de zap Nostr (NIP-57)
2. Le contenu complet est envoyé via **message privé chiffré (NIP-04)**
3. Le message privé contient :
   - Le contenu chiffré
   - Un tag `e` liant à l'article
   - Un tag `p` avec la clé publique du destinataire

## Conseils pour bien publier

### Écrire un bon aperçu

L'aperçu est crucial pour inciter les lecteurs à payer :
- ✅ Donnez un avant-goût du contenu complet
- ✅ Posez une question ou créez de la curiosité
- ✅ Mentionnez les points clés qui seront développés
- ❌ Ne révélez pas tout le contenu
- ❌ Ne soyez pas trop vague

**Exemple d'aperçu efficace** :
> "Découvrez comment Nostr révolutionne les réseaux sociaux en éliminant les serveurs centralisés. Dans cet article, nous explorerons l'architecture du protocole, les avantages de la décentralisation, et comment créer votre première application Nostr. Vous apprendrez également à implémenter des paiements Lightning directement dans vos applications."

### Montant de sponsoring

Le montant de sponsoring est fixe à **800 sats** pour tous les articles. Cela simplifie l'expérience utilisateur et garantit une tarification équitable.

### Contenu de qualité

Le contenu complet doit :
- ✅ Être substantiel et apporter de la valeur
- ✅ Justifier le montant de sponsoring de 800 sats
- ✅ Être bien formaté et lisible
- ✅ Inclure des exemples ou des illustrations si pertinent

## Gestion des articles publiés

### Voir vos articles

1. Cliquez sur votre **profil** (nom/avatar en haut à droite)
2. La section "My Articles" affiche tous vos articles
3. Vous pouvez rechercher et filtrer vos articles

### Statistiques

Actuellement, vous pouvez voir :
- Le nombre d'articles publiés
- Les notifications de paiements reçus

> **Note** : Des statistiques plus détaillées (vues, revenus, etc.) seront ajoutées dans une future version.

### Édition et suppression

> **Note** : L'édition et la suppression d'articles ne sont pas encore disponibles. Les événements Nostr sont immutables, donc une fois publié, un article ne peut pas être modifié. Cette fonctionnalité sera ajoutée dans une future version.

## Dépannage

### Je ne peux pas publier

**Vérifiez** :
- ✅ Que vous êtes connecté avec Nostr
- ✅ Que votre portefeuille Nostr peut signer des événements
- ✅ Que Alby est installé et activé
- ✅ Que tous les champs sont remplis

### L'invoice ne se crée pas

**Vérifiez** :
- ✅ Que Alby est installé
- ✅ Que vous avez autorisé l'application dans Alby
- ✅ Que votre portefeuille Lightning a des fonds (optionnel)
- ✅ Votre connexion internet

### L'article ne s'affiche pas après publication

**Vérifiez** :
- ✅ Que le relay Nostr est accessible
- ✅ Rafraîchissez la page
- ✅ Vérifiez la console du navigateur pour les erreurs

### Je ne reçois pas les paiements

**Vérifiez** :
- ✅ Que les lecteurs paient effectivement
- ✅ Vos notifications (badge en haut à droite)
- ✅ Votre portefeuille Lightning
- ✅ Que l'invoice n'a pas expiré

## Bonnes pratiques

### Fréquence de publication

- Publiez régulièrement pour maintenir l'engagement
- Ne publiez pas trop souvent (risque de spam)
- Qualité > Quantité

### Promotion

- Partagez vos articles sur d'autres plateformes Nostr
- Mentionnez vos articles dans vos notes Nostr
- Créez une communauté autour de votre contenu

### Engagement avec les lecteurs

- Répondez aux commentaires (si cette fonctionnalité est ajoutée)
- Créez du contenu de qualité qui mérite d'être payé
- Écoutez les retours de vos lecteurs

---

**Dernière mise à jour** : Décembre 2024