78 lines
3.5 KiB
Markdown
78 lines
3.5 KiB
Markdown
# 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
|