Files
akyldash/docs/product/platform-functionality.md
agent 55ff149c35
CI / tests-and-images (pull_request) Successful in 2m18s
Runner smoke test / runner-smoke (pull_request) Successful in 2s
docs: record platform specification in changelog
2026-11-15 15:16:38 +03:00

23 KiB
Raw Permalink Blame History

Функциональность платформы Акылдаш

Этот документ определяет целевой функциональный состав Акылдаша — юридической информационно-аналитической платформы для Кыргызской Республики. Пользователь сможет найти применимую норму, проверить источник и редакцию, сохранить материалы исследования и узнать об изменениях. Существенные юридические выводы проверяет специалист.

Текущая реализация

Сверено с main на 871bde1. В коде доступны полнотекстовый поиск по русским и кыргызским текстам, фильтры по языку, виду акта, статусу, группе органов, юридической силе и дате, сортировка по релевантности и дате, пагинация. Есть карточка документа, выбор редакции и доступного языка, оглавление, поиск в открытом тексте, печать и ссылка на официальный источник. Внутренние учётные записи поддерживают вход, смену пароля, серверную проверку прав, административное создание и удаление аккаунтов и сброс пароля. Лаборатория собирает оценки релевантности и комментарии проверяющих. Публичный запуск и готовность полного корпуса требуют подтверждения по состоянию инфраструктуры. Telegram-бот команды описан в решении о рабочем пространстве.

Правовые данные и условия публичного выпуска

  • Получать открытые или лицензированные НПА и иные правовые материалы из официальных источников. Для каждого источника проверить законное основание, условия использования и распространения. Хранить происхождение, ссылку, лицензию, идентификаторы, контрольные суммы, даты получения и последней успешной проверки. Секреты и персональные данные исключать из Git, логов и тестовых наборов. Закрытые юридические документы хранить с поимённым доступом в защищённом хранилище.
  • Поддерживать регулярное обновление ЦБД Минюста КР с проверкой подлинности, полноты, языков, порядка редакций, вложений и объяснённых пропусков. Нормализовать HTML и структуру до статей и пунктов, сохранять реквизиты и двуязычные коды справочников. У каждого индексируемого документа проверять код, редакцию, язык, статус, тип, орган, дату, номер, название и ссылку на первоисточник. Показывать только доступные официальные языковые версии, явно отмечать отсутствие текста и неизвестный статус. Различать принятие, публикацию, вступление в силу, период применимости, редакцию и дату проверки. Проверять, какая редакция применима на нужную дату.
  • Вести журнал новых, изменённых и отменённых актов. Повторная обработка изменения идемпотентна. Цель обновления в течение суток после появления у источника измеряется на пилоте до принятия SLA.
  • Сборку индекса проверять в чистом окружении. Пройти цепочку от обновления корпуса и нормализации до нового версионированного индекса с раздельным анализом RU/KY, проверки mapping, числа документов и фрагментов, затем атомарного переключения alias. При неудаче сохранять рабочий индекс. Приёмка корпуса и выкладка описаны в процедуре передачи корпуса и плане реализации и приёмки.
  • Собрать relevance set v1 из 50 практических запросов, минимум по 25 на каждом языке. Юрист сверяет эталонные документы с первоисточником и кодами в индексе. Второй проверяющий подтверждает формулировки и коды. Спорные случаи включаются после согласования. Заморозить набор, воспроизвести Recall@10 и MRR@10 отдельно по языкам, сохранять выдачу для каждого запроса. Сравнивать изменения на том же наборе, проверять опечатки, сокращения, практические запросы и ложные срабатывания. См. разметку и диагностику поиска.
  • Утвердить справочники v1 типов, органов, статусов, уровней действия и тем со стабильными кодами и подписями RU/KY. Публичный тематический отбор добавляется после MVP. Проверить опубликованный OpenAPI и реальные интеграции на локальном OpenSearch. Зафиксировать совместимый контракт для поиска, фильтров, пагинации, сортировки, карточки, списка и содержимого редакций. Покрыть пустую выдачу, неизвестный документ, недоступную редакцию и сбой источника. API явно возвращает список доступных языков, в том числе для одноязычных актов. Маршруты и запуск описаны в Backend README.
  • До проектирования публичного frontend зафиксировать сквозное прохождение перечисленных проверок с RU, KY и одноязычным документом, версии backend и индекса, известные ограничения и ответственного за юридическую проверку. До публичного выпуска проверить мониторинг ошибок и восстановление из резервной копии на изолированном окружении. Внутреннее рабочее место и лаборатория используют существующие API и развиваются по своим задачам.

