kayjaydee/portfolio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1a2cfc360bbfbc86f10486c1f09cda1776cb5bdd
portfolio/.planning/ROADMAP.md
T

11 KiB
Raw Blame History

Roadmap: Portfolio Killian' Dalcin

Milestone: M1 — Portfolio Hytale-first, SEO-ready, production Granularity: Coarse Coverage: 19/19 requirements mapped

Phases

  • Phase 1: Cleanup & Fixes - Sitemap conflit, Dockerfile pnpm, deps pinning, donnees incoherentes, rate limiting
  • Phase 2: Content - Hero Hytale, page Hytale, pricing, temoignages, jobTitle
  • Phase 3: SEO & i18n - Canonical, ogUrl, og:image, JSON-LD, audit i18n, traductions
  • Phase 4: Ship - Dockerfile final, verification production, deploy

Phase Details

Phase 1: Cleanup & Fixes

Goal: Le codebase est propre — pas de conflits de config, deps pinees, contact form protege, donnees coherentes Depends on: Nothing Requirements: FIX-01, FIX-02, FIX-03, FIX-04, FIX-05, DEPLOY-01 Success Criteria (what must be TRUE):

  1. public/sitemap.xml supprime — curl localhost:3000/sitemap.xml retourne le sitemap dynamique genere par @nuxtjs/sitemap
  2. Dockerfile utilise pnpm install --frozen-lockfile — docker build reussit sans npm
  3. package.json ne contient ni "latest" ni "*" dans les deps
  4. siteConfig.seo.organization.aggregateRating.reviewCount correspond a testimonials.totalReviews
  5. 10 requetes POST rapides sur /api/contact → les dernieres sont rejetees (rate limit) Plans: 2 plans Plans:
  • 01-01-PLAN.md — Delete static sitemap, pin deps, fix data inconsistencies
  • 01-02-PLAN.md — Migrate Dockerfile to pnpm, add contact API rate limiting

Phase 2: Content

Goal: Un visiteur comprend immediatement que Killian est dev Hytale, peut voir les services/prix, et lire des temoignages clients Depends on: Phase 1 Requirements: CONT-01, CONT-02, CONT-03, CONT-04, SEO-05 Success Criteria (what must be TRUE):

  1. Le H1 de la homepage contient "Hytale" — curl localhost:3000 | grep -i hytale dans le <h1>
  2. /hytale existe avec 3+ tiers de pricing visibles et un CTA contact/Discord
  3. app/data/site.ts contient jobTitle: 'Hytale Plugin Developer'
  4. Les temoignages apparaissent sur la homepage ET la page Hytale
  5. Tout le contenu est bilingue — curl localhost:3000/en/hytale retourne du contenu anglais Plans: 3 plans Plans:
  • 02-01-PLAN.md — Types, data files, site.ts config, i18n keys (foundation)
  • 02-02-PLAN.md — Hero refonte Hytale, testimonials featured prop, nav link
  • 02-03-PLAN.md — Hytale page creation with pricing, services, and sections UI hint: yes

Phase 3: SEO & i18n

Goal: Chaque page a des meta tags complets, JSON-LD, canonical links, et des traductions FR/EN naturelles et completes Depends on: Phase 2 Requirements: SEO-01, SEO-02, SEO-03, SEO-04, I18N-01, I18N-02, I18N-03, I18N-04 Success Criteria (what must be TRUE):

  1. curl localhost:3000 retourne <link rel="canonical"> et ogUrl dans le HTML
  2. curl localhost:3000/hytale retourne un JSON-LD Service avec les 3 tiers
  3. curl localhost:3000/en/ retourne du HTML anglais sans hardcoded French strings
  4. Aucun composant ne contient de chaine en dur (grep pour strings hors t() dans les templates)
  5. Les traductions FR sonnent naturel — pas de calque anglais Plans: 4 plans Plans:
  • 06-01-PLAN.md — Content schema Zod extension (draft/wordCount/minutes) + Nitro reading-time hook + draft:true sur test articles
  • 06-02-PLAN.md — i18n keys blog./nav.blog/a11y.blog + lien Blog dans AppHeader + BlogCard.vue unifié (default + compact)
  • 06-03-PLAN.md — Page listing app/pages/blog/index.vue (hero + grid + empty state, SSR bilingue)
  • 06-04-PLAN.md — BlogToc.vue + BlogPrevNext.vue + enrichissement app/pages/blog/[slug].vue (breadcrumb + header + TOC + surround)

