Nicolas Cantu
90ff8282f1
- Création lib/platformCommissions.ts : configuration centralisée des commissions - Articles : 800 sats (700 auteur, 100 plateforme) - Avis : 70 sats (49 lecteur, 21 plateforme) - Sponsoring : 0.046 BTC (0.042 auteur, 0.004 plateforme) - Validation des montants à chaque étape : - Publication : vérification du montant avant publication - Paiement : vérification du montant avant acceptation - Erreurs explicites si montant incorrect - Tracking des commissions sur Nostr : - Tags author_amount et platform_commission dans événements - Interface ContentDeliveryTracking étendue - Traçabilité complète pour audit - Logs structurés avec informations de commission - Documentation complète du système Les commissions sont maintenant systématiques, validées et traçables.
279 lines
8.8 KiB
Markdown
279 lines
8.8 KiB
Markdown
# Guide d'utilisation - Nostr Paywall
|
|
|
|
Bienvenue sur Nostr Paywall ! Cette plateforme vous permet de lire des articles avec des aperçus gratuits et de débloquer le contenu complet en payant avec Lightning Network.
|
|
|
|
## Table des matières
|
|
|
|
1. [Introduction](#introduction)
|
|
2. [Premiers pas](#premiers-pas)
|
|
3. [Connexion avec Nostr](#connexion-avec-nostr)
|
|
4. [Lire des articles](#lire-des-articles)
|
|
5. [Payer pour débloquer un article](#payer-pour-débloquer-un-article)
|
|
6. [Rechercher et filtrer des articles](#rechercher-et-filtrer-des-articles)
|
|
7. [Voir votre profil](#voir-votre-profil)
|
|
8. [Notifications](#notifications)
|
|
9. [Dépannage](#dépannage)
|
|
|
|
---
|
|
|
|
## Introduction
|
|
|
|
Nostr Paywall est une plateforme de publication d'articles basée sur le protocole Nostr. Les auteurs peuvent publier des articles avec :
|
|
- **Aperçu gratuit** : Visible par tous
|
|
- **Contenu complet** : Débloqué après un paiement Lightning de 800 sats (par défaut)
|
|
|
|
### Fonctionnalités principales
|
|
|
|
- ✅ Lecture gratuite des aperçus d'articles
|
|
- ✅ Déblocage du contenu complet via paiement Lightning
|
|
- ✅ Recherche et filtrage d'articles
|
|
- ✅ Profil utilisateur avec vos articles
|
|
- ✅ Notifications en temps réel pour les paiements
|
|
- ✅ Publication d'articles avec paiement Lightning
|
|
|
|
---
|
|
|
|
## Premiers pas
|
|
|
|
### 1. Installer Alby (recommandé)
|
|
|
|
Pour effectuer des paiements Lightning, vous devez installer une extension de portefeuille Lightning compatible avec WebLN :
|
|
|
|
1. Visitez [getalby.com](https://getalby.com/)
|
|
2. Installez l'extension Alby pour votre navigateur
|
|
3. Créez un compte ou connectez votre portefeuille Lightning existant
|
|
4. Ajoutez des fonds à votre portefeuille Alby
|
|
|
|
> **Note** : D'autres portefeuilles Lightning compatibles WebLN fonctionnent également.
|
|
|
|
### 2. Accéder à la plateforme
|
|
|
|
1. Ouvrez [votre instance de Nostr Paywall] dans votre navigateur
|
|
2. Vous verrez la liste des articles disponibles
|
|
3. Cliquez sur "Connect with Nostr" pour vous connecter
|
|
|
|
---
|
|
|
|
## Connexion avec Nostr
|
|
|
|
### Comment se connecter
|
|
|
|
1. Cliquez sur le bouton **"Connect with Nostr"** en haut à droite
|
|
2. Une fenêtre s'ouvrira pour vous connecter avec votre portefeuille Nostr
|
|
3. Par défaut, l'application utilise `use.nsec.app` comme pont NostrConnect
|
|
4. Autorisez la connexion dans votre portefeuille Nostr
|
|
|
|
### Que se passe-t-il après la connexion ?
|
|
|
|
- ✅ Votre profil Nostr s'affiche (nom, avatar, etc.)
|
|
- ✅ Vous pouvez publier des articles
|
|
- ✅ Vous pouvez payer pour débloquer des articles
|
|
- ✅ Vous recevez des notifications pour les paiements reçus
|
|
- ✅ Vous pouvez accéder à votre profil avec vos articles
|
|
|
|
### Déconnexion
|
|
|
|
Cliquez sur le bouton **"Disconnect"** pour vous déconnecter.
|
|
|
|
---
|
|
|
|
## Lire des articles
|
|
|
|
### Aperçu gratuit
|
|
|
|
Tous les articles affichent automatiquement :
|
|
- **Titre** de l'article
|
|
- **Aperçu** (preview) - contenu gratuit
|
|
- **Auteur** (clé publique Nostr)
|
|
- **Montant de sponsoring** en sats (800 sats)
|
|
- **Date de publication**
|
|
|
|
### Contenu complet
|
|
|
|
Pour lire le contenu complet d'un article :
|
|
1. Cliquez sur le bouton **"Débloquer avec X sats zap"**
|
|
2. Suivez les instructions pour effectuer un zap Lightning
|
|
3. Une fois le zap confirmé, le contenu complet s'affichera automatiquement
|
|
|
|
> **Note** : Le contenu débloqué est stocké localement dans votre navigateur et reste accessible même après déconnexion.
|
|
|
|
---
|
|
|
|
## Payer pour débloquer un article
|
|
|
|
### Processus de zap
|
|
|
|
1. **Cliquez sur "Débloquer avec X sats zap"** sur l'article que vous souhaitez débloquer
|
|
2. **Une fenêtre s'ouvre** avec :
|
|
- Le montant du zap (800 sats)
|
|
- Un QR code Lightning
|
|
- L'invoice Lightning
|
|
- Un bouton "Pay with Alby"
|
|
3. **Choisissez votre méthode de zap** :
|
|
- **Option 1** : Cliquez sur "Pay with Alby" (recommandé)
|
|
- Votre extension Alby s'ouvrira automatiquement
|
|
- Confirmez le zap dans Alby
|
|
- **Option 2** : Scannez le QR code avec votre portefeuille Lightning mobile
|
|
- **Option 3** : Copiez l'invoice et effectuez le zap depuis votre portefeuille
|
|
4. **Attendez la confirmation** :
|
|
- Le zap est vérifié automatiquement via les reçus de zap Nostr (NIP-57)
|
|
- Le contenu complet s'affichera automatiquement une fois confirmé
|
|
- Cela peut prendre quelques secondes
|
|
|
|
> **Note** : Seuls les zaps sont autorisés pour débloquer les articles. Les paiements Lightning standard ne fonctionnent pas.
|
|
|
|
### Expiration des invoices
|
|
|
|
Les invoices Lightning expirent après 24 heures. Si une invoice expire :
|
|
- Fermez la fenêtre de paiement
|
|
- Cliquez à nouveau sur "Unlock Article" pour générer une nouvelle invoice
|
|
|
|
### Problèmes de paiement
|
|
|
|
Si le paiement échoue :
|
|
- Vérifiez que vous avez suffisamment de fonds dans votre portefeuille
|
|
- Vérifiez que l'invoice n'a pas expiré
|
|
- Réessayez en cliquant à nouveau sur "Unlock Article"
|
|
- Consultez la [section Dépannage](#dépannage)
|
|
|
|
---
|
|
|
|
## Rechercher et filtrer des articles
|
|
|
|
### Barre de recherche
|
|
|
|
Utilisez la barre de recherche en haut de la page pour rechercher des articles par :
|
|
- **Titre**
|
|
- **Aperçu** (preview)
|
|
- **Contenu** (même le contenu débloqué est recherchable)
|
|
|
|
### Filtres
|
|
|
|
Les filtres vous permettent de :
|
|
- **Filtrer par auteur** : Sélectionnez un auteur spécifique
|
|
- **Trier les articles** :
|
|
- Sponsoring puis date (par défaut) : Les auteurs avec le plus de sponsoring apparaissent en premier
|
|
- Plus anciens d'abord
|
|
|
|
### Utilisation des filtres
|
|
|
|
1. Utilisez les menus déroulants pour sélectionner vos filtres
|
|
2. Les résultats se mettent à jour automatiquement
|
|
3. Cliquez sur "Clear Filters" pour réinitialiser tous les filtres
|
|
|
|
---
|
|
|
|
## Voir votre profil
|
|
|
|
### Accéder à votre profil
|
|
|
|
1. Connectez-vous avec Nostr
|
|
2. Cliquez sur votre **nom ou avatar** en haut à droite
|
|
3. Vous serez redirigé vers la page `/profile`
|
|
|
|
### Informations affichées
|
|
|
|
Votre profil affiche :
|
|
- **Photo de profil** (si disponible)
|
|
- **Nom** (si défini dans votre profil Nostr)
|
|
- **Clé publique** (pubkey)
|
|
- **NIP-05** (si vérifié)
|
|
- **Description** (about)
|
|
- **Nombre d'articles publiés**
|
|
|
|
### Vos articles
|
|
|
|
La section "My Articles" affiche :
|
|
- Tous vos articles publiés
|
|
- Recherche et filtres sur vos articles
|
|
- Statut de déblocage pour chaque article
|
|
|
|
---
|
|
|
|
## Notifications
|
|
|
|
### Types de notifications
|
|
|
|
Actuellement, vous recevez des notifications pour :
|
|
- **Paiements reçus** : Quand quelqu'un paie pour un de vos articles
|
|
|
|
### Badge de notification
|
|
|
|
- Un **badge rouge** avec le nombre de notifications non lues apparaît à côté de votre profil
|
|
- Cliquez sur le badge pour ouvrir le centre de notifications
|
|
|
|
### Centre de notifications
|
|
|
|
Le centre de notifications affiche :
|
|
- Liste de toutes vos notifications
|
|
- Indicateur visuel pour les notifications non lues
|
|
- Actions disponibles :
|
|
- **Marquer comme lu** : Cliquez sur une notification
|
|
- **Marquer tout comme lu** : Bouton en haut
|
|
- **Supprimer** : Icône de poubelle sur chaque notification
|
|
- **Tout supprimer** : Bouton "Clear all"
|
|
|
|
### Notifications persistantes
|
|
|
|
Les notifications sont stockées localement dans votre navigateur et persistent même après déconnexion.
|
|
|
|
---
|
|
|
|
## Dépannage
|
|
|
|
### Problèmes de connexion
|
|
|
|
**Je ne peux pas me connecter avec Nostr**
|
|
- Vérifiez que votre portefeuille Nostr est accessible
|
|
- Vérifiez que le pont NostrConnect (`use.nsec.app`) est accessible
|
|
- Essayez de rafraîchir la page
|
|
- Vérifiez votre connexion internet
|
|
|
|
### Problèmes de paiement
|
|
|
|
**Le paiement ne fonctionne pas**
|
|
- Vérifiez que Alby (ou votre portefeuille Lightning) est installé et activé
|
|
- Vérifiez que vous avez suffisamment de fonds
|
|
- Vérifiez que l'invoice n'a pas expiré
|
|
- Essayez de rafraîchir la page et réessayez
|
|
|
|
**Le contenu ne se débloque pas après le paiement**
|
|
- Attendez quelques secondes (la vérification peut prendre du temps)
|
|
- Vérifiez que le paiement a bien été effectué dans votre portefeuille
|
|
- Rafraîchissez la page
|
|
- Contactez l'auteur de l'article si le problème persiste
|
|
|
|
### Problèmes d'affichage
|
|
|
|
**Les articles ne s'affichent pas**
|
|
- Vérifiez votre connexion internet
|
|
- Vérifiez que le relay Nostr est accessible
|
|
- Essayez de rafraîchir la page
|
|
- Vérifiez la console du navigateur pour les erreurs
|
|
|
|
**Le contenu débloqué a disparu**
|
|
- Le contenu est stocké localement dans votre navigateur
|
|
- Si vous avez vidé le cache ou les données du navigateur, le contenu peut être perdu
|
|
- Vous devrez peut-être payer à nouveau pour débloquer l'article
|
|
|
|
### Problèmes de publication
|
|
|
|
**Je ne peux pas publier d'article**
|
|
- Vérifiez que vous êtes connecté avec Nostr
|
|
- Vérifiez que votre portefeuille Nostr peut signer des événements
|
|
- Vérifiez que Alby est installé (nécessaire pour créer l'invoice)
|
|
- Vérifiez que tous les champs sont remplis (titre, aperçu, contenu)
|
|
|
|
---
|
|
|
|
## Support
|
|
|
|
Pour plus d'aide :
|
|
- Consultez la [FAQ](./faq.md)
|
|
- Consultez le [Guide de publication](./publishing-guide.md)
|
|
- Consultez le [Guide de paiement](./payment-guide.md)
|
|
|
|
---
|
|
|
|
**Dernière mise à jour** : Décembre 2024
|