Militant - Application Mobile
Description
Militant est un réseau social décentralisé conçu pour les mouvements militants et les organisations politiques. Cette application mobile permet de se connecter à n'importe quelle instance Militant auto-hébergée.
Version actuelle : 1.1.0+139.
Nouveautés 1.1.0 (build 139)
- Navigation et interface harmonisées pour un accès plus direct aux espaces principaux.
- Meilleure prise en charge des thèmes clair et sombre, de l'accessibilité et des états de chargement.
- Mode hors ligne plus visible et chargement des médias plus fiable.
- Enregistrement des publications avec confirmation immédiate et possibilité d'annulation.
Nouveautés 1.0.9 (build 138)
-
Fiabilité des appels et notifications : corrections de réception des appels entrants et des notifications, avec OneSignal rétabli comme choix par défaut dans l’édition Google Play.
-
Mentions : les profils mentionnés affichent désormais leur avatar et le lien ouvre bien leur profil.
-
Deux binaires distincts : le binaire F-Droid est compilé sans SDK OneSignal ; l’APK/AAB Google Play conserve OneSignal. Le script de compilation choisit automatiquement le manifeste de dépendances correspondant.
-
Gestion des Notifications par E-mail & Contrôle des Interactions (Build 136) :
- Interrupteur d'e-mails dédié : Réintégration du commutateur dans les Paramètres > Notifications pour activer ou désactiver les alertes par e-mail directement depuis l'application mobile.
- Respect strict des préférences d'interactions : La désactivation de « J'aime » (ou commentaires, messages...) empêche désormais l'envoi indésirable d'e-mails ou de notifications push pour chaque like.
- Synchronisation bidirectionnelle : Alignement automatique des préférences de notifications entre l'application mobile et le profil web.
- Accessibilité continue des interactions : Les paramètres fins d'interactions restent visibles et configurables même si le push principal est désactivé.
-
Notifications Push Dégooglisées (ntfy) & Double Diffusion :
- Support complet d'un serveur de notifications push auto-hébergé et dégooglisé via ntfy (
push.revlibertaire.com).
- Connexion temps réel WebSocket / flux HTTP persistant sans dépendance aux Google Play Services ou Firebase.
- Sélecteur de fournisseur dans les Paramètres : ntfy, OneSignal ou les deux en simultané (double diffusion).
- Prise en charge des appels entrants audio & vidéo avec ntfy : ouverture directe de l'écran d'appel au clic sur "Répondre".
- Demande proactive de permission Android 13+ (
POST_NOTIFICATIONS) dès l'initialisation et au changement de préférences.
-
Variantes F-Droid (Libre) & Google Play Store :
- Édition F-Droid (
FDROID_BUILD=true) : 100% libre et dégooglisée, services Firebase désactivés, paramètres épurés sans options propriétaires.
- Édition Play Store (
FDROID_BUILD=false) : intégration OneSignal (Google FCM) pour distribution Play Store.
- Coexistence des deux versions possible sur le même appareil de test grâce à un
applicationId distinct (.fdroid).
- Scripts de compilation automatisés dans le dossier
scripts/ (build_fdroid.sh et build_playstore.sh).
-
Fediverse & Profil :
- Remplacement de l'adresse email sur le profil par l'identifiant Fediverse complet (ex:
@[email protected]).
- Clic rapide sur le handle Fediverse pour le copier directement dans le presse-papier avec confirmation.
- Corrections et améliorations sur l'écran Fediverse et la navigation des profils décentralisés.
- Ajout du défilement infini fluide (pagination automatique) pour les publications sur les profils.
-
Notifications & Messagerie :
- Redirection et ouverture automatique de la conversation (
ChatScreen et GroupChatScreen) lors du clic sur une notification push de message privé ou groupe.
- Résolution dynamique de l'avatar et du pseudo de l'interlocuteur dans la barre de titre du chat.
- Décodage JSON sécurisé et résilient dans le client API pour éviter les erreurs de réception serveur.
-
Appels vocaux & vidéo (WebRTC) :
- Support complet des appels longue durée : prolongation du relais TURN à 24h sans coupure.
- Optimisation du chargement et du redimensionnement des avatars d'appel entrant avec Coil 2.7.0 (économie de mémoire RAM).
-
Conformité & Performances Android 15 :
- Prise en charge native du bord-à-bord Android 15 (
Edge-to-Edge) et nettoyage des API système dépréciées.
- Optimisations R8 (fullMode) et réduction de taille des ressources (
resource shrinking).
- Version applicative synchronisée sur
1.0.9 (code de version 138).
Nouveautés 1.0.8
- Optimisation et internationalisation complète de la barre de recherche des groupes (style Facebook) et des messages (Français, Anglais, Espagnol)
- Navigation vers le profil d'un utilisateur en cliquant sur son nom/avatar depuis les messages, invitations et listes de membres.
- Correction du bug d'affichage du changement de compte et de la déconnexion sur les profils tiers (visible uniquement sur son propre profil).
- Réinitialisation du mot de passe depuis l’écran de connexion.
- Changement rapide de compte avec comptes enregistrés localement.
- Ajout d’un autre compte sans déconnexion préalable.
- Protection de la session active pendant l’ajout ou la bascule de compte.
- Correction des cas où un compte local pouvait disparaître après l’ajout d’un autre compte.
- Version affichée dans À propos synchronisée avec
1.0.8.
- Build Android release généré en APK et App Bundle Play Store.
Fonctionnalités
Authentification & Comptes
- Mot de passe oublié : demande de lien de réinitialisation directement depuis l’écran de connexion.
- Comptes rapides : sauvegarde locale des comptes connectés pour basculer rapidement entre plusieurs profils.
- Ajouter un compte : connexion à un autre compte sans devoir se déconnecter manuellement du compte courant.
- Protection de session : si une session enregistrée est expirée, l’app restaure la session précédente et demande une reconnexion.
Réseau Social Complet
- Posts : Création, modification, suppression de publications avec support multimédia (images, vidéos, audio)
- Interactions : Likes, commentaires, partages, réactions
- Profils : Personnalisation complète avec avatar, bannière, bio, liens sociaux
- Badges militants : Système de badges exclusif à l'app mobile (Militant, Antifa, Anarchiste, CNT-AIT, CNT-F, CNT-SO, FA, OCL, CGA, UCL, FLL, SLM, IWA-AIT, IWW, IAF-IFA, CNT-AIT-E, ULET-AIT)
Communication
- Messages privés : Conversations individuelles et groupes en temps réel
- Notifications Push Dégooglisées : Système d'alertes via serveur ntfy souverain auto-hébergé (sans compte Google ni trackers) ou OneSignal
- Appels WebRTC : Appels audio et vidéo chiffrés de pair à pair avec notification d'appel entrant et réponse directe
- Mentions : Mentionnez d'autres utilisateurs avec @
- Liens cliquables : Détection automatique des URLs avec cartes de prévisualisation pour les réseaux sociaux
Groupes & Événements
- Groupes : Créez et rejoignez des groupes militants avec système d’adhésion privée et invitations.
- Événements : Organisez et participez à des événements militants locaux ou nationaux.
- Stories : Partagez des moments éphémères (24h) avec prévisualisation vidéo.
- Lives (v1.0.6) : Diffusions en direct avec modération communautaire et gestion des invités en temps réel.
Fediverse
- Espace Fediverse mobile : onglets dédiés Flux, Profils, Abonnements et Abonnés.
- Recherche fédérée : recherche de profils et d’adresses comme
@[email protected].
- Profils distants : ouverture des profils Fediverse externes avec affichage des posts récents.
- Abonnements distants : suivi et désabonnement de comptes ActivityPub/Mastodon depuis l’application.
- Flux distant : consultation des contenus publiés par les comptes fédérés suivis.
- Identité locale : affichage de l’identité Fediverse locale de l’utilisateur dans l’application.
Modération & Sécurité
- Modération Démocratique : Système révolutionnaire où les modérateurs sont élus par vote (70% consensus)
- Transparence : Journal public de toutes les actions de modération
- Candidature : Tout utilisateur peut se porter candidat et retirer sa candidature
- Révocation : Les modérateurs peuvent être révoqués par vote populaire
- Actions : Suppression directe et avertissements pour les élus
- Signalements : Signalez les contenus inappropriés
- Comptes privés : Contrôlez qui peut vous suivre
Multilingue
- 3 langues : Français, Anglais, Espagnol
- Traduction automatique : Traduisez les posts dans votre langue
Technique
- Connexion multi-instances : Connectez-vous à n'importe quelle instance Militant
- Mode hors ligne : Consultez le contenu même sans connexion
- Thème sombre : Interface moderne avec couleurs du projet
- Performance : Optimisé pour supporter des milliers d'utilisateurs simultanés
Prérequis
- Flutter 3.0 ou supérieur
- Dart 3.0 ou supérieur
- Android Studio (pour le développement Android)
- Un émulateur Android ou appareil physique
Note : Android est supporté.
Installation
Cloner le projet
git clone https://gitlab.com/votre-username/militant-flutter.git
cd militant_flutter
Installer les dépendances
flutter pub get
Lancer l'application
# Sur émulateur/appareil connecté
flutter run
# Build APK de debug
flutter build apk --debug
# Build APK de release
flutter build apk --release
Configuration
URL de l'instance
L'application se connecte par défaut à https://api.militant.revlibertaire.com. Vous pouvez changer d'instance directement depuis l'écran de connexion.
Lives (v1.0.6) - Système Avancé
L’onglet Live s’appuie sur LiveKit et offre une expérience de diffusion militante sécurisée.
[!CAUTION]
Sécurité : Ne compilez jamais l'application avec vos secrets (LIVEKIT_API_SECRET). L'application utilise uniquement l'URL du serveur et l'URL de l'API pour récupérer des jetons sécurisés. Le secret doit rester exclusivement sur votre serveur militant-api.
[!TIP]
Format de l'URL : L'URL du serveur (LIVEKIT_URL) doit impérativement commencer par wss:// (ex: wss://live.votre-instance.org).
- Modération démocratique : Les créateurs peuvent nommer des modérateurs révocables sans hiérarchie. Le blocage des utilisateurs du chat est immédiat.
- Gestion des invités (Request Guest) : Système robuste permettant aux spectateurs de demander à "monter" dans le live, avec approbation/rejet en temps réel par le créateur.
- Sécurité u{id} : Utilisation d'identifiants persistants pour garantir une modération efficace même si l'utilisateur change de pseudonyme.
- Auto-nettoyage : Fermeture automatique des sessions inactives ou suite à une déconnexion prolongée du créateur (timeout 2 min).
- Consensus de signalement : Option de signalement communautaire ; si un seuil de votes est atteint, le live est automatiquement suspendu par sécurité.
Configuration technique (militant-api) : configurez au minimum LIVEKIT_URL, LIVEKIT_API_KEY et LIVEKIT_API_SECRET pour que l’endpoint POST …/v1/lives.php?path=token puisse répondre.
Fediverse mobile
L’application intègre désormais un espace Fediverse permettant de se connecter plus directement à l’écosystème ActivityPub.
- Recherche de comptes distants : prise en charge des handles et profils fédérés.
- Abonnements / abonnés : listes dédiées pour retrouver les comptes suivis et les abonnés Fediverse.
- Flux Fediverse : lecture des contenus distants synchronisés par l’API.
- Profils distants : affichage des avatars, bios, handles et posts récents.
Côté API (militant-api), cela suppose l’activation des endpoints Fediverse mobiles, notamment pour :
- la recherche distante
- le suivi / désabonnement de comptes externes
- la récupération des listes
followers / following
- l’exposition du
feed Fediverse
- la résolution des profils distants
Badges militants (exclusif mobile)
Les badges militants sont une fonctionnalité exclusive à l'application mobile. Ils permettent d'afficher votre appartenance à un mouvement ou une organisation :
- Militant (générique)
- Antifa
- Anarchiste
- CNT-AIT, CNT-F, CNT-SO
- FA (Fédération Anarchiste)
- OCL (Organisation Communiste Libertaire)
- CGA (Coordination des Groupes Anarchistes)
- UCL (Union Communiste Libertaire)
- FLL (Front de Libération Libertaire)
- SLM (Solidarité Libertaire Militante)
- IWA-AIT (International Workers' Association)
- IWW (Industrial Workers of the World)
- IAF-IFA (Internationale des Fédérations Anarchistes)
- CNT-AIT-E (Confederación Nacional del Trabajo)
- ULET-AIT
Pour choisir votre badge : Profil → Paramètres → Mon badge militant
Structure du projet
militant_flutter/
├── lib/
│ ├── main.dart # Point d'entrée de l'application
│ ├── models/ # Modèles de données
│ │ ├── post.dart
│ │ ├── user.dart
│ │ └── ...
│ ├── screens/ # Écrans de l'application
│ │ ├── home_screen.dart
│ │ ├── login_screen.dart
│ │ ├── profile_screen.dart
│ │ ├── messages_screen.dart
│ │ ├── groups_screen.dart
│ │ ├── events_screen.dart
│ │ ├── badge_selection_screen.dart
│ │ └── ...
│ ├── widgets/ # Composants réutilisables
│ │ ├── post_card.dart
│ │ ├── militant_badge.dart
│ │ ├── linkable_text.dart
│ │ └── ...
│ └── services/ # Services (API, langue)
│ ├── account_switcher_service.dart
│ ├── api_service.dart
│ └── language_service.dart
├── android/ # Configuration Android
├── ios/ # Configuration iOS
├── assets/
│ ├── logo.svg # Logo de l'application
│ ├── badges/ # Badges militants (exclusif mobile)
│ │ ├── militant.svg
│ │ ├── antifa.svg
│ │ ├── anarchist.svg
│ │ ├── cnt-ait.png
│ │ ├── cnt-f.jpg
│ │ ├── cnt-so.png
│ │ ├── fa.png
│ │ ├── ocl.gif
│ │ ├── cga.svg
│ │ ├── ucl.jpg
│ │ ├── fll.jpg
│ │ ├── slm.png
│ │ ├── iwa-ait.png
│ │ ├── iww.svg
│ │ ├── iaf-ifa.png
│ │ ├── cnt-ait-e.jpg
│ │ ├── ulet-ait.png
│ │ └── ...
│ └── offline.html # Page hors ligne
├── docs/ # Documentation technique et publication
├── scripts/
│ ├── test/ # Tests et diagnostics manuels
│ └── release/ # Publication des versions
├── test/ # Tests automatisés Flutter
└── pubspec.yaml # Dépendances Flutter
Documentation
Les tests et diagnostics manuels sont regroupés dans scripts/test/. Les
scripts de construction restent directement dans scripts/ et les scripts de
publication sont placés dans scripts/release/.
Dépendances principales
http : Communication avec l'API RESTshared_preferences : Sauvegarde des préférences utilisateurflutter_svg : Affichage des logos et badges SVGimage_picker : Sélection d'images et vidéosvideo_player : Lecture de vidéosaudioplayers : Lecture de fichiers audiofile_picker : Sélection de fichiersurl_launcher : Ouverture de liens externesshare_plus : Partage de contenuintl : Internationalisation et formatage de dates
Compilation & Build de production
L'application supporte deux modes de compilation distincts selon la cible de distribution :
1. Version F-Droid / Autonome (100% Libre & Dégooglisée)
Cette version est exempte de trackers et de dépendances aux services propriétaires Google :
- Push par défaut :
ntfy via WebSocket persistant sur votre serveur auto-hébergé (push.revlibertaire.com).
- Services Google / Firebase : désactivés au niveau Gradle.
- Paramètres : interface épurée masquant les options propriétaires, tout en conservant la configuration granulaire des alertes.
# Compilation via le script automatisé :
./scripts/build_fdroid.sh
# Ou via la commande Flutter directe :
flutter build apk --release \
--dart-define=DEFAULT_PUSH_PROVIDER=ntfy \
--dart-define=FDROID_BUILD=true
L'APK prêt à distribuer est généré dans dist/militant-fdroid.apk.
2. Version Google Play Store
Cette version intègre les services Google Play et OneSignal pour une distribution standard sur le Play Store :
- Push par défaut : OneSignal (Google FCM) avec possibilité pour l'utilisateur de basculer sur ntfy ou double diffusion.
- Format de publication : Android App Bundle (
.aab) requis par la Google Play Console.
# Compilation via le script automatisé (génère .aab et .apk) :
./scripts/build_playstore.sh
# Ou via les commandes Flutter directes :
# Pour la Play Console (App Bundle) :
flutter build appbundle --release \
--dart-define=DEFAULT_PUSH_PROVIDER=onesignal \
--dart-define=FDROID_BUILD=false
# Pour tester en APK local :
flutter build apk --release \
--dart-define=DEFAULT_PUSH_PROVIDER=onesignal \
--dart-define=FDROID_BUILD=false
Les fichiers sont générés dans :
dist/militant-playstore.aab (à téléverser sur la Google Play Console)dist/militant-playstore.apk (pour test direct)
Tester les deux versions côte à côte sur le même appareil
Pour tester simultanément la version Play Store et la version F-Droid sans conflit d'installation :
- Play Store utilise le package standard :
com.militant.militant_flutter
- F-Droid utilise le suffixe dédié :
com.militant.militant_flutter.fdroid
# Installer la version F-Droid sur votre appareil connecté
adb install dist/militant-fdroid-debug.apk
# Installer la version Play Store sur le même appareil
adb install dist/militant-playstore-debug.apk
Les deux applications apparaîtront séparément sur l'écran d'accueil de votre téléphone.
Performance & Scalabilité
L'application et l'API sont optimisées pour supporter un grand nombre d'utilisateurs :
- Rate limiting généreux : 1000 requêtes/minute par IP, 500-1000 requêtes/heure par utilisateur
- Capacité : Support de 5 000 à 50 000+ utilisateurs actifs simultanés selon le serveur
- Optimisations : Pagination, cache, requêtes optimisées
- Sécurité : Protection contre les attaques DDoS, brute force, injection SQL, XSS
Déploiement
Google Play Store
- Créer ou ouvrir la console Google Play.
- Téléverser le fichier
dist/militant-playstore.aab.
- Remplir les fiches de version et valider le déploiement.
F-Droid / Dépôt tiers
- Téléverser l'APK
dist/militant-fdroid.apk sur votre serveur web ou repository F-Droid.
- Signer le fichier avec votre keystore officiel.
Contribution
Les contributions sont les bienvenues ! Pour contribuer :
- Fork le projet
- Créer une branche (
git checkout -b feature/amelioration)
- Commit les changements (
git commit -m 'Ajout fonctionnalité')
- Push vers la branche (
git push origin feature/amelioration)
- Ouvrir une Merge Request
Contributeurs
Merci aux personnes qui font vivre Militant.
Licence
Ce projet est sous licence AGPL-3.0. Voir le fichier LICENSE pour plus de détails.
Liens
Support
Pour toute question ou problème :
- Ouvrir une issue sur GitLab
- Contacter l'équipe de développement
- Consulter la documentation
