v2: подробные комментарии во всех модулях — что, зачем, контракты

v2/src/config/index.js

@@ -1,12 +1,22 @@
 // ═══════════════════════════════════════════════════════════════════════════════
-// Конфигурация V2
+// V2 — конфигурация
 //
-// СЕЙЧАС: IAM URL для fetchIamUser() + версия.
-// ПОТОМ: добавить KC_BASE_URL, KC_CLIENT_ID, KC_CLIENT_SECRET для своего OIDC.
+// ЭТО: все настройки в одном месте.
+// ЗАЧЕМ: всё что может поменяться между средами — здесь, не размазано по коду.
+//
+// ПРИОРИТЕТ: process.env (V2_*) → хардкод-умолчания.
+// Умолчания — для тестовой среды (VM KC на italo.kube5s.ru:8080).
 // ═══════════════════════════════════════════════════════════════════════════════
 
 module.exports = {
-  version: '0.5.93',
-  iamUrl:  process.env.V2_IAM_API_URL || 'https://auth-api.ngcloud.ru',
-  appUrl:  process.env.V2_APP_URL      || 'https://whitelist.nodejsk8s.services.ngcloud.ru',
+  version: '0.5.94',
+
+  // ── IAM ──────────────────────────────────────────────────────────────────
+  iamUrl: process.env.V2_IAM_URL || 'https://auth-api.ngcloud.ru/api/v1/auth/user',
+
+  // ── OIDC (Keycloak) ──────────────────────────────────────────────────────
+  kcBaseUrl:      process.env.V2_KC_BASE_URL || 'https://italo.kube5s.ru:8080/realms/ipwhitelist',
+  kcClientId:     process.env.V2_KC_CLIENT_ID || 'ipwhitelist-app',
+  kcClientSecret: process.env.V2_KC_CLIENT_SECRET || '',
+  appUrl:         process.env.V2_APP_URL || 'https://whitelist.nodejsk8s.services.ngcloud.ru',
 };