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 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.
V3 · exécution
Plusieurs étapes pour lire la liste
Welcome.tsxappelle getProjectList()getProjectList.tsdélègue au providerProjectStoreProvider.tsexporte new ProjectStoreImplementation()ProjectStoreImplementation.renvoie le tableau en mémoiregetProjectList() 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é
ProjectSlugdé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.
