Aller au contenu
Soufiene Cherif
Al-Nassr Saudi — النصر السعودي

ÉTUDE DE CAS · PROJET PERSONNEL · SPORT · APPLICATION FAN

Al-Nassr Saudi — النصر السعودي

Application Flutter pour les supporters d'Al-Nassr FC : actualités, posts sociaux, vidéos et lives, calendrier et classement au même endroit, avec commentaires, likes et notifications push.

RÔLE
Développeur solo — Mobile, Backend & Admin
PÉRIODE
Dec 2023 - Aujourd'hui
TYPE
Projet personnel
LIEU
Sfax, Tunisie
PÉRIMÈTREApp mobileCRM & administrationBack-endCloud & domainePublication storesMonétisation

01 — VUE GLOBALE

Al-Nassr Saudi est une application Android et iOS (une seule base de code Flutter) pour les supporters d'Al-Nassr FC (Saudi Pro League), publiée sur Google Play.

Elle est monétisée avec AdMob et un abonnement VIP, et repose sur un backend Firebase serverless. En v2, j'ai réécrit l'application en Clean Architecture avec Bloc, déplacé toute la logique sensible dans des Cloud Functions et construit une console d'administration web pour la modération, les campagnes push, le contenu sponsorisé et les statistiques.

02 — CAPTURES D’ÉCRAN

Captures d’écran

Glisser · Cliquer pour agrandir

03 — FONCTIONNALITÉS CLÉS

01

Fil d'actualités unifié : articles de presse, posts Facebook, actualités de l'équipe nationale et vidéos, fusionnés par date avec une pagination indépendante par source. Filtres par source, lecteur d'article HTML, visionneuse d'images avec zoom, partage.

02

Vidéos & live : lecteur YouTube intégré, onglet live avec chat en direct (onglet activable à distance).

03

Matchs & classement : calendrier, résultats, fiche de match et classement de la Saudi Pro League, synchronisés côté serveur (ESPN, avec TheSportsDB en secours). Alertes de coup d'envoi et de fin de match.

04

Communauté : commentaires avec réponses, likes sur les posts et les commentaires, compteur de vues, notifications de réponses et de likes.

05

Modération côté utilisateur : masquer une source, bloquer un utilisateur, signaler un contenu ou un commentaire.

06

Notifications push : abonnement par canal (actualités, Facebook, équipe nationale, vidéos, matchs), deep links vers le contenu, boîte de réception locale des notifications reçues.

07

Bibliothèque : éléments sauvegardés consultables hors ligne, historique de lecture. Recherche dans tous les fils.

08

Feedback : conversation privée avec l'équipe de l'app (réponses reçues en push) et notation.

09

VIP : abonnement in-app (RevenueCat) qui retire les publicités et affiche un badge VIP. Un seul abonnement par compte, bouton « gérer l'abonnement », expiration gérée côté serveur.

10

Publicité : bannière ancrée, natives dans les fils et les vidéos, interstitiel avec plafond de fréquence. Posts sponsorisés gérés depuis la console (suivi des impressions et des clics) et formulaire « Advertise with us » avec fil de discussion.

11

Compte : connexion Google, consentement à la politique de confidentialité, suppression du compte (exigence des stores), pages CGU / confidentialité bilingues.

12

Expérience : Material 3, thèmes clair et sombre, arabe RTL et anglais, taille du texte réglable, barres masquées au scroll, splash et icônes adaptatives, invitation à mettre à jour contrôlée à distance, demande d'avis in-app, fonds d'écran (enregistrer ou définir une image).

04 — MON RÔLE

  1. 01Développeur unique, de bout en bout : application mobile, backend Firebase / Cloud Functions, console d'administration web.
  2. 02Architecture et réécriture complète de l'application Flutter en v2 (Clean Architecture, Bloc).
  3. 03Publication et maintenance sur Google Play.
  4. 04Monétisation : publicités AdMob, abonnement VIP avec RevenueCat, posts sponsorisés.

05 — IMPACT

  • 15 modules fonctionnels dans l'application mobile.
  • Plus de 20 Cloud Functions (callables, triggers, tâches planifiées, webhook, API admin).
  • 12 pages dans la console d'administration, 3 niveaux de rôles.

06

