Nail/ipwhitelist-app
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
naeel
2026-06-13 07:37:07 +04:00
parent 1af304b2a8
commit 616b4ead09
14 changed files with 592 additions and 518 deletions
Download Patch File Download Diff File Expand all files Collapse all files
v2/server.js
+47 -38
View File
@@ -1,16 +1,23 @@
// ═══════════════════════════════════════════════════════════════════════════════
// V2 — роутер (монтируется в server.js как /v2)
// V2 — главный роутер (монтируется в server.js как /v2)
//
// СЕЙЧАС: показывает IAM-данные из сессии основного приложения.
// Вход — через основной /login (production KC).
// ЭТО: createV2Router() — собирает все v2-роутеры в один.
// ЗАЧЕМ: единственная точка входа v2 в основное приложение.
//
// ПОТОМ: будет свой /v2/login → /v2/callback через production KC.
// Тогда заработает login() из src/auth/index.js.
// МОНТАЖ В ОСНОВНОМ server.js:
// const { createV2Router } = require('./v2/server');
// app.use('/v2', createV2Router());
//
// Модули:
// router/ — resolveContext: admin/user/impersonation → req.v2_*
// user/ — обычный CRUD (пустышка)
// admin/ — админка (пустышка)
// ПОРЯДОК МАРШРУТОВ (важен!):
// 1. /login — редирект на основной OIDC-вход
// 2. /iam — отладка IAM-данных из сессии
// 3. /app — CRUD юзера (resolveContext + user роутер)
// 4. /admin — админка (resolveContext + admin роутер)
// 5. /test — тестовый API (если ENABLE_TEST_API !== 'false')
// 6. /logout — редирект на основной выход
//
// ВАЖНО: роутеры /app и /admin используют resolveContext middleware,
// которое проверяет сессию и выставляет req.clientId, req.email, ...
// ═══════════════════════════════════════════════════════════════════════════════
'use strict';
@@ -25,26 +32,50 @@ const { pool } = require('./src/db');
const { ensureSchema } = require('./src/db/schema');
function createV2Router() {
// Автосоздание таблиц при старте
// Автосоздание таблиц v2_companies, v2_entries, v2_audit при старте
ensureSchema(pool).catch(e => console.error('[v2:db] Schema error:', e.message));
const router = express.Router();
// ── GET /v2/login — редирект на основной вход ──────────────────────────
// ── GET /v2/login — редирект на основной вход (KC OIDC) ─────────────
router.get('/login', (req, res) => {
res.redirect('/login?returnTo=' + encodeURIComponent('/v2/app'));
});
// ── GET /v2/app — показать IAM-данные из сессии ────────────────────────
// ── GET /v2/iam — отладка: показать IAM-данные из сессии ────────────
router.get('/iam', (req, res) => {
const u = req.session && req.session.user;
if (!u) return res.send('<h2>Нет данных</h2><p><a href="/v2/login">Войти</a></p>');
res.send(debugPage(u, config.version));
});
res.send(`
<!DOCTYPE html>
// ── /v2/app — пользовательский CRUD (только с сессией) ──────────────
router.use('/app', resolveContext, createUserRouter());
// ── /v2/admin — админка (только для isAdmin=true) ────────────────────
router.use('/admin', resolveContext, createAdminRouter());
// ── GET /v2/ — редирект на /v2/app ──────────────────────────────────
router.get('/', (req, res) => res.redirect('/v2/app'));
// ── /v2/test — тестовый API (отключить: ENABLE_TEST_API=false) ──────
// Код остаётся, роутер не монтируется при ENABLE_TEST_API=false.
if (process.env.ENABLE_TEST_API !== 'false') {
const { createTestRouter } = require('./src/test');
router.use('/test', createTestRouter());
}
// ── GET /v2/logout — редирект на основной выход ─────────────────────
router.get('/logout', (req, res) => res.redirect('/logout'));
return router;
}
function debugPage(u, version) {
return `<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>V2 — IAM</title>
<style>body{font-family:monospace;background:#111;color:#eee;padding:20px}pre{background:#1a1a2e;padding:15px;border-radius:8px}h2{color:#4fc3f7}.label{color:#888}</style></head><body>
<h2>IAM Response (v${config.version})</h2>
<h2>IAM Response (v${version})</h2>
<p><span class="label">Email:</span> ${u.email}</p>
<p><span class="label">clientId:</span> ${u.clientId}</p>
<p><span class="label">Компания:</span> ${u.companyName}</p>
@@ -53,29 +84,7 @@ function createV2Router() {
<p><span class="label">Компаний:</span> ${u.allClientIds ? u.allClientIds.length : 0} — ${(u.allClientIds || []).join(', ')}</p>
<hr><pre>${JSON.stringify(u, null, 2)}</pre>
<p><a href="/v2/logout">Выйти</a> | <a href="/v2/app">CRUD</a> | <a href="/v2/admin">Админка</a></p>
</body></html>`);
});
// ── /v2/app — обычный CRUD (только для авторизованных) ─────────────────
router.use('/app', resolveContext, createUserRouter());
// ── /v2/admin — админка (только для авторизованных) ────────────────────
router.use('/admin', resolveContext, createAdminRouter());
// ── GET /v2/ ─────────────────────────────────────────────────────────────
router.get('/', (req, res) => res.redirect('/v2/app'));
// ── /v2/test — тестовый эндпоинт (отключить: ENABLE_TEST_API=false) ──
if (process.env.ENABLE_TEST_API !== 'false') {
const { createTestRouter } = require('./src/test');
router.use('/test', createTestRouter());
}
// ── GET /v2/logout ───────────────────────────────────────────────────────
router.get('/logout', (req, res) => res.redirect('/logout'));
return router;
</body></html>`;
}
module.exports = { createV2Router };