V3 S5 : graphe documentaire + doublons + collections

Backend : resource_links + scan_session_id (000021), réconciliation
déterministe (same_scan outbox, doublons SHA-256 à l'upload + backfill,
same_issuer/référence via faits effectifs, verdicts préservés, élagage
auto), GET /files/:id/relations + verdict (owner-only),
GET /duplicates (groupes + gain récupérable). Tests service + handlers
+ migrations.

Mobile (Room v22) : links + collections, scanSessionId dans les creates
de scan, LinksRepository (sync + verdicts REST), « Voir aussi » dans la
fiche (verdict infirmer/re-confirmer), écran Doublons (garder le plus
récent), collections locales (sauver/rejouer/supprimer). FR/EN.

Contrat docs/api-v1.md (/relations, pas /links — pris par le partage),
V3.md (S5 livré, version_of non matérialisé).
This commit is contained in:
venture
2026-09-26 11:16:35 +02:00
parent 2d984fd665
commit 37dc36f1f2
66 changed files with 3933 additions and 34 deletions
@@ -0,0 +1,2 @@
ALTER TABLE resources DROP COLUMN IF EXISTS scan_session_id;
DROP TABLE IF EXISTS resource_links;
+32
View File
@@ -0,0 +1,32 @@
-- V3 relations documentaires (S5) : graphe auto + verdicts utilisateur.
-- `resource_links` : arêtes orientées (from_id → to_id) typées, avec
-- confiance et origine. `duplicate_of` (même content_hash), `same_scan`
-- (même session de scan, déterministe), `same_issuer` / `same_reference`
-- (faits normalisés égaux). `version_of` non matérialisé : les versions
-- vivent DANS la ressource (resource_versions, 000018), pas entre ressources.
-- `created_by` : 'auto' (dérivé serveur, écrasable) vs 'user' (verdict
-- explicite — la réconciliation ne touche jamais aux verdicts). Les
-- invalidations (confidence 0) sont conservées (pas de re-création auto).
-- `resources.scan_session_id` : session de scan opaque fournie par le client
-- dans le payload `create_resource` (zéro nouvelle op) — le serveur en
-- déduit les arêtes `same_scan`.
CREATE TABLE resource_links (
id TEXT PRIMARY KEY CHECK (id ~ '^[0-9a-f]{32}$'),
from_id TEXT NOT NULL REFERENCES resources(resource_id) ON DELETE CASCADE,
to_id TEXT NOT NULL REFERENCES resources(resource_id) ON DELETE CASCADE,
link_type TEXT NOT NULL CHECK (link_type IN (
'same_scan', 'duplicate_of', 'same_issuer', 'same_reference'
)),
confidence REAL NOT NULL CHECK (confidence >= 0 AND confidence <= 1),
created_by TEXT NOT NULL DEFAULT 'auto' CHECK (created_by IN ('auto', 'user')),
created_at TIMESTAMPTZ DEFAULT NOW(),
CHECK (from_id != to_id),
UNIQUE (from_id, to_id, link_type)
);
CREATE INDEX idx_links_from ON resource_links(from_id);
CREATE INDEX idx_links_to ON resource_links(to_id);
ALTER TABLE resources ADD COLUMN scan_session_id TEXT;
CREATE INDEX IF NOT EXISTS idx_resources_scan_session ON resources(user_id, scan_session_id)
WHERE scan_session_id IS NOT NULL;