Phase 4: Ship

Goal: Le site est deployable en production via Docker et passe tous les checks Depends on: Phase 3 Requirements: DEPLOY-01 Success Criteria (what must be TRUE):

  1. docker build complete sans erreur
  2. Le container sert le site SSR sur le port attendu
  3. pnpm typecheck et pnpm lint passent avec 0 erreurs
  4. curl sur chaque page retourne <title>, <meta description>, og:title dans le HTML brut Plans: 4 plans Plans:
  • 06-01-PLAN.md — Content schema Zod extension (draft/wordCount/minutes) + Nitro reading-time hook + draft:true sur test articles
  • 06-02-PLAN.md — i18n keys blog./nav.blog/a11y.blog + lien Blog dans AppHeader + BlogCard.vue unifié (default + compact)
  • 06-03-PLAN.md — Page listing app/pages/blog/index.vue (hero + grid + empty state, SSR bilingue)
  • 06-04-PLAN.md — BlogToc.vue + BlogPrevNext.vue + enrichissement app/pages/blog/[slug].vue (breadcrumb + header + TOC + surround)

Progress

Phase Plans Complete Status Completed
1. Cleanup & Fixes 2/2 Complete 2026-04-21
2. Content 3/3 Complete 2026-04-21
3. SEO & i18n 1/1 Complete 2026-04-21
4. Ship 1/1 Complete 2026-04-21

Roadmap: Portfolio Killian' Dalcin — M1.1

Milestone: M1.1 — SEO Hytale — Autorité & Contenu Granularity: Standard Coverage: 13/13 requirements mapped

Phases (M1.1)

  • Phase 5: @nuxt/content Setup & Renderer - Integration @nuxt/content, markdown renderer complet avec syntax highlighting et images — Completed 2026-04-22 (2/2 plans)
  • Phase 6: Blog Pages - Page listing /blog et page article /blog/[slug] SSR, bilingue, avec TOC et nav prev/next
  • Phase 7: SEO Blog - useSeoMeta par article, JSON-LD Article, sitemap etendu, og:image, BreadcrumbList
  • Phase 8: Content & Cocon Semantique - 2 articles seed Hytale, liens internes blog-hytale

Phase Details (M1.1)

Phase 5: @nuxt/content Setup & Renderer

Goal: Le systeme de contenu markdown est installe et rend fidelement le contenu technique — blocs de code colores, images optimisees, tables, alerts — sans configuration supplementaire dans les phases suivantes Depends on: Phase 4 (M1 complete) Requirements: BLOG-01, BLOG-04, BLOG-05 Success Criteria (what must be TRUE):

  1. @nuxt/content est installe et configure dans nuxt.config.ts — pnpm dev demarre sans erreur
  2. Un article markdown de test avec un bloc Kotlin est rendu avec coloration syntaxique visible dans le navigateur
  3. Une image referencee dans un article s'affiche via <NuxtImg> avec les optimisations (lazy, format webp)
  4. Un tableau markdown et un callout/alert sont rendus avec le style correct Plans: 2 plans Plans:
  • 05-01-PLAN.md — Installation @nuxt/content, configuration Shiki dual-theme, content.config.ts collections bilingues
  • 05-02-PLAN.md — Composants MDC ProseImg + Alert, articles de test FR/EN, checkpoint visuel UI hint: yes

Phase 6: Blog Pages