Публичный поисковый MVP

Публичный адаптивный веб-интерфейс на русском и кыргызском языках. Доступ к базовому поиску и чтению открыт без регистрации.

  • Поиск. Свободный полнотекстовый запрос, раздельный анализ двух языков, морфология русского текста, проверенные синонимы, сокращения и опечатки. Для кыргызского текста отдельно проверять качество нормализации и словарей. Выдача показывает число результатов, подсвеченные фрагменты и пагинацию.
  • Отбор. Фильтры по языку, виду документа, статусу, органу, юридической силе и дате. Сортировка по релевантности и дате. Сброс отдельных и всех фильтров, сохранение состояния поиска в URL для повторного открытия.
  • Документ. Заголовок и реквизиты, актуальная редакция, юридический статус и дата актуальности, происхождение и официальный источник. Доступны оглавление, поиск по тексту с подсветкой и переходом между совпадениями, выбор доступного языка, список редакций, открытие предыдущей редакции и печать. Одноязычные документы и карточки без текста имеют явное состояние.
  • Качество интерфейса. Состояния загрузки, пустой выдачи и ошибок, клавиатурная навигация, адаптивные фильтры и длинные правовые тексты, WCAG 2.2 AA, безопасное отображение очищенного HTML, проверка производительности, метаданные страниц и версии frontend/backend в подвале. Дизайн опирается на Түндүк. Перед выпуском пройти сквозные проверки поиска и чтения на 10–15 практических задачах.

Поисковое рабочее место

  • Реквизитный поиск с отдельными полями названия и текста, точным номером, открытием по коду и поиском без текстового запроса. Поддержать множественный выбор и определить правила AND/OR. Тематический отбор строить на иерархическом рубрикаторе КР с проверенными стабильными кодами.
  • Расширить паспорт документа. По мере готовности источников отображать точный орган принятия, территорию действия по классификации КР, данные регистрации и источник публикации. По результатам пилота добавить отбор по этим реквизитам и оценить сортировку по органу, виду, дате изменения и юридической силе с выбором направления.
  • Экспорт выбранной редакции, результатов и подборок в DOCX с сохранением структуры и выделений. Включать язык, редакцию, источник и время выгрузки. При копировании фрагмента указывать первоисточник. PDF сверх браузерной печати и RTF зависят от подтверждённой потребности.
  • Открывать несколько документов одновременно, сохранять контекст во вкладках и показывать материалы бок о бок. Приёмка рабочего места включает 20 практических задач от запроса до нужного фрагмента, проверку экспорта нужной редакции и отсутствие ухудшения на замороженном наборе поиска.

Личный кабинет и контроль изменений

  • Выбрать модель пользовательского доступа. Для закрытого пилота подходят внутренние аккаунты, выданные администратором. Для персональных функций внешних пользователей определить регистрацию, подтверждение аккаунта и проверяемое восстановление доступа по email.
  • Хранить на сервере избранное, историю запросов и документов, именованные поиски и шаблоны фильтров, параметры выдачи, закладки и заметки к статьям и пунктам. Поддержать папки и подборки по проектам, доступ по приглашению или ссылке с проверкой прав и экспорт подборок. Персонализировать быстрые ссылки, избранные разделы и панель инструментов.
  • Публиковать ленту поступлений и обзор новых, изменённых и отменённых актов. Пользователь ставит документ или отдельную норму на контроль и получает сигнал об изменении редакции либо о новой связанной судебной практике после появления соответствующей коллекции.
  • Выбрать каналы уведомлений из email, Telegram и Web Push по результатам пилота. Предусмотреть согласие, настройки частоты и отключение. Проверять синхронизацию на втором устройстве, изоляцию аккаунтов, отзыв доступа, отключение и удаление контроля, отсутствие дубликатов событий. Документировать сроки хранения истории и удаление аккаунта.

