ipwhitelist-app/v2/history/2026-06-12.md

V2 — история 2026-06-12 (финал)

V2 — это тестовый стенд для модулей

Код в v2/ — НЕ production. Это полигон для отладки модулей. Каждый модуль тестируется изолированно, затем будет интегрирован в основной код.

Текущее состояние (0.5.73)

v2/
├── server.js               # createV2Router() → /v2/login, /v2/iam, /v2/logout
├── src/
│   ├── auth/index.js       # fetchIamUser(), login(), exchangeCode(), buildAuthUrl()
│   ├── config/index.js     # iamUrl, appUrl, version (без KC — пока не нужен)
│   ├── crud/index.js       # createCrudRouter() — НЕ монтирован (будет позже)
│   ├── db/
│   │   ├── index.js        # pg pool
│   │   ├── queries.js      # CRUD SQL
│   │   └── schema.js       # ensureSchema(pool) — автосоздание v2_* таблиц
│   └── validators/index.js # CIDR validate, overlaps, BLOCKED_RANGES
└── history/
    └── 2026-06-12.md

Как работает сейчас

1. /v2/login → редирект на /login?returnTo=/v2/iam
2. Основной OIDC: production-KC → /callback → сессия → редирект на /v2/iam
3. /v2/iam → показывает IAM-данные из req.session.user

V2 НЕ делает свой OIDC. Использует готовую сессию основного приложения. Никаких своих KC-настроек. Никакого /v2/callback.

Модуль auth/index.js — готов, но не используется

Функции готовы к production:

• buildAuthUrl(config) — URL редиректа на KC
• exchangeCode(code, config) — обмен code → токен
• fetchIamUser(token, iamUrl) — IAM → профиль
• generateState() — CSRF
• login(code, oidcConfig, iamUrl) — оркестратор

Не тестировались: нужен /v2/callback в redirect URIs production-KC.

Модуль crud/ — готов, не монтирован

Функции:

• createCrudRouter() — роутер с выбором компании (всегда список, даже если одна)
• CRUD через db/queries.js

Таблицы: v2_companies, v2_entries, v2_audit (автосоздание через schema.js).

Модуль db/ — готов

• db/index.js — pg pool
• db/queries.js — getOrCreateCompany, listEntries, createEntry, updateEntry, deleteEntry, getAudit, ...
• db/schema.js — ensureSchema(pool) — CREATE TABLE IF NOT EXISTS

Модуль validators/ — готов

CIDR validate, overlaps, cidrToRange, aggregateCIDRs, BLOCKED_RANGES.

Что дальше

1. fio в fetchIamUser — возвращать строку (сейчас объект)
2. Добавить /v2/callback в redirect URIs production-KC
3. Протестировать auth/login() с production-KC
4. Подключить crud модуль
5. Админка, экспорт

Ключевые решения

• V2 НЕ трогает основной код (server.js — только app.use('/v2', ...))
• Каждый модуль — отдельная папка в src/
• env-переменные — через process.env, без .env/dotenv
• Умолчания — хардкод, переопределяются через V2_* env