Goal: Un visiteur peut naviguer vers /blog, parcourir la liste des articles, ouvrir un article, voir sa table des matieres et naviguer vers l'article precedent/suivant — le tout en SSR et en FR ou EN Depends on: Phase 5 Requirements: BLOG-02, BLOG-03, BLOG-06 Success Criteria (what must be TRUE):

  1. curl localhost:3000/blog retourne du HTML SSR avec une liste d'articles (titre, description, date, tags)
  2. curl localhost:3000/blog/[slug] retourne le contenu de l'article rendu en HTML, pas de SPA shell vide
  3. La page article affiche une table des matieres generee depuis les headings du markdown
  4. Des liens "Article precedent" et "Article suivant" sont presents en bas de chaque article
  5. curl localhost:3000/en/blog retourne le listing en anglais — les articles ont leur version EN Plans: 4 plans Plans:
  • 06-01-PLAN.md — Content schema Zod extension (draft/wordCount/minutes) + Nitro reading-time hook + draft:true sur test articles
  • 06-02-PLAN.md — i18n keys blog./nav.blog/a11y.blog + lien Blog dans AppHeader + BlogCard.vue unifié (default + compact)
  • 06-03-PLAN.md — Page listing app/pages/blog/index.vue (hero + grid + empty state, SSR bilingue)
  • 06-04-PLAN.md — BlogToc.vue + BlogPrevNext.vue + enrichissement app/pages/blog/[slug].vue (breadcrumb + header + TOC + surround) UI hint: yes

Phase 7: SEO Blog

Goal: Chaque page blog est indexable avec des meta tags complets, un JSON-LD Article valide, et les URLs /blog figurent dans le sitemap — Google peut crawler et comprendre le contenu sans ambiguite Depends on: Phase 6 Requirements: SEO-10, SEO-11, SEO-12, SEO-13, SEO-15 Success Criteria (what must be TRUE):

  1. curl localhost:3000/blog/[slug] retourne <meta property="og:title">, <meta property="og:description"> et <meta property="og:image"> uniques dans le HTML
  2. Le meme curl retourne un JSON-LD de type Article avec author, datePublished, headline remplis
  3. curl localhost:3000/sitemap.xml contient les URLs /blog/[slug] et /en/blog/[slug]
  4. og:image pointe vers l'image de l'article ou vers un fallback branded — jamais vers og-image.png generique
  5. La page article contient un JSON-LD BreadcrumbList : Accueil → Blog → Titre de l'article Plans: 4 plans Plans:
  • 07-01-PLAN.md — Install nuxt-schema-org + schema updated + definePerson/defineWebSite global + sitemap.sources
  • 07-02-PLAN.md — resolveOgImage helper + og-blog-default.jpg + [slug].vue useSeoMeta enrichi + defineArticle/defineBreadcrumb
  • 07-03-PLAN.md — index.vue useSeoMeta enrichi + defineWebPage(CollectionPage) + defineBreadcrumb
  • 07-04-PLAN.md — server/api/sitemap/urls.ts (bilingue, draft:false, alternates hreflang, lastmod=updated||date)

Phase 8: Content & Cocon Semantique

Goal: Le blog est lance avec au moins 2 articles Hytale de qualite, et un visiteur qui arrive sur /hytale decouvre les articles recents — le cocon semantique entre blog et page hytale est etabli Depends on: Phase 7 Requirements: BLOG-07, SEO-14 Success Criteria (what must be TRUE):

  1. /blog liste au moins 2 articles avec le tag "hytale", avec titres, descriptions et dates reels
  2. Chaque article blog contient au moins un lien interne vers /hytale dans le corps du texte
  3. La page /hytale affiche une section "Articles recents" avec liens vers les 2 articles seed
  4. Les articles existent en FR et EN — curl localhost:3000/en/blog les liste en anglais Plans: 4 plans Plans:
  • 06-01-PLAN.md — Content schema Zod extension (draft/wordCount/minutes) + Nitro reading-time hook + draft:true sur test articles
  • 06-02-PLAN.md — i18n keys blog./nav.blog/a11y.blog + lien Blog dans AppHeader + BlogCard.vue unifié (default + compact)
  • 06-03-PLAN.md — Page listing app/pages/blog/index.vue (hero + grid + empty state, SSR bilingue)
  • 06-04-PLAN.md — BlogToc.vue + BlogPrevNext.vue + enrichissement app/pages/blog/[slug].vue (breadcrumb + header + TOC + surround) UI hint: yes

Progress (M1.1)

Phase Plans Complete Status Completed
5. @nuxt/content Setup & Renderer 2/2 Complete 2026-04-22
6. Blog Pages 4/4 Complete 2026-04-22
7. SEO Blog 0/? Not started -
8. Content & Cocon Semantique 0/? Not started -
Reference in New Issue View Git Blame Copy Permalink