Spaces:
Running
Running
Ctrl+K
# Spécifications pour l'application TikoDeal - République Centrafricaine ## 1. Objectif Global et Contexte ### 1.1 Objectif de l'application TikoDeal L'objectif principal de l'application TikoDeal est de **permettre aux particuliers et micro-entreprises centrafricains de publier gratuitement, en moins de 60 secondes, des annonces de produits ou de services**. Ces annonces seront visibles pendant une période initiale de 5 jours. Au-delà de cette période, un système de paiement local (mobile money et espèces) permettra de prolonger leur visibilité. L'application, disponible sous forme de Progressive Web App (PWA) et d'application mobile, sera multilingue (Sango, Français, Anglais) et conçue pour fonctionner de manière optimale même sur des connexions 2G/3G instables et des appareils à faibles ressources. ### 1.2 Cible prioritaire et contexte centrafricain La **cible prioritaire de TikoDeal est la population de la République Centrafricaine (RCA)**, avec un accent particulier sur les particuliers et les micro-entrepreneurs. Le contexte centrafricain présente des défis spécifiques tels que des **infrastructures de télécommunication parfois limitées** (réseaux 2G/3G prédominants, faible bande passante, instabilité de la connexion), une **prévalence d'appareils mobiles d'entrée de gamme** (smartphones Android à moins de 50 €), et des **habitudes de paiement basées sur le mobile money** (Orange Money, Moov Money, Wave) et les espèces. L'application doit donc être conçue pour être légère, économe en données et en énergie, et intégrer des solutions de paiement adaptées à ces réalités locales. ### 1.3 Version et date cible La première version de l'application, **TikoDeal v1.0**, est prévue pour une sortie cible en **juillet 2025**. Cette version inclura l'ensemble des fonctionnalités de base décrites dans le cahier des charges, permettant la publication et la consultation d'annonces, la gestion des profils utilisateurs, la messagerie sécurisée, et le système de prolongation payante via les modes de paiement locaux. ## 2. Personas et User Stories ### 2.1 Personas cibles Les personas suivants ont été définis pour représenter les utilisateurs types de TikoDeal en République Centrafricaine : 1. **« Chantal »** : Vendeuse de pagnes à Bangui. Elle utilise un smartphone Android d'entrée de gamme (coûtant moins de 50 €) et effectue ses transactions via Orange Money. Elle a besoin de toucher plus de clients et d'augmenter ses ventes. 2. **« Serge »** : Mécanicien à Berbérati. Il utilise une tablette 3G pour ses recherches. Il a besoin de trouver des pièces automobiles à proximité pour réduire les coûts de transport et gagner du temps. 3. **« M. Ngbalo »** : Agent immobilier à Bambari. Il publie environ 20 annonces par mois et est prêt à payer pour prolonger leur visibilité afin de générer plus de prospects et de conclure davantage de transactions. 4. **« ONG locale »** : Cette entité recherche des services de traduction rapide (Sango, Français, Anglais) et consulte les profils de freelances pour communiquer efficacement dans le cadre de ses projets. ### 2.2 User Stories (format "En tant que... je veux... afin de...") Les user stories suivantes ont été définies pour couvrir les besoins des différents types d'utilisateurs de l'application TikoDeal, en se basant sur les personas identifiés. Ces récits utilisateurs permettent de guider le développement des fonctionnalités en se concentrant sur les objectifs et les motivations des utilisateurs finaux. 1. **En tant que** vendeuse de pagnes à Bangui (représentée par le persona "Chantal"), **je veux** déposer facilement une annonce gratuitement en moins d'une minute, **afin de** toucher plus de clients et d'augmenter mes ventes. Cette user story met l'accent sur la simplicité et la rapidité du processus de dépôt d'annonce, cruciales pour les utilisateurs comme Chantal qui utilisent des smartphones Android bas de gamme et ont potentiellement une connexion internet limitée. La gratuité initiale pour une durée de 5 jours est également un facteur important pour inciter les micro-entrepreneurs comme Chantal à utiliser la plateforme. L'objectif final est de permettre à Chantal d'étendre sa clientèle au-delà de son réseau local immédiat, en utilisant un outil adapté à ses contraintes techniques et financières. 2. **En tant que** mécanicien à Berbérati (représenté par le persona "Serge"), **je veux** chercher des pièces automobiles à proximité, **afin de** réduire les coûts de transport et de gagner du temps dans la réparation des véhicules. Pour Serge, l'accès à une plateforme lui permettant de trouver des pièces détachées localement est essentiel. La fonctionnalité de recherche, notamment par localisation et par catégorie (pièces automobiles), est au cœur de cette user story. L'objectif est de faciliter l'approvisionnement pour les professionnels comme Serge, en leur permettant de trouver rapidement ce dont ils ont besoin sans avoir à parcourir de longues distances, ce qui est particulièrement pertinent dans un contexte où les réseaux de distribution peuvent être moins denses. 3. **En tant que** agent immobilier à Bambari (représenté par le persona "M. Ngbalo"), **je publie** régulièrement des annonces et **je veux** prolonger leur visibilité, **afin de** générer plus de prospects et de conclure davantage de transactions. M. Ngbalo représente un utilisateur plus intensif de la plateforme, qui est prêt à payer pour des services supplémentaires. Cette user story met en avant le système de prolongation d'annonces, avec des options de durée variables (7, 15, 30 jours) et un système de paiement local adapté. L'objectif est de fournir à des professionnels comme M. Ngbalo un outil efficace pour maximiser la portée de leurs annonces et, par conséquent, leur chiffre d'affaires. La simplicité du processus de paiement et la visibilité accrue (badge "TOP") sont des éléments clés pour ce type d'utilisateur. 4. **En tant que** ONG locale, **je veux** trouver des freelances pour des services de traduction rapide, **afin de** communiquer efficacement dans le cadre de mes projets et activités. Cette user story cible un besoin spécifique de services, mettant en lumière la fonctionnalité de recherche de services et de consultation de profils freelances. Pour une ONG opérant en République Centrafricaine, la capacité à trouver rapidement des traducteurs compétents, par exemple en Sango, Français, ou English, est cruciale pour la réussite de ses missions. L'application doit permettre une recherche efficace de profils vérifiés et qualifiés, facilitant ainsi la mise en relation entre les ONG et les prestataires de services indépendants. ## 3. Fonctionnalités Détail ### 3.1 Parcours "Déposer une annonce" Le parcours "Déposer une annonce" est conçu pour être **ultra-rapide et simple**, permettant à un utilisateur de publier une annonce en **moins de 60 secondes**. L'utilisateur arrive sur un écran unique où il peut renseigner toutes les informations nécessaires : * **Catégorie** : Sélection à partir de listes dynamiques (ex: véhicules, immobilier, téléphones, services). * **Titre** : Champ de texte limité à **60 caractères**. * **Description** : Zone de texte permettant jusqu'à **500 caractères**, avec un éditeur riche limité (options de gras et d'emojis). * **Prix** : Champ numérique ou option "À discuter". * **Photos** : Possibilité d'ajouter jusqu'à **5 photos**, qui seront automatiquement compressées pour ne pas dépasser **300 Ko** chacune et converties au format **WebP**. * **Localisation** : Définition de l'emplacement via GPS ou saisie manuelle avec l'aide d'une carte **OpenStreetMap (OSM) hors-ligne**. * **Coordonnées** : Au moins un moyen de contact doit être fourni (WhatsApp, appel vocal, SMS, email). Après validation en cliquant sur "Publier", l'annonce est immédiatement mise en ligne et un **compte à rebours de 5 jours de visibilité gratuite** commence. Un **résumé SEO multilingue** est généré automatiquement pour optimiser la découvrabilité de l'annonce. ### 3.2 Gestion des prolongations d'annonces Après la période gratuite initiale de 5 jours, les utilisateurs peuvent **prolonger la visibilité de leurs annonces** via un écran dédié "Prolonger". Cet écran propose des options de durée (7, 15, ou 30 jours) avec des prix correspondants (**500 F CFA, 1 000 F CFA, 1 800 F CFA** respectivement), ajustables via un tableau d'administration. Les méthodes de paiement locales intégrées sont **Orange Money, Moov Money, Wave, et un paiement en espèces via le réseau d'agences "KangaCash"** (utilisant un QR code et un OTP). Un **fallback USSD** (par exemple, `*144*1*ID_Annonce#`) est prévu pour les paiements sans connexion internet. Après un paiement réussi, un **webhook notifie TikoDeal**, qui met à jour la base de données pour prolonger la date de fin de visibilité de l'annonce et ajoute un **badge "TOP" couleur or** à l'annonce, la mettant en avant. ### 3.3 Profil utilisateur Le profil utilisateur contient les champs suivants : **nom ou nom de la structure, photo de profil, localisation, année de création de la structure (pour les micro-entreprises), liens vers les profils WhatsApp et Telegram, une note moyenne basée sur les étoiles et les commentaires laissés par d'autres utilisateurs, et un badge "Vérifié"**. Ce badge "Vérifié" est obtenu après que l'utilisateur a soumis une photo de sa Carte Nationale d'Identité (CNI) et un selfie pour confirmation d'identité. La **consultation des profils est gratuite** et chaque profil dispose d'une **URL externe partageable** (par exemple, `https://kangamarket.cf/user/123`). ### 3.4 Recherche et filtres La fonctionnalité de recherche permet aux utilisateurs de trouver des annonces par **mode texte, avec une tolérance phonétique pour la langue Sango**. Des filtres avancés sont disponibles : **prix minimum et maximum, distance en kilomètres, catégorie spécifique, option pour n'afficher que les annonces de vendeurs vérifiés, et possibilité de livraison**. Les résultats de recherche peuvent être triés par **pertinence, prix (croissant ou décroissant), date de publication, ou distance**. L'affichage des résultats se fait sous forme de **cartes sur deux colonnes**, avec un **lazy-loading de 10 éléments maximum** par page pour optimiser les performances. Le poids total des éléments de la page de résultats doit être **inférieur à 150 Ko**. ### 3.5 Messagerie sécurisée TikoDeal intègre une **messagerie sécurisée de type chat E2E (End-to-End)**, utilisant une librairie légère similaire à Signal. Cette fonctionnalité permet aux utilisateurs de communiquer directement et de manière privée concernant les annonces. Un **fallback par SMS** est prévu si l'un des utilisateurs est hors connexion, garantissant ainsi la continuité de la communication. Un bouton "Signaler" est disponible dans la messagerie, permettant de rapporter des comportements inappropriés (spam, escroquerie), ce qui déclenchera un **workflow de modération combinant une analyse par IA et une intervention humaine**. ### 3.6 Notifications Le système de notifications utilise **OneSignal pour les notifications push web** et un **webservice local pour l'envoi de SMS**. La fréquence des notifications est limitée à un **maximum de 3 par jour** pour ne pas submerger les utilisateurs. Un mécanisme d'**opt-out simple** est mis à disposition pour permettre aux utilisateurs de gérer leurs préférences de notification. ### 3.7 Administration et modération Un **tableau de bord d'administration** est prévu pour la gestion de la plateforme. Il affichera des **KPI (Key Performance Indicators)** tels que le nombre d'annonces actives, le chiffre d'affaires généré par les prolongations, et le taux de fraude détecté. La **modération des annonces et des utilisateurs** s'appuie sur une **combinaison d'IA et d'intervention humaine**. L'IA sera utilisée pour la détection d'images inappropriées (NSFW - Not Safe For Work) et de textes frauduleux (via des mots-clés et un modèle BERT entraîné pour le Sango et le Français). Les administrateurs pourront également **exporter les données de paiement au format CSV** pour des besoins comptables. ## 4. Contraintes Techniques et Solutions ### 4.1 Faible bande passante et optimisation PWA L'application TikoDeal doit être conçue pour fonctionner de manière optimale dans des conditions de **faible bande passante**, caractéristiques des réseaux **2G/3G instables en République Centrafricaine**. Pour répondre à cette contrainte, plusieurs mesures techniques seront mises en œuvre. Premièrement, l'application sera développée en tant que **Progressive Web App (PWA)**, ce qui permettra une **mise en cache agressive des ressources via un service worker**. La stratégie de cache **"cache first"** sera privilégiée pour les ressources statiques, garantissant que l'application puisse se charger même sans connexion internet active, en utilisant les versions précédemment mises en cache. Deuxièmement, la taille des images sera strictement contrôlée : chaque image téléchargée par les utilisateurs pour leurs annonces sera automatiquement compressée pour ne pas dépasser **300 Ko**. Le format **WebP** sera utilisé pour cette compression, offrant un bon rapport qualité/poids par rapport aux formats traditionnels comme JPEG ou PNG. Enfin, un **mode "Lite"** sera implémenté. Ce mode, activable par l'utilisateur ou automatiquement en fonction des conditions réseau, désactivera les fonctionnalités non essentielles et supprimera les fichiers CSS et JavaScript superflus, permettant de réduire le poids total de la page à **moins de 200 Ko**. Cette approche vise à minimiser le temps de chargement et la consommation de données, améliorant ainsi l'expérience utilisateur sur des connexions lentes ou intermittentes , . Des outils comme Lighthouse et WebPageTest seront utilisés pour mesurer et analyser les performances du réseau dans différentes conditions simulées, notamment en 3G . ### 4.2 Énergie et support d'appareils La **gestion de l'énergie** et le **support d'une large gamme d'appareils**, y compris les smartphones Android d'entrée de gamme (coûtant moins de 50 €), sont des contraintes majeures pour TikoDeal. Pour adresser la problématique énergétique, l'application intégrera un **dark-mode par défaut**. Ce choix n'est pas seulement esthétique mais contribue également à réduire la consommation d'énergie sur les appareils équipés d'écrans OLED ou AMOLED, où les pixels noirs sont éteints. De plus, des techniques d'optimisation de la batterie seront mises en place, telles que la réduction de l'activité en arrière-plan, l'utilisation efficace des timers et des animations, et la minimisation des requêtes réseau inutiles. En ce qui concerne le support des appareils, TikoDeal ciblera spécifiquement **Android 6+ (niveau d'API 23) et iOS 12+**. Ces versions ont été choisies pour couvrir une grande majorité d'appareils en circulation en République Centrafricaine, tout en permettant l'utilisation de fonctionnalités modernes nécessaires à l'application. Le développement avec **Capacitor.js** facilitera le packaging de l'application PWA en applications natives pour Android et iOS, tout en assurant un accès aux API natives comme la caméra, la géolocalisation et les notifications push, essentielles pour l'expérience utilisateur , . Des tests de compatibilité approfondis seront effectués sur une variété d'appareils et de navigateurs pour garantir une expérience uniforme . ### 4.3 Localisation et langues (Sango, Français, English) TikoDeal sera une application **multilingue**, prenant en charge le **Sango, le Français et l'Anglais**, afin de toucher le plus large public possible en République Centrafricaine. La gestion de la localisation sera assurée par le système **i18n (internationalisation)**, utilisant des **fichiers JSON pour chaque langue** (`fr.json`, `sg.json`, `en.json`). Chaque fichier contiendra des paires clé-valeur, où la clé représente l'identifiant du texte à traduire et la valeur sa traduction dans la langue correspondante. Par exemple, un fichier `en.json` pourrait contenir `{ "welcome_message": "Welcome to TikoDeal!" }` et le fichier `fr.json` contiendrait `{ "welcome_message": "Bienvenue sur TikoDeal !" }`. Une **stratégie de fallback** sera implémentée : si une traduction pour une clé spécifique n'est pas disponible dans la langue sélectionnée par l'utilisateur (par exemple, en Sango), l'application affichera la version française de ce texte. Le Français est choisi comme langue de fallback car c'est une langue officielle largement comprise en RCA. Pour les annonces elles-mêmes, une fonctionnalité de **traduction automatique** sera proposée. Lorsqu'un visiteur consulte une annonce dans une langue différente de celle dans laquelle elle a été publiée, **Google Cloud Translation** (ou un service similaire) sera utilisé pour fournir une traduction instantanée. Les résultats de ces traductions automatiques seront **mis en cache pendant 30 jours** pour améliorer les performances et réduire les coûts d'API. L'implémentation technique utilisera probablement une bibliothèque comme `react-i18next` pour React, permettant de charger dynamiquement les fichiers de traduction et de changer de langue à la volée , . Un sélecteur de langue sera disponible dans l'interface utilisateur pour permettre aux utilisateurs de choisir leur langue préférée , . ### 4.4 Monétisation locale (Orange Money, Moov, Wave, cash) La monétisation de TikoDeal repose sur un système de **prolongation de la visibilité des annonces** au-delà de la période gratuite initiale de 5 jours. Ce système de paiement doit s'adapter aux réalités locales de la République Centrafricaine en proposant des méthodes de paiement largement accessibles. L'intégration de l'**API Orange Money pour la Centrafrique** est un élément clé. L'endpoint prévu pour les paiements est `POST /v1/payments`, et le corps de la requête attendu sera de la forme `{ amount, currency:XAF, msisdn, reference }`, où `amount` est le montant à payer, `currency` est fixé à XAF (Franc CFA), `msisdn` est le numéro de téléphone de l'utilisateur effectuant le paiement, et `reference` est un identifiant unique pour la transaction , . Pour les utilisateurs n'ayant pas accès à une connexion de données, un système de **fallback basé sur le code USSD** sera proposé. Un code spécifique, par exemple `*144*1*ID#` (où ID est l'identifiant de l'annonce ou de la transaction), sera généré, permettant à l'utilisateur de payer directement depuis son portefeuille Orange Money sans nécessiter de connexion internet. En plus d'Orange Money, d'autres services de mobile money comme **Moov Money et Wave** seront intégrés de manière similaire, si leurs API le permettent. Pour les paiements en espèces, un partenariat sera établi avec un réseau d'agences de transfert, dénommé **"KangaCash"**. Ce réseau permettra aux utilisateurs de déposer du cash dans une agence, et le paiement sera confirmé sur la plateforme TikoDeal via un **QR code et un OTP (One-Time Password)** fourni à l'utilisateur. Les prix des prolongations seront fixés à **500 F CFA pour 7 jours, 1 000 F CFA pour 15 jours, et 1 800 F CFA pour 30 jours**, avec la possibilité pour l'administrateur de les ajuster via un tableau de bord dédié , . Des solutions comme CinetPay, qui supportent Orange Money et d'autres opérateurs dans plusieurs pays africains, pourraient également être envisagées pour simplifier l'intégration , . ### 4.5 Conformité juridique RCA La **conformité juridique de TikoDeal avec la législation de la République Centrafricaine (RCA)** est une priorité absolue. Les **Conditions Générales d'Utilisation (CGU)** de l'application seront rédigées pour être conformes au droit **OHADA (Organisation pour l'Harmonisation en Afrique du Droit des Affaires)**, qui régit une grande partie du droit des affaires dans les pays membres, dont la RCA. De plus, les CGU respecteront la **loi 20.21 "cyber-centrafrique"**, qui traite spécifiquement des questions liées à la cybercriminalité et à la protection des données dans le pays. La collecte de données personnelles sensibles, telles que les copies de **Cartes Nationales d'Identité (CNI)** pour la vérification des profils, sera effectuée avec le plus grand soin. Ces données seront **cryptées en utilisant l'algorithme AES-256** avant d'être stockées. Le cahier des charges prévoit un **stockage de ces données dans l'Union Européenne (UE)** pour bénéficier d'un niveau de protection équivalent au **RGPD (Règlement Général sur la Protection des Données)**, même si la RCA n'est pas membre de l'UE. Cette approche "RGPD light" vise à assurer un haut niveau de sécurité et de confidentialité pour les données des utilisateurs. Enfin, un mécanisme de **signalement en un clic** sera mis en place pour permettre aux utilisateurs de rapporter facilement tout contenu ou comportement illicite. Ces signalements seront directement transmis au **CNERT-RCA (Centre National de la Réponse aux Urgences Informatiques de la République Centrafricaine)**, l'autorité compétente en matière de cybersécurité et de lutte contre la cybercriminalité. ## 5. Architecture et Stack Technique ### 5.1 Frontend (PWA React, Vite, TailwindCSS, Capacitor.js) Le frontend de TikoDeal sera développé en tant que **Progressive Web App (PWA)** en utilisant la bibliothèque JavaScript **React**. React a été choisi pour sa flexibilité, sa grande communauté et sa capacité à créer des interfaces utilisateur interactives et performantes. Pour la configuration du projet et le bundling des assets, **Vite** sera utilisé à la place de Create React App (CRA). Vite offre des avantages significatifs en termes de vitesse, notamment un démarrage instantané du serveur de développement et un Hot Module Replacement (HMR) plus rapide, grâce à l'utilisation d'ESBuild pour la compilation , . Le framework CSS **TailwindCSS** sera intégré pour le styling. TailwindCSS est un framework "utility-first" qui permet de construire des designs directement dans le balisage en utilisant des classes prédéfinies, favorisant ainsi un développement rapide et une cohérence visuelle , . Pour transformer l'application PWA en applications mobiles natives pour Android et iOS, **Capacitor.js** sera utilisé. Capacitor.js est un runtime d'application native qui permet d'exécuter des applications web (construites avec React, Vue, Angular, etc.) de manière native sur iOS, Android et le web avec une seule base de code , . Il fournit une API multiplateforme pour accéder aux fonctionnalités natives de l'appareil, telles que la caméra, la géolocalisation et les notifications push, via des plugins officiels ou personnalisés , . Cette combinaison de technologies permettra de développer une application performante, multiplateforme, et offrant une expérience proche du natif, tout en bénéficiant des avantages du développement web moderne. ### 5.2 Backend (Node.js, Express, TypeScript, PostgreSQL, Redis) Le backend de TikoDeal sera construit en utilisant **Node.js (version 20 ou supérieure)** avec le framework **Express.js**, le tout codé en **TypeScript**. Node.js a été choisi pour sa performance, sa scalabilité et son modèle non-bloquant, idéal pour les applications nécessitant de nombreuses opérations I/O comme une plateforme d'annonces. Express.js est un framework web minimaliste et flexible pour Node.js, fournissant un ensemble robuste de fonctionnalités pour les applications web et mobiles . L'utilisation de TypeScript apportera une sécurité de type au code JavaScript, facilitant la maintenance, la détection précoce des erreurs et améliorant l'expérience de développement. La base de données principale sera **PostgreSQL**, une base de données relationnelle open source puissante et fiable, gérée idéalement via un service RDS (Relational Database Service) pour une meilleure disponibilité et gestion. PostgreSQL stockera toutes les données structurées de l'application, telles que les informations des utilisateurs, les annonces, les paiements, etc. , . En complément de PostgreSQL, **Redis** sera utilisé comme cache en mémoire. Redis permettra d'améliorer les performances de l'application en stockant temporairement les données fréquemment accédées (comme les résultats de recherche populaires ou les sessions utilisateur), réduisant ainsi la charge sur la base de données principale. Pour le stockage des fichiers, notamment les images des annonces, une solution compatible S3 sera utilisée, telle que Scaleway Object Storage ou une instance Minio auto-hébergée. L'API sera de type RESTful, permettant une interaction standardisée entre le frontend et le backend. Pour les fonctionnalités de chat en temps réel, WebSocket sera implémenté, probablement via la bibliothèque Socket.io, permettant une communication bidirectionnelle et à faible latence entre le client et le serveur. ### 5.3 DevOps (CI/CD, Déploiement, Monitoring) L'approche DevOps pour TikoDeal sera axée sur l'automatisation et la fiabilité du processus de déploiement, ainsi que sur la surveillance continue de l'application. La **CI/CD (Intégration Continue / Déploiement Continu)** sera mise en place à l'aide de **GitHub Actions**. À chaque push ou pull request sur la branche principale, des workflows GitHub Actions seront déclenchés pour exécuter les tests automatisés, construire l'application (frontend et backend), et déployer les nouvelles versions sur l'environnement de production. Le déploiement se fera sur un **VPS (Virtual Private Server) OVH situé à Tunisie**. Ce choix de localisation vise à obtenir une **latence inférieure à 60 ms depuis Bangui**, la capitale de la République Centrafricaine, tout en bénéficiant d'une infrastructure fiable. L'application sera conteneurisée à l'aide de **Docker**, avec des fichiers Dockerfile pour chaque service (backend, frontend, base de données) et un fichier **docker-compose.yml** pour orchestrer le déploiement des différents conteneurs , . **Ansible** sera utilisé pour l'automatisation de la configuration et du déploiement sur le **VPS Ubuntu 22.04**. Des playbooks Ansible permettront de provisionner le serveur, d'installer les dépendances nécessaires (Docker, etc.), de déployer les images Docker et de configurer les services. Pour le monitoring, une stack comprenant **Grafana, Loki et Prometheus** sera déployée. Prometheus sera utilisé pour collecter les métriques de performance de l'application et de l'infrastructure. Loki servira à agréger les logs des différents services. Grafana sera utilisé pour visualiser les données collectées par Prometheus et Loki, permettant à l'équipe de surveiller les KPI (Key Performance Indicators), de détecter les anomalies et de résoudre les problèmes rapidement. Des outils comme Coolify pourraient également être envisagés pour simplifier la gestion des déploiements sur VPS . ## 6. Spécifications Détaillées (Livrables pour l'IA Générative) ### 6.1 Diagrammes de flux utilisateur Les diagrammes de flux utilisateur décrivent les parcours typiques des utilisateurs au sein de l'application TikoDeal. Ces flux visent à illustrer de manière claire et séquentielle les interactions entre l'utilisateur et le système, depuis l'arrivée sur l'application jusqu'à la réalisation de tâches spécifiques. L'objectif est d'identifier les étapes clés, les points de décision et les écrans associés à chaque parcours, en mettant l'accent sur une expérience utilisateur (UX) ultra-simple, comme spécifié dans le cahier des charges. La compréhension de ces flux est essentielle pour la conception de l'interface et la définition des fonctionnalités. #### 6.1.1 Flux normal d'inscription et dépôt d'annonce Ce diagramme de flux décrit le processus complet depuis l'ouverture de l'application par un nouvel utilisateur jusqu'à la publication réussie d'une annonce. Il met en évidence les étapes d'inscription, de connexion, et de remplissage des informations relatives à l'annonce. Chaque étape est décrite de manière à refléter les spécifications du cahier des charges, notamment en ce qui concerne les champs obligatoires, les limites de caractères, le nombre de photos, et les options de localisation et de coordonnées. Ce flux est crucial pour garantir que le parcours principal de l'application, à savoir la publication d'annonces, soit aussi fluide et intuitif que possible, répondant ainsi à l'objectif de publication en 60 secondes. * **Étape 1 :** L'utilisateur ouvre l'application TikoDeal. * **Action :** L'utilisateur lance l'application sur son appareil mobile ou accède au site web. * **Écran :** Écran de chargement/splash screen (le cas échéant), puis écran d'accueil. * **Étape 2 :** Il est dirigé vers l'écran d'accueil. * **Action :** L'application affiche l'écran d'accueil, présentant les principales options (Déposer une annonce, Rechercher, Se connecter). * **Écran :** Écran d'accueil (Home). * **Étape 3 :** Il clique sur 'S'inscrire' s'il est nouveau ou 'Se connecter' s'il a déjà un compte. * **Action :** L'utilisateur choisit de créer un nouveau compte ou d'accéder à un compte existant. * **Écran :** Écran d'accueil avec boutons "S'inscrire" et "Se connecter". * **Étape 4 :** S'il s'inscrit, il entre son nom, son numéro de téléphone et un mot de passe. * **Action :** L'utilisateur remplit le formulaire d'inscription avec les informations requises. * **Écran :** Écran/Formulaire d'inscription. * **Détails :** Les champs "nom", "numéro de téléphone" (utilisé comme identifiant principal) et "mot de passe" sont obligatoires. Une validation du numéro de téléphone (par OTP) pourrait être implémentée. * **Étape 5 :** Après l'inscription ou la connexion, il est redirigé vers son tableau de bord. * **Action :** Le système authentifie l'utilisateur et l'oriente vers son espace personnel. * **Écran :** Tableau de bord utilisateur (User Dashboard). * **Détails :** Le tableau de bord peut afficher les annonces en cours, les messages, les favoris, etc. * **Étape 6 :** Il clique sur 'Déposer une annonce'. * **Action :** L'utilisateur initie le processus de création d'une nouvelle annonce. * **Écran :** Tableau de bord utilisateur avec bouton "Déposer une annonce". * **Étape 7 :** Il sélectionne une catégorie de l'annonce à partir d'une liste déroulante. * **Action :** L'utilisateur choisit la catégorie la plus appropriée pour son produit ou service (ex: Véhicules, Immobilier, Téléphones, Services). * **Écran :** Écran de dépôt d'annonce - Étape 1 : Catégorie. * **Détails :** Les catégories doivent être dynamiques et éventuellement hiérarchiques (catégories et sous-catégories). * **Étape 8 :** Il entre un titre concis (maximum 60 caractères). * **Action :** L'utilisateur saisit un titre accrocheur pour son annonce. * **Écran :** Écran de dépôt d'annonce - Étape 2 : Titre et Description. * **Détails :** Le champ de titre doit compter les caractères et empêcher la saisie au-delà de 60 caractères. * **Étape 9 :** Il rédige une description détaillée (jusqu'à 500 caractères), en utilisant les options de formatage limitées (gras, emojis). * **Action :** L'utilisateur fournit une description complète du produit/service. * **Écran :** Écran de dépôt d'annonce - Étape 2 : Titre et Description. * **Détails :** L'éditeur de texte doit permettre la mise en gras et l'insertion d'emojis. Un compteur de caractères doit être présent (max 500 caractères). * **Étape 10 :** Il indique le prix ou choisit 'À discuter'. * **Action :** L'utilisateur fixe un prix ou opte pour une négociation. * **Écran :** Écran de dépôt d'annonce - Étape 3 : Prix. * **Détails :** Le champ prix doit accepter uniquement des valeurs numériques. Une case à cocher ou un bouton radio "À discuter" doit être disponible. * **Étape 11 :** Il ajoute jusqu'à 5 photos, qui sont automatiquement compressées et converties au format WebP pour une taille inférieure à 300 Ko. * **Action :** L'utilisateur sélectionne et télécharge des photos depuis sa galerie ou prend de nouvelles photos. * **Écran :** Écran de dépôt d'annonce - Étape 4 : Photos. * **Détails :** L'interface doit permettre la sélection multiple jusqu'à 5 images. Une fonction de compression et de conversion en WebP doit s'exécuter automatiquement côté client ou serveur pour réduire la taille des fichiers. Un indicateur de poids et de format est souhaitable. * **Étape 12 :** Il spécifie la localisation (GPS ou choix manuel + carte OSM hors-ligne). * **Action :** L'utilisateur définit l'emplacement de l'annonce. * **Écran :** Écran de dépôt d'annonce - Étape 5 : Localisation. * **Détails :** L'application doit tenter d'utiliser le GPS de l'appareil. Une carte OpenStreetMap hors-ligne doit être disponible pour un choix manuel si le GPS n'est pas disponible ou précis. L'utilisateur doit pouvoir saisir une adresse ou pointer sur une carte. * **Étape 13 :** Il renseigne ses coordonnées (WhatsApp, appel vocal, SMS, email – au moins 1 obligatoire). * **Action :** L'utilisateur indique comment il souhaite être contacté. * **Écran :** Écran de dépôt d'annonce - Étape 6 : Coordonnées. * **Détails :** Des champs pour le numéro de téléphone (WhatsApp, appel, SMS) et l'adresse email doivent être proposés. Au moins un de ces champs doit être rempli pour pouvoir publier. * **Étape 14 :** Il clique sur "Publier". * **Action :** L'utilisateur soumet son annonce. * **Écran :** Écran de dépôt d'annonce - Bouton "Publier". * **Étape 15 :** L'annonce est immédiatement visible pour 5 jours, un résumé SEO multilingue est généré, et un compte à rebours est visible. * **Action :** Le système enregistre l'annonce, génère un résumé optimisé pour le référencement dans les trois langues (Sango, Français, Anglais), et l'affiche dans la liste des annonces. * **Écran :** Confirmation de publication et redirection vers l'annonce publiée. * **Détails :** L'annonce publiée doit afficher un compte à rebours indiquant les 5 jours de visibilité gratuite. Le résumé SEO peut être utilisé pour la balise meta description et pour d'autres fins d'indexation. Ce flux détaillé assure que toutes les spécifications du cahier des charges concernant le dépôt d'annonce sont prises en compte, en particulier l'objectif de simplicité et de rapidité. L'utilisation de listes déroulantes, de champs avec limites de caractères, de la compression automatique des images et de la localisation par GPS ou carte OSM hors-ligne contribue à une expérience utilisateur optimisée pour le contexte centrafricain. La génération automatique d'un résumé SEO multilingue et l'affichage du compte à rebours sont des fonctionnalités clés qui ajoutent de la valeur à l'application. #### 6.1.2 Flux de prolongation d'annonce et paiement Ce diagramme de flux décrit le processus qu'un utilisateur, comme "M. Ngbalo" (agent immobilier), suit pour prolonger la visibilité d'une de ses annonces après la période gratuite initiale de 5 jours. Il couvre la sélection de la durée de prolongation, le choix du mode de paiement, l'exécution du paiement via les systèmes locaux (Orange Money, Moov Money, Wave, KangaCash), et la mise à jour de l'annonce suite au paiement réussi. Ce flux est essentiel pour la monétisation de l'application et doit être conçu pour être simple, sécurisé et adapté aux méthodes de paiement courantes en République Centrafricaine. * **Étape 1 :** L'utilisateur consulte son tableau de bord et sélectionne une annonce expirée ou sur le point d'expirer. * **Action :** L'utilisateur accède à la liste de ses annonces et identifie celle qu'il souhaite prolonger. * **Écran :** Tableau de bord utilisateur, section "Mes annonces". * **Étape 2 :** Il clique sur le bouton "Prolonger" associé à l'annonce. * **Action :** L'utilisateur initie l'action de prolongation. * **Écran :** Tableau de bord utilisateur, avec bouton "Prolonger" sur chaque annonce éligible. * **Étape 3 :** L'application affiche l'écran "Prolonger" avec les options de durée (7, 15, 30 jours) et les prix correspondants (500 F CFA, 1 000 F CFA, 1 800 F CFA). * **Action :** Le système présente les offres de prolongation. * **Écran :** Écran "Prolonger l'annonce". * **Détails :** Les durées et les prix doivent être clairement affichés, éventuellement avec un tableau comparatif. Ces prix doivent être configurables via le tableau d'administration. * **Étape 4 :** L'utilisateur sélectionne la durée de prolongation souhaitée. * **Action :** L'utilisateur fait son choix parmi les options proposées. * **Écran :** Écran "Prolonger l'annonce" avec sélecteur de durée. * **Étape 5 :** L'application affiche les méthodes de paiement disponibles (Orange Money, Moov Money, Wave, KangaCash). * **Action :** Le système propose les différents moyens de paiement adaptés au contexte local. * **Écran :** Écran de sélection du mode de paiement. * **Détails :** Des icônes ou logos représentant chaque service de paiement peuvent être utilisés pour une meilleure reconnaissance. * **Étape 6 :** L'utilisateur choisit son mode de paiement. * **Action :** L'utilisateur sélectionne la méthode qu'il souhaite utiliser. * **Écran :** Écran de sélection du mode de paiement. * **Étape 7 :** En fonction du choix : * **a. Paiement mobile (Orange Money, Moov Money, Wave) :** * **i. L'application redirige vers l'interface de paiement du service choisi ou génère un code USSD.** * **Action :** Intégration avec l'API du service de paiement mobile. * **Écran :** Interface du service de paiement mobile ou instructions pour composer le code USSD (ex: *144*1*ID_Annonce#). * **ii. L'utilisateur effectue le paiement sur la plateforme du service.** * **Action :** L'utilisateur suit les étapes requises par le service de paiement mobile (saisie du code PIN, confirmation). * **iii. Le service de paiement notifie TikoDeal du paiement réussi via un webhook.** * **Action :** Un webhook reçoit la confirmation de paiement (HTTP POST JSON). * **b. Paiement cash via KangaCash (QR code + OTP) :** * **i. L'application génère un QR code et un OTP (One-Time Password).** * **Action :** Génération d'un identifiant de transaction sécurisé. * **Écran :** Affichage du QR code et de l'OTP, avec instructions pour se rendre dans une agence KangaCash. * **ii. L'utilisateur se rend dans une agence KangaCash, présente le QR code et l'OTP, et effectue le paiement en cash.** * **Action :** Paiement physique dans le réseau d'agences. * **iii. L'agence KangaCash valide le paiement et notifie TikoDeal.** * **Action :** Notification à TikoDeal via une API sécurisée. * **Étape 8 :** TikoDeal reçoit la confirmation de paiement. * **Action :** Le backend de TikoDeal traite la notification de paiement. * **Étape 9 :** La base de données est mise à jour : la date de fin de visibilité de l'annonce est prolongée. * **Action :** Le système met à jour l'annonce concernée avec la nouvelle date d'expiration. * **Étape 10 :** Un badge "TOP" couleur or est ajouté à l'annonce. * **Action :** L'annonce est mise en avant pour indiquer qu'elle a été prolongée. * **Détails :** Ce badge peut améliorer la visibilité de l'annonce dans les résultats de recherche. * **Étape 11 :** L'utilisateur reçoit une notification confirmant la prolongation et le badge "TOP". * **Action :** Une notification push ou un message dans l'application informe l'utilisateur du succès de l'opération. * **Écran :** Notification et/ou écran de confirmation dans l'application. Ce flux de prolongation et de paiement est conçu pour être robuste et adapté aux réalités locales, en offrant plusieurs options de paiement, y compris un fallback USSD pour les utilisateurs sans accès data. L'utilisation de webhooks et d'API pour la confirmation des paiements assure une mise à jour en temps réel de l'état de l'annonce. La simplicité du processus, depuis la sélection de la durée jusqu'à la confirmation, est primordiale pour encourager les utilisateurs à utiliser ce service payant. ### 6.2 Modèle de données SQL Le modèle de données relationnel pour l'application TikoDeal sera implémenté en utilisant **PostgreSQL**, un système de gestion de base de données relationnelle-objet open-source robuste et évolutif. Ce choix est cohérent avec la stack technique définie dans le cahier des charges. La structure de la base de données sera conçue pour supporter les fonctionnalités clés de l'application, telles que la gestion des utilisateurs, des annonces, des paiements, des messages et des signalements. L'utilisation de schémas PostgreSQL peut être envisagée pour organiser logiquement les différentes entités et améliorer la maintenabilité de la base de données, bien que le schéma par défaut `public` puisse être utilisé pour une application de cette envergure initiale , . Les schémas permettent de regrouper des objets de base de données (tables, vues, fonctions, etc.) et d'éviter les conflits de noms, ce qui est particulièrement utile dans les bases de données complexes ou partagées . Cependant, pour la version 1.0 de TikoDeal, une structure simple dans le schéma `public` pourrait suffire, en veillant à une nomenclature claire des tables. La conception de la base de données pour des petites annonces doit prendre en compte la flexibilité nécessaire pour gérer différents types d'articles et leurs spécifications, ce qui peut impliquer des modèles de données EAV (Entity-Attribute-Value) ou des colonnes JSON dans PostgreSQL pour les attributs variables . Les principales tables seront les suivantes : * **`users`** : Cette table stockera les informations relatives aux utilisateurs de la plateforme, qu'ils soient particuliers ou micro-entreprises. * `user_id` (SERIAL, PRIMARY KEY) : Identifiant unique de l'utilisateur, généré automatiquement. * `name` (VARCHAR(255), NOT NULL) : Nom de l'utilisateur ou de la structure. * `phone` (VARCHAR(20), UNIQUE, NOT NULL) : Numéro de téléphone de l'utilisateur, utilisé pour l'authentification et la communication. L'unicité est imposée. * `email` (VARCHAR(255), UNIQUE, NULLABLE) : Adresse e-mail de l'utilisateur, facultative mais unique si fournie. * `password_hash` (VARCHAR(255), NOT NULL) : Hash du mot de passe de l'utilisateur, stocké de manière sécurisée. * `profile_photo_url` (VARCHAR(255), NULLABLE) : URL de la photo de profil de l'utilisateur, stockée sur un service de stockage d'objets (S3-compatible ou Minio). * `location` (VARCHAR(255), NULLABLE) : Localisation textuelle de l'utilisateur (ville, quartier). * `latitude` (DECIMAL(10, 8), NULLABLE) : Coordonnée géographique de latitude pour la localisation. * `longitude` (DECIMAL(11, 8), NULLABLE) : Coordonnée géographique de longitude pour la localisation. * `bio` (TEXT, NULLABLE) : Description ou biographie de l'utilisateur. * `whatsapp_link` (VARCHAR(255), NULLABLE) : Lien vers le profil WhatsApp. * `telegram_link` (VARCHAR(255), NULLABLE) : Lien vers le profil Telegram. * `year_established` (INTEGER, NULLABLE) : Année de création de la structure, pour les micro-entreprises. * `average_rating` (DECIMAL(3, 2), DEFAULT 0.00) : Note moyenne de l'utilisateur, calculée à partir des commentaires. * `is_verified` (BOOLEAN, DEFAULT FALSE) : Indicateur si le profil de l'utilisateur est vérifié (après envoi de CNI + selfie). * `verification_data` (JSONB, NULLABLE) : Stockage crypté des données de vérification (CNI, selfie) si nécessaire, ou référence à un stockage sécurisé. * `created_at` (TIMESTAMP WITH TIME ZONE, DEFAULT NOW()) : Date et heure de création du profil. * `updated_at` (TIMESTAMP WITH TIME ZONE, DEFAULT NOW()) : Date et heure de la dernière mise à jour du profil. * Des index seront créés sur `phone`, `email` et éventuellement `name` pour accélérer les recherches et les opérations d'authentification. * **`ads`** : Cette table contiendra les annonces publiées par les utilisateurs. * `ad_id` (SERIAL, PRIMARY KEY) : Identifiant unique de l'annonce, généré automatiquement. * `user_id` (INTEGER, FOREIGN KEY REFERENCES users(user_id), NOT NULL) : Identifiant de l'utilisateur ayant publié l'annonce. * `category_id` (INTEGER, FOREIGN KEY REFERENCES categories(category_id), NOT NULL) : Identifiant de la catégorie de l'annonce. * `title` (VARCHAR(60), NOT NULL) : Titre de l'annonce (60 caractères max). * `description` (VARCHAR(500), NOT NULL) : Description de l'annonce (500 caractères max), pouvant inclure du formatage riche limité. * `price` (DECIMAL(12, 2), NULLABLE) : Prix du produit ou service. NULL si "À discuter". * `is_negotiable` (BOOLEAN, DEFAULT FALSE) : Indicateur si le prix est négociable. * `status` (VARCHAR(20), DEFAULT 'active', CHECK (status IN ('active', 'expired', 'sold', 'archived'))) : Statut de l'annonce. * `location` (VARCHAR(255), NULLABLE) : Localisation textuelle de l'annonce. * `latitude` (DECIMAL(10, 8), NULLABLE) : Coordonnée géographique de latitude pour la localisation de l'annonce. * `longitude` (DECIMAL(11, 8), NULLABLE) : Coordonnée géographique de longitude pour la localisation de l'annonce. * `contact_whatsapp` (VARCHAR(20), NULLABLE) : Numéro WhatsApp pour contact. * `contact_call` (VARCHAR(20), NULLABLE) : Numéro pour appel vocal. * `contact_sms` (VARCHAR(20), NULLABLE) : Numéro pour SMS. * `contact_email` (VARCHAR(255), NULLABLE) : Adresse e-mail pour contact. * `created_at` (TIMESTAMP WITH TIME ZONE, DEFAULT NOW()) : Date et heure de création de l'annonce. * `updated_at` (TIMESTAMP WITH TIME ZONE, DEFAULT NOW()) : Date et heure de la dernière mise à jour de l'annonce. * `expires_at` (TIMESTAMP WITH TIME ZONE, NOT NULL) : Date et heure d'expiration de l'annonce (5 jours après la création par défaut). * `is_top` (BOOLEAN, DEFAULT FALSE) : Indicateur si l'annonce est mise en avant (après paiement de prolongation). * `seo_summary_fr` (TEXT, NULLABLE) : Résumé SEO en français. * `seo_summary_sg` (TEXT, NULLABLE) : Résumé SEO en Sango. * `seo_summary_en` (TEXT, NULLABLE) : Résumé SEO en anglais. * Des index seront créés sur `user_id`, `category_id`, `price`, `created_at`, `expires_at`, et `status` pour optimiser les requêtes de recherche et de filtrage. * **`categories`** : Cette table définira les catégories et sous-catégories d'annonces. * `category_id` (SERIAL, PRIMARY KEY) : Identifiant unique de la catégorie, généré automatiquement. * `parent_category_id` (INTEGER, FOREIGN KEY REFERENCES categories(category_id), NULLABLE) : Identifiant de la catégorie parente pour gérer les hiérarchies (NULL pour les catégories racines). * `name_fr` (VARCHAR(100), NOT NULL) : Nom de la catégorie en français. * `name_sg` (VARCHAR(100), NOT NULL) : Nom de la catégorie en Sango. * `name_en` (VARCHAR(100), NOT NULL) : Nom de la catégorie en anglais. * `slug` (VARCHAR(100), UNIQUE, NOT NULL) : Slug de la catégorie pour les URLs. * `icon_url` (VARCHAR(255), NULLABLE) : URL de l'icône représentant la catégorie. * Un index sera créé sur `parent_category_id` et `slug`. * **`ad_photos`** : Cette table stockera les informations sur les photos associées aux annonces. * `photo_id` (SERIAL, PRIMARY KEY) : Identifiant unique de la photo, généré automatiquement. * `ad_id` (INTEGER, FOREIGN KEY REFERENCES ads(ad_id), NOT NULL) : Identifiant de l'annonce à laquelle la photo est associée. * `photo_url` (VARCHAR(255), NOT NULL) : URL de la photo (format WebP, ≤ 300 Ko), stockée sur un service de stockage d'objets. * `photo_thumbnail_url` (VARCHAR(255), NOT NULL) : URL de la miniature de la photo, pour un chargement plus rapide. * `position` (INTEGER, NOT NULL) : Position de la photo dans l'ordre d'affichage. * `created_at` (TIMESTAMP WITH TIME ZONE, DEFAULT NOW()) : Date et heure de téléchargement de la photo. * Un index sera créé sur `ad_id`. * **`payments`** : Cette table enregistrera les transactions de paiement pour les prolongations d'annonces. * `payment_id` (SERIAL, PRIMARY KEY) : Identifiant unique du paiement, généré automatiquement. * `user_id` (INTEGER, FOREIGN KEY REFERENCES users(user_id), NOT NULL) : Identifiant de l'utilisateur effectuant le paiement. * `ad_id` (INTEGER, FOREIGN KEY REFERENCES ads(ad_id), NOT NULL) : Identifiant de l'annonce concernée par la prolongation. * `amount` (DECIMAL(12, 2), NOT NULL) : Montant du paiement en FCFA. * `payment_method` (VARCHAR(50), NOT NULL, CHECK (payment_method IN ('Orange Money', 'Moov Money', 'Wave', 'KangaCash', 'Cash'))) : Méthode de paiement utilisée. * `transaction_id` (VARCHAR(255), UNIQUE, NULLABLE) : Identifiant de transaction fourni par le système de paiement. * `status` (VARCHAR(20), DEFAULT 'pending', CHECK (status IN ('pending', 'success', 'failed', 'cancelled'))) : Statut du paiement. * `payment_details` (JSONB, NULLABLE) : Détails supplémentaires du paiement (par exemple, numéro de téléphone pour mobile money, code OTP, etc.). * `prolongation_days` (INTEGER, NOT NULL) : Nombre de jours de prolongation achetés (7, 15, ou 30). * `created_at` (TIMESTAMP WITH TIME ZONE, DEFAULT NOW()) : Date et heure de la transaction. * `verified_at` (TIMESTAMP WITH TIME ZONE, NULLABLE) : Date et heure de vérification du paiement. * Des index seront créés sur `user_id`, `ad_id`, `transaction_id`, et `status`. * **`messages`** : Cette table stockera les messages échangés entre utilisateurs via la messagerie sécurisée. * `message_id` (SERIAL, PRIMARY KEY) : Identifiant unique du message, généré automatiquement. * `from_user_id` (INTEGER, FOREIGN KEY REFERENCES users(user_id), NOT NULL) : Identifiant de l'utilisateur expéditeur. * `to_user_id` (INTEGER, FOREIGN KEY REFERENCES users(user_id), NOT NULL) : Identifiant de l'utilisateur destinataire. * `ad_id` (INTEGER, FOREIGN KEY REFERENCES ads(ad_id), NULLABLE) : Identifiant de l'annonce concernée par la conversation (si applicable). * `content` (TEXT, NOT NULL) : Contenu du message (chiffré de bout en bout). * `is_read` (BOOLEAN, DEFAULT FALSE) : Indicateur si le message a été lu par le destinataire. * `created_at` (TIMESTAMP WITH TIME ZONE, DEFAULT NOW()) : Date et heure d'envoi du message. * Des index seront créés sur `from_user_id`, `to_user_id`, `ad_id`, et `created_at` pour optimiser l'affichage des conversations. * **`reports`** : Cette table enregistrera les signalements d'annonces ou d'utilisateurs pour spam, escroquerie, etc. * `report_id` (SERIAL, PRIMARY KEY) : Identifiant unique du signalement, généré automatiquement. * `reporter_user_id` (INTEGER, FOREIGN KEY REFERENCES users(user_id), NOT NULL) : Identifiant de l'utilisateur ayant effectué le signalement. * `reported_user_id` (INTEGER, FOREIGN KEY REFERENCES users(user_id), NULLABLE) : Identifiant de l'utilisateur signalé (si le signalement concerne un utilisateur). * `reported_ad_id` (INTEGER, FOREIGN KEY REFERENCES ads(ad_id), NULLABLE) : Identifiant de l'annonce signalée (si le signalement concerne une annonce). * `reason` (VARCHAR(100), NOT NULL) : Raison du signalement (spam, escroquerie, contenu inapproprié, etc.). * `description` (TEXT, NULLABLE) : Description détaillée du signalement par l'utilisateur. * `status` (VARCHAR(20), DEFAULT 'pending', CHECK (status IN ('pending', 'under_review', 'resolved', 'dismissed'))) : Statut du traitement du signalement. * `moderator_notes` (TEXT, NULLABLE) : Notes internes de l'équipe de modération. * `created_at` (TIMESTAMP WITH TIME ZONE, DEFAULT NOW()) : Date et heure du signalement. * `updated_at` (TIMESTAMP WITH TIME ZONE, DEFAULT NOW()) : Date et heure de la dernière mise à jour du signalement. * Des index seront créés sur `reporter_user_id`, `reported_user_id`, `reported_ad_id`, et `status`. Ce modèle de données est conçu pour être évolutif et répondre aux besoins fonctionnels décrits dans le cahier des charges. Des ajustements pourront être nécessaires lors de la phase de développement et de test. L'utilisation de types de données appropriés (comme `SERIAL` pour les clés primaires auto-incrémentées, `VARCHAR` avec des limites de longueur, `DECIMAL` pour les montants financiers, `TIMESTAMP WITH TIME ZONE` pour les dates et heures, et `JSONB` pour les données semi-structurées) est cruciale pour l'intégrité et la performance de la base de données. Les contraintes de clé étrangère (`FOREIGN KEY`) assureront l'intégrité référentielle entre les tables. Les contraintes `CHECK` seront utilisées pour valider les valeurs des colonnes selon des critères prédéfinis (par exemple, les statuts de paiement ou d'annonce). La normalisation de la base de données sera appliquée pour éviter la redondance des données et faciliter les mises à jour. Par exemple, la séparation des tables `users`, `ads`, et `categories` suit ce principe. La table `ad_photos` permet de gérer plusieurs photos par annonce sans modifier la structure de la table `ads`. De même, la table `payments` est distincte pour enregistrer l'historique des transactions liées aux prolongations. ### 6.3 Spécifications API REST L'API REST pour TikoDeal sera développée en utilisant **Node.js** avec le framework **Express** et **TypeScript**, conformément à la stack technique définie. Elle servira d'interface de communication entre le frontend (PWA React) et le backend (PostgreSQL, Redis). L'API sera conçue selon les principes RESTful, utilisant les verbes HTTP standard (GET, POST, PUT, DELETE) pour opérer sur les ressources. Les réponses seront principalement au format JSON. La sécurité de l'API sera assurée par des mécanismes d'authentification et d'autorisation, tels que **JWT (JSON Web Tokens)** pour les endpoints protégés. La documentation de l'API sera générée à l'aide d'outils comme **Swagger/OpenAPI** pour faciliter son utilisation par les développeurs frontend et pour d'éventuelles intégrations futures . Les principaux endpoints de l'API sont les suivants : #### 1. Authentification et Gestion des Utilisateurs * **POST /api/auth/register** * **Description** : Permet à un nouvel utilisateur de s'inscrire. * **Requête (Body - JSON)** : ```json { "name": "string", "phone": "string", "email": "string (optionnel)", "password": "string", "profile_photo": "string (base64, optionnel)", "location": "string (optionnel)", "latitude": "number (optionnel)", "longitude": "number (optionnel)", "bio": "string (optionnel)", "whatsapp_link": "string (optionnel)", "telegram_link": "string (optionnel)", "year_established": "number (optionnel)" } ``` * **Réponse (Succès - 201 Created)** : ```json { "user_id": "number", "name": "string", "phone": "string", "message": "Inscription réussie. Veuillez vérifier votre téléphone pour le code OTP." } ``` * **Réponse (Erreur - 400 Bad Request)** : Données invalides, numéro de téléphone déjà utilisé, etc. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. * **POST /api/auth/login** * **Description** : Permet à un utilisateur de se connecter. * **Requête (Body - JSON)** : ```json { "phone": "string", "password": "string" } ``` * **Réponse (Succès - 200 OK)** : ```json { "token": "string (JWT)", "user_id": "number", "name": "string", "is_verified": "boolean" } ``` * **Réponse (Erreur - 401 Unauthorized)** : Identifiants incorrects. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. * **POST /api/auth/verify-otp** (si OTP par SMS est utilisé pour la vérification initiale ou la réinitialisation du mot de passe) * **Description** : Vérifie le code OTP envoyé à l'utilisateur. * **Requête (Body - JSON)** : ```json { "phone": "string", "otp": "string" } ``` * **Réponse (Succès - 200 OK)** : ```json { "message": "Code OTP vérifié avec succès." } ``` * **Réponse (Erreur - 400 Bad Request)** : Code OTP invalide ou expiré. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. * **GET /api/users/{user_id}** * **Description** : Récupère les informations du profil d'un utilisateur. * **Authentification requise** : Non (profil public). * **Réponse (Succès - 200 OK)** : ```json { "user_id": "number", "name": "string", "profile_photo_url": "string", "location": "string", "year_established": "number", "whatsapp_link": "string", "telegram_link": "string", "average_rating": "number", "is_verified": "boolean", "bio": "string" } ``` * **Réponse (Erreur - 404 Not Found)** : Utilisateur non trouvé. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. * **PUT /api/users/{user_id}** * **Description** : Met à jour les informations du profil de l'utilisateur connecté. * **Authentification requise** : Oui (JWT). * **Requête (Body - JSON)** : Champs à mettre à jour (similaires à l'inscription, mais tous optionnels sauf `user_id` dans l'URL). * **Réponse (Succès - 200 OK)** : ```json { "message": "Profil mis à jour avec succès." } ``` * **Réponse (Erreur - 403 Forbidden)** : Tentative de modification d'un autre utilisateur. * **Réponse (Erreur - 400 Bad Request)** : Données invalides. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. * **POST /api/users/{user_id}/verify-identity** * **Description** : Soumet les documents (photo CNI + selfie) pour la vérification du profil. * **Authentification requise** : Oui (JWT). * **Requête (Body - FormData)** : * `cni_photo` (fichier image) * `selfie_photo` (fichier image) * **Réponse (Succès - 202 Accepted)** : ```json { "message": "Documents de vérification soumis. Votre profil sera vérifié sous peu." } ``` * **Réponse (Erreur - 400 Bad Request)** : Fichiers manquants ou invalides. * **Réponse (Erreur - 403 Forbidden)** : Utilisateur non autorisé. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. #### 2. Gestion des Annonces * **POST /api/ads** * **Description** : Permet à un utilisateur connecté de publier une nouvelle annonce. * **Authentification requise** : Oui (JWT). * **Requête (Body - FormData)** : * `category_id` (number, required) * `title` (string, max 60 chars, required) * `description` (string, max 500 chars, required) * `price` (number, nullable if negotiable) * `is_negotiable` (boolean, default false) * `photos` (array of files, max 5, each <= 300KB, WebP preferred) * `location_text` (string, optional) * `latitude` (number, optional) * `longitude` (number, optional) * `contact_whatsapp` (string, optional) * `contact_call` (string, optional) * `contact_sms` (string, optional) * `contact_email` (string, optional) (at least one contact method required) * **Réponse (Succès - 201 Created)** : ```json { "ad_id": "number", "title": "string", "expires_at": "timestamp", "seo_summary_fr": "string", "seo_summary_sg": "string", "seo_summary_en": "string", "message": "Annonce publiée avec succès." } ``` * **Réponse (Erreur - 400 Bad Request)** : Données invalides, catégorie inexistante, etc. * **Réponse (Erreur - 401 Unauthorized)** : Utilisateur non connecté. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. * **GET /api/ads** * **Description** : Récupère une liste paginée d'annonces avec filtres et tri. * **Authentification requise** : Non. * **Paramètres de requête (Query Params)** : * `page` (number, default 1) * `limit` (number, default 10) * `search` (string, optional) * `category_id` (number, optional) * `min_price` (number, optional) * `max_price` (number, optional) * `user_id` (number, optional) * `location` (string, optional) e.g., "Bangui" * `radius` (number, optional) e.g., 10 (in km, requires latitude/longitude) * `latitude` (number, optional, required if radius is used) * `longitude` (number, optional, required if radius is used) * `sort_by` (string, optional) e.g., "price_asc", "price_desc", "date_desc", "distance_asc" * `is_top` (boolean, optional) * `is_verified_seller` (boolean, optional) * **Réponse (Succès - 200 OK)** : ```json { "ads": [ { "ad_id": "number", "title": "string", "price": "number", "thumbnail_url": "string", "location": "string", "created_at": "timestamp", "is_top": "boolean", "user_verified": "boolean", "distance": "number (if applicable)" } ], "total_ads": "number", "total_pages": "number", "current_page": "number" } ``` * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. * **GET /api/ads/{ad_id}** * **Description** : Récupère les détails d'une annonce spécifique. * **Authentification requise** : Non. * **Réponse (Succès - 200 OK)** : ```json { "ad_id": "number", "user_id": "number", "category_id": "number", "title": "string", "description": "string", "price": "number", "is_negotiable": "boolean", "status": "string", "location_text": "string", "latitude": "number", "longitude": "number", "contact_whatsapp": "string", "contact_call": "string", "contact_sms": "string", "contact_email": "string", "created_at": "timestamp", "updated_at": "timestamp", "expires_at": "timestamp", "is_top": "boolean", "photos": ["url1", "url2"], "seo_summary_fr": "string", "seo_summary_sg": "string", "seo_summary_en": "string", "seller_name": "string", "seller_profile_pic": "string", "seller_verified": "boolean" } ``` * **Réponse (Erreur - 404 Not Found)** : Annonce non trouvée. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. * **PUT /api/ads/{ad_id}/extend** * **Description** : Prolonge la durée de visibilité d'une annonce après paiement réussi (appelé en interne après confirmation du webhook de paiement). * **Authentification requise** : Oui (JWT, généralement pour usage interne ou vérification). * **Requête (Body - JSON)** : ```json { "prolongation_days": "number (7, 15, or 30)", "new_expiry_date": "timestamp", "is_top": "boolean" } ``` * **Réponse (Succès - 200 OK)** : ```json { "message": "Annonce prolongée avec succès.", "new_expiry_date": "timestamp", "is_top": "boolean" } ``` * **Réponse (Erreur - 400 Bad Request)** : Données invalides. * **Réponse (Erreur - 403 Forbidden)** : Non autorisé. * **Réponse (Erreur - 404 Not Found)** : Annonce non trouvée. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. #### 3. Gestion des Paiements * **POST /api/payments/initiate** * **Description** : Initie un paiement pour la prolongation d'une annonce. * **Authentification requise** : Oui (JWT). * **Requête (Body - JSON)** : ```json { "ad_id": "number", "user_id": "number", "amount": "number (500, 1000, or 1800 XAF)", "payment_method": "string (Orange Money, Moov Money, Wave, KangaCash)", "prolongation_days": "number (7, 15, or 30)", "user_msisdn": "string (for mobile money payments)" } ``` * **Réponse (Succès - 200 OK)** : ```json { "payment_id": "string", "status": "string (e.g., PENDING)", "payment_instructions": "string (e.g., USSD code, KangaCash QR code/OTP, or redirect URL for payment gateway)", "ussd_code": "string (if applicable, e.g., *144*1*ID#)" } ``` * **Réponse (Erreur - 400 Bad Request)** : Données invalides, annonce non éligible, etc. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. * **POST /api/payments/webhook/{provider}** (e.g., /api/payments/webhook/orange-money) * **Description** : Endpoint de webhook pour recevoir les notifications de statut de paiement des fournisseurs de paiement. * **Authentification requise** : Non (sécurisé par un secret de webhook ou une validation IP). * **Requête (Body - JSON, spécifique au fournisseur)** : ```json // Exemple générique { "transaction_id": "string", "payment_id": "string (from TikoDeal)", "status": "string (SUCCESS, FAILED, CANCELLED)", "amount": "number", "currency": "string (XAF)", "msisdn": "string", "timestamp": "string" } ``` * **Réponse (Succès - 200 OK)** : Le backend traite la notification et met à jour le statut du paiement et de l'annonce. * **Réponse (Erreur - 400 Bad Request)** : Notification invalide. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur lors du traitement. #### 4. Messagerie * **POST /api/messages** * **Description** : Envoie un nouveau message entre deux utilisateurs. * **Authentification requise** : Oui (JWT). * **Requête (Body - JSON)** : ```json { "sender_id": "number", "receiver_id": "number", "ad_id": "number (optionnel, si lié à une annonce)", "content": "string (chiffré E2E côté client)" } ``` * **Réponse (Succès - 201 Created)** : ```json { "message_id": "string", "timestamp": "timestamp" } ``` * **Réponse (Erreur - 400 Bad Request)** : Données invalides. * **Réponse (Erreur - 403 Forbidden)** : Non autorisé. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. * **GET /api/messages** * **Description** : Récupère l'historique des messages pour un utilisateur (conversations ou messages spécifiques à une conversation). * **Authentification requise** : Oui (JWT). * **Paramètres de requête (Query Params)** : * `user_id` (number, required) : ID de l'utilisateur connecté. * `contact_id` (number, optional) : ID de l'autre utilisateur pour filtrer une conversation spécifique. * `ad_id` (number, optional) : ID de l'annonce pour filtrer les messages liés à une annonce. * `page` (number, default 1) * `limit` (number, default 20) * **Réponse (Succès - 200 OK)** : ```json { "messages": [ { "message_id": "string", "sender_id": "number", "receiver_id": "number", "ad_id": "number (optionnel)", "content": "string (chiffré E2E, à décrypter côté client)", "timestamp": "timestamp", "is_read": "boolean" } ], "total_messages": "number", "total_pages": "number" } ``` * **Réponse (Erreur - 403 Forbidden)** : Non autorisé. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. #### 5. Signalements * **POST /api/reports** * **Description** : Soumet un signalement pour une annonce ou un utilisateur. * **Authentification requise** : Oui (JWT). * **Requête (Body - JSON)** : ```json { "reporter_user_id": "number", "reported_ad_id": "number (optionnel, si l'annonce est signalée)", "reported_user_id": "number (optionnel, si l'utilisateur est signalé)", "reason": "string (spam, escroquerie, contenu inapproprié, etc.)", "description": "string (optionnel, description détaillée)" } ``` * **Réponse (Succès - 201 Created)** : ```json { "report_id": "number", "message": "Signalement soumis avec succès." } ``` * **Réponse (Erreur - 400 Bad Request)** : Données invalides. * **Réponse (Erreur - 500 Internal Server Error)** : Erreur serveur. ### 6.4 Scripts de déploiement (Docker-compose, Ansible) Pour assurer un déploiement reproductible et automatisé de TikoDeal, des scripts utilisant **Docker-compose** et **Ansible** seront fournis. Ces scripts permettront de déployer l'application sur un **VPS Ubuntu 22.04**. **Docker-compose** sera utilisé pour définir et exécuter l'application multi-conteneurs. Un fichier `docker-compose.yml` décrira les services nécessaires, tels que le backend Node.js, la base de données PostgreSQL, le cache Redis, et éventuellement Minio pour le stockage d'objets si une solution on-premise est choisie. Chaque service aura son propre `Dockerfile` pour construire l'image Docker correspondante. Le fichier `docker-compose.yml` spécifiera les configurations réseau, les volumes de données persistantes, les variables d'environnement et les dépendances entre les services. Par exemple, le service backend dépendra des services PostgreSQL et Redis pour démarrer correctement. L'utilisation de Docker-compose simplifie grandement le processus de déploiement et garantit que l'application s'exécute dans un environnement cohérent, que ce soit en développement, en staging ou en production. **Ansible** sera utilisé pour l'automatisation de la configuration du serveur VPS et du déploiement de l'application. Des playbooks Ansible définiront les tâches à exécuter sur le serveur distant, telles que : 1. **Configuration initiale du serveur** : Mise à jour des paquets, configuration du pare-feu (UFW), création d'un utilisateur de déploiement, configuration de l'accès SSH. 2. **Installation des dépendances** : Installation de Docker et Docker-compose. 3. **Déploiement de l'application** : Copie des fichiers de l'application (code source, fichiers de configuration, scripts Docker) depuis le référentiel Git vers le serveur. 4. **Gestion des services** : Construction des images Docker à l'aide de Docker-compose, démarrage/arrêt/redémarrage des services. 5. **Gestion des secrets** : Injection sécurisée des variables d'environnement sensibles (clés API, mots de passe de base de données) dans les conteneurs Docker. 6. **Configuration de Nginx** (ou autre reverse proxy) : Configuration du reverse proxy pour rediriger le trafic vers le conteneur backend. 7. **Configuration de Certbot** : Obtention et renouvellement automatique de certificats SSL/TLS via Let's Encrypt pour activer HTTPS. Les playbooks Ansible seront organisés en rôles pour une meilleure modularité et réutilisabilité. Par exemple, un rôle `common` pour la configuration de base du serveur, un rôle `docker` pour l'installation de Docker, un rôle `deploy` pour le déploiement de l'application, etc. L'inventaire Ansible définira les serveurs cibles (dans ce cas, le VPS OVH). L'exécution d'un playbook Ansible permettra de provisionner et de configurer le serveur de manière idempotente, c'est-à-dire que les tâches ne seront exécutées que si elles sont nécessaires pour atteindre l'état désiré du serveur. Cette approche "Infrastructure as Code" (IaC) garantit la reproductibilité et la traçabilité des déploiements. ### 6.5 Plan de test Le plan de test pour TikoDeal sera complet et couvrira plusieurs niveaux et types de tests pour garantir la qualité, la fiabilité et les performances de l'application, en particulier dans le contexte de la République Centrafricaine. Les tests seront structurés comme suit : 1. **Tests Unitaires** : * **Objectif** : Vérifier le bon fonctionnement des composants logiciels individuels (fonctions, classes, modules) de manière isolée. * **Outils** : Jest, Mocha, Chai, Sinon. * **Couverture** : Logique métier du backend (par exemple, calcul de la date d'expiration d'une annonce, validation des entrées utilisateur, logique de paiement), utilitaires, helpers. * **Méthodologie** : Les tests unitaires seront écrits pour chaque module significatif, en utilisant des mocks et des stubs pour isoler les dépendances externes (comme les appels à la base de données ou aux API de paiement). 2. **Tests d'Intégration** : * **Objectif** : Vérifier l'interaction entre différents modules ou services de l'application. * **Couverture** : Interaction entre les contrôleurs et les modèles de base de données, intégration avec les services externes (par exemple, l'API Orange Money en mode sandbox), fonctionnement des services worker de la PWA. * **Méthodologie** : Ces tests simuleront des scénarios plus complets, comme la création d'une annonce par un utilisateur, l'initiation d'un paiement, ou la réception d'un webhook de paiement. La base de données de test sera utilisée et réinitialisée avant chaque test. 3. **Tests de Composants Frontend (React)** : * **Objectif** : Vérifier le comportement et le rendu des composants React individuels. * **Outils** : Jest, React Testing Library. * **Couverture** : Rendu correct des composants en fonction des props et de l'état, gestion des événements utilisateur (clics, saisie de formulaire). * **Méthodologie** : Les tests vérifieront si les composants affichent le contenu attendu, réagissent correctement aux interactions de l'utilisateur et mettent à jour leur état de manière appropriée. 4. **Tests End-to-End (E2E)** : * **Objectif** : Vérifier le flux complet de l'application du point de vue de l'utilisateur, du frontend au backend. * **Outils** : Cypress, Playwright, Selenium. * **Couverture** : Parcours utilisateur critiques tels que l'inscription, la publication d'une annonce, la recherche d'annonces, le processus de prolongation et de paiement, l'envoi de messages. * **Méthodologie** : Des scénarios E2E seront écrits pour simuler les actions d'un utilisateur réel naviguant dans l'application. Les tests interagiront avec l'interface utilisateur comme le ferait un humain. 5. **Tests de Performance et de Charge** : * **Objectif** : Évaluer les performances de l'application sous charge et identifier les goulots d'étranglement. * **Outils** : K6, Artillery, JMeter. * **Couverture** : * **Charge de 1 000 req/s** : Tester la capacité de l'API à gérer un volume important de requêtes simultanées, en particulier sur les endpoints critiques comme la recherche d'annonces et la récupération des détails de l'annonce. * **Temps de réponse** : Mesurer les temps de réponse des endpoints API sous différentes charges. * **Stabilité** : Vérifier que l'application reste stable et ne plante pas sous une charge soutenue. * **Méthodologie** : Des scripts de test de charge seront créés pour simuler un nombre spécifique d'utilisateurs virtuels effectuant diverses actions sur l'application. Les tests seront exécutés dans un environnement de pré-production qui reflète l'environnement de production. 6. **Tests de Réseau (Edge Cases)** : * **Objectif** : Vérifier le comportement de l'application dans des conditions de réseau instables ou à faible bande passante, typiques de la RCA. * **Outils** : Chrome DevTools (Network Throttling), outils de simulation réseau plus avancés. * **Couverture** : Simulation de pertes de paquets, latences élevées, débits faibles (2G/3G). * **Méthodologie** : Les tests E2E et d'API seront exécutés dans des conditions réseau dégradées pour s'assurer que l'application reste utilisable, que les timeouts sont gérés correctement, et que le mode "Lite" fonctionne comme prévu , . 7. **Tests de Sécurité** : * **Objectif** : Identifier et corriger les vulnérabilités de sécurité. * **Outils** : OWASP ZAP, outils de scan de vulnérabilités. * **Couverture** : Injections SQL, attaques XSS, CSRF, gestion sécurisée des authentifications et des sessions, protection des données sensibles. * **Méthodologie** : Tests manuels et automatisés pour détecter les failles de sécurité courantes. Vérification que toutes les communications se font bien en HTTPS . 8. **Tests de Fonctionnalité Hors Ligne (PWA)** : * **Objectif** : Vérifier que les fonctionnalités hors ligne de la PWA (service worker, mise en cache) fonctionnent correctement. * **Méthodologie** : Tester le chargement de l'application sans connexion internet, la consultation d'annonces précédemment visitées, le formulaire de dépôt d'annonce (avec soumission différée) . ### 6.6 Guide de localisation (i18n, glossaire Sango-français) Le guide de localisation pour TikoDeal détaillera la méthodologie et les outils utilisés pour rendre l'application multilingue, prenant en charge le **Sango, le Français et l'Anglais**. La base de la localisation reposera sur l'utilisation de la bibliothèque **`react-i18next`** pour React, couramment utilisée pour la gestion de l'internationalisation (i18n) dans les applications web modernes , . Les traductions seront stockées dans des **fichiers JSON distincts pour chaque langue** : `fr.json` pour le Français, `sg.json` pour le Sango, et `en.json` pour l'Anglais. Chaque fichier contiendra des paires clé-valeur, où la clé est un identifiant unique représentant un morceau de texte dans l'application (par exemple, `"homepage.welcomeMessage"`) et la valeur est la traduction correspondante dans la langue du fichier. Par exemple : **en.json:** ```json { "welcome_message": "Welcome to TikoDeal!", "post_ad_button": "Post your ad", "search_placeholder": "Search for products or services...", "price_label": "Price: {{price}} XAF", "days_left": "{{count}} day left", "days_left_plural": "{{count}} days left" } ``` **fr.json:** ```json { "welcome_message": "Bienvenue sur TikoDeal !", "post_ad_button": "Déposer votre annonce", "search_placeholder": "Rechercher des produits ou services...", "price_label": "Prix : {{price}} FCFA", "days_left": "{{count}} jour restant", "days_left_plural": "{{count}} jours restants" } ``` **sg.json:** ```json { "welcome_message": "Balaô TikoDeal !", "post_ad_button": "Sû ndo tî mo", "search_placeholder": "Gi lêgë tî yê wala sëvisi...", "price_label": "Ngûrû : {{price}} XAF", "days_left": "{{count}} lâ tî bïkua-ôko agä", "days_left_plural": "{{count}} lâ tî bïkua agä" } ``` *(Les traductions en Sango sont des exemples et devront être validées par des locuteurs natifs)* Une **structure de dossiers commune**, telle que `public/locales/{lang}/translation.json`, sera adoptée pour organiser ces fichiers . Le guide expliquera comment initialiser `i18next` dans l'application React, comment charger les fichiers de traduction (éventuellement de manière asynchrone pour optimiser les performances), et comment utiliser le hook `useTranslation` ou le composant `<Trans>` de `react-i18next` dans les composants React pour afficher les textes traduits . Un **sélecteur de langue** sera implémenté dans l'interface utilisateur, permettant aux utilisateurs de changer dynamiquement la langue de l'application. Ce sélecteur appellera la fonction `i18n.changeLanguage(lng)` pour mettre à jour la langue active , . Un **glossaire Sango-Français spécifique au contexte de TikoDeal** sera également créé et maintenu. Ce glossaire listera les termes techniques, les noms de catégories, les messages d'interface, etc., avec leur traduction approuvée en Sango et en Français. Ce glossaire servira de référence pour les traducteurs et assurera la cohérence terminologique dans toute l'application. La gestion des **pluriels**, qui peut varier d'une langue à l'autre, sera également abordée en utilisant les fonctionnalités de `react-i18next` . Enfin, le guide couvrira la **traduction automatique des annonces** à l'aide de l'API Google Cloud Translation, y compris le mécanisme de cache des traductions pour une durée de 30 jours. ## 7. UI/UX et Chartre Graphique ### 7.1 Maquettes d'interface utilisateur Les maquettes d'interface utilisateur (UI) pour TikoDeal seront conçues en suivant les principes d'une **UX ultra-simple**, comme spécifié dans le cahier des charges. L'accent sera mis sur la clarté, la facilité d'utilisation et la rapidité d'exécution des tâches principales, en particulier le dépôt d'annonces. Les maquettes couvriront les écrans principaux de l'application, notamment : * **Écran d'accueil** : Présentant les options de navigation (recherche, dépôt d'annonce, connexion/inscription). * **Écran de dépôt d'annonce** : Un écran unique et linéaire, comme décrit dans la section 3.1, minimisant le nombre de clics et de chargements. * **Écran de recherche et résultats** : Affichant les filtres et les annonces sous forme de cartes, avec un lazy-loading. * **Écran de détail d'une annonce** : Montrant toutes les informations de l'annonce, les photos, les coordonnées du vendeur et l'option de messagerie. * **Tableau de bord utilisateur** : Permettant de gérer ses annonces, consulter ses messages, et accéder à son profil. * **Écran de profil utilisateur** : Affichant les informations publiques du profil. * **Écran de prolongation d'annonce** : Pour sélectionner la durée et le mode de paiement. * **Interface de messagerie** : Simple et intuitive, permettant les conversations E2E. Les maquettes seront réalisées en utilisant la charte graphique "sable & braise" et tiendront compte des contraintes d'affichage sur des appareils mobiles d'entrée de gamme. ### 7.2 Principe d'UX ultra-simple Le principe d'**UX ultra-simple** guidera toutes les décisions de conception de TikoDeal. Cela se traduira par : * **Navigation intuitive** : Une structure de navigation claire et facile à comprendre, avec un nombre minimal d'étapes pour accéder aux fonctionnalités principales. * **Formulaires simplifiés** : Le dépôt d'annonce se fera sur un seul écran, avec des champs clairement libellés et des aides contextuelles si nécessaire. Les champs obligatoires seront réduits au strict minimum. * **Chargements rapides** : Optimisation des performances pour des temps de chargement les plus courts possibles, même sur des connexions lentes (2G/3G) et des appareils peu puissants. Cela inclut la compression des images, la mise en cache agressive, et le lazy-loading. * **Feedback utilisateur clair** : Des messages d'information, de succès ou d'erreur seront affichés de manière concise et compréhensible pour guider l'utilisateur. * **Accessibilité** : La conception tiendra compte des bonnes pratiques d'accessibilité pour les utilisateurs en situation de handicap. * **Adaptation au contexte local** : L'interface sera conçue en tenant compte des habitudes et des contraintes des utilisateurs centrafricains, par exemple en privilégiant les moyens de contact locaux (WhatsApp, appel) et en intégrant des méthodes de paiement familières. L'objectif est de rendre l'application TikoDeal extrêmement facile à prendre en main, même pour des utilisateurs peu familiarisés avec les technologies numériques. ### 7.3 Couleur charte "sable & braise" (#C19A6B, #8B4513) La charte graphique de TikoDeal sera basée sur les couleurs **"sable & braise"**, représentées par les codes hexadécimaux **#C19A6B (sable)** et **#8B4513 (braise)**. Ces couleurs évoquent des éléments naturels et chaleureux, ce qui peut contribuer à une expérience utilisateur accueillante. * **#C19A6B (Sable)** : Cette couleur pourra être utilisée comme couleur de fond principale, pour les éléments d'arrière-plan, ou pour certains textes. Elle apporte une sensation de légèreté et de neutralité. * **#8B4513 (Braise)** : Cette couleur plus foncée et plus saturée pourra être utilisée pour les éléments d'accentuation, tels que les boutons d'action principaux, les liens importants, ou les bordures. Elle apporte du contraste et de la chaleur. Ces deux couleurs principales seront complétées par une palette de gris pour les textes, les bordures et les arrière-plans secondaires, ainsi que du blanc et du noir pour assurer une bonne lisibilité et un contraste suffisant. Le **dark-mode par défaut** sera également implémenté en utilisant des nuances de ces couleurs adaptées à un fond sombre, tout en respectant la charte. L'utilisation de TailwindCSS facilitera l'application cohérente de cette charte graphique à travers toute l'application. ## 8. Génération de Code et Testabilité ### 8.1 Code source complet (frontend et backend) Le livrable inclura le **code source complet** de l'application TikoDeal, à la fois pour le **frontend (PWA React, Vite, TailwindCSS)** et le **backend (Node.js, Express, TypeScript, PostgreSQL, Redis)**. Le code sera structuré de manière modulaire et bien commenté pour faciliter la compréhension, la maintenance et les éventuelles évolutions futures. Le frontend comprendra tous les composants React, les fichiers de style TailwindCSS, les configurations Vite, les service workers pour la PWA, et les intégrations Capacitor.js pour les fonctionnalités natives. Le backend comprendra la définition des routes API, la logique des contrôleurs, les modèles de données pour PostgreSQL, les scripts d'interaction avec Redis, la gestion du stockage des fichiers, et les configurations nécessaires pour Express et TypeScript. Le code sera fourni dans un référentiel Git (par exemple, GitHub) avec un historique de commits clair. ### 8.2 Testabilité immédiate de la version mobile La **version mobile de TikoDeal**, générée à l'aide de **Capacitor.js**, sera **immédiatement testable**. Cela signifie que les artefacts de build pour Android (APK) et/ou iOS (IPA) seront fournis, ou que des instructions claires seront données pour construire et exécuter l'application mobile sur des émulateurs ou des appareils physiques. Pour Android, un fichier APK pourra être installé directement sur un appareil compatible. Pour iOS, si un fichier IPA est fourni, il pourra être installé via des outils comme TestFlight ou directement sur un appareil enregistré pour le développement. L'objectif est de permettre aux testeurs et aux parties prenantes d'expérimenter rapidement l'application dans son environnement mobile natif, en accédant aux fonctionnalités spécifiques aux appareils (caméra, géolocalisation, notifications push). Des scripts ou des commandes simples seront fournis pour faciliter le processus de build et de déploiement sur les plateformes mobiles à partir du code source. - Initial Deployment
cbcdb38 verified