Codex Agent
07381ad70f
Add a resumable standard-library normalization pipeline for the downloaded CBD archive. It produces canonical bilingual metadata, sanitized HTML, plain text, deterministic fragments, checksums, quality markers, and an SQLite processing manifest while preserving the raw source. Recover document-list pagination when the Ministry API exhausts request retries, and cover that scenario with a regression test. Document the normalization workflow and frontend-search MVP plan, include the source functional specification, ignore local runtime logs, and bump the backend version to 0.2.1.
Акылдаш
Акылдаш — проект юридической информационно-аналитической платформы. Цель — собирать правовые источники на законных основаниях, сохранять их происхождение и версии, готовить данные для поиска и RAG, а затем предоставлять результаты через API и пользовательский интерфейс со ссылками на первоисточники.
Telegram-бот — только часть рабочего окружения команды, а не основной продукт.
Текущее состояние
Сейчас реализованы Telegram-бот-секретарь версии 0.2.2 и backend версии
0.2.1: возобновляемая выгрузка и нормализация документов ЦБД Минюста КР.
| Компонент | Версия | Состояние |
|---|---|---|
| Telegram-бот | 0.2.2 |
на Synology работает 0.2.1; обновление после слияния |
| Backend | 0.2.1 |
реализованы выгрузка и нормализация документов ЦБД Минюста КР |
| Frontend | — | ещё не создан |
| Сбор и обработка правовых данных | 0.2.1 |
реализованы архиватор и нормализатор ЦБД Минюста КР |
| RAG и база знаний | — | ещё не созданы |
Структура репозитория
docs/ структурированная документация проекта
decisions/ принятые архитектурные и продуктовые решения
operations/ состояние проекта и рабочие процессы
product/ назначение, границы и развитие продукта
team/ материалы для команды
tools/
telegram-bot/ бот рабочего Telegram-пространства
backend/
ingestion/ получение и обновление правовых источников
normalization/ воспроизводимая нормализация исходного архива
Каталоги для загрузки и обработки источников, RAG, backend и frontend будут создаваться с первой реальной задачей в соответствующей области. Это позволит выбрать структуру по фактическим требованиям, а не поддерживать пустой каркас.
Начать знакомство с проектом: документация и обзор продукта.
Конфиденциальные материалы
Секреты, персональные данные, договоры и материалы по правовой защите проекта не должны храниться в этом репозитории. Для них нужен отдельный закрытый репозиторий или защищённое хранилище с минимально необходимыми правами доступа, журналированием и резервным копированием. Здесь допустимы только несекретные правила и ссылки на такие материалы без раскрытия их содержания.
Проверка Telegram-бота
python3 -m unittest discover -s tools/telegram-bot -v
Акылдаш · Telegram-бот v0.2.2 · Backend v0.2.1 · Frontend — не создан