Comme au commit fa2a239, la protection se fait côté serveur sur
jobrunner.fr (basic_auth de Caddy). Le verrou dans la page était
contournable et exposait le mot de passe.
- index.html affiche directement le tableau de bord (plus d'écran de mot
de passe ni de bouton de déconnexion), assets/js/espace.js supprimé.
- app.html et charte.html : garde sessionStorage retirée.
- legal.html : clés de stockage du verrou retirées de la politique cookies.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
11 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 (point d'entrée ; accès protégé par Caddy basic_auth)
├── 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, voir docs/conformite-legale.md
├── 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)
└── assets/
├── css/
│ ├── app.css # CSS Tailwind compilé (généré, à versionner)
│ ├── espace.css # Styles de l'espace projet (index.html)
│ ├── 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 (l'ancien logo-light.svg reste utilisé par app.html)
├── 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). |
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 & Configuration du Domaine Jobrunner.fr
Pointage DNS du domaine :
Dans l'interface de gestion de votre nom de domaine Jobrunner.fr (chez votre registrar) :
- Enregistrement
A:- Hôte :
@ - Valeur :
IP_DE_VOTRE_SERVEUR
- Hôte :
- Enregistrement
CNAME:- Hôte :
www - Valeur :
jobrunner.fr.
- Hôte :
- Certificat SSL / HTTPS :
- Activation du certificat HTTPS Let's Encrypt (gratuit) sur votre serveur pour un affichage sécurisé avec le cadenas vert.
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.