# PorteJoie (BC) — aide V9.3 (25 septembre 2026)

# PorteJoie (BC) — aide

*Version V9.3 du 25 septembre 2026. Les questions fréquentes sont mises à jour en continu ; le mode d'emploi qui suit est livré avec la version installée : il décrit toujours ce que vous avez sous les yeux.*

PorteJoie (BC) est une **maquette de démonstration**. Elle montre comment des « Joies », de petits objets numériques de gratitude à l'effigie d'une figure inspirante, peuvent circuler de personne à personne en étant enregistrées sur une **blockchain**, sans que personne ne puisse les falsifier.

Tout ce que vous y voyez est **fictif** : comptes de test, Joies, messages. N'y mettez aucune information personnelle réelle.

---

## Questions fréquentes

**J'ai changé de téléphone, ou je l'ai perdu.**
Vos Joies ne sont pas dans le téléphone : elles sont inscrites sur la blockchain. Si votre passkey est sauvegardée avec votre compte Google ou Apple, votre porteJoie se rouvre tout seul sur le nouvel appareil. Sinon, demandez un lien de connexion par email sur la page de connexion, puis, dans **Profil**, révoquez l'appareil perdu et ajoutez le nouveau.

**Comment ouvrir mon porteJoie sur un PC ou une tablette ?**
Trois possibilités : la passkey de l'appareil (sur un PC Windows, un simple code PIN suffit) ; la passkey de votre téléphone, en choisissant « utiliser un autre appareil » et en scannant le code affiché ; ou un lien reçu par email. Sur un ordinateur partagé, décochez « Se souvenir de cet appareil ».

**Pourquoi n'y a-t-il pas de mot de passe ?**
Parce qu'une passkey est plus sûre et plus simple : rien à retenir, rien qui puisse être volé sur le serveur. Elle utilise l'empreinte, le visage ou le code de déverrouillage de votre appareil.

**Comment être prévenu quand on m'offre une Joie ?**
Répondez « Oui, me prévenir » à la question posée sur l'écran principal, puis autorisez les notifications. Vous pouvez changer d'avis à tout moment avec le lien **Notifications** en bas de l'écran. Sur iPhone et iPad, ajoutez d'abord porteJoie à l'écran d'accueil (bouton Partager, puis « Sur l'écran d'accueil ») et ouvrez-le depuis l'icône.

**J'ai refusé les notifications, comment revenir en arrière ?**
Le navigateur retient votre refus : il faut l'annuler dans ses réglages (le petit cadenas à gauche de l'adresse, puis « Notifications » ; sur Android, réglages du site dans Chrome). Revenez ensuite sur **Notifications**.

**On m'invite à créer un porteJoie, mais j'en ai déjà un.**
Aucun souci. Sur la page d'invitation, choisissez **« J'ai déjà un porteJoie »**. Si votre porteJoie est ouvert sur ce téléphone, un clic suffit. Sinon, indiquez l'adresse email de votre porteJoie : vous recevrez un lien de confirmation. Vous pouvez aussi relier l'adresse à laquelle on vous a invité : la prochaine personne qui l'utilisera vous trouvera directement.

**Je ne trouve pas la personne à qui donner.**
Dans **Donner**, le champ « À qui ? » montre vos contacts récents. Pour quelqu'un d'autre, tapez **son adresse email complète** : si elle a un porteJoie relié à cette adresse, elle apparaît ; sinon, vous pouvez l'inviter. Vous pouvez aussi **consulter l'annuaire général**.

**Qui voit mon nom dans l'annuaire ?**
Personne, sauf si vous l'avez choisi : la case « Je figure dans l'annuaire » est décochée par défaut. On y cherche par nom ; votre adresse email n'y apparaît que masquée (a•••@exemple.fr).

**Pourquoi ne puis-je pas inviter par SMS ?**
Un SMS coûte de l'argent à l'association. Seules les organisations habilitées peuvent en envoyer, en nombre limité. Entre particuliers, l'invitation passe par email, gratuitement : si vous ne connaissez pas l'adresse, demandez-la à la personne.

**Pourquoi mon message n'est-il pas sur la blockchain ?**
Parce qu'on ne pourrait plus jamais l'effacer. Seule une empreinte du texte y figure : elle prouve que le message n'a pas été modifié, sans en révéler le contenu.

