214 lines
9.2 KiB
Markdown
214 lines
9.2 KiB
Markdown
---
|
|
phase: 07-seo-blog
|
|
plan: 01
|
|
type: execute
|
|
wave: 1
|
|
depends_on: []
|
|
files_modified:
|
|
- package.json
|
|
- pnpm-lock.yaml
|
|
- nuxt.config.ts
|
|
- content.config.ts
|
|
- app/app.vue
|
|
- app/utils/seo-person.ts
|
|
autonomous: true
|
|
requirements: [SEO-11, SEO-12]
|
|
must_haves:
|
|
truths:
|
|
- "nuxt-schema-org est installé et chargé comme module Nuxt"
|
|
- "Schema Zod blog_fr/blog_en accepte `updated` (ISO string) en plus de `image`"
|
|
- "Une identité Person Killian globale (definePerson) + defineWebSite est émise dans chaque page SSR"
|
|
- "nuxt.config.ts référence /api/__sitemap__/urls dans sitemap.sources"
|
|
artifacts:
|
|
- path: "app/utils/seo-person.ts"
|
|
provides: "KILLIAN_PERSON_ID const + killianPerson object (dérivé de siteConfig)"
|
|
contains: "export const KILLIAN_PERSON_ID"
|
|
- path: "content.config.ts"
|
|
provides: "blogSchema étendu avec updated.optional()"
|
|
contains: "updated: z.string().optional()"
|
|
- path: "nuxt.config.ts"
|
|
provides: "module nuxt-schema-org + sitemap.sources"
|
|
contains: "nuxt-schema-org"
|
|
- path: "app/app.vue"
|
|
provides: "useSchemaOrg global (definePerson + defineWebSite)"
|
|
contains: "useSchemaOrg"
|
|
key_links:
|
|
- from: "app/app.vue"
|
|
to: "app/utils/seo-person.ts"
|
|
via: "import killianPerson"
|
|
pattern: "killianPerson"
|
|
- from: "nuxt.config.ts"
|
|
to: "/api/__sitemap__/urls"
|
|
via: "sitemap.sources"
|
|
pattern: "sitemap.*sources.*__sitemap__/urls"
|
|
---
|
|
|
|
<objective>
|
|
Fondation SEO Blog : installer `nuxt-schema-org`, étendre le schema Zod `blog_fr`/`blog_en` avec `updated`, déclarer l'identité Killian globale (Person + WebSite) dans `app.vue`, et brancher le sitemap dynamique sur un endpoint Nitro (déclaration uniquement — l'endpoint est créé plan 07-04).
|
|
|
|
Purpose: Aucun des plans Wave 2 ne peut fonctionner sans (a) le module `nuxt-schema-org` présent dans `modules[]`, (b) le champ `updated` queryable, (c) l'identité Person disponible par `@id` global, (d) `sitemap.sources` wiré.
|
|
Output: package installé, 1 fichier utilitaire créé, 3 fichiers config/racine modifiés.
|
|
</objective>
|
|
|
|
<execution_context>
|
|
@$HOME/.claude/get-shit-done/workflows/execute-plan.md
|
|
@$HOME/.claude/get-shit-done/templates/summary.md
|
|
</execution_context>
|
|
|
|
<context>
|
|
@.planning/PROJECT.md
|
|
@.planning/ROADMAP.md
|
|
@.planning/STATE.md
|
|
@.planning/phases/07-seo-blog/07-CONTEXT.md
|
|
@.planning/phases/07-seo-blog/07-RESEARCH.md
|
|
@.planning/phases/07-seo-blog/07-PATTERNS.md
|
|
@nuxt.config.ts
|
|
@content.config.ts
|
|
@app/app.vue
|
|
@app/data/site.ts
|
|
|
|
<interfaces>
|
|
Depuis app/data/site.ts :
|
|
- `siteConfig.url` = 'https://killiandalcin.fr'
|
|
- `siteConfig.social` = tableau avec entrées Gitea, LinkedIn, Discord, Email (reprendre `url` pour `sameAs`)
|
|
|
|
Depuis content.config.ts (existant) :
|
|
```ts
|
|
const blogSchema = z.object({
|
|
title: z.string(),
|
|
description: z.string(),
|
|
date: z.string(),
|
|
tags: z.array(z.string()).optional(),
|
|
image: z.string().optional(), // DÉJÀ présent (D-14 #2 = no-op)
|
|
draft: z.boolean().optional().default(false),
|
|
wordCount: z.number().optional(),
|
|
minutes: z.number().optional(),
|
|
})
|
|
```
|
|
|
|
Depuis app/app.vue (existant) : `useHead` + `useLocaleHead({ seo: true })` — NE PAS remplacer, APPEND.
|
|
|
|
Auto-imports nuxt-schema-org (une fois module ajouté) : `useSchemaOrg`, `definePerson`, `defineWebSite`, `defineArticle`, `defineBreadcrumb`, `defineWebPage`.
|
|
</interfaces>
|
|
</context>
|
|
|
|
<tasks>
|
|
|
|
<task type="auto">
|
|
<name>Task 1: Installer nuxt-schema-org + étendre content.config.ts (schema updated)</name>
|
|
<files>package.json, pnpm-lock.yaml, content.config.ts</files>
|
|
<read_first>
|
|
- package.json (vérifier absence de nuxt-schema-org)
|
|
- content.config.ts (schéma actuel, ligne 3-12)
|
|
- .planning/phases/07-seo-blog/07-RESEARCH.md §Standard Stack (version cible ^6.0.4)
|
|
- .planning/phases/07-seo-blog/07-RESEARCH.md Pitfall 8 (cache invalidation)
|
|
- .planning/phases/07-seo-blog/07-PATTERNS.md §content.config.ts (modify)
|
|
</read_first>
|
|
<action>
|
|
1. Installer : `pnpm add -D nuxt-schema-org@^6.0.4` (D-01, D-04 — NE PAS installer `@nuxtjs/seo` umbrella).
|
|
2. Dans `content.config.ts`, modifier `blogSchema` : ajouter exactement la ligne `updated: z.string().optional(),` entre `date: z.string(),` et `tags: z.array(z.string()).optional(),` (D-13, D-14). Ne PAS toucher aux autres champs (`image` déjà présent).
|
|
3. Vider les caches pour forcer la re-ingestion : `rm -rf node_modules/.cache/content .nuxt` (Pitfall 8 RESEARCH).
|
|
</action>
|
|
<verify>
|
|
<automated>grep -q '"nuxt-schema-org"' package.json && grep -q 'updated: z.string().optional()' content.config.ts && pnpm typecheck</automated>
|
|
</verify>
|
|
<done>nuxt-schema-org^6.0.4 dans devDependencies, `updated: z.string().optional()` présent dans blogSchema, caches vidés, typecheck exit 0.</done>
|
|
</task>
|
|
|
|
<task type="auto">
|
|
<name>Task 2: Enregistrer module + sitemap.sources dans nuxt.config.ts, créer app/utils/seo-person.ts, brancher useSchemaOrg global dans app/app.vue</name>
|
|
<files>nuxt.config.ts, app/utils/seo-person.ts, app/app.vue</files>
|
|
<read_first>
|
|
- nuxt.config.ts (lignes 1-82 entier, surtout modules[] 5-13)
|
|
- app/app.vue (10 lignes entier)
|
|
- app/data/site.ts (lignes 5-43 — source url + social)
|
|
- .planning/phases/07-seo-blog/07-PATTERNS.md §seo-person.ts, §nuxt.config.ts, §app.vue
|
|
- .planning/phases/07-seo-blog/07-RESEARCH.md §Pattern 1 (Global Schema Identity)
|
|
</read_first>
|
|
<action>
|
|
1. **nuxt.config.ts** :
|
|
- Ajouter `'nuxt-schema-org'` dans `modules[]` après `'@nuxtjs/sitemap'` (ligne ~12).
|
|
- Ajouter, au même niveau d'indentation que `site:` et `i18n:`, le bloc :
|
|
```ts
|
|
sitemap: {
|
|
sources: ['/api/__sitemap__/urls'],
|
|
},
|
|
```
|
|
- Ne PAS modifier `site`, `i18n`, `content`, `runtimeConfig`, `gtag`, `vite`.
|
|
2. **Créer `app/utils/seo-person.ts`** avec le contenu exact (pattern `app/utils/countWords.ts` : JSDoc top + export nommé + const typé) :
|
|
```ts
|
|
/**
|
|
* Global Person identity for schema.org (Killian Dal-Cin).
|
|
* Consumed by: app/app.vue (definePerson global) and app/pages/blog/[slug].vue (author/publisher @id ref).
|
|
* Derives URLs from siteConfig — single source of truth.
|
|
*/
|
|
import { siteConfig } from '~/data/site'
|
|
|
|
export const KILLIAN_PERSON_ID = '#killian'
|
|
|
|
export const killianPerson = {
|
|
'@id': KILLIAN_PERSON_ID,
|
|
name: "Killian' Dal-Cin",
|
|
url: siteConfig.url,
|
|
jobTitle: siteConfig.jobTitle,
|
|
sameAs: siteConfig.social
|
|
.filter((s) => s.name !== 'Email')
|
|
.map((s) => s.url),
|
|
} as const
|
|
```
|
|
3. **app/app.vue** : APPEND (ne pas remplacer) après le bloc `useHead({...})` existant, AVANT la fermeture `</script>` :
|
|
```ts
|
|
import { killianPerson } from '~/utils/seo-person'
|
|
|
|
useSchemaOrg([
|
|
definePerson(killianPerson),
|
|
defineWebSite({
|
|
name: "Killian' Dal-Cin — Hytale Plugin Developer",
|
|
inLanguage: ['fr-FR', 'en-US'],
|
|
}),
|
|
])
|
|
```
|
|
Ne pas toucher au `<template>` ni au `useLocaleHead`/`useHead` existants.
|
|
</action>
|
|
<verify>
|
|
<automated>grep -q "'nuxt-schema-org'" nuxt.config.ts && grep -q "/api/__sitemap__/urls" nuxt.config.ts && grep -q "KILLIAN_PERSON_ID" app/utils/seo-person.ts && grep -q "definePerson(killianPerson)" app/app.vue && pnpm typecheck && pnpm dev --port 3000 & sleep 10 && curl -s http://localhost:3000/ | grep -q '"@type":"Person"' && kill %1</automated>
|
|
</verify>
|
|
<done>Module chargé sans erreur ; `curl /` contient un `<script type="application/ld+json">` avec `"@type":"Person"` et `"@id":"#killian"` émis en SSR ; typecheck vert.</done>
|
|
</task>
|
|
|
|
</tasks>
|
|
|
|
<threat_model>
|
|
## Trust Boundaries
|
|
|
|
| Boundary | Description |
|
|
|----------|-------------|
|
|
| build → runtime | Dépendance npm (`nuxt-schema-org`) introduite dans le supply chain — version figée `^6.0.4` |
|
|
|
|
## STRIDE Threat Register
|
|
|
|
| Threat ID | Category | Component | Disposition | Mitigation Plan |
|
|
|-----------|----------|-----------|-------------|-----------------|
|
|
| T-07-01 | Tampering | package.json (nouveau module) | mitigate | Version explicite `^6.0.4` + pnpm-lock.yaml committé, intégrité pnpm |
|
|
| T-07-02 | Information Disclosure | schema.org Person (exposition URLs publiques) | accept | URLs déjà publiques (portfolio freelance), email exclu de `sameAs` |
|
|
</threat_model>
|
|
|
|
<verification>
|
|
- Module présent : `grep "'nuxt-schema-org'" nuxt.config.ts`
|
|
- Sitemap source : `grep "sources.*__sitemap__/urls" nuxt.config.ts`
|
|
- Schema étendu : `grep "updated: z.string().optional()" content.config.ts`
|
|
- Person global en HTML SSR : `curl http://localhost:3000/ | grep '"@id":"#killian"'`
|
|
- TypeScript : `pnpm typecheck` exit 0
|
|
</verification>
|
|
|
|
<success_criteria>
|
|
1. `nuxt-schema-org` installé (^6.0.4), lockfile à jour
|
|
2. `updated` queryable (Zod) — un article avec `updated:` frontmatter sera exposé par `queryCollection(...).select('updated')`
|
|
3. `curl /` émet JSON-LD global avec Person (@id=#killian) + WebSite, en SSR pur
|
|
4. `nuxt.config.ts > sitemap.sources` déclaré (l'endpoint sera créé 07-04)
|
|
</success_criteria>
|
|
|
|
<output>
|
|
Après complétion, créer `.planning/phases/07-seo-blog/07-01-SUMMARY.md`.
|
|
</output>
|