From 9b1717cbd8451962e4943a1a5bc0e89f26c99a42 Mon Sep 17 00:00:00 2001
From: kayjaydee <killian.dalcin@gmail.com>
Date: Wed, 22 Apr 2026 11:14:46 +0200
Subject: [PATCH] docs(07-01): capture plan summary
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Foundation SEO Blog shipped — nuxt-schema-org installed, blog schema extended
with updated field, global Person/WebSite schema.org emitted SSR, sitemap.sources
wired to future Nitro endpoint (07-04).
---
 .planning/phases/07-seo-blog/07-01-SUMMARY.md | 97 +++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 .planning/phases/07-seo-blog/07-01-SUMMARY.md

diff --git a/.planning/phases/07-seo-blog/07-01-SUMMARY.md b/.planning/phases/07-seo-blog/07-01-SUMMARY.md
new file mode 100644
index 0000000..3c23931
--- /dev/null
+++ b/.planning/phases/07-seo-blog/07-01-SUMMARY.md
@@ -0,0 +1,97 @@
+---
+phase: 07-seo-blog
+plan: 01
+subsystem: seo-infrastructure
+tags: [seo, schema-org, sitemap, nuxt-content, foundation]
+status: shipped
+completed: 2026-04-22
+requirements: [SEO-11, SEO-12]
+dependency_graph:
+  requires:
+    - "@nuxtjs/sitemap (déjà présent)"
+    - "@nuxt/content blog_fr/blog_en (Phase 5)"
+    - "app/data/site.ts siteConfig"
+  provides:
+    - "Module nuxt-schema-org chargé globalement (useSchemaOrg / definePerson / defineWebSite / defineArticle / defineBreadcrumb auto-imports)"
+    - "Identité Person Killian globale (@id #killian) injectée via JSON-LD SSR sur chaque page"
+    - "WebSite schema.org global (FR+EN inLanguage)"
+    - "Schema Zod blog `updated: z.string().optional()` queryable (dateModified upstream)"
+    - "nuxt.config.ts > sitemap.sources branché sur /api/__sitemap__/urls (endpoint créé Plan 07-04)"
+    - "app/utils/seo-person.ts : KILLIAN_PERSON_ID + killianPerson (single source of truth)"
+  affects:
+    - "Wave 2 Plans 07-02/07-03/07-04 (consomment l'identité Person + module schema-org)"
+tech_stack:
+  added:
+    - "nuxt-schema-org ^6.0.4 (devDependency)"
+  patterns:
+    - "Auto-imports nuxt-schema-org : useSchemaOrg, definePerson, defineWebSite (pas d'import explicite requis dans .vue)"
+    - "Person helper module-level (pattern app/utils/countWords.ts) : JSDoc top + named const typé `as const`"
+key_files:
+  created:
+    - "app/utils/seo-person.ts (20 lignes, KILLIAN_PERSON_ID + killianPerson)"
+  modified:
+    - "package.json + pnpm-lock.yaml (devDep nuxt-schema-org ^6.0.4)"
+    - "content.config.ts (blogSchema + updated: z.string().optional())"
+    - "nuxt.config.ts (modules[] + 'nuxt-schema-org', new sitemap.sources)"
+    - "app/app.vue (useSchemaOrg global append, pas de remplacement du useLocaleHead/useHead existant)"
+decisions:
+  - "D-01, D-04: cherry-pick nuxt-schema-org (pas le bundle @nuxtjs/seo umbrella qui doublonne avec sitemap déjà présent)"
+  - "D-12: Person Killian déclarée en global (app.vue) — les defineArticle des plans suivants référenceront @id=#killian au lieu de réinliner author/publisher"
+  - "D-13, D-14: `updated` optional dans schema Zod (si absent → dateModified = date dans les plans downstream)"
+  - "Sitemap endpoint déclaré mais pas créé ici (Plan 07-04 owner)"
+metrics:
+  duration_minutes: 8
+  tasks_completed: 2
+  commits: 2
+  files_created: 1
+  files_modified: 4
+---
+
+# Phase 7 Plan 1 : Foundation SEO Blog — Summary
+
+**One-liner** : Module `nuxt-schema-org` installé + identité Person/WebSite Killian globale + schema Zod blog étendu avec `updated` + `sitemap.sources` branché sur endpoint Nitro futur.
+
+## Ce qui a été fait
+
+**Task 1 — `chore(07-01)`** (commit `17420af`)
+- `pnpm add -D nuxt-schema-org@^6.0.4`
+- `content.config.ts` : ajout `updated: z.string().optional()` entre `date` et `tags` dans `blogSchema` (partagé `blog_fr` + `blog_en`)
+- Caches `node_modules/.cache/content` + `.nuxt` vidés (Pitfall 8 research — forcer la re-ingestion)
+- `pnpm typecheck` exit 0
+
+**Task 2 — `feat(07-01)`** (commit `654842b`)
+- `nuxt.config.ts` : `'nuxt-schema-org'` ajouté dans `modules[]` juste après `'@nuxtjs/sitemap'`; nouveau bloc `sitemap: { sources: ['/api/__sitemap__/urls'] }` au même niveau d'indentation que `site`/`i18n`
+- `app/utils/seo-person.ts` créé : exporte `KILLIAN_PERSON_ID = '#killian'` et `killianPerson` (dérivé de `siteConfig` — `sameAs` filtre l'entrée `Email`)
+- `app/app.vue` : append (pas de remplacement) d'un bloc `useSchemaOrg([definePerson(killianPerson), defineWebSite({ name, inLanguage: ['fr-FR','en-US'] })])` après le `useHead` existant
+- `pnpm typecheck` exit 0
+- Validation SSR curl : `curl http://localhost:3001/fr` renvoie bien un `<script type="application/ld+json" data-nuxt-schema-org="true">` contenant `@type: Person` (id se terminant par `#killian`) + `@type: WebSite` + `@type: WebPage` auto-attaché par le module
+
+## Deviations from Plan
+
+**None critical.** Deux points de friction mineurs rencontrés & résolus sans changer le plan :
+
+1. **Port** : `pnpm dev --port 3000` a basculé automatiquement sur 3001 (port 3000 déjà occupé). Non-bloquant — validation faite sur 3001.
+2. **@id Person** : le module `nuxt-schema-org` préfixe l'`@id` fourni (`#killian`) par la route canonique du site (résultat final : `https://killiandalcin.fr/#/schema/person/#killian`). Comportement attendu du module et cohérent avec la spec schema.org — le fragment `#killian` reste identifiable en suffixe, ce qui suffit aux références inter-entités (author/publisher) dans les plans Wave 2 via la forme `{ '@id': '#killian' }` (le module résout le préfixe tout seul).
+
+## Acceptance Criteria — tous passés
+
+- [x] `grep "'nuxt-schema-org'" nuxt.config.ts` — match ligne 12
+- [x] `grep "sources.*__sitemap__/urls" nuxt.config.ts` — match bloc sitemap
+- [x] `grep "updated: z.string().optional()" content.config.ts` — match ligne 7
+- [x] `curl http://localhost:3001/fr` émet JSON-LD global Person (@id suffixe `#killian`) + WebSite + WebPage, en SSR pur (aucun JS client requis — détection `<script type="application/ld+json">` directement dans le HTML renvoyé)
+- [x] `pnpm typecheck` exit 0 (sortie clean, seulement banners Nuxt Icon)
+
+## Known Stubs
+
+Aucun. Le seul placeholder explicitement déclaré (`sitemap.sources: ['/api/__sitemap__/urls']`) référence un endpoint Nitro qui sera implémenté par le Plan 07-04 (ownership clair, documenté dans dependency_graph).
+
+## Threat Flags
+
+Aucun nouveau surface de menace introduit. Le module `nuxt-schema-org ^6.0.4` figé en devDependency + `pnpm-lock.yaml` commité mitige T-07-01 (Tampering supply chain). T-07-02 (IDisclo Person public) accepté — URLs du `sameAs` déjà publiques, l'email est explicitement filtré du `sameAs` dans `seo-person.ts` (`filter((s) => s.name !== 'Email')`).
+
+## Self-Check: PASSED
+
+- `app/utils/seo-person.ts` — FOUND
+- Commit `17420af` (chore Task 1) — FOUND in git log
+- Commit `654842b` (feat Task 2) — FOUND in git log
+- Validation SSR JSON-LD — confirmée via curl (Person @id=#killian + WebSite + WebPage émis avant hydratation)