Task: Connectors API - Phases 2, 3 & 4

Date : 25/01/2026 14:10 Status : TERMINÉ Projet : connectors-api

Objectif

Implémenter les phases 2 (Auto-discovery), 3 (Audit logs) et 4 (Versioning) pour rendre l'API connectors-hub autonome et complète.

Travail réalisé

Phase 2 : Auto-discovery

Nouveau service : src/services/autodiscovery.ts

• Recherche intelligente de swagger aux URLs courantes :
  • /swagger.json, /openapi.json, /api-docs, /v3/api-docs
  • /swagger/v1/swagger.json, /api/swagger.json, etc.
• Fallback : exploration des endpoints communs (/users, /repos, /projects, etc.)
• Trigger automatique à la création d'un connecteur

Nouveaux endpoints :

• POST /api/connectors → déclenche auto-discovery en arrière-plan
• POST /api/connectors/:id/rediscover → relance discovery manuellement

Phase 3 : Audit Logs

Nouveau service : src/services/audit.ts Migration : migrations/002_audit_logs.sql

Actions loggées :

• auth.login, auth.logout, auth.register
• auth.password_change, auth.password_reset, auth.disable_account
• connector.create, connector.update, connector.delete
• connector.auth, connector.revoke
• fetch.execute, endpoint.discover, endpoint.import, endpoint.update

Nouveaux endpoints :

• GET /api/audit/logs - Liste avec filtres (user_id, connector_id, action, resource)
• GET /api/audit/logs/:id - Détail d'un log
• GET /api/audit/stats - Statistiques
• GET /api/connectors/:id/logs - Logs d'un connecteur

Phase 4 : Versioning

Nouveau service : src/services/versioning.ts Migration : migrations/003_endpoint_versions.sql

Fonctionnalités :

• Snapshot complet à chaque modification d'endpoint
• Historique des versions avec change_type et change_summary
• Rollback vers n'importe quelle version antérieure
• Diff entre deux versions

Nouveaux endpoints :

• GET /api/endpoints/:id - Détail d'un endpoint
• GET /api/endpoints/:id/versions - Historique des versions
• GET /api/endpoints/:id/versions/:v - Détail d'une version
• POST /api/endpoints/:id/rollback/:v - Rollback
• GET /api/endpoints/:id/diff/:v1/:v2 - Comparer deux versions

Commits

1. e507bcb - feat(discovery): auto-discovery on connector creation
2. caac2c7 - feat: add audit logs and endpoint versioning (Phase 3 & 4)

Tests

• [x] Pipeline #351 : Auto-discovery déployé
• [x] Pipeline #352 : Audit + Versioning déployé
• [x] Health check OK
• [x] Swagger mis à jour avec nouveaux endpoints
• [x] Audit logs endpoint fonctionnel

Prochaines étapes

• [ ] Phase 5 : Front Qwik séparé (connectors-front)
• [ ] Ajouter plus d'audit logging aux autres actions
• [ ] Template email pour reset password via notif-logger