Files
akyldash/docs/product/search-catalog-v1.md

9.4 KiB
Raw Blame History

Справочники Search API v1

Статус: рабочий контракт Search API v1. Тематическая иерархия вынесена в отдельный черновой каталог и не входит в фильтры API v1.

code — неизменяемый идентификатор, независимый от языка. Клиент хранит и передаёт только code; русское и кыргызское названия являются подписями и могут исправляться без изменения кода.

Типы документов

Code RU KY
constitution Конституция Конституция
constitutional_law Конституционный Закон Конституциалык Мыйзам
code Кодекс Кодекс
law Закон Мыйзам
decree Указ Жарлык
resolution Постановление Токтом
order Распоряжение Распоряжение
instruction Инструкция Инструкция
rules Правила Правила
procedure Порядок Порядок
provision Положение Жобо
regulation Регламент Регламент
charter Устав Жобо (Устав)
program Программа Программа
plan План План
strategy Стратегия Стратегия
concept Концепция Концепция
doctrine Доктрина Доктрина
agreement Соглашение Соглашение
declaration Декларация Декларация
registry Реестр Реестр
norms Нормативы Нормативы
model Модель Модель
matrix Матрица Матрица
study Исследование Исследование
report Доклад Доклад
principles Основные принципы Основные принципы
unspecified Не указан Көрсөтүлгөн эмес

Статусы

Code RU KY
active Действует Күчүндө
repealed Утратил силу Күчүн жоготту
unspecified Не указан Көрсөтүлгөн эмес

Юридическая сила

Это укрупнённая группировка для фильтра Search API, а не полная иерархия нормативных правовых актов из статьи 6 Закона КР «О нормативных правовых актах». В этой группировке Конституция и конституционные законы относятся к конституционному уровню, кодексы и законы — к законодательному, указы и постановления, перечисленные законом как виды НПА, — к подзаконному.

Code RU KY
constitutional Конституционный уровень Конституциялык деңгээл
legislative Законодательный уровень Мыйзам деңгээли
subordinate Подзаконный уровень Мыйзам алдындагы деңгээл

Для прочих типов значение не назначается автоматически: одного названия типа недостаточно, чтобы установить юридическую силу утверждающего НПА. Основание: статьи 4 и 6 Закона КР «О нормативных правовых актах». Эта группировка реализована как фильтр legal_force Search API v1.

Органы принятия

Орган содержит два уровня: стабильную группу и конкретный орган. В v1 группы следующие:

Code RU KY
president Президент Президент
parliament Органы законодательной власти Мыйзам чыгаруу бийлик органдары
cabinet Правительство и Кабинет Министров Өкмөт жана Министрлер Кабинети
ministries_and_committees Министерства и государственные комитеты Министрликтер жана мамлекеттик комитеттер
administrative_agencies Административные ведомства Административдик ведомстволор
national_bank Национальный банк Улуттук банк
other_state_bodies Иные государственные органы Башка мамлекеттик органдар
local_representative_bodies Представительные органы местного самоуправления Жергиликтүү өз алдынча башкаруунун өкүлчүлүктүү органдары
other Прочие органы Башка органдар

Конкретные министерства, муниципальные и айылные кенеши не получают ID из подписи: в выгрузке ЦБД их поле Code часто равно null. До появления первичного неизменяемого идентификатора API v1 выдаёт и принимает только код группы органа. Полный каталог конкретных органов — отдельная версия (v2), когда источник предоставит такие идентификаторы либо будет утверждён вручную поддерживаемый реестр.

Темы

Полная исходная иерархия GeneralClassifiers сохранена отдельно в search-topic-taxonomy-v1.json. Над исходными ветвями добавлены предложенные смысловые группы; исходные подписи и вложенность не переставляются. Поле document_count показывает число документов, где узел встречается. Предлагаются группы: конституционный строй и права; государство и публичное управление; право, суд и правопорядок; международные отношения; оборона и безопасность; экономика, финансы и предпринимательство; труд и социальная защита; здравоохранение; образование, наука и культура; земля, природные ресурсы и окружающая среда; сельское хозяйство; транспорт, связь, строительство и жильё; информация и СМИ; гражданские, семейные и жилищные отношения; общие и межотраслевые вопросы.

Каталог является черновиком: группа корневой рубрики предложена по русской подписи, неоднозначные и нераспознанные рубрики помещены в review_required и отмечены manual_review; остальные помечены provisional_lexical. В корпусе 2 065 узлов и 687 вариантов корневых рубрик; 251 корневой вариант ожидает ручной классификации. Отсутствующие в источнике кыргызские подписи оставлены пустыми: они отсутствуют у 1 524 узлов, новые переводы не придуманы. Внутренние source-* ID являются временными хешами кода источника и цепочки подписей; при Code: null они зависят от подписей и не утверждаются как публичные стабильные коды.

Тематическая навигация и фильтр не входят в Search API v1. До включения в API нужно вручную утвердить смысловые группы, идентификаторы и недостающие KY- подписи. Источник — нормализованные данные ЦБД Минюста; команда для пересборки каталога находится в tools/build_search_topic_taxonomy.py.

Правила совместимости

  • Код из этой таблицы нельзя переиспользовать и нельзя менять его значение.
  • Новое значение добавляется только новой записью; удалённое остаётся доступно для старых документов.
  • Запрос с неизвестным кодом возвращает 400.