Fichiers
jobrunner-html/docs/project.md
T

123 lignes
6.6 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** : fichier absent. Le fallback « J » s'affiche.
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).