**Puis-je me faire aider par un assistant IA ?**
Oui. Ouvrez l'assistant de votre choix (Claude, ChatGPT, Le Chat…) et commencez par lui donner l'adresse du texte de cette aide : **https://a6.tail7cdd25.ts.net/aide.md**. Il pourra alors vous guider pas à pas. Ne lui confiez pas vos liens personnels (`?p=…`) : ils ouvrent votre porteJoie.

*Une question qui n'est pas ici ? Écrivez à contact@pourlajoie-mock.example.*

---

## 1. Accéder à la maquette

Ouvrez dans votre navigateur (ordinateur ou téléphone) :

**https://a6.tail7cdd25.ts.net/**

Choisissez ensuite un porteJoie de test dans la liste : Alice, Bruno, Chloé, Diego, Élise, Farid ou Gérard. Vous pouvez aussi aller directement sur un compte en ajoutant son prénom à l'adresse, par exemple :

- https://a6.tail7cdd25.ts.net/?p=alice
- https://a6.tail7cdd25.ts.net/?p=bruno

> **Deux modes, selon le réglage du serveur.**
> - **Mode test** : pas de connexion ; le lien `?p=prénom` suffit à ouvrir un compte de test.
> - **Mode protégé** : chaque porteJoie s'ouvre avec sa passkey ou un lien reçu par email (voir la section 2 bis). Les comptes de démonstration restent ouverts par lien, pour les essais.
>
> Pour essayer un échange complet, ouvrez deux onglets, un par personne, par exemple Alice et Bruno.

**Si la page ne s'ouvre pas :**
- Le serveur de démonstration est un petit ordinateur personnel : il peut être éteint ou en veille. Réessayez plus tard, ou prévenez François.
- Si l'application **Tailscale** est installée sur votre appareil, désactivez-la le temps de la visite. Ce cas ne concerne normalement pas les visiteurs extérieurs.

---

## 2. L'écran principal

En haut et en bas de l'écran, **six compteurs** (l'unité 手 veut dire « main », voir 2 ter) :

| Compteur | Ce qu'il compte |
|---|---|
| **proposées** | les Joies qu'on vous offre et qui attendent votre réponse |
| **disponibles** | les Joies que vous possédez |
| **envoyées** | vos dons des deux dernières minutes (affichés en rouge) |
| **reçues** | toutes les Joies que vous avez reçues |
| **données** | toutes les Joies que vous avez données |
| **émises** | les Joies que vous avez créées vous-même |

**Cliquez sur un compteur** pour voir le détail : liste des Joies, historique des dons, messages.

Au milieu, quatre onglets : **Recevoir**, **Donner**, **Souscrire**, **Émettre**.
En bas : **Certificats**, **Inviter**, **Aide** (cette page), **Profil**, **Déconnexion**.

> **Délais.** Chaque action importante est inscrite sur la blockchain, ce qui prend **quelques secondes**. Pendant l'attente, le curseur de la souris devient un sablier (ou un cercle bleu sous Windows). Si un compteur ne semble pas à jour, **rechargez la page** quelques secondes plus tard.

---

## 2 ter. Le nouvel accueil (à essayer)

Un **nouvel accueil**, plus lisible et plus simple, est proposé à côté de l'ancien. C'est vous qui choisissez :

1. En haut de l'écran principal, cliquez sur **« Essayer le nouvel accueil »**.
2. Pour revenir en arrière, le lien **« Revenir à l'ancien accueil »** se trouve tout en bas du nouvel accueil.

Le choix est **mémorisé par appareil et par navigateur** : sur un autre téléphone ou un autre navigateur, il faut le refaire.

Ce que vous y trouvez :

