---
page: products
sous-page: overview
route: /products/overview
statut: draft
version: 0.1
transverse-liées: [conventions, i18n, design-system]
date: 2026-06-03
---

# CdC — `products/overview`

> **Dashboard products** en lecture : production + pages en ligne + **santé du flux** + actions. Drill-down vers les sous-pages.

## 1. Objectif

Donner l'état e-commerce d'un site : où en est l'**optimisation**, l'état des **pages produits** et du **flux Merchant**, et **quoi corriger en priorité**.

## 2. Périmètre

- **Dans** : KPIs production (par statut), **pages live + fraîcheur**, **santé du flux** (actifs / refusés / en attente), perf *(en souffrance — D1)*, **actions suggérées**, drill-down.
- **Hors** : écriture (→ sous-pages).

## 3. User stories *(persona : SEO e-commerce)*

- Je vois combien de produits sont **optimisés vs à faire**.
- Je vois les **flux refusés** à corriger.
- Je vois les **pages à rafraîchir**.

## 4. Fonctionnalités

- F1 — **KPIs production** : `product_item` par statut.
- F2 — **Pages live + fraîcheur** (à mettre à jour).
- F3 ⭐ — **Santé du flux** : actifs / **refusés** / en attente, top issues.
- F4 — **Perf** *(en souffrance — D1)* : carte gelée.
- F5 ⭐ — **Actions suggérées** : « X flux refusés à corriger · Y pages à rafraîchir · Z produits à optimiser ».
- F6 — **Drill-down** vers `planning` / `online` / `stats`.

## 5. UI / écrans

- Grille de cartes (lecture) + mini-charts ; carte perf « en souffrance ». Quick-actions (R2). Tokens `design.md`.

## 6. Données & actions

- **Affiché** : agrégats production + online + flux.
- **Actions** : naviguer / drill-down, lancer une action suggérée.

## 7. Modèle de données

- **Aucune table propre** : agrégats sur `product`, `product_item`, `product_page`, `feed_status` (+ plus tard `product_perf` via D1).

## 8. API Hono

- `GET /sites/:siteId/products/dashboard`
- `GET /sites/:siteId/products/suggested-actions`

## 9. Capacités requises *(fonctionnel — mapping modules TBD)*

Agrégation production + online + flux · détection des **issues flux** · actions suggérées · cache.

## 10. Tools / capacités MCP

- `product_dashboard` (read) · `product_suggested_actions` (read)

> Privé vs public-limité : **TBD**.

## 11. i18n

- UI localisée.

## 12. Qualité *(réf. fiches des 128 par slug)*

- **Perf** : agrégats cachés, `cache-control`. **A11y** : cartes/quick-actions clavier. **Sécu** : isolation **par site**, auth. **Indexation** : noindex.

## 13. Critères d'acceptation

- [ ] Les KPIs production reflètent le board `planning`.
- [ ] Les **flux refusés** remontent depuis `online`.
- [ ] La carte **perf** affiche « en souffrance » tant que D1 non tranché.
- [ ] Une action suggérée ouvre la **bonne sous-page filtrée**.

## 14. Dépendances & risques · questions ouvertes

- **Dépend de** : `products/planning`, `products/online`, `products/stats` (D1), `_transverse/conventions`.
- **Questions ouvertes** : règles des actions suggérées ? fréquence de rafraîchissement ?