diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..7f9cb72 --- /dev/null +++ b/.gitignore @@ -0,0 +1,26 @@ +# Fichiers d'environnement et secrets +.env +.env.local +.env.*.local +*.pem +*.key + +# DĂ©pendances et builds +node_modules/ +dist/ +build/ +.cache/ + +# Fichiers temporaires et logs +*.log +npm-debug.log* +yarn-debug.log* +yarn-error.log* +.DS_Store +Thumbs.db + +# Fichiers IDE +.vscode/ +.idea/ +*.sublime-project +*.sublime-workspace diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md new file mode 100644 index 0000000..6ecd2f2 --- /dev/null +++ b/DOCUMENTATION.md @@ -0,0 +1,145 @@ +# 📚 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 +1. [Vue d'ensemble du Projet](#1-vue-densemble-du-projet) +2. [Architecture et Organisation des Fichiers](#2-architecture-et-organisation-des-fichiers) +3. [RĂšgles de Travail sur le DĂ©pĂŽt Git PrivĂ©](#3-rĂšgles-de-travail-sur-le-dĂ©pĂŽt-git-privĂ©) +4. [FonctionnalitĂ©s Actuelles du Site (Frontend)](#4-fonctionnalitĂ©s-actuelles-du-site-frontend) +5. [SpĂ©cifications Techniques des APIs Ă  IntĂ©grer](#5-spĂ©cifications-techniques-des-apis-Ă -intĂ©grer) + - [Paiements & SĂ©questre (Stripe)](#51-paiements--sĂ©questre-stripe) + - [VĂ©rification d'IdentitĂ© 100% LĂ©gale & Gratuite](#52-vĂ©rification-didentitĂ©-100-lĂ©gale--gratuite) +6. [Mise en Ligne & Configuration du Domaine `Jobrunner.fr`](#6-mise-en-ligne--configuration-du-domaine-jobrunnerfr) +7. [StratĂ©gie Marketing & Acquisition RĂ©seaux Sociaux](#7-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 # Application Web frontend complĂšte (6600+ lignes) +``` + +### Technologies du Frontend : +* **HTML5 / JavaScript Vanilla :** Application Single Page dynamique sans framework lourd pour un chargement instantanĂ©. +* **Tailwind CSS (CDN) :** Palette de couleurs sur-mesure (`#F4F2EC` Ă©cru/beige, `#7A8E76` sauge, `#1F221E` sombre). +* **Phosphor Icons :** BibliothĂšque d'icĂŽnes vectorielles moderne. +* **Typographies :** Polices *Chillax* (titres modernes) et *Plus Jakarta Sans* (corps de texte). +* **Responsive Hybride :** Conçu en prioritĂ© pour mobile (format app native avec dock de navigation bas) et adaptĂ© pour grand Ă©cran desktop. + +--- + +## 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`) : + +1. **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`. +2. **Gestion des Secrets & ClĂ©s API :** + * **JAMAIS** de clĂ© secrĂšte Stripe (`sk_live_...` ou `sk_test_...`) dans le code HTML/JS cĂŽtĂ© client. + * Toutes les clĂ©s sensibles doivent rĂ©sider dans un fichier `.env` ou sur le serveur backend uniquement. + * Le fichier `.gitignore` bloque l'envoi de ces fichiers sensibles sur Git. +3. **Commandes usuelles de synchronisation :** + ```bash + # 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 :** + 1. Le client clique sur *"RĂ©server avec SĂ©questre"*. + 2. Le serveur appelle `stripe.paymentIntents.create` avec l'option `capture_method: 'manual'` (autorisation prĂ©alable). + 3. L'argent est bloquĂ© sans ĂȘtre transfĂ©rĂ© au runner immĂ©diatement. + 4. Fin de mission : le client valide $\rightarrow$ le serveur exĂ©cute `stripe.paymentIntents.capture` $\rightarrow$ les 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 + +1. **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 $\rightarrow$ l'API confirme l'existence de l'entreprise, son immatriculation et son gĂ©rant lĂ©gal $\rightarrow$ Attribution automatique du badge *"Pro VĂ©rifiĂ© SIRET"*. +2. **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. +3. **VĂ©rification PiĂšce d'IdentitĂ© CNI (Optionnelle via Stripe Identity) :** + * FacturĂ©e ~1,50 € par vĂ©rification $\rightarrow$ Frais rĂ©percutĂ©s au runner qui choisit de dĂ©bloquer le badge *"IdentitĂ© CertifiĂ©e CNI"*. + +--- + +## 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` +* **Enregistrement `CNAME` :** + * HĂŽte : `www` + * Valeur : `jobrunner.fr.` +* **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 : +1. **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." +2. **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. diff --git a/README.md b/README.md index b8e689f..d93f9b4 100644 --- a/README.md +++ b/README.md @@ -1 +1,30 @@ -# jobrunner.html \ No newline at end of file +# 🚀 Jobrunner Web + +Plateforme moderne de mise en relation de services et prestations avec sĂ©questre bancaire sĂ©curisĂ©. + +* 🌐 **Site web officiel :** [https://jobrunner.fr](https://jobrunner.fr) +* 🔒 **DĂ©pĂŽt privĂ© :** `gastinelt/jobrunner.html` + +--- + +## 📖 Documentation ComplĂšte + +Pour consulter l'ensemble des spĂ©cifications techniques, le fonctionnement des APIs (Stripe, VĂ©rifications d'identitĂ©), les rĂšgles de collaboration Git et la mise en ligne, consultez le fichier : + +👉 **[DOCUMENTATION.md](./DOCUMENTATION.md)** + +--- + +## ⚡ Lancement Rapide en Local + +Ouvrez simplement le fichier `index.html` dans n'importe quel navigateur moderne, ou utilisez un serveur de dĂ©veloppement local : + +```bash +# Avec Python +python -m http.server 8080 + +# Ou avec Node.js (npx serve) +npx serve . +``` + +Puis accĂ©dez Ă  `http://localhost:8080`. \ No newline at end of file