Documentation votre communauté

Objectif

L'application a été créée pour que la famille garde un seul et même lieu de retrouvailles, où que chacun vive. Elle sert au quotidien à :

• maintenir le lien entre les générations et les branches familiales ;
• partager les nouvelles importantes (naissances, mariages, réussites, deuils) ;
• échanger photos, vidéos et souvenirs en toute confidentialité ;
• organiser les événements familiaux malgré les fuseaux horaires ;
• transmettre l'histoire, les recettes et les traditions aux plus jeunes.

Public cible

Tous les membres de votre communauté, partout dans le monde : les aînés comme les plus jeunes, les cousins installés au Canada, en Europe, en Afrique ou ailleurs, ainsi que les amis très proches invités par un membre.

L'accès n'est jamais public : chaque inscription est validée manuellement par un administrateur de la famille.

Nos valeurs

Plateformes supportées

• iOS (Safari) : application installable depuis le navigateur via « Partager » puis « Sur l'écran d'accueil ».
• Android (Chrome) : bannière « Installer l'application » ou menu « Ajouter à l'écran d'accueil ».
• Web : accessible depuis n'importe quel ordinateur, l'interface s'adapte à l'écran.

Une fois installée, l'application se comporte comme une application native : icône, plein écran et notifications.

Inscription et connexion

• Email et mot de passe : la méthode principale.
• Google : connexion en un clic avec un compte Google.
• Code d'invitation : un code transmis par un membre accélère la validation.
• Validation par un administrateur : votre compte reste « en attente » jusqu'à approbation.

Profil membre

• Photo, bannière, bio, centres d'intérêt, pays et ville.
• Thèmes de couleur personnalisables et sections « À propos » modulables.
• Mode portfolio pour mettre en avant ses réalisations professionnelles ou artistiques.
• Liens de parenté visibles depuis l'arbre généalogique.
• Badges et points gagnés grâce à la participation.

Fil d'actualité

Le cœur de l'application : publications texte, photos, vidéos et GIF, avec réactions emoji, commentaires et sondages. Le fil met aussi en avant le « Membre du mois » et le « Conte du mois ».

• Plusieurs photos ou vidéos par publication (galerie en mosaïque).
• GIF et stickers via le bouton « GIF » du compositeur.
• Modification ou suppression de sa publication et de ses commentaires pendant 15 minutes.

Messagerie

