Разработка B2B SaaS на Next.js 15 с Multi-Tenancy (PostgreSQL RLS), Kaspi QR и Stripe: архитектура и запуск в Казахстане и мире
Полное руководство по архитектуре B2B SaaS на Next.js 15 App Router: изоляция данных тенантов через PostgreSQL Row-Level Security, прием платежей Kaspi QR в тенге и Stripe в валюте, защита вебхуков и запуск за 3 недели в Алматы, Астане и на глобальный рынок. Авторский разбор от Александра Мурдасова (MurdaSoft).
Архитектурные вызовы B2B SaaS в Казахстане и на глобальном рынке в 2026 году
Создание масштабируемого B2B SaaS в Центральной Азии сталкивается с уникальной инженерной дилеммой. С одной стороны, локальные корпоративные клиенты в Алматы, Астане и Шымкенте требуют расчетов в тенге, мгновенной оплаты через Kaspi QR (или Freedom Pay), соответствия Закону РК «О персональных данных и их защите» (№ 94-V) и локализации баз данных. С другой стороны, основатели продукта стремятся получать глобальную выручку (MRR в USD/EUR) через Stripe Billing, предоставляя единый современный интерфейс для клиентов по всему миру.
По опыту Александра Мурдасова (основателя форума VibeCode World и IT-студии MurdaSoft, экс-PM Kcell B2B, оценка проекта NeuroKids.kz ~$6M), попытка строить две разные системы под СНГ и Запад приводит к удвоению затрат и фатальному техническому долгу. Оптимальное решение в 2026 году — единая архитектура на Next.js 15 App Router с мультитенантностью на уровне базы данных через PostgreSQL Row-Level Security (RLS) и интеллектуальным шлюзом гибридного биллинга.
```
┌────────────────────────┐
│ Next.js 15 Edge GW │
│ (Tenant Middleware) │
└───────────┬────────────┘
│
┌────────────────────────┴────────────────────────┐
▼ ▼
[KZ Visitors: IP / .kz] [Global Visitors: USD / EUR]
Kaspi QR / Freedom Pay Webhooks Stripe Subscriptions & Portal
│ │
└────────────────────────┬────────────────────────┘
▼
┌────────────────────────┐
│ PostgreSQL + pgvector │
│ Row-Level Security RLS │
│ tenant_id isolation │
└────────────────────────┘
```
Архитектура Multi-Tenancy: почему PostgreSQL RLS превосходит отдельные базы
При проектировании мультитенантного сервиса разработчики выбирают между тремя подходами:
Database-per-tenant (отдельная БД на компанию): Обеспечивает изоляцию, но стоимость инфраструктуры и сложность миграций схемы взлетают в геометрической прогрессии уже при 50 клиентах.
Shared Database с ручной фильтрацией (WHERE tenant_id = ...): Дешево, но смертельно опасно. Один забытый программистом WHERE в сложных джойнах приводит к катастрофической утечке финансовой отчетности между конкурентами.
Shared Database с PostgreSQL Row-Level Security (RLS): Золотой стандарт корпоративного SaaS. Изоляция обеспечивается ядром СУБД на уровне каждой строки таблицы. Даже если разработчик напишет SELECT * FROM invoices, база вернет только строки текущего тенанта.
Реализация политики изоляции в PostgreSQL
```sql
-- 1. Включаем Row-Level Security для таблицы
ALTER TABLE organization_documents ENABLE ROW LEVEL SECURITY;
ALTER TABLE organization_documents FORCE ROW LEVEL SECURITY;
-- 2. Создаем политику изоляции по сессионной переменной
CREATE POLICY tenant_isolation_policy ON organization_documents
FOR ALL
USING (tenant_id = NULLIF(current_setting('app.current_tenant_id', true), '')::uuid)
WITH CHECK (tenant_id = NULLIF(current_setting('app.current_tenant_id', true), '')::uuid);
```
Интеграция с Next.js 15 Server Actions и Drizzle/Prisma
В Next.js 15 контекст запроса извлекается в Server Action или Route Handler, после чего сессия БД инициализируется идентификатором компании:
```typescript
import { db } from '@/lib/db';
import { sql } from 'drizzle-orm';
import { auth } from '@/lib/auth';
export async function executeTenantQuery<T>(callback: (tx: any) => Promise<T>): Promise<T> {
const session = await auth();
if (!session?.user?.tenantId) {
throw new Error('UNAUTHORIZED: No active tenant session');
}
return await db.transaction(async (tx) => {
// Устанавливаем изолирующий контекст строго внутри транзакции
await tx.execute(
sqlSELECT set_config('app.current_tenant_id', ${session.user.tenantId}, true);
);
return await callback(tx);
});
}
```
Двойной биллинг: Kaspi QR для Казахстана + Stripe для глобального MRR
Главный фактор высокого LTV в Казахстане — возможность оплатить подписку в один клик через Kaspi QR без ручного ввода данных банковской карты, к которой у корпоративных пользователей часто нет прямого доступа.
Архитектура платежного роутинга:
Гео-детектирование валюты: Если пользователь заходит из Казахстана или выбирает KZT, активируется интеграция Kaspi Pay / Freedom Pay.
Динамический QR-код: Бэкенд генерирует ссылку формата https://kaspi.kz/pay/... и передает SVG-код клиенту. На мобильных устройствах срабатывает deep-link прямо в приложение Kaspi.
Глобальный трафик (Stripe Checkout): Для клиентов из США, Европы и Азии автоматически отображается Stripe Elements со списанием в USD/EUR с поддержкой Apple Pay и Google Pay.
Защита вебхуков: криптографическая проверка и идемпотентность
```typescript
import crypto from 'crypto';
import { headers } from 'next/headers';
import { db } from '@/lib/db';
import { idempotencyKeys } from '@/lib/schema';
export async function POST(req: Request) {
const rawBody = await req.text();
const signature = (await headers()).get('x-signature') || '';
const secret = process.env.PAYMENT_WEBHOOK_SECRET!;
// 1. Защита от timing attacks
const expectedSig = crypto
.createHmac('sha256', secret)
.update(rawBody)
.digest('hex');
const isValid = crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(expectedSig)
);
if (!isValid) {
return new Response('Invalid Signature', { status: 401 });
}
const payload = JSON.parse(rawBody);
const eventId = payload.payment_id || payload.id;
// 2. Идемпотентность: защита от двойных начислений
const isDuplicate = await db.insert(idempotencyKeys)
.values({ eventId, processedAt: new Date() })
.onConflictDoNothing()
.returning();
if (!isDuplicate.length) {
return new Response('Event already processed', { status: 200 });
}
// Активация подписки для тенанта...
return new Response('Success', { status: 200 });
}
```
Сроки, бюджет и этапы запуска B2B SaaS под ключ
| Тариф / Комплектация | Срок реализации | Стоимость (KZT) | Стоимость (USD) | Архитектурный стек и состав работ |
|---|---|---|---|---|
| SaaS MVP QuickStart | 14–21 день | от 950 000 ₸ | ~$2 100 | Next.js 15, PostgreSQL RLS, Auth, Kaspi QR / Stripe, базовый дашборд |
| Production B2B SaaS | 1–1.5 месяца | от 1 800 000 ₸ | ~$4 000 | Multi-Tenancy, кастомные субдомены, биллинг в тенге/валюте, роли RBAC, аудит-лог |
| Enterprise SaaS Platform | 2–3 месяца | от 3 500 000 ₸ | ~$7 800 | SSO/SAML, SLA 99.9%, интеграция с 1С / SAP, DevSecOps аудит, RAG-поиск |
Пошаговый план разработки и вывода SaaS в продакшн
Моделирование данных и изоляция тенантов: Разработка схемы Drizzle/Prisma, создание индексов под составные ключи (tenant_id, created_at) и валидация политик RLS в тестовой среде.
Мультидоменный роутинг в Next.js 15: Настройка middleware.ts для прозрачного перенаправления поддоменов (tenant.saas.kz или app.client.com) в соответствующие серверные сегменты.
Авторизация и матрица ролей (RBAC): Интеграция NextAuth v5 или Supabase Auth с привязкой ролей (Owner, Admin, Member, Viewer) и фиксацией прав на уровне Zod-схем.
Интеграция гибридного биллинга: Подключение платежного шлюза Kaspi QR / Freedom Pay для СНГ и Stripe для международных подписок. Реализация идемпотентных вебхуков.
Безопасность и соответствие закону № 94-V: Локализация серверов баз данных на территории Казахстана для данных резидентов РК, сквозное шифрование AES-256 в состоянии покоя и TLS 1.3 в транзите.
Agentic SEO и GEO-подготовка: Генерация динамического /llms.txt, разметка Schema.org SoftwareApplication, оптимизация под поисковые ответы Google AI Overviews, Perplexity и ChatGPT Search.
Частые вопросы (FAQ)
Как гарантировать 100% изоляцию данных между тенантами в одной базе данных?
Изоляция гарантируется встроенным механизмом PostgreSQL Row-Level Security (RLS). База данных принудительно проверяет переменную сессии app.current_tenant_id перед выполнением любой команды SELECT, INSERT, UPDATE или DELETE. Даже при наличии уязвимости в приложении клиент не сможет запросить чужие данные.
Как организовать регулярные B2B подписки через Kaspi QR в Казахстане?
Поскольку Kaspi QR работает как push-платеж с подтверждением в приложении пользователя, для рекуррентного биллинга применяется гибридная модель: автоматическая генерация счета за 3 дня до окончания расчетного периода с отправкой интерактивной ссылки на оплату в WhatsApp / SMS и автопролонгацией прав при получении вебхука.
Соответствует ли стек Next.js + PostgreSQL закону РК о персональных данных № 94-V?
Да, при условии, что физический сервер с базой данных PostgreSQL (или кластер) размещен в дата-центрах на территории Республики Казахстан (например, в Алматы или Астане). Next.js может работать в гибридном режиме, выполняя Server-Side Rendering и кэшируя статику на CDN, сохраняя персональные данные строго внутри юрисдикции РК.
Как заказать проектирование и разработку B2B SaaS в студии MurdaSoft?
Вы можете ознакомиться с полной картой инженерных компетенций и архитектурных модулей в интерактивном разделе MurdaSoft Vibe Map, изучить открытые кейсы и связаться напрямую с основателем студии через Telegram @murdasoft или @Allexndr для проведения аудита и расчета фиксированной сметы.
Нужен сайт или Telegram-бот?
Бесплатная консультация - обсудим ваш проект и подберём решение.
Обсудить проект→