story-research-zapwall/docs/faq.md

# FAQ - Questions fréquentes

## Questions générales

### Qu'est-ce que zapwall.fr ?

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 un aperçu gratuit et un contenu complet payant, débloqué via des paiements Lightning Network.

### Comment fonctionne le système de paiement ?

1. L'auteur publie une publication avec un aperçu gratuit
2. L'auteur crée une invoice Lightning lors de la publication pour recevoir les zaps
3. Les lecteurs peuvent lire l'aperçu gratuitement
4. Pour lire le contenu complet, les lecteurs effectuent un zap Lightning de 800 sats
5. Une fois le zap confirmé, le contenu complet est envoyé via message privé chiffré (NIP-04)

### Combien coûte une publication ?

Toutes les publications ont le même montant : **800 sats** (environ 0,000008 BTC). Sur ce montant :
- **700 sats** vont à l'auteur
- **100 sats** sont la commission de la plateforme
- Des frais de transaction Lightning s'ajoutent

### Qu'est-ce qu'un "sat" ?

Un "sat" (satoshi) est la plus petite unité de Bitcoin. 1 BTC = 100 000 000 sats.

### Comment fonctionne le sponsoring ?

Le sponsoring permet de soutenir directement un auteur avec **0.046 BTC** :
- **0.042 BTC** vont à l'auteur
- **0.004 BTC** sont la commission de la plateforme
- Le sponsoring se fait via une transaction Bitcoin mainnet

---

## Connexion et authentification

### Comment me connecter ?

Cliquez sur "Connect with Nostr" et autorisez la connexion avec Alby. L'application utilise l'extension Alby pour l'authentification Nostr (NIP-07) et les paiements Lightning (WebLN).

### J'ai besoin d'un compte ?

Non, vous n'avez pas besoin de créer un compte. Vous utilisez votre identité Nostr existante via votre portefeuille Nostr.

### Puis-je utiliser plusieurs comptes ?

Oui, vous pouvez vous déconnecter et vous reconnecter avec un autre compte Nostr à tout moment.

### Que se passe-t-il si je me déconnecte ?

- Vous restez connecté pour lire les aperçus de publications
- Vous devez être connecté pour créer votre page auteur
- Vous devez être connecté pour publier des publications
- Vous devez être connecté pour payer et débloquer des publications
- Le contenu déjà débloqué reste accessible (stocké localement)

---

## Paiements

### Comment effectuer un zap pour une publication ?

1. Cliquez sur "Débloquer" sur la publication souhaitée
2. Une fenêtre s'ouvre avec un QR code et une invoice Lightning
3. Cliquez sur "Pay with Alby" ou scannez le QR code avec votre portefeuille Lightning
4. Confirmez le zap dans votre portefeuille
5. Le contenu se débloque automatiquement après confirmation

> **Important** : Seuls les zaps sont autorisés. Les paiements Lightning standard ne fonctionnent pas pour débloquer les publications.

### Quel portefeuille Lightning puis-je utiliser ?

Tout portefeuille Lightning compatible avec WebLN fonctionne. **Alby** est recommandé et testé. D'autres portefeuilles comme Breez, Zeus, etc. peuvent fonctionner s'ils supportent WebLN et peuvent effectuer des zaps.

### Dois-je installer Alby ?

Oui, pour effectuer des paiements facilement, vous devez installer l'extension Alby (ou un autre portefeuille Lightning compatible WebLN).

### Les zaps sont-ils sécurisés ?

Oui, les zaps utilisent le protocole Lightning Network et sont vérifiés via les reçus de zap Nostr (NIP-57), ce qui est sécurisé et décentralisé. Les zaps sont la seule méthode autorisée pour débloquer les publications.

### Que se passe-t-il si je paie mais que le contenu ne se débloque pas ?

Cela ne devrait pas arriver, mais si c'est le cas :
1. Attendez quelques secondes (la vérification peut prendre du temps)
2. Rafraîchissez la page
3. Vérifiez que le paiement a bien été effectué dans votre portefeuille
4. Contactez l'auteur de la publication

### Puis-je obtenir un remboursement ?

Les paiements Lightning sont généralement irréversibles. Contactez l'auteur de la publication si vous avez un problème.

### Les invoices expirent-elles ?

Oui, les invoices expirent après **24 heures**. Si une invoice expire, fermez la fenêtre et cliquez à nouveau sur "Débloquer" pour générer une nouvelle invoice.

---

## Publication de publications

### Comment publier une publication ?

1. Connectez-vous avec Nostr
2. Créez votre page auteur (obligatoire, une seule fois)
3. Cliquez sur "Publier une publication" dans le menu
4. Remplissez le formulaire :
   - **Titre** : Le titre de votre publication
   - **Preview** : L'aperçu gratuit (visible par tous)
   - **Content** : Le contenu complet (débloqué après paiement)
   - **Catégorie** : Science-fiction ou Recherche scientifique
   - **Série** : Optionnel, pour organiser vos publications
5. Cliquez sur "Publier"
6. Autorisez la création de l'invoice Lightning dans Alby
7. Votre publication sera publiée sur le relay Nostr

### Dois-je payer pour publier une publication ?

Non, la publication est gratuite. Vous devez seulement avoir Alby installé pour créer l'invoice Lightning.

### Puis-je modifier ou supprimer une publication après publication ?

Actuellement, cette fonctionnalité n'est pas disponible. Les publications publiées sur Nostr sont immutables. Une fonctionnalité d'édition/suppression sera ajoutée dans une future version.

