13 KiB
📚 DOCUMENTATION TECHNIQUE & GUIDE PROJET - JOBRUNNER
Plateforme de mise en relation de services et prestations avec séquestre bancaire sécurisé.
Dépôt privé :https://github.com/gastinelt/jobrunner.html
Nom de domaine de production :https://jobrunner.fr
📑 Sommaire
- Vue d'ensemble du Projet
- Architecture et Organisation des Fichiers
- Règles de Travail sur le Dépôt Git Privé
- Fonctionnalités Actuelles du Site (Frontend)
- Spécifications Techniques des APIs à Intégrer
- Mise en Ligne & Configuration du Domaine
Jobrunner.fr - Stratégie Marketing & Acquisition Réseaux Sociaux
1. Vue d'ensemble du Projet
Jobrunner met en relation des clients ayant un besoin de service du quotidien (bricolage, déménagement, ménage, urgences, livraisons, etc.) avec des prestataires indépendants et fiables appelés les "Runners".
Le modèle économique :
- Garantie Séquestre (Escrow) : Les fonds du client sont débités et mis en sécurité lors de la réservation. Le runner n'est payé qu'une fois la prestation réalisée et validée par le client.
- Modèle 0 € de frais fixes : Aucun abonnement récurrent pour le gérant. Les frais Stripe (~1,5% + 0,25 €) sont directement couverts par la commission de la plateforme (10% à 15%).
- Confiance & Conformité : Respect strict des lois françaises (RGPD, CNIL, DSP2) et vérifications des profils (numéro de téléphone certifié, SIRET officiel État français, et pièce d'identité sécurisée).
2. Architecture et Organisation des Fichiers
jobrunner web/
├── .gitignore # Protection des clés privées, logs et dépendances
├── README.md # Présentation du dépôt
├── DOCUMENTATION.md # Présente documentation technique complète
├── index.html # Espace projet : tableau de bord & générateur de codes bêta (admin.jobrunner.fr)
├── app.html # Application Web frontend complète (HTML, CSS inline, JS vanilla)
├── charte.html # Charte graphique v1.1 (couleurs, typo, logo, icônes, animations)
├── legal.html # Documents légaux (CGU, CGV, confidentialité, cookies, mentions) — brouillon
├── package.json # Outil de build CSS (devDependency : Tailwind 3.4.19)
├── tailwind.config.js # Palette et ombres du site (source du CSS généré, lit app.html)
├── beta/ # Couche autonome de la bêta testeurs (Python 3 standard)
│ ├── server.py # Serveur HTTP (porte d'entrée, sessions, API admin, injection CSS/JS)
│ ├── codes.py # CLI d'administration des codes d'accès (génération, révocation, liste)
│ ├── db.py # Couche SQLite (codes, sessions, tentatives, audit, démo)
│ ├── bots.py # Simulation d'activité lente et profils fictifs
│ ├── static/ # Pages HTML autonomes (formulaire.html, gate.html)
│ ├── pdf/ # Générateur du formulaire d'engagement testeur PDF (AcroForm)
│ ├── deploiement/ # Architecture et plan de déploiement en production (PLAN.md)
│ └── tests/ # Suite de 25 tests unitaires automatisés
└── assets/
├── css/
│ ├── app.css # CSS Tailwind compilé (généré, à versionner)
│ ├── espace.css # Styles de l'espace projet (index.html) dont zone gestion bêta
│ ├── legal.css # Styles de legal.html
│ ├── tailwind.src.css # Entrée du build Tailwind + règle reduced-motion
│ └── fonts.css # @font-face Plus Jakarta Sans et Outfit (auto-hébergées)
├── js/
│ └── legal.js # Navigation de legal.html
├── icones-jobrunner/ # 15 icônes de la charte (SVG, currentColor, sans cadre)
├── img/logo-j.svg # Logo J de la charte v1.1
├── fonts/ # Fichiers .woff2 Plus Jakarta Sans et Outfit (latin + latin-ext)
└── icons/
├── phosphor.css # Icônes Phosphor (sous-ensemble utilisé)
└── Phosphor-*.woff2 # Polices d'icônes (Regular, Bold, Fill)
Technologies du Frontend :
- HTML5 / JavaScript Vanilla : Application Single Page dynamique sans framework, sans bibliothèque JS externe.
- Tailwind CSS 3.4.19 (build statique) : le CSS est compilé dans
assets/css/app.css; aucun script Tailwind n'est chargé dans le navigateur. Palette sur-mesure (#F4F2ECécru/beige,#7A8E76sauge,#1F221Esombre). - Phosphor Icons 2.1.2 (MIT) : sous-ensemble de la police d'icônes, auto-hébergé dans
assets/icons/. - Typographies : Plus Jakarta Sans (corps de texte) et Outfit (titres, classe
font-titre), toutes deux auto-hébergées sous licence OFL. - Note : la marque utilisait Chillax (Fontshare) pour les titres. Elle est remplacée par Outfit, faute d'accès au téléchargement de Chillax depuis l'environnement de build. Pour revenir à Chillax, déposer les
.woff2dansassets/fonts/, ajouter les@font-facedansassets/css/fonts.csset adaptertailwind.config.js. - Aucun appel externe pour le code ou les polices : plus de CDN Tailwind, unpkg, Google Fonts ni Fontshare. Seules les images et vidéos de démonstration restent hébergées ailleurs (Unsplash, Mixkit, placehold.co).
- Responsive Hybride : Conçu en priorité pour mobile (format app native avec dock de navigation bas) et adapté pour grand écran desktop.
Régénérer le CSS (uniquement après ajout de classes Tailwind) :
npm install
npm run build:css
Le CSS est versionné : il n'est pas nécessaire d'installer Node pour déployer le site.
3. Règles de Travail sur le Dépôt Git Privé
Pour garantir la sécurité et la propreté du travail d'équipe avec vos collaborateurs (gastinelt & ronnetnils-cyber) :
- Dépôt Privé Obligatoire : Tout le code source, la documentation et les développements sont stockés sur le dépôt privé
gastinelt/jobrunner.html. - Gestion des Secrets & Clés API :
- JAMAIS de clé secrète Stripe (
sk_live_...ousk_test_...) dans le code HTML/JS côté client. - Toutes les clés sensibles doivent résider dans un fichier
.envou sur le serveur backend uniquement. - Le fichier
.gitignorebloque l'envoi de ces fichiers sensibles sur Git.
- JAMAIS de clé secrète Stripe (
- Commandes usuelles de synchronisation :
# Récupérer les dernières modifications de vos collaborateurs git pull origin main # Enregistrer vos modifications locales git add . git commit -m "description claire de vos modifications" # Envoyer sur le dépôt privé GitHub git push origin main
4. Fonctionnalités Actuelles du Site (Frontend)
Le fichier index.html intègre déjà les modules complets suivants :
| Module | Description |
|---|---|
| Accueil & Recommandations | Bannière, recherche rapide, catégories de services, sélection de runners recommandés. |
| Moteur de Recherche & Filtres | Filtres par catégorie, tarif horaire, localisation, badge vérifié, tri par avis. |
| Shorts / Vidéos UGC | Lecteur vidéo vertical style TikTok/Reels intégré, présentant les prestations des runners. |
| Fiche Runner / Annonce | Détails du profil, photos, tarifs, avis clients, garanties et bouton de réservation. |
| Messagerie Instantanée | Système de messagerie interactif complet (vue liste + fenêtre de conversation dédiée). |
| Processus de Séquestre Mock | Modale de paiement avec explication des fonds protégés et validation de fin de mission. |
| Espace Profil & Annonces | Gestion des annonces personnelles, favoris, historique et statut de certification. |
| Footer & Mentions Légales | Modales légales (Mentions légales, CGU, Politique de confidentialité RGPD, Cookies). |
Porte d'entrée & Bêta (jobrunner.fr) |
Porte d'accès par code unique, formulaire d'inscription autonome (/__beta/formulaire), bandeau d'information bêta et bouton de retour d'expérience. |
Gestionnaire Bêta (admin.jobrunner.fr) |
Générateur instantané de codes testeurs JRB-..., validité paramétrable, message d'invitation pré-rempli pour WhatsApp/SMS, historique et statut des codes en temps réel. |
5. Spécifications Techniques des APIs à Intégrer
5.1 Paiements & Séquestre (Stripe)
- Objectif : Bloquer les fonds du client jusqu'à validation du service.
- Fonctionnement :
- Le client clique sur "Réserver avec Séquestre".
- Le serveur appelle
stripe.paymentIntents.createavec l'optioncapture_method: 'manual'(autorisation préalable). - L'argent est bloqué sans être transféré au runner immédiatement.
- Fin de mission : le client valide
\rightarrowle serveur exécutestripe.paymentIntents.capture\rightarrowles fonds sont libérés.
- Frais : ~1,5% + 0,25 € par transaction par carte bancaire (couverts par les frais de service de la plateforme).
5.2 Vérification d'Identité 100% Légale & Gratuite
- Vérification SIRET Auto-entrepreneurs / Artisans (0 €) :
- API Officielle :
api.gouv.fr(Base SIRENE État français). - Vérification instantanée : Le runner renseigne son SIRET
\rightarrowl'API confirme l'existence de l'entreprise, son immatriculation et son gérant légal\rightarrowAttribution automatique du badge "Pro Vérifié SIRET".
- API Officielle :
- Vérification Numéro de Téléphone (0 €) :
- API : Google Firebase Phone Auth.
- Vérification : Envoi d'un code SMS à 6 chiffres. En France, toute ligne mobile 06/07 est obligatoirement liée à une identité chez un opérateur téléphonique.
- Vérification Pièce d'Identité CNI (Optionnelle via Stripe Identity) :
- Facturée ~1,50 € par vérification
\rightarrowFrais répercutés au runner qui choisit de débloquer le badge "Identité Certifiée CNI".
- Facturée ~1,50 € par vérification
6. Mise en Ligne & Architecture de Production (Déployé le 29/10/2026)
L'infrastructure sépare le site public de test et l'espace projet / administration :
6.1 Domaines & DNS (Infomaniak)
jobrunner.fr,www.jobrunner.fr,beta.jobrunner.fr: EnregistrementsAvers179.237.102.233(VPS Suisse).admin.jobrunner.fr: EnregistrementAvers179.237.102.233(Espace projet sous authentification HTTP Basic Auth).
6.2 Architecture Caddy (VPS cornafsuisse)
admin.jobrunner.fr: Protégé par HTTP Basic Auth (/etc/caddy/jobrunner-auth.caddy). Sert les fichiers statiques de/srv/jobrunner.fr. La route/_admin/api/*est proxifiée vers10.88.88.2:8830via WireGuard (wg2) avec l'en-tête interneX-Admin: 1.jobrunner.fr(et aliaswww,beta) : Proxifié vers10.88.88.2:8830via WireGuard (wg2).
6.3 Serveur Backend (cornafserver)
- Service :
jobrunner-beta.service(systemd utilisateur). - Port :
8830, sécurisé parnftables(accessible uniquement depuis le VPS via WireGuardwg2). - Données :
/home/cornaf2049/jobrunner-beta-data/beta.sqliteavec permissions restreintes (0600). - Sécurité applicative : HMAC-SHA256 pour les codes d'accès, anti-bruteforce (6 essais / 15 min), plafonds de requêtes concurrentes, timeouts stricts de 20 s.
7. Stratégie Marketing & Acquisition Réseaux Sociaux
Deux cibles distinctes :
- Les Clients (Demandeurs de services) :
- Accroche : "Besoin d'un coup de main en urgence ? Ne prenez aucun risque : vos fonds sont protégés par séquestre et le runner n'est payé que si vous êtes 100% satisfait."
- Les Runners (Prestataires / Indépendants) :
- Accroche : "Comment gagner de 100 € à 300 € par semaine à côté de vos études ou de votre travail, avec la certitude d'être payé sans impayé."
Formats Vidéos Recommandés :
- Shorts / TikTok / Reels (Format 9:16) :
- Utiliser le style UGC (face caméra, smartphone en main, authentique, sous-titres dynamiques).
- Montrer la plateforme en action directement à l'écran grâce à l'interface mobile de Jobrunner.