Console d'administration (nouvelle en v2)

  • Application web hébergée sur Firebase Hosting, construite avec Astro (pages pré-rendues servies par CDN) + React islands + Tailwind CSS 4. Aucun secret et pas de serveur dédié : toutes les données passent par une API back-office sécurisée dans Cloud Functions.
  • Accès : connexion Google uniquement, pas d'inscription. Trois rôles : Moderator, Admin, Owner. L'accès exige un custom claim Firebase (posé uniquement par le backend) et une fiche administrateur active, ce qui permet de révoquer un accès instantanément. Les owners invitent et activent les administrateurs.
  • Dashboard : utilisateurs, activité, abonnés VIP, appareils, langues, engagement, contenus les plus populaires et éléments à traiter, avec filtre par période. Statistiques mises en cache pour réduire les lectures Firestore.
  • Utilisateurs : recherche, filtres (VIP, bannis), tri (création, dernière activité, nom, temps passé dans l'app), fiche détaillée (appareil, temps passé), bannir / débannir, accorder / retirer le VIP, envoyer une notification, supprimer le compte.
  • Feedback : boîte de réception (non lus / ouverts / résolus), réponses envoyées en push, réponses types, notes des utilisateurs.
  • Signalements & contenus : traiter les news et commentaires signalés, supprimer un commentaire ou un post, bannir l'auteur, voir les vues, likes et commentaires de chaque post.
  • Campagnes push : envoi à tous, aux VIP, aux abonnés d'un canal ou à un seul utilisateur. Filtres par langue et par activité (actifs / inactifs / inscrits depuis une période ou une date). Image, lien, action dans l'app, aperçu et historique.
  • Sponsoring : création et suivi des posts sponsorisés, gestion des demandes « Advertise with us », export d'un rapport publicitaire en PDF pour l'annonceur.
  • Réglages de l'app à distance : publicités on/off, onglet live, invitation à mettre à jour (version, titre, message).
  • Journal d'activité : chaque action faite depuis la console est tracée.

Captures de la console d'administration

Glisser · Cliquer pour agrandir

07

Backend (Firebase + Cloud Functions)

  • Firebase Authentication, Cloud Firestore, Cloud Messaging, Cloud Functions (TypeScript, Node 22, europe-west1), Analytics et Hosting.
  • Fonctions callable : likes, commentaires et vues (transactions et incréments atomiques), blocage d'utilisateurs, suppression de compte, posts sponsorisés, demandes publicitaires.
  • Triggers Firestore : notifications de commentaires, réponses, likes et réponses au feedback, envoyées avec l'Admin SDK.
  • Tâches planifiées : synchronisation des matchs et du classement (en pause la nuit, heure de Riyad, pour économiser les appels), expiration des abonnements VIP.
  • Webhook RevenueCat pour l'état des abonnements.
  • Index dédiés (audience push, inbox feedback) pour que la console ne scanne jamais des collections entières.

08

Défis techniques

  • Réécrire sans casser la production : la v1 et un crawler de news utilisent toujours la même base Firestore. J'ai gelé le schéma existant et je n'ai fait que des ajouts, donc v1 et v2 tournent en parallèle.
  • Sécurité : la v1 envoyait les push depuis l'app avec une clé serveur FCM intégrée à l'APK (API legacy, depuis arrêtée par Google). En v2, toute la logique sensible (push, likes, commentaires, blocages, suppression de compte) est exécutée côté serveur.
  • Fiabilité des données : les likes et commentaires écrits par le client (qui réécrivaient des listes entières) sont remplacés par des transactions côté serveur. Le compteur de vues utilise un incrément atomique.
  • Fil multi-sources : un Bloc fusionne plusieurs collections, chacune avec son propre curseur et un « watermark », pour garder un ordre chronologique correct pendant la pagination.
  • Coûts : moins de lectures Firestore dans la console (cache des stats, index dédiés), synchronisation des matchs en pause la nuit.
  • i18n & RTL : arabe par défaut (RTL) et anglais, avec une direction du texte adaptée au contenu (scores, textes mixtes).

09

Chronologie

  • Déc. 2023 : début du projet (v1).
  • Nov. 2024 : publication sur Google Play.
  • Juil. 2025 : mise à jour du target SDK et corrections.
  • Nov. 2026 : v2, réécriture complète (architecture, design, backend, console d'administration).

10 — STACK TECHNIQUE

  • Flutter
  • Dart
  • Bloc / Cubit
  • Clean Architecture
  • Firebase
  • Cloud Functions
  • TypeScript
  • Cloud Firestore
  • Firebase Cloud Messaging
  • Firebase Auth
  • Firebase Analytics
  • Firebase Hosting
  • Node.js 22
  • get_it
  • go_router
  • Material 3
  • Astro
  • React 19
  • Tailwind CSS 4
  • Recharts
  • jsPDF
  • Google AdMob
  • RevenueCat
  • YouTube
  • ESPN API
  • TheSportsDB
  • Google Sign-In
  • bloc_test
  • mocktail
Me contacterCV ↓

Essayez : Kotlin · Firebase · Koweït · sécurité · SOS