• Discussions privées entre deux membres.
• Groupes (branche familiale, comité d'organisation, cousins…).
• Messages en temps réel avec pièces jointes multiples (photos, vidéos).
• Messages vocaux, GIF et emoji directement depuis la barre de saisie.
• Modification d'un message envoyé pendant 15 minutes.

Galerie multimédia

Les photos et vidéos sont regroupées en albums thématiques (mariages, retrouvailles, voyages, archives). Chaque album peut être alimenté par plusieurs membres.

Actualités et annonces

Espace réservé aux nouvelles importantes : naissances, mariages, diplômes, décès. Les annonces sont publiées par les administrateurs et restent visibles en haut de la section.

Calendrier familial

• Événements en ligne ou sur place, avec lieu et pays.
• RSVP : je viens / peut-être / je ne peux pas.
• Rappels automatiques avant l'événement.
• Heures affichées dans votre fuseau horaire.

Carte interactive

Une carte du monde montre où vivent les membres. L'affichage de votre position est facultatif : il dépend uniquement de vos paramètres de confidentialité.

Arbre généalogique

• Vue arborescente avec zoom et déplacement.
• Fiches individuelles reliées aux profils de l'application.
• Ajout d'ancêtres et de descendants, soumis à validation d'un administrateur.
• Filtres par branche, pays et génération, recherche par nom.
• Export en image ou PDF, consultation hors connexion.

Mémoire et traditions

Histoires familiales, traditions et rites, recettes, proverbes et galerie historique. Les contributions peuvent être écrites, enregistrées en audio ou filmées, en français ou en langue locale, et sont publiées après modération.

Notifications

Chaque type peut être activé ou désactivé depuis Profil → Paramètres → Notifications.

Modération

Quatre rôles cohabitent (super admin, admin, modérateur, membre). Tout contenu peut être signalé en deux clics et les nouvelles inscriptions sont validées à la main.

Le modèle de publication est hybride : le fil est libre, tandis que la Place du marché, les événements et la Mémoire passent par une file de validation (Gestion → File de publication).

Appels audio et vidéo

Depuis une conversation, un appel audio (📞) ou vidéo (🎥) peut être lancé en un geste. Les appels sont directs entre téléphones (pair-à-pair chiffré), sans serveur intermédiaire.

• Appel 1-à-1 : audio ou vidéo, avec sonnerie, notification système et écran d'appel entrant.
• Appel de groupe : jusqu'à 5 participants en maillage, grille vidéo adaptative.
• Commandes : micro, caméra, changement d'objectif avant/arrière, raccrocher.
• Sans réponse au bout de 45 secondes, l'appel est marqué « manqué » dans l'historique.
• Au-delà de 5 personnes, utilisez le module Live, conçu pour les grandes assemblées.

Lives et diffusions

Réunions de famille, questions-réponses et célébrations peuvent être diffusées en direct, avec chat en temps réel, programmation à l'avance et rappels automatiques aux membres.

Place du marché

Les membres proposent produits et services à la famille, en CAD, EUR ou XAF. Mise en contact par message privé, notation et avis après échange. Chaque annonce est validée par un modérateur.

Tontine et caisse familiale

• Tontine : cycles automatiques (hebdomadaire, mensuel…), parts par membre (1 à 20), ordre de passage, pénalités de retard paramétrables et rappels J-3 / J-1.
• Le modérateur de la tontine peut modifier ou supprimer une tontine déjà démarrée, ajouter des membres, confirmer les paiements et exporter l'historique en CSV.
• Ponctualité récompensée : +8 points de gamification par cotisation payée à temps.
• Caisse familiale : suivi des entrées et sorties multi-devises, solde en temps réel et justificatifs.

Sondages et messages vocaux

• Sondages : questions à choix multiples publiées dans le fil, résultats en direct.
• Messages vocaux : enregistrement direct depuis la messagerie, lecture avec forme d'onde.
• Réactions par emoji : appui long sur « J'aime » d'une publication, ou réaction directe sur une photo ou une vidéo.

Album vocal des aînés

• Interviews guidées par thèmes (enfance, village, métiers, traditions).
• Enregistrement long format jusqu'à 15 minutes, écoute directe dans l'application.
• Transcription automatique du récit, modifiable à la main.
• Rattachement possible à une fiche de l'arbre généalogique.

Annuaire, anniversaires et recherche

• Annuaire familial : recherche par nom, ville, pays, métier ou centres d'intérêt, avec téléphone et WhatsApp si le membre les rend visibles.
• Anniversaires : widget des prochains anniversaires (30 jours) et rappel le jour J.
• Recherche globale : une seule barre pour retrouver membres, publications, événements, souvenirs et annonces.
• Souvenirs d'archive : les publications d'il y a un an ou plus remontent automatiquement dans le fil.

Gamification

• Points : publication +10, commentaire +4, j'aime +1, cotisation de tontine à l'heure +8.
• Rangs et badges débloqués au fil de la participation.
• Classement familial et « Membre du mois » mis en avant sur le fil.

Mode hors ligne et installation

L'application est une PWA installable : les derniers contenus consultés restent lisibles sans réseau, et un bandeau signale la reconnexion. Une version Android native (Capacitor) permet les notifications push même application fermée.

Créer un compte et faire valider son profil

1. 1Ouvrez l'application et appuyez sur « Rejoindre la famille ».
2. 2Choisissez Email + mot de passe, Google, ou saisissez votre code d'invitation.
3. 3Indiquez votre nom, votre pays de résidence et votre lien avec la famille.
4. 4Lisez et acceptez les Règles de la communauté.
5. 5Votre compte passe en statut « En attente » : un administrateur le valide généralement sous 24 à 48 h.
6. 6Vous recevez une notification dès l'approbation : complétez alors votre profil (photo, bio, intérêts).

Publier une photo ou une vidéo

1. 1Depuis le fil d'actualité, appuyez sur la zone « Partagez une nouvelle… ».
2. 2Écrivez votre message.
3. 3Appuyez sur l'icône image ou vidéo et choisissez un fichier (jusqu'à 50 Mo).
4. 4Vérifiez l'aperçu, puis appuyez sur « Publier ».

Pensez à demander l'accord des personnes visibles sur la photo, en particulier pour les enfants.

Envoyer un message privé ou créer un groupe

