# Guide d'utilisation - zapwall.fr

Bienvenue sur zapwall.fr ! Cette plateforme vous permet de lire des publications scientifiques et de science-fiction 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 publications](#lire-des-publications)
5. [Payer pour débloquer une publication](#payer-pour-débloquer-une-publication)
6. [Rechercher et filtrer des publications](#rechercher-et-filtrer-des-publications)
7. [Voir votre profil et votre page auteur](#voir-votre-profil-et-votre-page-auteur)
8. [Séries](#séries)
9. [Avis](#avis)
10. [Dépannage](#dépannage)

---

## Introduction

zapwall.fr est une plateforme de publication de contenus scientifiques et de science-fiction basée sur le protocole Nostr. Les auteurs peuvent publier des publications avec :
- **Aperçu gratuit** : Visible par tous
- **Contenu complet** : Débloqué après un paiement Lightning de 800 sats (moins 100 sats de commission et frais de transaction)

### Fonctionnalités principales

- ✅ Lecture gratuite des aperçus de publications
- ✅ Déblocage du contenu complet via paiement Lightning
- ✅ Recherche et filtrage de publications
- ✅ Page auteur avec présentation et sponsoring
- ✅ Séries pour organiser vos publications
- ✅ Avis rémunérables sur les publications
- ✅ Sponsoring d'auteurs (0.046 BTC)

---

## 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 [zapwall.fr](https://zapwall.fr) dans votre navigateur
2. Vous verrez la liste des publications 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 l'extension nos2x (NIP-07). Un pont NostrConnect (NIP-46) peut être configuré via la variable d'environnement `NEXT_PUBLIC_NOSTRCONNECT_BRIDGE`
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 créer votre page auteur (obligatoire pour publier)
- ✅ Vous pouvez publier des publications
- ✅ Vous pouvez payer pour débloquer des publications
- ✅ Vous pouvez accéder à votre profil avec vos publications

### Déconnexion

Cliquez sur le bouton **"Disconnect"** pour vous déconnecter.

---

## Lire des publications

### Aperçu gratuit

Toutes les publications affichent automatiquement :
- **Titre** de la publication
- **Aperçu** (preview) - contenu gratuit
- **Auteur** (avec lien vers sa page auteur)
- **Montant** en sats (800 sats)
- **Date de publication**
- **Catégorie** (Science-fiction ou Recherche scientifique)

### Contenu complet

Pour lire le contenu complet d'une publication :
1. Cliquez sur le bouton **"Débloquer"**
2. Suivez les instructions pour effectuer un zap Lightning de 800 sats
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 une publication

### Processus de zap

1. **Cliquez sur "Débloquer"** sur la publication 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 publications. 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 "Débloquer" 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 "Débloquer"
- Consultez la [section Dépannage](#dépannage)

---

## Rechercher et filtrer des publications

### Barre de recherche

Utilisez la barre de recherche en haut de la page pour rechercher des publications par :
- **Titre**
- **Aperçu** (preview)
- **Contenu** (même le contenu débloqué est recherchable)

### Filtres

Les filtres vous permettent de :
- **Filtrer par catégorie** : Science-fiction ou Recherche scientifique
- **Filtrer par auteur** : Sélectionnez un auteur spécifique
- **Trier les publications** :
  - Plus récentes d'abord (par défaut)
  - Plus anciennes d'abord

### Utilisation des filtres

1. Utilisez les onglets de catégorie pour filtrer par type de contenu
2. Utilisez le menu déroulant pour sélectionner un auteur
3. Les résultats se mettent à jour automatiquement
4. Cliquez sur "Effacer tout" pour réinitialiser tous les filtres

---

## Voir votre profil et votre page auteur

### Page auteur (obligatoire)

Avant de pouvoir publier, vous devez créer votre **page auteur** :
1. Connectez-vous avec Nostr
2. Cliquez sur **"Créer page auteur"** dans le menu
3. Remplissez votre présentation avec :
   - Votre description
   - Votre adresse Bitcoin mainnet pour le sponsoring (optionnel)
4. Une fois créée, votre page auteur est accessible à tous via `/author/[votre-pubkey]`

### 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)

### Vos publications

La section "My Articles" affiche :
- Toutes vos publications publiées
- Recherche et filtres sur vos publications
- Statut de déblocage pour chaque publication

---

## Séries

### Qu'est-ce qu'une série ?

Une série est un regroupement de publications organisées par un auteur. Les séries permettent de :
- Organiser vos publications par thème
- Créer une continuité narrative
- Faciliter la découverte de vos contenus

### Créer une série

1. Connectez-vous avec Nostr
2. Lors de la publication, vous pouvez créer ou sélectionner une série
3. Remplissez les informations de la série :
   - Titre
   - Description
   - Image de couverture (optionnel)
4. Les publications de la série seront regroupées sur la page de la série

### Voir une série

1. Cliquez sur une série depuis la page d'un auteur
2. Vous verrez toutes les publications de la série
3. Chaque publication peut être débloquée individuellement

---

## Avis

### Qu'est-ce qu'un avis ?

Un avis est un commentaire ou une évaluation d'une publication par un lecteur qui a acheté la publication. Les avis sont :
- **Rémunérables** : L'auteur peut remercier un avis avec 70 sats (moins 21 sats de commission)
- **Publics** : Visibles par tous sur la plateforme
- **Liés à une publication** : Chaque avis est associé à une publication spécifique

### Poster un avis

1. Débloquez une publication (800 sats)
2. Accédez à la page de la publication
3. Rédigez votre avis
4. Publiez votre avis

### Remercier un avis

En tant qu'auteur, vous pouvez remercier un lecteur pour son avis :
1. Accédez à la publication concernée
2. Trouvez l'avis que vous souhaitez remercier
3. Cliquez sur "Remercier" (70 sats)
4. Confirmez le zap dans Alby

> **Note** : Le remerciement d'un avis coûte 70 sats (49 sats au reviewer, 21 sats de commission).

---

## 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 la publication si le problème persiste

### Problèmes d'affichage

**Les publications 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 la publication

### Problèmes de publication

**Je ne peux pas publier de publication**
- Vérifiez que vous êtes connecté avec Nostr
- Vérifiez que vous avez créé votre page auteur (obligatoire)
- 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