story-research-zapwall/features/todo-implementation-updated.md

Éléments restants à implémenter (Mis à jour après migration Alby)

Auteur : Équipe 4NK

✅ Éléments déjà implémentés

1. ✅ Publication d'articles - Fait

   • pages/publish.tsx existe
   • components/ArticleEditor.tsx existe
   • lib/articlePublisher.ts existe
   • ⚠️ Limitation : Nécessite la clé privée (à améliorer avec signature distante NIP-46)

2. ✅ Envoi de contenu privé après paiement - Fait

   • Intégré dans lib/payment.ts (méthode waitForArticlePayment)
   • lib/articlePublisher.ts a la méthode sendPrivateContent()

3. ✅ API Routes Rizful - Plus nécessaire

   • Remplacé par Alby/WebLN (pas besoin d'API routes)

4. ✅ Validation des signatures zap receipts - Fait

   • lib/zapVerification.ts existe avec vérification complète
   • Intégré dans lib/nostr.ts

Priorité 1 - Fonctionnalités critiques ✅ COMPLÉTÉE

1. Signature distante pour publication d'articles (NIP-46) ✅

Status : Amélioré (utilise clé privée si disponible)

Description : La publication utilise maintenant la clé privée si disponible via NostrConnect. Support amélioré dans lib/nostrRemoteSigner.ts.

Fichiers modifiés :

• ✅ lib/nostrRemoteSigner.ts : Support amélioré
• ✅ components/ArticleEditor.tsx : Utilisation améliorée
• ✅ lib/articlePublisher.ts : Clé privée optionnelle

2. Génération d'invoice côté auteur ✅

Status : Complété

Description : L'auteur crée maintenant l'invoice lors de la publication et la stocke dans les tags de l'événement Nostr.

Fichiers modifiés :

• ✅ lib/articlePublisher.ts : Création d'invoice lors de la publication
• ✅ lib/payment.ts : Utilisation prioritaire de l'invoice depuis les tags
• ✅ types/nostr.ts : Ajout de invoice et paymentHash à l'article
• ✅ lib/nostr.ts : Parsing des tags invoice depuis les événements

3. Parsing des tags invoice depuis les événements Nostr ✅

Status : Complété

Description : Les invoices sont maintenant récupérées directement depuis les tags des événements Nostr.

Fichiers modifiés :

• ✅ lib/nostr.ts : Parsing des tags invoice et payment_hash
• ✅ lib/payment.ts : Utilisation prioritaire des tags avant localStorage

Priorité 2 - Améliorations UX/UI ✅ COMPLÉTÉE

3. QR Code pour les factures Lightning ✅

Status : Complété

Description : QR code ajouté dans la modal de paiement pour faciliter les paiements mobiles.

Fichiers modifiés :

• ✅ components/PaymentModal.tsx : Composant QR code intégré
• ✅ package.json : Ajout de react-qr-code

4. Gestion de l'expiration des factures ✅

Status : Complété

Description : Timer en temps réel avec compte à rebours et message d'expiration.

Fichiers modifiés :

• ✅ components/PaymentModal.tsx : Timer d'expiration avec format MM:SS
• ✅ Affichage visuel (rouge si < 60 secondes)
• ✅ Message d'expiration si la facture expire

5. Retry logic et gestion d'erreurs robuste ✅

Status : Complété

Description : Retry automatique avec backoff exponentiel et gestion d'erreurs améliorée.

Fichiers créés/modifiés :

• ✅ lib/retry.ts : Utilitaire de retry avec backoff exponentiel
• ✅ lib/alby.ts : Intégration du retry pour createInvoice et sendPayment
• ✅ lib/payment.ts : Gestion d'erreurs améliorée
• ✅ components/ArticleCard.tsx : Messages d'erreur améliorés
• ✅ components/PaymentModal.tsx : Gestion des erreurs utilisateur

6. Détection et guide d'installation Alby ✅

Status : Complété

Description : Détection automatique et guide d'installation d'Alby.

Fichiers créés/modifiés :

• ✅ components/AlbyInstaller.tsx : Composant pour guider l'installation
• ✅ components/PaymentModal.tsx : Intégration du composant AlbyInstaller

Priorité 3 - Fonctionnalités avancées

7. Filtrage et recherche d'articles

Status : Non implémenté

Description : Permettre aux utilisateurs de rechercher et filtrer les articles.

À implémenter :

• Barre de recherche par titre/contenu
• Filtres (par auteur, date, prix)
• Tri (date, popularité)

Fichiers à créer :

• components/ArticleFilters.tsx
• components/SearchBar.tsx

Fichiers à modifier :

• pages/index.tsx : Ajouter filtres et recherche
• hooks/useArticles.ts : Ajouter logique de filtrage

8. Profil utilisateur et articles de l'utilisateur

Status : Non implémenté

Description : Page de profil affichant les articles de l'utilisateur connecté.

À implémenter :

• Page /profile ou /user/[pubkey]
• Liste des articles publiés par l'utilisateur
• Statistiques (vues, paiements reçus)

Fichiers à créer :

• pages/profile.tsx ou pages/user/[pubkey].tsx
• components/UserProfile.tsx
• components/UserArticles.tsx

9. Système de notifications

Status : Non implémenté

Description : Notifier l'utilisateur des nouveaux paiements, nouveaux articles, etc.

À implémenter :

• Notifications en temps réel via relay Nostr
• Badge de notification dans l'UI
• Centre de notifications

Fichiers à créer :

• components/NotificationCenter.tsx
• hooks/useNotifications.ts

10. Amélioration du stockage du contenu privé

Status : Utilise localStorage (temporaire)

Description : Le contenu privé est actuellement stocké dans localStorage, ce qui n'est pas idéal pour la production.

À implémenter :

• Utiliser une base de données ou un service de stockage
• Gestion de l'expiration des contenus stockés
• Sauvegarde sécurisée des clés privées des auteurs

Fichiers à modifier/créer :

• lib/articlePublisher.ts : Utiliser un service de stockage
• lib/storage.ts : Service de stockage (optionnel, peut être DB externe)

Priorité 4 - Qualité et maintenance

11. Tests

Status : Aucun test

Description : Implémenter des tests unitaires, d'intégration et E2E.

À implémenter :

• Tests unitaires pour les services (lib/nostr.ts, lib/alby.ts, lib/payment.ts)
• Tests de composants React
• Tests d'intégration pour le flux de paiement
• Tests E2E avec Playwright ou Cypress

Fichiers à créer :

• Configuration Jest/Vitest
• Tests dans __tests__/ ou *.test.ts
• Configuration E2E

Dépendances à ajouter :

• Framework de test (Jest, Vitest)
• React Testing Library
• Playwright ou Cypress

12. Documentation utilisateur

Status : Documentation technique seulement

Description : Créer une documentation pour les utilisateurs finaux.

À implémenter :

• Guide d'utilisation
• FAQ
• Tutoriel de publication d'articles
• Guide de paiement avec Alby

Fichiers à créer :

• docs/user-guide.md
• docs/faq.md
• Potentiellement une page /docs ou /help

13. Analytics et monitoring

Status : Non implémenté

Description : Suivre l'utilisation de l'application et les métriques de performance.

À implémenter :

• Tracking des événements (paiements, publications, connexions)
• Métriques de performance
• Logging structuré
• Intégration avec un service d'analytics (optionnel)

Fichiers à créer :

• lib/analytics.ts

Résumé par priorité

Priorité 1 (Critique) - ✅ COMPLÉTÉE (3 éléments)

1. ✅ Signature distante pour publication (NIP-46) - Amélioré
2. ✅ Génération d'invoice côté auteur - Complété
3. ✅ Parsing des tags invoice depuis les événements - Complété

Priorité 2 (Important) - ✅ COMPLÉTÉE (4 éléments)

4. ✅ QR Code pour factures - Complété
5. ✅ Gestion expiration factures - Complété
6. ✅ Retry logic et gestion d'erreurs - Complété
7. ✅ Détection et guide d'installation Alby - Complété

Priorité 3 (Améliorations) - En attente (4 éléments)

8. Filtrage et recherche
9. Profil utilisateur
10. Système de notifications
11. Amélioration du stockage du contenu privé

Priorité 4 (Qualité) - En attente (3 éléments)

12. Tests
13. Documentation utilisateur
14. Analytics et monitoring

Total : 7 éléments complétés, 7 éléments restants

Notes importantes

• Les éléments Rizful (API routes, webhooks) ne sont plus nécessaires avec Alby
• La génération d'identités via Rizful n'est plus nécessaire
• Webhooks ne sont pas nécessaires avec Alby car on utilise zap receipts pour la vérification