Монгол العربية 中文 English Français Русский Español

Gerege Nexus

Единая платформа цифровых операций

Gerege Nexus — это открытая модульная платформа, объединяющая услуги, операции, системы и данные государственных и частных организаций. Основной язык платформы — монгольский, и она напрямую интегрирована с национальной цифровой инфраструктурой Монголии (DAN, E-ID, XYP / ХУР).

Nexus — это точка соединения: место, где сходятся организации, услуги, рабочие процессы, системы, пользователи и данные. Сама платформа не привязана к одной отрасли — специфику задаёт набор работающих на ней модулей.

Модули компилируются в единый бинарный файл Go, а магазин приложений на PostgreSQL определяет, какие приложения активны для каждого арендатора, — разделение модулей без сетевых вызовов и эксплуатационной сложности микросервисов.

Монгол  ·  العربية  ·  中文  ·  English  ·  Français  ·  Русский  ·  Español

Содержание

• Авторы
• Ключевые возможности
• Бизнес-приложения
• Структура репозитория
• Быстрый старт
• Конфигурация
• Обзор API
• Тесты и контроль качества
• Безопасность
• Указатель документации

Авторы

Ключевые возможности

1. Высокопроизводительный модульный монолит

• Go-модули времени компиляции — contacts, products, inventory, billing, documents и sso_clients собираются в один бинарный файл и вызываются внутри процесса.
• Магазин приложений на уровне арендатора — права на приложения, меню и RBAC управляются через PostgreSQL (app_installations).
• Разрешение зависимостей — рекурсивный обход направленного ациклического графа с обнаружением циклов и проверкой semver-ограничений.
• Синхронизация каталога — catalog/apps.json является единственным источником истины; таблица apps синхронизируется с ним при каждом запуске.

2. Cloud-native механизмы отказоустойчивости

3. Интеграция с национальной инфраструктурой

• XYP — государственная система обмена данными (platform/gerege/xyp.go): регистрация граждан (WS100101) и проверка юридических лиц (WS100201).
• Национальные E-ID и DAN (developer.gerege.mn, eidmongolia.mn) — цифровая подпись PKI, мобильный OTP, банковский SSO и биометрия по лицу.
• Встроенный провайдер OAuth2 / OIDC (/.well-known/openid-configuration), выдающий токены по схеме client credentials.
• Подтверждение адреса электронной почты (platform/emailverify) — единый процесс подтверждения, который все модули приложений вызывают внутри процесса. Письмо отправляет хостинговая служба (enigma.mn), поэтому платформа не хранит почтовых учётных данных и не владеет адресом отправителя. Подтверждение записывается, когда человек возвращается, и этот возврат срабатывает ровно один раз. Виден в разделе «Настройки → Подтверждение адреса».

Важно. Mock-режим для E-ID, DAN и XYP предназначен только для разработки. При ENVIRONMENT=production он отключается автоматически, поэтому сфабрикованный регистрационный номер не пройдёт аутентификацию.

4. AI-помощник и аналитика

• AI-ассистент (platform/ai/copilot.go) — диалог с классификацией намерений, подключённый к актуальным данным арендатора.
• Прогноз спроса на складе (platform/ai/inventory_forecaster.go) — рекомендации по страховому запасу и точке дозаказа на основе истории движений.

Бизнес-приложения

Маршруты открываются только после установки и включения приложения для арендатора, иначе шлюз возвращает 403 Forbidden.

Структура репозитория

backend/
  cmd/api/            HTTP API-сервер (+ demo seeder)
  cmd/migrate/        Запуск миграций Goose
  db/migrations/      SQL-миграции
  internal/
    module.go         Контракт Go Module
    apps/             Бизнес-модули
    platform/         Сервисы ядра платформы
frontend/             Веб-клиент Next.js 16 (App Router)
catalog/              Каталог магазина приложений и манифесты
deploy/               Production Dockerfile, конфигурация Nginx
docs/                 Документация и переводы

Быстрый старт

Требования

• Go 1.26+
• Node.js 20+
• PostgreSQL 16+ (или Docker Compose)

1. Docker Compose

docker compose up -d

Миграции выполняет отдельный одноразовый сервис migrate, и только после этого запускается API.

2. Вручную

Backend:

cd backend
go mod download
DATABASE_URL="postgres://postgres:postgrespassword@localhost:5432/platform_db?sslmode=disable" \
  go run ./cmd/migrate up
go run ./cmd/api

Frontend:

cd frontend
npm ci
npm run dev

Откройте http://localhost:3000.

Демонстрационный доступ

Демо-учётная запись создаётся только вне production. В production она появится лишь при явно заданном SEED_DEMO_DATA=true.

Конфигурация

Полный список — в .env.example.

Обзор API

Токен сессии передаётся в HttpOnly cookie либо в заголовке Authorization: Bearer <token>.

Тесты и контроль качества

# Модульные тесты backend с детектором гонок
cd backend && go test -race ./...

# Статический анализ
cd backend && go vet ./... && golangci-lint run

# Проверка уязвимостей
cd backend && govulncheck ./...

# Сборка frontend
cd frontend && npm run build

CI выполняет lint, тесты, сборку frontend, сборку Docker-образа, govulncheck и gosec при каждом push и pull request.

Безопасность

• Токены сессий — 256-битные случайные значения; в базе хранится только их SHA-256-дайджест.
• Пароли хешируются bcrypt, попытки входа ограничиваются по IP.
• Установка, включение и отключение приложений, а также регистрация интеграций требуют прав администратора арендатора.
• Аутентификация OAuth2-клиента использует сравнение за постоянное время.

Порядок сообщения об уязвимостях описан в SECURITY.md.

Указатель документации

Благодарности и источники вдохновения

1. snykk/go-rest-boilerplate от @snykk — основа Go REST API.
2. Odoo — модульный магазин приложений и модель зависимостей.
3. go-zero — cloud-native механизмы отказоустойчивости.

Лицензия

Copyright (c) 2026 Gerege Systems Development Team, Gemini AI & Claude AI. Распространяется по лицензии Apache 2.0 — см. LICENSE.

Иконки флагов — Flaticon (атрибуция).