---
page: backlink
sous-page: overview
route: /backlink/overview
statut: draft
version: 0.1
transverse-liées: [reservoir-data-model (TBD), conventions, i18n, design-system]
date: 2026-06-03
---

# CdC — `backlink/overview`

> Dashboard netlinking en lecture : **santé globale du Reservoir** + **campagnes par site** + **actions suggérées**. Drill-down vers les sous-pages.

## 1. Objectif

Donner l'état du netlinking : qualité/volumétrie du pool global (par thème/langue), **risques** (footprint, toxiques, liens perdus), avancement des campagnes par site, et **quoi faire ensuite**.

## 2. Périmètre

- **Dans** : KPIs globaux du Reservoir + KPIs **par site** (sélecteur), risques, cadence/avancement campagne, activité récente, **actions suggérées**, drill-down.
- **Hors** : toute écriture (→ sous-pages).

## 3. User stories *(persona : netlinker)*

- Je vois la **santé** de mon netlinking d'un coup d'œil.
- Je repère les **liens perdus** et **toxiques** à traiter.
- Je repère les **prospects à planifier**.

## 4. Fonctionnalités

- F1 — **KPIs Reservoir global** : nb de sources, par **thème/langue**, distribution TF/CF/DR.
- F2 ⭐ — **Risques** : **footprint** (domaines sur-exploités), **toxiques** (à disavow), **liens perdus** récents.
- F3 — **Campagnes par site** (sélecteur) : cadence + avancement (prospect → live → perdu).
- F4 — **Backlog d'opportunités** : top sources pertinentes non encore prospectées.
- F5 — **Activité récente** : imports, acquisitions, pertes.
- F6 ⭐ — **Actions suggérées** : « X liens perdus à reconquérir · Y toxiques à disavow · Z prospects à planifier · trous thématiques ».
- F7 — **Drill-down** vers `reservoir`/`recherche`/`planning` filtrés.

## 5. UI / écrans

- Grille de cartes (lecture) : section **globale** + section **par site** (sélecteur), mini-charts. Quick-actions (R2). Tokens `design.md`.

## 6. Données & actions

- **Affiché** : agrégats globaux + par site.
- **Actions** : naviguer / drill-down, lancer une action suggérée.

## 7. Modèle de données

- **Aucune table propre** : agrégats sur `link_source`, `link_source_metric`, `backlink`, `import_job`.

## 8. API Hono

- `GET /backlinks/dashboard` *(global)*
- `GET /sites/:siteId/backlinks/dashboard` *(par site)*
- `GET /sites/:siteId/backlinks/suggested-actions`

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

Agrégation globale + par site · détection de **risques** (footprint/toxic/lost) · actions suggérées · cache.

## 10. Tools / capacités MCP

- `bl_dashboard` (read) · `bl_suggested_actions` (read)

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

## 11. i18n

- UI localisée. Réf `_transverse/i18n.md` (TBD).

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

- **Perf** : agrégats **cachés** ; `cache-control`, `core-web-vitals`. **A11y** : cartes/quick-actions clavier. **Sécu** : accès données globales, auth. **Indexation** : noindex.

## 13. Critères d'acceptation

- [ ] Les KPIs globaux reflètent le Reservoir ; les KPIs par site reflètent ses campagnes.
- [ ] Les **risques** (footprint/toxic/lost) sont listés et cliquables.
- [ ] Une action suggérée ouvre la **bonne sous-page filtrée**.
- [ ] Le **switch de site** met à jour la section campagne.

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

- **Dépend de** : `reservoir`, `recherche`, `planning`, `export-import`, `_transverse/reservoir-data-model`, `_transverse/conventions`.
- **Questions ouvertes** : seuils des risques (footprint/toxic) ? fréquence de rafraîchissement ?