Rémi Girard
Menu

Journal de fabrication ·

Un catalogue suffit pour huit projets statiques

Ce portfolio présente huit projets écrits dans le code. La version précédente passait par un store et un provider pour les afficher. Un catalogue typé suffit aujourd’hui à alimenter les cartes, les pages et le sitemap.

  • Architecture
  • TypeScript
  • DDD
  • Tests
Le portfolio de Rémi Girard, son paysage et sa constellation

Le provider fixait la seule source

Dans la V3, Welcome.tsx appelait getProjectList.ts. La fonction passait par un provider, puis par ProjectStoreImplementation, pour obtenir projectList : huit objets déjà présents en mémoire.

Le store ne lisait ni fichier, ni API, ni base de données. Il n’existait qu’une seule implémentation de ProjectStoreInterface, choisie dès l’import du provider.

Project et ProjectStoreInterface n’ajoutaient aucun traitement à l’exécution. Le schéma ci-dessous distingue ces types du chemin suivi pour obtenir les projets.

Les mêmes huit projets : d’abord plusieurs intermédiaires, puis un catalogue lu par les pages.

V3 · exécution

Plusieurs étapes pour lire la liste

  1. Welcome.tsxappelle getProjectList()
  2. getProjectList.tsdélègue au provider
  3. ProjectStoreProvider.tsexporte new ProjectStoreImplementation()
  4. ProjectStoreImplementation.getProjectList()renvoie le tableau en mémoire
  5. projectListhuit projets définis dans le code

Actuel · catalogue

Un catalogue pour toutes les pages

projectCatalog.ts8 définitionsas const satisfies readonly ProjectDefinition[]
  • Cartes d’accueil
  • Études de cas
  • Métadonnées + sitemap
  • Tests du catalogue
Identité
ProjectSlug dérivé
Chemins
projectPath()
Vérifications
routes · médias · technologies

01 · contrat

Le type rendait trop de champs facultatifs

Le type Project exigeait name et key. La description, les domaines, les technologies, l’image et les logos étaient facultatifs. ProjectCard ne demandait qu’un titre, alors que le lien utilisait aussi projectKey pour construire /project/….

Ces types permettaient des cartes incomplètes dont les huit projets publiés n’avaient pas besoin. Ils ne garantissaient ni les slugs, ni les technologies connues, ni la présence des images. Je n’ai pas trouvé de défaut causé par cette souplesse.

02 · catalogue

Dériver les routes du catalogue

projectCatalog.ts regroupe les huit projets. ProjectDefinition exige un titre, un résumé, les domaines de travail, les technologies, une image et le statut de mise en avant. Avec as const satisfies, TypeScript vérifie ces champs et conserve les slugs précis dans le type ProjectSlug.

listProjects() et getProject() lisent ce catalogue. projectPath() et projectCanonicalPath() construisent les URLs à partir de ProjectSlug. L’accueil, les études de cas, les métadonnées et le sitemap utilisent ainsi les mêmes identifiants. Les autres médias des études restent dans un registre séparé.

Identité
8 slugs littéraux
Routes

ProjectSlug → projectPath()

Consommateurs

Cartes · études · métadonnées · sitemap

03 · vérifications

Déplacer les garanties vers les vérifications

TypeScript contrôle les champs requis et les technologies. Les tests vérifient les liens entre le catalogue, les fichiers et les routes.

  • Chaque slug doit être unique et correspondre à une route d’étude statique.

  • Les technologies montrées sur une carte doivent appartenir à l’environnement détaillé du projet.

  • Chaque image référencée doit exister avec les dimensions annoncées ; les SVG sont aussi inspectés avant d’entrer dans l’ensemble servi.

  • Les fichiers servis doivent correspondre exactement aux images des cartes et aux médias enregistrés pour les études de cas.

La vérification se fait avant la publication, sans code supplémentaire au chargement des pages.

04 · portée

Quand un catalogue suffit

Un repository serait utile si les projets venaient d’une base de données, d’une API ou de plusieurs sources possibles. Ici, ils sont écrits dans le code : le catalogue suffit.

Ce changement permet de vérifier les routes, les images et les identifiants depuis une source commune. Je n’ai pas mesuré son effet sur les performances.