Юридическое сравнение и связи

  • Сравнивать редакции бок о бок с подсветкой добавлений, исключений, перемещений и перенумерации. Различать технические и содержательные правки, отмечать утратившие силу фрагменты и показывать неопределённость. Юрист проверяет минимум 30 разнообразных пар. Юридическую применимость оценивать по реквизитам и источникам.
  • Показывать русский и кыргызский тексты одной редакции параллельно, сопоставляя только подтверждённые фрагменты.
  • Хранить прямые и обратные связи с другими нормами, актами, разъяснениями и судебной практикой. Показывать контекстный предпросмотр, цепочку норм и дерево или граф. Фиксировать источник, целевую редакцию и уверенность сопоставления. Отдельно обозначать непроверенные связи.
  • Выдавать проверенные вложения, сканы и графические копии при наличии в источнике и прав на распространение.

Практические материалы и проверяемые ответы

  • По результатам пилота оценить включение правоприменительной практики КР, писем и позиций госорганов, редакционных пояснений и экспертных комментариев. Проверять полноту, обновляемость, обезличивание и права на использование. Сначала выяснить покрытие международных актов существующим корпусом.
  • Подготовить типовые договоры, заявления, претензии и акты с заполняемыми полями и подсказками. Добавить инструкции, готовые решения, чек-листы, сроки и ответственные органы. Справочный раздел включает производственный календарь, сроки отчётности, ставки, курсы, индексы и реквизиты госорганов. Для справочных данных определить источник и частоту обновления.
  • Построить базу знаний для RAG поверх проверенного корпуса и структуры редакций. Сначала выдавать доказательства и точные цитаты с переходом к фрагменту, затем формировать краткий ответ. Отделять найденные факты от вывода, сообщать о недостатке данных и проверять актуальность нормы. Приёмка на замороженном экспертном наборе проверяет каждую ссылку, цитату и редакцию и требует отсутствия критических неподтверждённых юридических утверждений.

Организации и интеграции

  • Профили организаций, приглашение и удаление участников, роли и права юриста, бухгалтера, кадровика и администратора. Сервер проверяет доступ к материалам и срок действия прав. Журналировать административные и юридически значимые действия с соблюдением правил хранения данных.
  • Тарифы и права по продуктам, срок подписки, счета, платежи и сверка. Начать с одной модели подписки и канала оплаты после подтверждения спроса. Повторное событие обрабатывается один раз. Данные сохраняются при истечении подписки. Промокоды зависят от выбранной модели продаж.
  • Корпоративный API, структурированные выгрузки для дальнейшей обработки и интеграция с системами электронного документооборота с проверкой доступа.
  • Социальный вход, самостоятельные мобильный и десктопный клиенты, зарубежные коллекции, форум и пользовательские сообщения требуют отдельного решения о спросе, лицензиях и стоимости сопровождения.

Порядок развития и проверка спроса

Данные и готовность выпуска предшествуют публичному MVP. Далее развивать поисковое рабочее место, личные функции и контроль изменений. Сравнение, связи и ответы зависят от проверенных редакций и структуры норм. Командные тарифы требуют доказанного повторного использования и готовности платить. Инфраструктурные и визуальные критерии ведутся в плане реализации и приёмки.

Исходная гипотеза из анализа «Токтом Онлайн» от 24 октября 2026 года — пилот для небольших юридических и бухгалтерских команд по ОсОО/ЖЧК, налогообложению и труду. Предложено провести 12–15 интервью, затем четырёхнедельный пилот с 10–15 специалистами на 20 обезличенных RU/KY-задачах. Юрист проверяет правильность по первоисточникам. Для каждого языка предложены пороги Recall@10 ≥ 0,90 и MRR@10 ≥ 0,75. Предложенный выигрыш медианного времени правильного решения составляет ≥ 25%, возвращаемость на четвёртой неделе составляет ≥ 60%. На пилоте также нужно подтвердить готовность минимум трёх организаций платить названную цену и отсутствие критических ошибок редакции или источника в приёмочных задачах. Пороги, сроки реализации и бюджет требуют подтверждения. Сужать сегмент, если нужные материалы недоступны законно или расходы на редакцию, поддержку и эксплуатацию делают тариф нежизнеспособным.

История требований сохранена в Git на 871bde1. В основу этого документа легли Word-ТЗ поисковой СПС, обзор проекта, планы поискового frontend и готовности к нему, а также датированный анализ «Токтом Онлайн» (матрица G01–G25 и этапы A–F). Оценки конкурента относятся к датированному исследованию.


Акылдаш · Telegram-бот v0.2.2 · Backend v0.13.4 · Frontend v0.3.4