Gerege Verify (XYP)¶
Production · Слой 2 — Справки ·
Репозиторий: sso-gerege-mn (xyp.gerege.mn/) · xyp.gerege.mn
Справочный сервис, который проверяет сведения о компаниях и организациях по государственному реестру. Состоит из Go API и административного экрана на Next.js.
Что он делает¶
Когда платформы экосистемы создают организацию, добавляют участника или выдают права, им нередко нужно подтвердить, что организация действительно существует в государственном реестре. Gerege Verify даёт эту справку через единое окно.
Типичные сценарии:
- зарегистрирована ли организация, совпадают ли её название и регистрационный номер,
- кто является уполномоченным должностным лицом организации,
- связан ли данный гражданин с этой организацией.
Структура¶
| Часть | Технология | Роль |
|---|---|---|
api/ |
Go | API справок, управление клиентами / API-ключами, счётчики использования |
web/ |
Next.js | Консоль администратора — регистрация клиентов, отчёты об использовании |
Модель API¶
| Путь | Назначение |
|---|---|
/v1/* |
Основной API справок — с rate limit |
/api/clients |
Регистрация клиентов (админ) |
/api/usage |
Телеметрия использования (админ) |
/health |
Проверка работоспособности |
Доступ регулируется API-ключами. У каждого клиента свой ключ, использование подсчитывается и видно в административном экране.
Зачем нужны счётчики
Справки из государственного реестра могут быть платным источником с квотой. Без поклиентского подсчёта невозможно ни распределить затраты, ни заметить превышение. Кроме того, есть требование аудита — прослеживать, кто и по какой организации запрашивал сведения.
Кто им пользуется¶
- Gerege Platform и Template Platform — в потоках создания и поиска организаций,
- Gerege Wallet — в потоке организационного счёта,
- внутренние административные инструменты.
Связь с X-Road¶
В долгосрочной перспективе межведомственные справки движутся к стандартизации на X-Road. Сейчас Gerege Verify — канал справок, работающий рядом с X-Road; после полного внедрения X-Road часть справок может перейти туда.
Подробная документация¶
Документация по реализации находится в каталоге xyp.gerege.mn/ репозитория
sso-gerege-mn.