diff --git a/docs/product/search-catalog-v1.md b/docs/product/search-catalog-v1.md new file mode 100644 index 0000000..7d4acca --- /dev/null +++ b/docs/product/search-catalog-v1.md @@ -0,0 +1,78 @@ +# Справочники Search API v1 + +Статус: утверждённый контракт для Search 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` | Основные принципы | Основные принципы | + +## Статусы + +| Code | RU | KY | +| --- | --- | --- | +| `active` | Действует | Күчүндө | +| `repealed` | Утратил силу | Күчүн жоготту | +| `unspecified` | Не указан | Көрсөтүлгөн эмес | + +## Органы принятия + +Орган содержит два уровня: стабильную группу и конкретный орган. В 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`), +когда источник предоставит такие идентификаторы либо будет утверждён вручную +поддерживаемый реестр. + +## Правила совместимости + +- Код из этой таблицы нельзя переиспользовать и нельзя менять его значение. +- Новое значение добавляется только новой записью; удалённое остаётся доступно + для старых документов. +- Запрос с неизвестным кодом возвращает `400`.