129 lines
9.5 KiB
Markdown
129 lines
9.5 KiB
Markdown
# Справочники 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 Закона КР «О нормативных правовых актах»](https://cbd.minjust.gov.kg/4-3987/edition/53304/ru).
|
||
Эта группировка реализована как фильтр `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`](search-topic-taxonomy-v1.json). Над исходными
|
||
ветвями добавлены предложенные смысловые группы; исходные подписи и вложенность
|
||
не переставляются. Поле `document_count` показывает число документов, где узел
|
||
встречается. Предлагаются группы: конституционный строй и права; государство и
|
||
публичное управление; право, суд и правопорядок; международные отношения;
|
||
оборона и безопасность; экономика, финансы и предпринимательство; труд и
|
||
социальная защита; здравоохранение; образование, наука и культура; земля,
|
||
природные ресурсы и окружающая среда; сельское хозяйство; транспорт, связь,
|
||
строительство и жильё; информация и СМИ; гражданские, семейные и жилищные
|
||
отношения; общие и межотраслевые вопросы.
|
||
|
||
Каталог является черновиком: группа корневой рубрики предложена по русской
|
||
подписи, рубрики с несколькими совпадениями правил или без совпадений помещены
|
||
в `review_required` и отмечены `manual_review`; остальные помечены
|
||
`provisional_lexical`. В корпусе 2 065 узлов и 687 вариантов корневых рубрик;
|
||
328 корневых вариантов ожидают ручной классификации. Отсутствующие в источнике
|
||
кыргызские подписи оставлены пустыми: они отсутствуют у 1 524 узлов, новые
|
||
переводы не придуманы. Внутренние `source-*` ID являются
|
||
временными хешами кода источника и цепочки подписей; при `Code: null` они
|
||
зависят от подписей и не утверждаются как публичные стабильные коды.
|
||
|
||
Тематическая навигация и фильтр не входят в Search API v1. До включения в API
|
||
нужно вручную утвердить смысловые группы, идентификаторы и недостающие KY-
|
||
подписи. Источник — нормализованные данные ЦБД Минюста; команда для пересборки
|
||
каталога находится в `tools/build_search_topic_taxonomy.py`.
|
||
|
||
## Правила совместимости
|
||
|
||
- Код из этой таблицы нельзя переиспользовать и нельзя менять его значение.
|
||
- Новое значение добавляется только новой записью; удалённое остаётся доступно
|
||
для старых документов.
|
||
- Запрос с неизвестным кодом возвращает `400`.
|