Технический документ

Архитектура ПО Принципал

Прозрачная многоуровневая архитектура. Полностью российский стек. Для аудиторов, регуляторов, интеграторов и партнёров.

9 уровней стека

L1

Клиент

  • · Web-кабинет (Next.js 16)
  • · Mobile (PWA через браузер)
  • · API-партнёры (плановое)
L2

Шлюзы

  • · Caddy (TLS + reverse proxy)
  • · NextAuth (sessions + JWT)
  • · Yandex SmartCaptcha
  • · Rate-limit middleware
L3

Приложение

  • · Multi-tenant Drizzle ORM
  • · Row-Level Security (Postgres)
  • · PD-фильтр перед отправкой в LLM
  • · Cache L1 (in-memory) + L2 (Postgres)
L4

AI Router

  • · Multi-provider failover (Yandex → GigaChat)
  • · Model tier router (Lite / Pro / Max)
  • · Anti-hallucination валидатор
  • · Chain-of-Verification для критичных запросов
L5

10 AI-специалистов

  • · Анна, Михаил, Николай, Дмитрий
  • · Андрей, Виктор, Максим, Сергей
  • · 56 function-calling tools
  • · Hardened-промпты + база РФ-2026
L6

Yandex Cloud Services

  • · YandexGPT 5 Lite/Pro · Embeddings
  • · Vision OCR · SpeechKit · YandexART
  • · Search API · Translate
  • · Object Storage · Lockbox · Monium
  • · SmartCaptcha · Postbox
L7

GigaChat (fallback)

  • · GigaChat 2 Lite / Pro / Max
  • · Embeddings Giga (256-мерные)
  • · B2B-scope (после ИНН)
L8

Внешние данные

  • · ЕГРЮЛ / ЕГРИП (через DaData + pb.nalog.ru)
  • · Федресурс (банкротство)
  • · ЦБ РФ (курсы валют XML)
  • · Минцифры (аккредитованные IT)
  • · Реестр российского ПО
L9

Хранилища

  • · PostgreSQL 16 (Selectel, РФ)
  • · Yandex Object Storage (документы)
  • · Cache: Postgres ai_response_cache
  • · Backups: ежедневный pg_dump → S3

Языки программирования и платформа

Языки программирования: TypeScript · JavaScript · SQL (PostgreSQL) · Python
Основной язык разработки: TypeScript (>90% кода)
Runtime: Node.js 22 LTS
Основной фреймворк: Next.js 16 (React Server Components, App Router)
Клиент: React 19 · Tailwind CSS 4
База данных: PostgreSQL 16 + расширение pgvector
ORM: Drizzle ORM (TypeScript)
Reverse proxy / TLS: Caddy 2
Контейнеризация: Docker
Нейросетевые модели: GigaChat (ПАО Сбербанк), YandexGPT (Yandex Cloud)

Все компоненты имеют российское происхождение либо являются open-source (свободное программное обеспечение) без лицензионных ограничений на территории Российской Федерации.

Технические факты

Серверы

Selectel · Москва · 152-ФЗ

AI-провайдеры

100% российские

Storage

Yandex S3 + Selectel PG

LLM-стек

YandexGPT + GigaChat

TLS

Let's Encrypt + Caddy

Шифрование бэкапов

age (X25519)

Backup-частота

Ежедневно

Журнал AI-запросов

Учёт использования

Compliance · 152-ФЗ

  • ✓Все вычисления и хранение — на серверах Selectel в Москве (РФ юрисдикция).
  • ✓PD-фильтр в приложении: маскирует паспорта, СНИЛС, ИНН ФЛ, карты, счета, телефоны и email до отправки в LLM.
  • ✓Резервные копии БД шифруются (age) до записи на диск. Шифрование ПДн-колонок в БД (Yandex KMS) — в планах.
  • ✓OpenAI / Anthropic / Google / AWS — НЕ используются. Только российский стек.
  • ✓Аудит-лог каждой операции с агентом, доступен клиенту в его ЛК.
  • ✓Экспорт всех данных клиента в 1С / Excel / JSON в любой момент.

Нужен технический аудит?

Корп.клиенты на тарифе MAX получают доступ к расширенной технической документации, схемам интеграции, security-аудиту и SLA с конкретными метриками.