diff --git a/docs/conv.nils.md b/docs/conv.nils.md new file mode 100644 index 0000000..1bf15b5 --- /dev/null +++ b/docs/conv.nils.md @@ -0,0 +1,92 @@ +# Historique détaillé de la conversation — Jobrunner + +> Compte rendu de la session de travail menée avec Claude Code sur le dépôt `gastinelt/jobrunner.html`, du point de vue des demandes, des actions réalisées, des décisions et des points restés ouverts. Destiné à Nils pour reprendre le contexte sans relire l'historique. + +## 1. Point de départ + +- Dépôt avec trois commits : `Initial commit`, `feat: site Jobrunner complet`, `docs: documentation technique`. +- Le site est un seul fichier `index.html` (≈ 6 600 lignes) plus `README.md` et `DOCUMENTATION.md`. +- Le site dépendait de services externes : CDN Tailwind (script JS), icônes Phosphor via unpkg (script JS), polices Google Fonts et Fontshare. + +## 2. Demande initiale : faire le point sur le dépôt + +Résultat : état des lieux de l'application (modules, technologies, éléments simulés) et des points d'attention (CDN, verrou développeur côté client, absence de backend, documentation qui décrivait encore l'ancienne organisation). + +## 3. Optimisation et suppression des dépendances externes + +Référence fournie : un autre site personnel (`index.html` de 3 765 lignes) qui sert ses polices depuis son propre dossier `assets/` et n'utilise aucun CDN. + +### Actions réalisées (commit `1222f3f`) + +- **Tailwind** : le CDN a été remplacé par un CSS compilé une fois (`assets/css/app.css`, environ 60 Ko), avec la même version majeure (3.4.19) et la même configuration. Le fichier est versionné : Node n'est nécessaire qu'à la régénération. +- **Icônes** : le paquet Phosphor complet (plusieurs centaines de Ko par graisse) a été réduit aux 88 icônes utilisées, en trois graisses (regular, bold, fill). Résultat : environ 29 Ko au total. Vérification : chaque icône du HTML a sa règle. +- **Polices** : Plus Jakarta Sans auto-hébergée (woff2, latin et latin-ext, graisses 400 à 800). +- **Images et vidéo** : `loading="lazy"` et `decoding="async"` sur les 27 images, `preload="metadata"` sur la vidéo. +- **Accessibilité** : respect de `prefers-reduced-motion`. +- **Vérification** : test dans Chromium headless. Plus aucun appel vers unpkg, Google Fonts, Fontshare ou le CDN Tailwind. Icônes et polices chargées, pas de débordement horizontal. + +### Problème rencontré + +Fontshare (source de Chillax) est bloqué par la politique réseau de l'environnement de build (erreur 403). Chillax n'existe pas non plus sur npm. + +## 4. Demande : ajouter les fichiers Chillax + +Les fichiers n'ont pas été reçus (aucun fichier Chillax dans le dépôt ni dans les uploads). Demande de renvoi, sans suite pour l'instant. + +## 5. Recherche d'alternatives + +Trois pistes : téléchargement par l'utilisateur lui-même, remplacement par une police OFL disponible sur npm, ou mirroirs non officiels (écartés pour des raisons de licence et d'authenticité). L'utilisateur a choisi la deuxième. + +## 6. Remplacement de Chillax par Outfit (commit `f8c2a4c`) + +- **Outfit** choisie comme police la plus proche de Chillax (géométrique, graisses fortes, licence OFL). +- Titres et logo passent sur Outfit ; la graisse 700 est préchargée. +- La classe `font-chillax` (48 usages) devient `font-titre`. +- Vérification : titres en Outfit, aucune erreur JavaScript, rendu validé par capture d'écran. +- Pour revenir à Chillax : déposer les woff2 dans `assets/fonts/`, ajouter les `@font-face` dans `assets/css/fonts.css` et adapter `tailwind.config.js`. + +## 7. Analyse de la direction artistique + +Question posée : « Est-ce que la DA du site est posée ? » + +Réponse, en synthèse : +- **Posé** : palette de base (écru, sauge, noir doux), typographie (titres Outfit, texte Plus Jakarta Sans), formes arrondies, ombres douces, icônes homogènes. +- **Pas encore posé** : + 1. Logo absent (`logo.jpg` introuvable ; fallback « J »). + 2. Couleurs d'accent trop nombreuses (rose, violet, émeraude, ambre, bleu, ciel, fuchsia : environ 280 usages). + 3. Deux gris coexistants (gris Tailwind par défaut et gris maison). + 4. Photos stock sans traitement commun. + 5. Une vingtaine d'emojis dans l'interface. + 6. Aucune charte écrite. + +Ces points n'ont pas encore été corrigés dans le code. + +## 8. Documentation du projet + +- `docs/project.md` : fiche de référence du projet. +- `docs/conv.nils.md` : le présent document. +- `docs/otherinfos.nils.md` : méthode de travail, ton et objectifs de Nils, à compléter par Nils lui-même. + +## 9. Transmission des assets + +Un prompt a été rédigé pour Nils (à coller dans Antigravity) afin de remonter dans le dépôt l'ensemble des assets et fichiers du dossier local, sans secrets, et de compléter `otherinfos.nils.md`. + +## Décisions à retenir + +| Sujet | Décision | +|---|---| +| CSS | Compilé, versionné, sans CDN | +| Icônes | Sous-ensemble Phosphor, auto-hébergé | +| Titres | Outfit, à la place de Chillax | +| Branche | Tout le travail reste sur `claude/laughing-feynman-wtq9jc` | +| Commits | Sans identifiant de modèle dans les messages (règle appliquée) | + +## Points restés ouverts + +1. Logo à fournir (ou à retrouver dans le dossier local de Nils). +2. Fichiers Chillax, si la marque souhaite revenir à cette police. +3. Assets de Nils (photos, vidéos, logo, fichiers divers) à remonter dans `assets/`. +4. Application des corrections de direction artistique (accents, gris, emojis). +5. Remplacement ou rapatriement des images et vidéos externes. +6. Découpage de `index.html` (CSS et JavaScript séparés). +7. Retrait de l'écran de verrouillage développeur avant mise en production. diff --git a/docs/otherinfos.nils.md b/docs/otherinfos.nils.md new file mode 100644 index 0000000..a392d51 --- /dev/null +++ b/docs/otherinfos.nils.md @@ -0,0 +1,60 @@ +# Informations complémentaires — Nils + +> À compléter par Nils. Ce fichier sert à reprendre le projet avec la même manière de travailler, le même ton et les mêmes priorités. Les réponses peuvent être courtes : une phrase suffit. + +## 1. Méthode de travail + +- **Comment travaillez-vous d'habitude sur ce projet ?** (seul, en binôme, en alternant ? Quel outil principal : Antigravity, autre ?) +- **Quand travaillez-vous sur le site ?** (horaires, rythme, sessions courtes ou longues) +- **Comment découpez-vous une tâche ?** (par page, par fonctionnalité, par bug ?) +- **Comment validez-vous un changement avant de le pousser ?** (test manuel sur téléphone, sur ordinateur, relecture ?) + +Réponse : + +## 2. Façon de demander les choses + +- **Comment formulez-vous habituellement vos demandes à l'IA ?** (détaillées, en étapes, avec des exemples, en langage courant ?) +- **Préférez-vous qu'on vous propose plusieurs options, ou une seule solution argumentée ?** +- **Que faut-il éviter absolument ?** (modifications sans prévenir, changement de style, ajout de dépendances…) + +Réponse : + +## 3. Ton et style + +- **Quel ton souhaitez-vous pour le site ?** (chaleureux, premium, sobre, « appli du quotidien », autre ?) +- **Quel ton pour les textes destinés aux utilisateurs ?** (tutoiement ou vouvoiement, formel ou familier) +- **Quels mots ou idées faut-il mettre en avant ?** (confiance, rapidité, sécurité, proximité…) +- **Quels mots ou idées faut-il éviter ?** + +Réponse : + +## 4. Objectif principal + +- **Quel est le but numéro un du projet dans les 3 à 6 prochains mois ?** (lancer une version publique, obtenir les premiers runners, lever des fonds, valider le modèle…) +- **Quelle est la cible prioritaire ?** (clients ou runners) +- **Qu'est-ce qui serait un succès concret pour vous ?** (un chiffre, un événement, une démo) + +Réponse : + +## 5. Priorités et contraintes + +- **Quelles sont les trois tâches les plus urgentes ?** +- **Y a-t-il une échéance ?** (présentation, lancement, rendez-vous) +- **Quelles contraintes ne doivent jamais être oubliées ?** (RGPD, sécurité des paiements, accessibilité, budget) + +Réponse : + +## 6. Assets et fichiers + +- **Où se trouvent les fichiers sur votre ordinateur ?** (chemin du dossier) +- **Y a-t-il un logo ?** Si oui, dans quel format et quelle version (couleur, sombre, icône seule) ? +- **Avez-vous des photos ou vidéos réelles ?** (prestataires, lieux, démonstrations) +- **Avez-vous des fichiers de Chillax ou d'autres polices ?** + +Réponse : + +## 7. Autres remarques + +Tout ce qui vous semble utile et ne rentre dans aucune case ci-dessus. + +Réponse : diff --git a/docs/project.md b/docs/project.md new file mode 100644 index 0000000..5424433 --- /dev/null +++ b/docs/project.md @@ -0,0 +1,107 @@ +# 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 +│ └── 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 + +1. **Logo** : fichier absent. Le fallback « J » s'affiche. +2. **Chillax** : fichiers à fournir si la marque veut revenir à cette police. +3. **Assets de Nils** : photos, logo, vidéos et autres fichiers du dossier local, à remonter dans `assets/` (voir le prompt transmis). +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`.