1. 1Ouvrez l'onglet « Messages ».
2. 2Pour un message privé : appuyez sur « Nouvelle discussion » et choisissez un membre.
3. 3Pour un groupe : appuyez sur « Nouveau groupe », donnez-lui un nom et sélectionnez les participants.
4. 4Écrivez votre message, ajoutez éventuellement une pièce jointe, puis envoyez.

Ajouter un événement au calendrier

1. 1Ouvrez « Événements » puis appuyez sur « Créer un événement ».
2. 2Renseignez le titre, la description, la date et l'heure (dans votre fuseau).
3. 3Indiquez le lieu, ou cochez « En ligne » et collez le lien.
4. 4Enregistrez : les membres reçoivent une notification et peuvent répondre au RSVP.

Contribuer à l'arbre généalogique

1. 1Ouvrez « Arbre » et naviguez avec deux doigts (zoom) ou en faisant glisser.
2. 2Appuyez sur une personne pour voir sa fiche.
3. 3Appuyez sur « Ajouter un parent » ou « Ajouter un enfant ».
4. 4Renseignez nom, dates, pays, branche, et une photo si vous en avez une.
5. 5Envoyez : la proposition part en validation auprès d'un administrateur.

Partager une histoire ou une recette

1. 1Ouvrez « Mémoire » puis « Contribuer ».
2. 2Choisissez la catégorie : histoire, tradition, recette, proverbe ou photo historique.
3. 3Rédigez votre texte, ou enregistrez un audio / ajoutez une vidéo.
4. 4Pour une recette, listez les ingrédients puis les étapes.
5. 5Précisez la langue, la région et la génération concernée, puis envoyez pour modération.

Modifier ses paramètres de confidentialité

1. 1Ouvrez « Profil » puis « Paramètres ».
2. 2Choisissez qui peut voir votre profil complet et vos coordonnées.
3. 3Activez ou désactivez votre position sur la carte familiale.
4. 4Réglez qui peut vous écrire en privé.
5. 5Ajustez vos notifications, puis enregistrez.

Questions fréquentes

Rôles et permissions

Validation des nouveaux membres

1. 1Ouvrez le tableau de bord « Admin » → onglet « En attente ».
2. 2Vérifiez le nom, le lien de parenté déclaré et le code d'invitation éventuel.
3. 3En cas de doute, contactez le membre référent de la branche concernée.
4. 4Approuvez, ou refusez en indiquant un motif.

Critères d'approbation : lien familial vérifiable, ou parrainage explicite par un membre approuvé.

Modération de contenu

1. 1Ouvrez « Modération » : la file des signalements est triée du plus récent au plus ancien.
2. 2Consultez le contenu signalé et le motif indiqué.
3. 3Choisissez l'action : masquer, supprimer, mettre en sourdine l'auteur, ou rejeter le signalement.
4. 4Chaque décision est enregistrée dans l'historique des actions, consultable par l'équipe.

• Masquer : le contenu disparaît du fil mais reste consultable par l'équipe.
• Supprimer : suppression définitive.
• Sourdine : le membre ne peut plus publier pendant une durée choisie.
• Bannissement : réservé aux administrateurs, pour les cas graves ou répétés.

Gestion des événements

Les administrateurs peuvent créer, modifier et annuler tout événement, y compris ceux créés par d'autres membres. En cas d'annulation, ajoutez toujours un mot d'explication : les participants inscrits sont notifiés automatiquement.

Statistiques et insights

• Nombre de membres approuvés, en attente, actifs sur 30 jours.
• Publications, commentaires et réactions par période.
• Événements à venir et taux de participation (RSVP).
• Contributions à l'arbre et à la section Mémoire en attente de validation.
• Signalements ouverts et délai moyen de traitement.

Stack technique

