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:
@@ -0,0 +1,2 @@
|
||||
ALTER TABLE resources DROP COLUMN IF EXISTS scan_session_id;
|
||||
DROP TABLE IF EXISTS resource_links;
|
||||
@@ -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;
|
||||
@@ -447,6 +447,50 @@ func TestMigrationsUpDown(t *testing.T) {
|
||||
t.Error("index idx_resources_search_tsv manquant après 000020")
|
||||
}
|
||||
|
||||
// --- 000021 : graphe documentaire ----------------------------------------
|
||||
assertTables(t, conn, "users", "devices", "resources", "operations", "ocr_jobs", "shares", "share_links", "storage_locations", "resource_placements", "groups", "group_members", "resource_versions", "resource_facts", "resource_links", "schema_migrations")
|
||||
|
||||
// resource_links.id : CHECK 32-hex (requête ciblée — le helper
|
||||
// générique matcherait `from_id <> to_id` qui contient aussi "id").
|
||||
var linksIDCheck string
|
||||
err = conn.QueryRow(`
|
||||
SELECT pg_get_constraintdef(c.oid)
|
||||
FROM pg_constraint c
|
||||
JOIN pg_class t ON t.oid = c.conrelid
|
||||
WHERE t.relname = 'resource_links' AND c.conname = 'resource_links_id_check'`).Scan(&linksIDCheck)
|
||||
if err != nil {
|
||||
t.Fatalf("contrainte CHECK(resource_links.id) manquante: %v", err)
|
||||
}
|
||||
if !strings.Contains(linksIDCheck, "^[0-9a-f]{32}$") {
|
||||
t.Errorf("CHECK resource_links.id attendu 32-hex, obtenu : %s", linksIDCheck)
|
||||
}
|
||||
|
||||
var linksUniq int
|
||||
err = conn.QueryRow(`
|
||||
SELECT COUNT(*) FROM pg_index i
|
||||
JOIN pg_class t ON t.oid = i.indrelid
|
||||
WHERE t.relname = 'resource_links' AND i.indisunique
|
||||
AND ARRAY(SELECT a.attname FROM unnest(i.indkey) WITH ORDINALITY k(attnum, ord)
|
||||
JOIN pg_attribute a ON a.attrelid = t.oid AND a.attnum = k.attnum
|
||||
ORDER BY k.ord)::text[] = ARRAY['from_id','to_id','link_type']`).Scan(&linksUniq)
|
||||
if err != nil {
|
||||
t.Fatalf("links unique: %v", err)
|
||||
}
|
||||
if linksUniq == 0 {
|
||||
t.Error("contrainte UNIQUE(from_id, to_id, link_type) manquante sur resource_links après 000021")
|
||||
}
|
||||
|
||||
var scanSessionCol int
|
||||
err = conn.QueryRow(`
|
||||
SELECT COUNT(*) FROM information_schema.columns
|
||||
WHERE table_schema = 'public' AND table_name = 'resources' AND column_name = 'scan_session_id'`).Scan(&scanSessionCol)
|
||||
if err != nil {
|
||||
t.Fatalf("scan_session_id column: %v", err)
|
||||
}
|
||||
if scanSessionCol == 0 {
|
||||
t.Error("colonne resources.scan_session_id manquante après 000021")
|
||||
}
|
||||
|
||||
if err := MigrateDownDatabase(url); err != nil {
|
||||
t.Fatalf("migrate down: %v", err)
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user