Fichiers
jobrunner-html/docs/project.md
T

156 lignes
9.2 KiB
Markdown

# Fiche projet — Jobrunner
> Fiche de référence rapide. Pour la technique détaillée, voir [`DOCUMENTATION.md`](../DOCUMENTATION.md).
## Identité
| | |
|---|---|
| **Nom** | Jobrunner |
| **Nature** | Plateforme de mise en relation de services du quotidien, avec séquestre des paiements |
| **Dépôt** | `gastinelt/jobrunner.html` (privé) |
| **Branche de travail** | `claude/laughing-feynman-wtq9jc` |
| **Domaine visé** | `jobrunner.fr` (non encore branché) |
| **Statut** | Prototype frontend avancé. Pas encore de backend, de paiement réel ni de vérification d'identité réelle. |
## Principe
- **Clients** : demandent un service (bricolage, ménage, déménagement, cours, urgences…).
- **Runners** : prestataires indépendants qui proposent leurs services.
- **Séquestre** : les fonds du client sont bloqués à la réservation et versés au runner une fois le service validé par les deux parties.
- **Modèle économique** : 0 € de frais fixes pour le gérant. Les frais Stripe (~1,5 % + 0,25 €) sont couverts par une commission de 10 à 15 %.
## État du site
Le site est une **application monopage** dans un seul fichier, `index.html` (environ 6 600 lignes, HTML, CSS et JavaScript vanilla). Les données sont générées en mémoire : il n'y a pas de base de données.
Modules présents : accueil et recommandations, recherche et filtres, shorts vidéo, fiche annonce, messagerie (mobile et desktop), séquestre simulé, profil et annonces, passes d'abonnement, réglages du compte, mentions légales.
### Ce qui est simulé (à remplacer)
- Connexion et inscription : aucun compte réel, sessions en `localStorage`.
- Paiement et séquestre : aucun appel à Stripe.
- Vérification SIRET, téléphone et pièce d'identité : aucune vérification réelle.
- Photos et vidéos des annonces : banque d'images Unsplash et vidéos Mixkit, hébergées chez des tiers.
## Stack technique
- **HTML, CSS, JavaScript vanilla** : pas de framework.
- **Tailwind CSS 3.4.19** : compilé en CSS statique (`assets/css/app.css`) par `npm run build:css`. Aucun script Tailwind n'est chargé dans le navigateur.
- **Polices auto-hébergées** (licence OFL) :
- *Plus Jakarta Sans* : texte courant.
- *Outfit* : titres et logo (remplace *Chillax*, voir plus bas).
- **Icônes Phosphor 2.1.2** (MIT) : sous-ensemble de 88 icônes, auto-hébergé.
- **Aucun CDN** pour le code ni les polices.
## Arborescence
```
jobrunner.html/
├── index.html # Application complète
├── DOCUMENTATION.md # Documentation technique
├── README.md # Présentation et lancement local
├── docs/
│ ├── project.md # Cette fiche
│ ├── conv.nils.md # Historique détaillé des échanges et décisions
│ ├── gemini-synthese.md # Synthèse des conversations Gemini (produit, DA, ton)
│ └── otherinfos.nils.md # Méthode de travail, ton et objectifs de Nils
├── tailwind.config.js # Palette, ombres et polices (source du CSS)
├── package.json # Script build:css
├── assets/
│ ├── css/ # app.css (généré), fonts.css, tailwind.src.css
│ ├── fonts/ # Fichiers .woff2 (Plus Jakarta Sans, Outfit)
│ └── icons/ # phosphor.css et polices d'icônes
└── .gitignore
```
## Commandes utiles
```bash
# Lancer en local
python -m http.server 8080 # puis http://localhost:8080
# Régénérer le CSS (seulement après ajout de classes Tailwind)
npm install
npm run build:css
```
## Identité visuelle
- **Couleurs de base** : écru `#F4F2EC`, sauge `#7A8E76`, noir doux `#1F221E`.
- **Titres** : Outfit. **Texte** : Plus Jakarta Sans.
- **Formes** : coins très arrondis, ombres douces.
- **Points à trancher** : logo manquant (`logo.jpg` absent), couleurs d'accent trop nombreuses, deux gris coexistants, emojis dans l'interface. Voir l'analyse de direction artistique dans `conv.nils.md`.
## Décisions prises
| Sujet | Décision | Raison |
|---|---|---|
| Tailwind | Compilé en CSS statique | Supprime le runtime JS du CDN |
| Icônes | Sous-ensemble Phosphor | Passe d'environ 150 Ko à moins de 30 Ko |
| Police des titres | Outfit à la place de Chillax | Chillax inaccessible depuis l'environnement de build |
| Images | `loading="lazy"` partout | Chargement plus léger |
## Points ouverts
0. **Police des titres** : la marque avait prévu Chillax. Le site utilise Outfit en attendant les fichiers Chillax. À confirmer (voir `conv.nils.md`, section 11).
0bis. **Shorts** : `ENABLE_SHORTS` est encore à `true`. À passer à `false` pour l'avant-première.
0quater. **Grille tarifaire** : trois versions se contredisent (code, Gemini, extraction JobRuner.txt). À trancher, voir `conv.nils.md`, section 12.
0quinquies. **Palette** : la palette choisie par Nils (capture du 12/10, généré avec Gemini) est `#F2F0E6` beige, `#8B9E90` vert, `#2D2D2D` noir. Elle n'est pas encore appliquée : le code utilise `#F4F2EC` / `#7A8E76` / `#1F221E`. À appliquer après validation.
0sexies. **Amorçage** : l'extraction parle d'un lancement sur Google Sites. Le code est une application monopage. À trancher.
0ter. **Passes** : la grille à 5 offres est toujours là. Elle doit être réduite pour le lancement.
1. **Logo** : intégré (`assets/img/logo.png`, PNG transparent, fourni par Nils). Reste à vérifier le rendu sur mobile.
2. **Chillax** : fichiers à fournir si la marque veut revenir à cette police.
3. **Assets de Nils** : le logo a été déposé dans le dossier local de l'auteur (non accessible depuis l'environnement de build). Il faut le pousser dans `assets/img/` ou le transmettre ici. Les autres fichiers de Nils restent à remonter.
4. **Écran de verrouillage développeur** : protection cosmétique côté client. À retirer avant la mise en production.
5. **Images et vidéos externes** : à rapatrier ou à remplacer par des médias propres au projet.
6. **Découpage du fichier** : `index.html` est très long. Séparer le CSS et le JavaScript est la prochaine étape d'optimisation.
7. **Tests** : aucun test automatisé, aucun lint.
8. **Mise en ligne** : le domaine `jobrunner.fr` n'est pas encore relié.
## Équipe
- `gastinelt` : propriétaire du dépôt.
- `ronnetnils-cyber` (Nils) : collaborateur. Voir `otherinfos.nils.md`.
## Sources de connaissance
- `extraction-jobrunner-txt.md` : extraction de `JobRuner.txt` et `Mise-a-jour.txt` (non vérifiée, à lire avec prudence).
- `conv.nils.md` : historique des échanges avec Claude Code.
- `gemini-synthese.md` : synthèse des conversations Gemini (décisions, DA, ton, objectifs).
- `otherinfos.nils.md` : méthode de travail de Nils (à compléter par Nils).
## Points ouverts — état consolidé (12/10)
**Décisions à prendre par l'auteur**
1. Version à retenir pour le site : dépôt actuel, ou fichier local `e:/dev/jobrunner web/index.html` (plus récent selon l'extraction ?).
2. Palette : `#F2F0E6` / `#8B9E90` / `#2D2D2D` (choix de Nils) ou `#F4F2EC` / `#7A8E76` / `#1F221E` (code actuel).
3. Police des titres : Outfit (actuelle) ou Chillax (à fournir en fichiers `.woff2`).
4. Grille tarifaire : prix du Pass Pro (19,99 € dans le code, 29,99 € dans l'extraction), modèle des Shorts supplémentaires, nombre de pass au lancement.
5. Amorçage : application existante, ou MVP sur Google Sites avec formulaires.
6. Règle de litige sur le séquestre : validation automatique après 48 h, ou intervention du support.
7. Où brancher les logos SVG (`logo-light.svg` pour fond clair, `logo-dark.svg` pour fond foncé).
8. Hébergement et domaine `jobrunner.fr` : aucun choix fait.
**Incohérences dans le code à corriger**
- Inscription : le formulaire demande encore un IBAN, alors que la décision est de ne rien demander à l'inscription (lignes 1304 et 1604 de `index.html`).
- `ENABLE_SHORTS` est à `true` (ligne 2142) : à passer à `false` pour l'avant-première.
- Passes : la grille à 5 niveaux est toujours là. Le nom « Lite » n'apparaît presque pas.
- Lien Instagram : `instagram.com/jobrunner.fr` dans le code, `jobrunnerr` dans l'extraction.
- Envoi d'emails réels : absent (aucun service connecté). Le code OTP est à vérifier (simulation ou réel).
- Popups : une dizaine de types de notifications, alors que la décision est de n'en garder que trois.
- Photo de profil : pas de sélecteur de fichier ni de recadrage.
**Assets et fichiers**
- Logo PNG intégré (`assets/img/logo.png`), à vérifier sur mobile.
- Logos SVG ajoutés (`logo-light.svg`, `logo-dark.svg`), non branchés.
- Chillax : fichiers `.woff2` à fournir si la marque veut revenir à cette police.
- Fichiers de Nils (photos, vidéos, autres) : pas encore remontés. Son push n'a pas eu lieu.
- Fichiers cités dans les extractions mais absents du dépôt : `index-4.html`, `index-11.html`, `index-12.html`, `carrousel.html`, `logos.html`, `JobRuner.txt`, `Mise-a-jour.txt`, maquettes.
**Documentation**
- `docs/otherinfos.nils.md` : questionnaire toujours vide, à remplir par Nils.
- Extraction « JobRuner.txt » : non vérifiée, à lire avec prudence (`docs/extraction-jobrunner-txt.md`).
- Synthèses Gemini : `docs/gemini-synthese.md`, et la vérification de la dernière extraction est dans `docs/conv.nils.md`, section 15.