• Interface : React 19 + TanStack Start / TanStack Router, application web progressive (PWA) installable sur iOS et Android.
• Build : Vite 7, TypeScript, déploiement sur un runtime edge (Cloudflare Workers).
• Styles : Tailwind CSS v4 avec un thème « terre & or » (#1B1410, #C2703D, #E8B84B, #F7F1E8) et mode sombre.
• Données : TanStack Query pour le cache client, Supabase JS pour l'accès à la base.
• Backend : Supabase — authentification, PostgreSQL, stockage privé des médias, temps réel.
• Temps réel : messagerie, présence, chat des lives, notifications et signalisation d'appels via les canaux Supabase Realtime.
• Appels : WebRTC pair-à-pair (maillage jusqu'à 5 participants), sans serveur média.
• Mobile natif : Capacitor pour la version Android et les notifications push FCM.
• Tâches planifiées : rappels d'événements, de lives et de tontines via pg_cron.

Structure de base de données (simplifiée)

Sécurité et confidentialité

• Chiffrement des échanges en transit (HTTPS) et des données au repos côté hébergeur.
• Row Level Security activée sur toutes les tables : seul un membre approuvé (et non mis en sourdine) accède aux contenus et publie.
• Rôles stockés dans une table dédiée, contrôlés par des fonctions SECURITY DEFINER (has_role, is_staff, is_approved) pour éviter toute élévation de privilèges.
• Médias stockés dans un bucket privé et servis via des URL signées à durée limitée, filtrées par can_read_media.
• Protection du contenu : clic droit et téléchargement réservés aux super admins, filigrane nominatif sur les médias.
• Vérification de l'adresse e-mail obligatoire à l'inscription, puis validation manuelle par un administrateur.
• Conformité RGPD : droit d'accès, de rectification et de suppression sur simple demande à un administrateur (page Confidentialité).

Vue d'ensemble en couches

Diagrammes C4

L'architecture est décrite selon le modèle C4, du plus général au plus détaillé. Les diagrammes sources (format Mermaid) sont versionnés dans le dépôt, dossier docs/diagrams.

Organisation des écrans

Le routage est basé sur les fichiers : chaque écran est un fichier de src/routes. Les écrans réservés aux membres approuvés se trouvent sous _authenticated, protégé par une garde de route qui redirige vers la connexion.

• Public : accueil, connexion, réinitialisation du mot de passe, règles, confidentialité, documentation.
• Vie de famille : fil, actualités, galerie, événements, anniversaires, classement.
• Héritage : arbre généalogique, mémoire et traditions.
• Entraide & argent : tontine, caisse, place du marché.
• Échanges : messagerie, appels, lives, annuaire, recherche.
• Gestion : administration, modération, file de publication.

Flux de données

1. 1L'écran demande ses données via TanStack Query (cache local, rechargement en arrière-plan, support hors ligne).
2. 2La fonction métier de src/lib appelle Supabase avec le jeton du membre connecté.
3. 3PostgreSQL applique les politiques RLS : seules les lignes autorisées sont renvoyées.
4. 4Les triggers SQL créent au passage les notifications et les points de gamification.
5. 5Les canaux Realtime poussent les nouveautés (message, présence, appel) directement dans l'interface.

Aucune logique de sécurité n'est laissée au téléphone : la base reste la seule autorité sur ce qu'un membre peut lire ou écrire.

Architecture des appels

1. 1L'appelant crée une ligne dans la table calls (et call_participants pour un groupe).
2. 2La signalisation (offres, réponses, candidats réseau) transite par un canal Realtime ciblé destinataire par destinataire.
3. 3Chaque paire de participants ouvre une connexion WebRTC directe : en groupe, chacun est relié à tous les autres (maillage).
4. 4L'audio et la vidéo ne transitent jamais par nos serveurs ; seule la signalisation le fait.
5. 5Fin d'appel, refus ou absence de réponse au bout de 45 s : le statut est écrit dans calls pour l'historique.

Chaîne de notification

• Trigger SQL → table notifications (source unique de vérité).
• Realtime → badge, bandeau in-app et signal sonore.
• Service Worker → notification système sur le téléphone, même onglet fermé.
• Capacitor + FCM → notification push Android, application fermée.

Livraison et environnements

• Code source synchronisé en continu avec le dépôt GitHub privé de la famille.
• Aperçu de préproduction pour valider chaque évolution avant publication.
• Production web : votre domaine de production.
• Android : bundle signé (.aab) généré via Capacitor, voir GUIDE-ANDROID.md pour le détail des commandes.
• Migrations de base versionnées dans supabase/migrations, appliquées dans l'ordre.

Les mots de l'application

Nous joindre

Des tutoriels vidéo courts seront ajoutés progressivement dans cette section (création de compte, première publication, arbre généalogique).

Cette documentation évolue avec l'application : chaque nouvelle fonctionnalité y est ajoutée sous forme d'une nouvelle sous-section.