Proposition : Multi-instances, auth_type none et connecteurs publics

Date : 26/01/2026 Projet : connectors-api Status : En attente validation

Contexte

Trois problèmes identifiés :

1. Services sans auth : affichent une option credentials inutile
2. Multi-comptes : impossible d'avoir 2 comptes Jellyfin (perso + famille)
3. Connecteurs publics : les services internes sans auth ne sont pas disponibles par défaut

État actuel des connecteurs

Architecture actuelle

config (connecteur)          tokens (credentials)
├── id                       ├── connector_id ─┐
├── name (UNIQUE)            ├── user_id ──────┼── UNIQUE ensemble
├── type                     ├── api_key       │
├── auth_type                └── access_token  │
└── base_url                                   │
                                               ▼
                             1 seul token par connector/user

Solution proposée

1. Supporter auth_type: none proprement

Backend :

• Ajouter none à la contrainte CHECK SQL
• Ne pas créer d'entrée dans tokens pour ces connecteurs
• Ignorer les appels POST /api/user/connectors/:id/token si auth_type: none

Frontend :

• Masquer la section "Credentials" si auth_type: none
• Afficher "Pas d'authentification requise" à la place

2. Système d'instances (multi-comptes)

Nouvelle architecture :

connector_types (prédéfinis)     user_connectors (instances)
├── type (github, jellyfin)      ├── id
├── display_name                 ├── user_id
├── auth_type                    ├── connector_type ──► type
├── endpoints[]                  ├── name (ex: "Jellyfin Perso")
└── default_base_url             ├── base_url (override)
                                 ├── api_key / token
                                 └── is_default

Avantages :

• Un utilisateur peut créer plusieurs instances du même type
• Chaque instance a son propre nom et credentials
• Les endpoints sont partagés (définis par type)

3. Migration

Option A : Évolution douce (recommandée)

• Garder la table config comme "types de connecteurs"
• Ajouter une table user_connectors pour les instances
• Migration : créer une instance par token existant

Option B : Refactoring complet

• Renommer config → connector_types
• Fusionner tokens dans user_connectors
• Plus propre mais plus de travail

Schéma SQL (Option A)

-- Nouvelle table pour les instances utilisateur
CREATE TABLE connectors.user_connectors (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  user_id UUID NOT NULL,
  connector_type_id UUID NOT NULL REFERENCES connectors.config(id),

  -- Instance config
  name TEXT NOT NULL,                    -- "Jellyfin Perso"
  base_url TEXT,                         -- Override de l'URL par défaut

  -- Credentials (fusionné depuis tokens)
  api_key TEXT,
  access_token TEXT,
  refresh_token TEXT,
  expires_at TIMESTAMPTZ,
  token_metadata JSONB DEFAULT '{}',

  -- Metadata
  is_default BOOLEAN DEFAULT false,      -- Instance par défaut pour ce type
  created_at TIMESTAMPTZ DEFAULT NOW(),
  updated_at TIMESTAMPTZ DEFAULT NOW(),

  UNIQUE(user_id, name)                  -- Nom unique par utilisateur
);

API modifiée

# Lister les instances de l'utilisateur
GET /api/user/connectors
→ [{"id": "...", "name": "Jellyfin Perso", "type": "jellyfin", ...}]

# Créer une nouvelle instance
POST /api/user/connectors
{
  "type": "jellyfin",
  "name": "Jellyfin Famille",
  "base_url": "https://jellyfin-famille.example.com",
  "api_key": "..."
}

# Appeler via une instance spécifique
POST /api/fetch
{
  "connector": "jellyfin",           // type OU
  "instance": "Jellyfin Famille",    // nom d'instance
  "method": "GET",
  "path": "/System/Info"
}

Effort estimé

3. Connecteurs publics (sans auth)

Problème

• scraper et web-search sont marqués custom mais n'ont pas d'auth
• Ces connecteurs + yolo + ai-orchestrator devraient être utilisables immédiatement
• Actuellement marqués is_connected: false → l'UI suggère qu'il faut configurer quelque chose

Solution

Nouveau champ is_public dans la table config :

ALTER TABLE connectors.config ADD COLUMN is_public BOOLEAN DEFAULT false;

-- Connecteurs publics (sans auth, disponibles pour tous)
UPDATE connectors.config SET is_public = true, auth_type = 'none'
WHERE name IN ('ai-orchestrator', 'yolo', 'scraper', 'web-search');

Comportement :

• is_public = true → Toujours is_connected = true dans l'API
• Pas de section credentials dans l'UI
• Pas besoin de créer une entrée dans tokens
• Utilisable immédiatement par tous les utilisateurs authentifiés sur la plateforme

⚠️ Important : "public" ne signifie PAS accessible sans auth !

• L'utilisateur DOIT être connecté à connectors-api (JWT valide)
• Mais il n'a PAS besoin de configurer de credentials pour ces services internes
• Les appels /api/fetch nécessitent toujours le header Authorization: Bearer <token>

Liste des connecteurs publics : | Connecteur | Usage | |------------|-------| | ai-orchestrator | Queue IA, GPU status | | yolo | Détection objets | | web-search | Recherche web (SearXNG) | | scraper | Web scraping (Playwright) |

⚠️ Préservation des données

Aucune donnée ne sera perdue !

Toutes les migrations sont additives :

• ALTER TABLE ADD COLUMN → ajoute sans toucher aux données existantes
• UPDATE ... SET is_public = true → modifie uniquement le nouveau champ
• Les tokens existants restent intacts
• Les connecteurs existants restent fonctionnels

Script de migration sécurisé :

-- Transaction pour rollback si erreur
BEGIN;

-- 1. Ajouter colonne (sans impact sur données)
ALTER TABLE connectors.config ADD COLUMN IF NOT EXISTS is_public BOOLEAN DEFAULT false;

-- 2. Mettre à jour UNIQUEMENT les connecteurs sans auth
UPDATE connectors.config
SET is_public = true, auth_type = 'none'
WHERE name IN ('ai-orchestrator', 'yolo', 'scraper', 'web-search');

-- 3. Vérifier avant commit
SELECT name, auth_type, is_public FROM connectors.config;

COMMIT;

Résumé des changements

Questions pour validation

1. Option A ou B pour la migration multi-instances ?
2. Nommage : "instance" ou "account" ou autre ?
3. Priorité :
   • Quick fix (is_public + auth_type) → maintenant ?
   • Multi-instances → plus tard ?