- **Quand une Joie vous attend**, elle s'affiche en haut : qui vous l'offre, à quelle effigie, son message, et les boutons **Accepter** et **Refuser**. Si plusieurs vous attendent, le lien « et … autres en attente » les montre toutes.
- **Quand aucune Joie n'attend**, l'écran vous demande « À qui voulez-vous faire plaisir aujourd'hui ? » et propose vos **contacts récents** : un clic ouvre **Donner** avec la personne déjà choisie.
- **Dernière Joie reçue** : un clic ouvre sa fiche (photo de l'effigie, de qui, quand, message).
- Le grand bouton **Donner une Joie**, puis trois compteurs : **à donner**, **reçues**, **données**. Un clic sur un compteur ouvre la liste, et chaque ligne ouvre sa fiche.
- En bas, les gestes plus rares : **Montrer mon code pour recevoir** (voir 3), **Émettre des Joies**, **Archives et souscription**. Donner, Émettre et les archives s'ouvrent sur l'écran classique ; le bouton **← Accueil** vous ramène.

Le signe **手** (« main » en chinois) est la **marque de porteJoie** : une Joie se donne de la main à la main. porteJoie est une pseudo-monnaie décentralisée **à valeur nulle**, et 手 est son signe, comme € ou $ pour une vraie monnaie. Vous le trouvez sur chaque écran.

Le nouvel accueil utilise la police **Atkinson Hyperlegible**, dessinée pour les personnes malvoyantes, et des contrastes conformes aux normes d'accessibilité.

## 2 bis. Se connecter et protéger son porteJoie

Il n'y a **aucun mot de passe**. **Protéger son porteJoie est un choix, pas une obligation** : sans rien faire, il reste ouvert sur votre appareil, comme une application qui reste connectée. Pour pouvoir le rouvrir ailleurs, ajoutez une adresse email ou une passkey.

Trois façons d'ouvrir son porteJoie, toutes gratuites :

1. **Avec ma passkey** : l'empreinte, le visage ou le code de déverrouillage de l'appareil. Sur un PC Windows, un simple code PIN (Windows Hello) suffit.
2. **Avec la passkey de mon téléphone, sur un autre appareil** : cliquez sur « Avec ma passkey », choisissez « utiliser un autre appareil », puis scannez le code affiché avec votre téléphone.
3. **Avec un lien reçu par email** : indiquez votre adresse ; le lien est valable 15 minutes, une seule fois.

**Créer un porteJoie** : sur la page de connexion, indiquez un prénom ou un pseudonyme (votre vrai nom n'est jamais exigé) ; cochez « Ordinateur partagé » si vous n'êtes pas sur votre propre appareil. On vous propose ensuite une passkey : acceptez, ou choisissez « Plus tard ». Vous pouvez aussi le créer en ouvrant une invitation reçue.

**Se souvenir de cet appareil** : cochez la case pour ne plus avoir à vous reconnecter. **Décochez-la sur un ordinateur partagé** : la session s'arrête alors à la fermeture du navigateur.

**Profil** (en bas de l'écran) :
- une ligne verte « Votre porteJoie vous suit » si votre passkey est sauvegardée avec votre compte Google ou Apple ; sinon, un conseil pour mettre vos Joies à l'abri ;
- **Mes porteJoie** : si vous en avez plusieurs, choisissez celui que vous utilisez ;
- **Mon adresse email** : ajoutez-la ; un lien de confirmation vous est envoyé. Elle sert seulement à rouvrir votre porteJoie et à vous prévenir ;
- **Mes appareils** : ajoutez l'appareil que vous tenez en main, ou **révoquez** un appareil perdu : sa passkey ne fonctionne plus.

> Une passkey ne quitte jamais votre appareil : le serveur n'en garde qu'une clé publique, qui ne permet pas de se connecter à votre place.

---

## 3. Recevoir

L'onglet **Recevoir** affiche votre **QR code**, c'est-à-dire votre adresse sur la blockchain. Dans la maquette, il sert surtout à montrer que chaque porteJoie a une adresse.

Dans le nouvel accueil, ce code n'est plus affiché d'office : touchez **« Montrer mon code pour recevoir »**. C'est la personne qui **reçoit** qui montre son code ; celle qui **donne** le vise avec l'appareil photo de son téléphone.

---

## 4. Donner une Joie

1. Onglet **Donner**.
2. **Quelle Joie donner ?** Choisissez une Joie précise, ou **« 🎲 Au hasard parmi mes Joies »**.
3. **À qui ?** Tapez les premières lettres d'un contact, ou son adresse email complète. La liste propose aussi :
   - **« Quelqu'un d'autre, par email »** : la personne reçoit une invitation, qu'elle ait déjà un porteJoie ou non ;
   - **« Consulter l'annuaire général »** : recherche par nom parmi les porteJoie qui ont choisi d'y figurer. La recherche ignore les accents et tolère les fautes de frappe.
4. **Message** (facultatif, 200 caractères au plus) : un petit mot qui accompagne la Joie.
5. Cliquez sur **Donner**.

La Joie **ne part pas tout de suite**. Le destinataire reçoit une **offre** qu'il peut accepter ou refuser pendant **48 heures**. Tant qu'il n'a pas répondu, la Joie reste chez vous.

Si vous avez invité quelqu'un par email, la Joie lui est proposée dès qu'il a ouvert l'invitation et créé (ou retrouvé) son porteJoie. L'invitation reste valable **8 jours**.

---

## 5. Accepter ou refuser une Joie

1. Cliquez sur le compteur **proposées**.
2. Choisissez l'offre : l'effigie, l'expéditeur et le message s'affichent.
3. Cliquez sur le grand **✓** vert pour **accepter**, ou sur le petit **✗** rouge pour **refuser**.

Si vous acceptez, la Joie devient la vôtre, et c'est la blockchain qui l'enregistre. Au-delà de 48 heures, l'offre expire et la Joie reste chez l'expéditeur.

---

## 5 bis. Être prévenu (notifications)

porteJoie peut vous prévenir par une notification quand **on vous offre une Joie** ou **qu'on vous décerne une médaille**. C'est vous qui décidez.

1. Sur l'écran principal, une question s'affiche : *« Être prévenu quand on vous offre une Joie ou vous décerne une Médaille ? »*. Répondez **Oui, me prévenir**, puis autorisez les notifications quand votre appareil le demande. **Plus tard** ne ferme rien : la question reviendra, trois fois au plus.
2. À tout moment, le lien **Notifications** en bas de l'écran (ou la rubrique **Notifications** du Profil) permet d'activer, d'**arrêter**, ou de **s'envoyer un test**.

À savoir :

- La notification dit **qui** vous offre une Joie et **à quelle effigie**, jamais le message : il pourrait se lire sur l'écran verrouillé. Le message s'affiche quand vous ouvrez l'offre.
- **Sur iPhone et iPad**, il faut d'abord ajouter porteJoie à l'écran d'accueil (bouton **Partager**, puis **« Sur l'écran d'accueil »**) et l'ouvrir depuis l'icône.
- **Sur ordinateur**, la notification arrive quand le navigateur est ouvert (même en arrière-plan). Sur Android, elle arrive même navigateur fermé.
- **Sur un PC Windows**, la notification s'affiche quelques secondes en bas à droite, puis se range dans le **Centre de notifications** : **touche Windows + N** (Windows 11) ou **touche Windows + A** (Windows 10), ou un clic sur la date et l'heure. Les notifications y sont **regroupées par application** (ici Microsoft Edge, Chrome ou Firefox), pas toujours dans l'ordre chronologique. Si rien n'arrive, vérifiez que le mode **Ne pas déranger** est coupé et que le navigateur est autorisé dans **Paramètres → Système → Notifications**.
- **En navigation privée** (InPrivate, fenêtre privée), les navigateurs bloquent les notifications.
- Chaque appareil s'abonne séparément : activez les notifications sur chacun de ceux où vous voulez être prévenu.
- Pour certaines effigies, le **donneur** est aussi prévenu quand sa Joie est **acceptée** (réglage de l'effigie).
- Si vous avez refusé par erreur, le navigateur garde ce refus : voyez les questions fréquentes.

---

## 6. Inviter et suivre ses invitations

Le lien **Inviter**, en bas de l'écran, ouvre la page de vos invitations :

- chaque invitation affiche son état : **envoyée**, **non remise**, **reçue** (avec le nom de la personne), **annulée** ou **expirée** ;
- si une invitation n'a pas pu être remise, demandez une autre adresse email à la personne et cliquez sur **Renvoyer** ;
- vous pouvez **annuler** une invitation : la Joie redevient disponible.

**Organisations.** Un porteJoie d'organisation (dans la maquette : « Club IA Yaka », `?p=club`) peut aussi inviter **par SMS**, dans la limite de son quota et une seule fois par numéro. Dans la maquette, **aucun SMS ne part réellement** : les envois sont simulés et visibles dans le **journal des envois**.

**Journal des envois.** Depuis la page Inviter, le lien « Envois (journal) » montre chaque email et chaque SMS simulé, avec son texte et son coût estimé.

> **Pour les tests.** Un numéro finissant par 0 simule un SMS non remis ; une adresse email contenant `+echec` simule un email non remis.

---

## 7. Médailles et Joies illimitées

Chaque Joie a une **transmissibilité** : le nombre de fois où elle peut encore être donnée.

- Une Joie **illimitée** peut circuler sans fin.
- Une **médaille** ne se transmet qu'un nombre limité de fois, par exemple 2. Dans la liste Donner, elle indique « médaille, encore N dons ». Une fois épuisée, elle reste chez son dernier destinataire : elle apparaît **grisée** (« médaille épuisée ») et ne peut plus être choisie.

Cette règle est appliquée **par la blockchain elle-même** : même en contournant l'écran, personne ne peut donner une médaille épuisée.

---

## 8. Émettre de nouvelles Joies

1. Onglet **Émettre**.
2. Choisissez une **effigie**. Pour chacune, la liste indique le nombre d'éditions encore disponibles et le type de Joie : médaille ou illimitée.
3. Indiquez le **nombre** de Joies à créer (10 au plus à la fois).
4. Cliquez sur **Émettre**.

Les nouvelles Joies sont créées **à votre nom** sur la blockchain, avec des numéros d'édition qui se suivent. Chaque effigie a un **tirage maximal** : une fois atteint, on ne peut plus en émettre. Votre compteur **émises** augmente.

---

## 9. Certifier une Joie publiquement

Vous pouvez prouver à n'importe qui, par exemple sur un réseau social, qu'une Joie vous appartient.

**Publier un certificat**
1. En bas de l'écran, cliquez sur **Certificats**.
2. Choisissez la **Joie**, le **nom à afficher** et, si vous voulez, une **mention** (par exemple « Escolo dis Aup »).
3. Cliquez sur **Publier**.
4. Vous obtenez un **lien** et un **QR code**. Le bouton **« Copier le lien »** permet de le coller dans un message ou une publication.

**Ce que voit la personne qui ouvre le lien**

La page vérifie la Joie **en direct sur la blockchain**, à chaque ouverture. Elle affiche l'un de ces trois verdicts :

- **✅ Authentique** : la Joie appartient toujours à la personne qui a publié le certificat. La page indique son nom, la mention, qui a émis la Joie, son parcours et des détails techniques.
- **⚠️ Cette Joie a changé de mains** : elle a été donnée depuis la publication. Le certificat n'est plus valable et le nom n'est plus affiché.
- **Certificat retiré** : son détenteur l'a retiré.

**Retirer un certificat**

Dans **Certificats**, rubrique « Mes certificats », cliquez sur **Retirer**. La page publique n'affichera plus votre nom.

> **À savoir.** Un certificat prouve que *cette Joie, émise par telle personne ou organisation, vous appartient*. Sa valeur dépend donc de **qui l'a émise**. Dans la maquette, la « Cigale d'or (démonstration) » est une distinction **fictive**, créée uniquement pour la démonstration.

---

## 10. Autres points

- **Langue** : l'interface suit la langue de votre navigateur pour les mots propres aux Joies. Pour forcer le portugais, ajoutez `&lang=pt` à l'adresse, par exemple https://a6.tail7cdd25.ts.net/?p=alice&lang=pt. La traduction ne concerne pour l'instant que quelques mots, comme « médaille », qui devient « medalha ».
- **Souscrire** : cette fonction n'est pas encore disponible dans la maquette. Dans la vraie application, elle passe par un paiement.
- **Créer un compte** : en mode protégé, depuis la page de connexion (voir 2 bis) ; en mode test, le lien « Créer un compte » de la page d'accueil ajoute aussi un porteJoie de test. Le compte démarre sans Joie.

---

## 11. Ce qu'il faut retenir

- Les Joies, leurs propriétaires et leurs échanges sont inscrits sur une **blockchain** : personne, pas même l'administrateur, ne peut les modifier en douce.
- Les **messages**, les **noms** et les **adresses email** ne sont pas sur la blockchain : ils restent effaçables.
- C'est une **maquette** : données fictives, pas de vraie connexion, serveur de démonstration pas toujours allumé.

*Une question, un souci ? Écrivez à contact@pourlajoie-mock.example, ou contactez François.*
