Outil de pilotage interne de la stratégie d'acquisition de WebJourney (agence web, Valais).
Auteurs : Remy & Maxime
Application web collaborative de pilotage de la roadmap d'acquisition de WebJourney. Transforme une stratégie d'acquisition floue en tableau de bord opérationnel partagé entre Remy et Maxime.
v2 (en production) — Next.js 15 · TypeScript · Supabase · Vercel. Tâches pilotables avec statuts, assignation, notes et liens. Authentification magic link.
v1 (prototype de référence) — resources/prototypes/roadmap-v2.html, fichier HTML autonome sans dépendance, toujours utilisable comme référence visuelle.
URL : https://webjourneyadmin.vercel.app
Développement local :
cd app
npm install
npm run devRequiert un fichier .env.local dans app/ (voir .env.example).
resources/prototypes/roadmap-v2.html
Ouvrir directement dans un navigateur. Aucune dépendance. Persistance via localStorage.
Fichiers de configuration et d'entrée du repo.
| Fichier | Description |
|---|---|
README.md |
Ce fichier. Vue d'ensemble du repo, architecture, conventions. |
CLAUDE.md |
Instructions permanentes pour l'IA (ClaudeCode). Règles de travail spécifiques à ce projet, chargées automatiquement à chaque session. |
.gitignore |
Fichiers exclus du versionnement Git. Couvre les dépendances, builds, secrets, fichiers éditeurs et fichiers locaux ClaudeCode. |
Application Next.js v2 — stack de production. Contient toute la logique serveur/client, les composants React, les routes, la config Supabase et les types.
| Dossier / Fichier | Description |
|---|---|
app/ |
Routes Next.js App Router (dashboard, login, auth callback). |
components/ |
Composants React : roadmap/, task/, filters/. |
lib/ |
Logique métier : roadmap/queries.ts, roadmap/mutations.ts, client Supabase. |
types/roadmap.ts |
Types TypeScript partagés (TaskStatus, FilterState, ChapterWithData, etc.). |
supabase/ |
Migrations SQL de la base de données. |
.env.example |
Variables d'environnement requises (Supabase URL, anon key). |
Fichiers applicatifs. Contient l'application en cours de développement.
| Fichier | Description |
|---|---|
roadmap-v2.html |
Application principale. Fichier HTML/CSS/JS autonome, sans dépendance npm. Gère les 10 priorités d'acquisition, le simulateur, le glossaire, le plan 30 jours et la persistance via localStorage. |
Documentation officielle du projet. Source de vérité pour toute décision produit, technique ou UX. À lire avant de modifier quoi que ce soit.
| Fichier | Description |
|---|---|
00-index.md |
Point d'entrée unique du projet. Indique quel fichier lire selon la tâche en cours. À consulter en premier. |
01-product-brief.md |
Vision du produit, objectifs, cible et positionnement. Explique pourquoi cet outil existe et à qui il s'adresse. |
02-functional-spec.md |
Spécification fonctionnelle complète. Décrit chaque fonctionnalité attendue, les comportements, les interactions. |
03-data-model.md |
Structure des données. Détaille les clés localStorage, les objets JS, les types et les valeurs attendues. |
04-ui-ux-guidelines.md |
Règles d'interface. Couvre les couleurs, le layout, la typographie, les thèmes dark/light, les breakpoints et les micro-interactions. |
05-technical-architecture.md |
Stack actuelle et cible. Documente les choix techniques, les dépendances et la trajectoire d'évolution vers une app Next.js. |
06-backlog.md |
Liste des tâches à faire, en cours et livrées. Référence pour choisir quoi implémenter ensuite. |
07-decisions-log.md |
Journal des décisions structurantes. Chaque décision importante (DEC-XXX) est documentée avec son contexte et sa justification. |
Ressources stables de support projet — fichiers qui évoluent avec le projet, ni documentation canonique ni code. Git en garde l'historique.
| Fichier | Description |
|---|---|
design-profile.json |
Profil de design system extrait du repo WebJourney. Couleurs, typographie, tokens Tailwind/shadcn, styles des composants. Contexte visuel réutilisable par l'IA. |
design-profile.md |
Guide d'utilisation du profil JSON : objectif, utilisation avec Claude Code / ChatGPT, points à valider. |
v2-ui-spec.md |
Spécification UI de l'app v2 : pages, composants, états (loading/error/empty), UX des tâches, filtres, auth, accessibilité, checklist d'acceptation. |
v2-component-architecture.md |
Architecture des composants React v2 : arborescence cible, props, séparation client/server, nommage, règles anti-chaos. |
v2-tailwind-token-plan.md |
Plan des tokens Tailwind et shadcn/ui : couleurs, typo, spacing, radius, shadows, statuts, mapping globals.css et tailwind.config.ts. |
chatgpt-project-context.md |
Contexte projet exporté pour ChatGPT — résumé de la stack, des décisions et du backlog à partager avec une IA web. |
wireframes-v3.md |
Wireframes ASCII des 4 vues du dashboard v3 (Home, Roadmap, Pipeline, Weekly). Input pour Claude Design / prototypage Figma. |
Références techniques sur les outils et configurations utilisés dans le projet.
| Fichier | Description |
|---|---|
claude-code.md |
Mécanismes Claude Code : CLAUDE.md, .claude/, Hooks, commandes natives. Quoi utiliser et quand. |
gitignore.md |
Le .gitignore : catégories ignorées, fichiers à conserver, checklist pré-push, procédure git rm --cached. |
skills.md |
Guide opérationnel des 6 skills du projet : invocation, formulations naturelles, workflow feature. |
Fichiers de travail terminés, archivés pour traçabilité. Format : YYYYMMDD-nom-original.md.
| Fichier | Description |
|---|---|
20260601-roadmap-brief.md |
Brief original du projet. Document source ayant servi à structurer toute la documentation officielle. |
20260602-reorganiser-fichiers-v2.md |
Checklist de réorganisation des fichiers v2 dans resources/ et todo/. |
20260603-docs-phase1-corrections.md |
Session de correction de la documentation phase 1 (2026-06-03). |
20260603-webjourney-admin-v2.md |
Session de développement v2 — stabilisation Supabase, filtres, assignation, notes, liens, déploiement Vercel (2026-06-03). |
Configuration Claude Code pour ce projet. Ne contient pas de documentation produit — uniquement des réglages d'outil.
| Fichier / Dossier | Description |
|---|---|
settings.json |
Configuration Claude Code partagée par l'équipe. Définit les permissions et l'allowlist des commandes autorisées. Versionné dans Git. |
settings.local.json |
Surcharges locales personnelles. Non versionné (ignoré par .gitignore). |
skills/acquisition-audit/ |
Audit stratégique d'acquisition — /acquisition-audit |
skills/spec-feature/ |
Spécifier un item backlog avant de coder — /spec-feature B-NNN |
skills/implement/ |
Implémenter un item spécifié — /implement B-NNN |
skills/review/ |
Relire UI ou code avant commit — /review |
skills/integrate-decision/ |
Intégrer une décision dans les docs — /integrate-decision |
skills/sync-docs/ |
Vérifier les références croisées — /sync-docs |
v2 (production) — Next.js 15 · TypeScript strict · shadcn/ui · Tailwind · Supabase · Vercel
v1 (prototype de référence archivé) — HTML / CSS / JS · Google Fonts (CDN) · localStorage
| Préfixe | Usage |
|---|---|
feat: |
Nouvelle fonctionnalité |
fix: |
Correction de bug |
docs: |
Modification documentation uniquement |
chore: |
Maintenance, config, gitignore |
refactor: |
Restructuration sans changement de comportement |
1 commit = 1 changement logique. Ne jamais mélanger doc et code dans un même commit.