### Comment les lecteurs paient-ils pour ma publication ?

Les lecteurs cliquent sur "Débloquer" et paient l'invoice Lightning que vous avez créée lors de la publication. Une fois le paiement confirmé, le contenu complet est automatiquement envoyé via message privé chiffré.

### Comment recevoir les paiements ?

Les paiements sont envoyés directement à votre portefeuille Lightning (celui utilisé pour créer l'invoice lors de la publication). Vous recevrez 700 sats sur chaque vente (800 sats - 100 sats de commission).

### Puis-je définir un montant personnalisé ?

Non, le montant est fixe à 800 sats pour toutes les publications. Cela simplifie l'expérience utilisateur et garantit une tarification équitable.

---

## Page auteur

### Qu'est-ce qu'une page auteur ?

Une page auteur est une publication obligatoire que chaque auteur doit créer avant de pouvoir publier. Elle contient :
- Votre présentation
- Votre description
- Votre adresse Bitcoin mainnet pour le sponsoring (optionnel)

### Dois-je créer une page auteur ?

Oui, la page auteur est **obligatoire** pour publier des publications. Vous ne pouvez publier qu'après avoir créé votre page auteur.

### Comment créer ma page auteur ?

1. Connectez-vous avec Nostr
2. Cliquez sur "Créer page auteur" dans le menu
3. Remplissez votre présentation
4. Publiez votre page auteur

### Ma page auteur est-elle publique ?

Oui, votre page auteur est accessible publiquement à l'adresse `/author/[votre-pubkey]`. Elle permet aux lecteurs de vous découvrir et de vous sponsoriser.

---

## 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 d'organiser vos publications par thème.

### Comment créer une série ?

Lors de la publication d'une publication, vous pouvez créer une nouvelle série ou sélectionner une série existante. Remplissez les informations de la série (titre, description, image de couverture).

### Puis-je ajouter une publication à une série existante ?

Oui, lors de la publication, vous pouvez sélectionner une série existante pour y ajouter votre publication.

---

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

### Qui peut poster un avis ?

Seuls les lecteurs qui ont débloqué une publication peuvent poster un avis sur cette publication.

### Les avis sont-ils rémunérables ?

Oui, en tant qu'auteur, vous pouvez remercier un lecteur pour son avis avec **70 sats** :
- **49 sats** vont au reviewer
- **21 sats** sont la commission de la plateforme

### Comment remercier un 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

---

## Contenu et publications

### Puis-je lire les publications sans payer ?

Oui, vous pouvez lire l'**aperçu** (preview) de toutes les publications gratuitement. Seul le **contenu complet** nécessite un paiement.

### Le contenu débloqué est-il stocké ?

Oui, le contenu débloqué est stocké localement dans votre navigateur (IndexedDB) pour rester accessible même après déconnexion.

### Puis-je partager une publication débloquée ?

Le contenu débloqué est stocké localement dans votre navigateur. Vous pouvez partager le lien de la publication, mais les autres utilisateurs devront payer pour débloquer le contenu.

### Les publications sont-elles publiques ?

Les **aperçus** sont publics et visibles par tous sur le relay Nostr. Le **contenu complet** est envoyé uniquement via message privé chiffré après paiement.

### Puis-je rechercher dans les publications ?

Oui, vous pouvez rechercher par titre, aperçu ou contenu. Vous pouvez également filtrer par catégorie, auteur et trier par date.

---

## Technique

### Quel relay Nostr est utilisé ?

Par défaut, l'application utilise `wss://relay.damus.io`. La configuration des relais est stockée dans IndexedDB (stockage local du navigateur) et peut être personnalisée via les paramètres de l'application. L'application supporte plusieurs relais avec un système de priorité.

### Les données sont-elles stockées sur un serveur ?

Non, l'application est décentralisée :
- Les publications sont publiées sur le relay Nostr (décentralisé)
- Le contenu débloqué est stocké localement dans votre navigateur (IndexedDB)
- Les notifications sont stockées localement dans votre navigateur

### Puis-je utiliser un autre relay Nostr ?

Oui, vous pouvez configurer un autre relay via les variables d'environnement. Cependant, vous ne verrez que les publications publiées sur le relay configuré.

### L'application fonctionne-t-elle hors ligne ?

Non, l'application nécessite une connexion internet pour :
- Se connecter au relay Nostr
- Publier des publications
- Effectuer des paiements Lightning
- Recevoir des notifications

Le contenu déjà débloqué reste accessible hors ligne (stocké localement).

---

## Problèmes et support

### L'application ne fonctionne pas

Vérifiez :
1. Votre connexion internet
2. Que le relay Nostr est accessible
3. La console du navigateur pour les erreurs
4. Que JavaScript est activé dans votre navigateur

### Je ne peux pas créer ma page auteur

Vérifiez :
1. Que vous êtes connecté avec Nostr
2. Que votre portefeuille Nostr peut signer des événements
3. Que tous les champs sont remplis

### Mon contenu débloqué a disparu

Le contenu est stocké localement. Si vous avez :
- Vidé le cache du navigateur
- Supprimé les données du site
- Utilisé un autre navigateur ou appareil

Le contenu peut être perdu. Vous devrez peut-être payer à nouveau pour débloquer la publication.

### Puis-je contacter le support ?

Pour l'instant, il n'y a pas de support officiel. Consultez la documentation ou créez une issue sur le [dépôt Gitea du projet](https://git.4nkweb.com/4nk/story-research-zapwall/issues).

---

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