Набор утилит для повседневной работы медстатистика: реестры ОМС (DBF), статистика и экономика стационара, смертность, отчёты в Excel и HTML. Название говорит о подходе: синяя изолента — как швейцарский нож, одна программа на все мелкие задачи, которые иначе делаются руками.

Проект — платформа: новые утилиты добавляются одним файлом-плагином и автоматически получают вкладку, сохранение настроек и общий журнал работы. Программа сама проверяет выход новой версии на GitHub и умеет обновляться в один клик.

Написан на чистой стандартной библиотеке Python — сторонних зависимостей нет (графика — на tkinter, который поставляется вместе с Python).

📄 История изменений (CHANGELOG) · ⬇️ Релизы и готовый .exe

Удаление по протоколам	Удаление по списку кодов
Статистика стационара	Экономика стационара
Смертность стационара	О программе и обновление

Общие свойства обеих утилит удаления:

• Режим проверки («Проверить, не изменять» / --dry-run) — показывает, что будет удалено, ничего не трогая.
• Резервная копия всего семейства файлов (.dbf + мемо .fpt/.dbt + индексы .cdx/.idx) в папку backup_<дата_время> перед любым изменением.
• Атомарная запись (через временный файл): исходный файл не остаётся повреждённым при сбое.
• Обновление индексов: после физического удаления устаревшие индексы .cdx/.idx удаляются, а флаг индекса в заголовке сбрасывается — потребитель (FoxPro) перестроит их заново.
• Самопроверка после записи и подробный журнал (в т.ч. в файл udalenie_*.log).

Нужен Python 3.9 или новее.

git clone https://github.com/Mist3s/duct-tape.git
cd duct-tape
pip install -e .

Графический интерфейс:

omsreg            # после установки пакета
# или без установки, из папки проекта:
python -m omsreg

В Windows можно запустить scripts\run-gui.bat, в Linux/macOS — scripts/run-gui.sh.

Все утилиты доступны и из терминала — как через единую команду omsreg, так и по отдельности:

omsreg remove-talons re_gb3 --dry-run
omsreg remove-codes  re_gb3 коды.txt
omsreg stat          uu/0091_016.dbf --day-kotd 10,15,12
omsreg econ          uu/0091_016.dbf --day-kotd 10,15,12
omsreg deaths        "Отчет по умершим (новый).xls"

# отдельные команды (устанавливаются вместе с пакетом):
omsreg-remove-talons ...
omsreg-remove-codes  ...
omsreg-stat          ...
omsreg-econ          ...
omsreg-deaths        ...

Подробнее по каждой — omsreg <команда> --help.

scripts\build-exe.bat

Получится один файл dist\duct-tape.exe, который работает без установленного Python. На каждый тег v* тот же EXE собирается автоматически в GitHub Actions (.github/workflows/build-exe.yml).

Последний пункт бокового списка — «О программе»: название, версия, автор, лицензия, ссылка на GitHub и кнопки «Проверить обновление», «Обновить», «Страница релиза».

• При запуске программа сама проверяет, вышла ли новая версия (галочка «Проверять обновления при запуске» на той же странице, ключ app.check_updates в настройки.txt). Проверка идёт в фоновом потоке с коротким таймаутом. Если сети нет или GitHub закрыт, никаких окон с ошибками не появляется — статус просто виден на странице «О программе». Когда обновление найдено, пункт списка помечается номером версии, а в журнал добавляется строка.
• Кнопка «Обновить» скачивает новый duct-tape.exe, сверяет его sha256 с суммой, опубликованной в API релиза, заменяет им себя и перезапускается. Прежняя версия сохраняется рядом как duct-tape.old.exe и удаляется при следующем запуске. Если контрольная сумма не совпала — файл удаляется и установка отменяется; если не удалось подменить файл (например, нет прав в Program Files) — прежняя версия возвращается на место, а на странице появляется объяснение.
• При запуске из исходников обновление не выполняется: программа предлагает git pull.

Механика — в core/updater.py (только стандартная библиотека), интерфейс — в gui/about.py.

Значения полей сохраняются в файле настройки.txt рядом с программой (создаётся при первом запуске). В репозитории лежит только пример — examples/настройки.example.txt; сам настройки.txt намеренно не версионируется. Файлы прежней версии со старыми русскими ключами подхватываются автоматически и переписываются в новую схему.

Отчёт «Экономика стационара» подписывает группы КСГ официальными наименованиями и профилями из справочника src/omsreg/utils/_shared/ksg_catalog.py (692 группы: дневной ds… + круглосуточный st…). Веса и коэффициенты в справочник намеренно не входят — они берутся из самого реестра.

Справочник сгенерирован и вручную не правится. Пересобрать его при выходе новой версии (например, на новый год) — из официальных файлов «Расшифровка групп КСГ … .xlsx» скриптом tools/build_ksg_catalog.py:

python tools/build_ksg_catalog.py \
    "Расшифровка групп КСГ для дневного стационара на 2026 год.xlsx" \
    "Расшифровка групп КСГ для круглосуточного стационара на 2026 год.xlsx"

Скрипт читает лист «КСГ» каждого файла (столбцы «КСГ», «Наименование КСГ», «Профиль»), объединяет дневной и круглосуточный стационар в один словарь и перезаписывает ksg_catalog.py. Зависимостей нет — .xlsx разбирается как zip с XML средствами стандартной библиотеки. Необязательный ключ --out PATH меняет путь вывода.

Отчёт «Смертность стационара» относит каждого умершего к группе причин смерти по коду МКБ клинического диагноза (патологоанатомический — если клинический пуст) через справочник src/omsreg/utils/_shared/mkb_death_groups.csv. Это простой редактируемый CSV: правила код_от;код_до;группа;подгруппа читаются сверху вниз, берётся первое подходящее (специфичные — выше общих). Пример:

G00;G99;Болезни нервной системы;
I60;I69;Болезни нервной системы;      # инсульты отнесены к неврологии, а не к кровообращению
I20;I25;Болезни кровообращения;ИБС    # подгруппа -> приписка «(в т.ч. ИБС N)»
I48;I48;Болезни кровообращения;фибрилляция
I00;I99;Болезни кровообращения;

Порядок столбцов в отчёте = порядок первого появления групп в файле; коды вне всех правил идут в столбец «Прочие» (их список выводится в отчёте, чтобы можно было дополнить справочник). Правьте файл под свой перечень групп; для .exe можно указать свой CSV того же формата — параметром «Справочник групп» на вкладке или ключом --groups в командной строке (без пересборки программы).

Excel-файл отчёта (.xlsx) собирается мини-генератором core/xlsx.py на стандартной библиотеке (ширины колонок, жирная шапка, рамки — как в образце), поэтому сторонних зависимостей по-прежнему нет.

src/omsreg/
  core/     общий код без tkinter: dbf, convert, format, errors, logging_setup, cli,
            backup, textio, report_html, xlsx (мини-генератор .xlsx),
            updater (проверка и установка обновлений с GitHub)
  utils/    доменные утилиты-вкладки (CLI + функции run_*): remove_error_talons,
            remove_codes, stat_stacionar, stat_economics, stat_deaths
    _shared/  вспомогательное (не вкладки): stat_common, removal_common,
              stat_stacionar_report, stat_economics_report, stat_deaths_report,
              ksg_catalog (справочник КСГ), mkb_death_groups (+ .csv — справочник причин смерти)
  gui/      платформа: spec, registry, theme, config, log_panel, app, plugin_fields
              (общие поля вкладок), about (страница «О программе» и обновление),
              plugins/ — только модули-плагины: один файл = одна вкладка
tests/      тесты ядра и утилит (без дисплея)
tools/      сервисные скрипты (в пакет не входят): build_ksg_catalog.py —
            сборка справочника КСГ из официальных xlsx

1. Напишите доменную логику в src/omsreg/utils/<name>.py (функция run_..., при желании main() для CLI). Всё чтение/запись DBF берите из omsreg.core.
2. Создайте плагин src/omsreg/gui/plugins/<name>.py с объектом SPEC (omsreg.gui.spec.UtilitySpec): метаданные, схема параметров, кнопки-действия и функция run(ctx) -> JobResult. См. готовые plugins/stat.py, plugins/codes.py.
3. Добавьте модуль в кортеж BUILTIN в plugins/__init__.py — это обязательно, чтобы плагин попал в сборку .exe (в собранном приложении файлового автоскана нет). При запуске из исходников плагин подхватится и без этого шага.

Вкладка, хранение настроек и поток запуск/проверка/подтверждение/журнал создадутся автоматически.

pip install -e .[dev]
ruff check .
pytest -q

Набор правил ruff (E F W I UP B N D FA ARG SIM RET C4 PERF PTH PLC0415 RUF100 C90 PLR091x, preview = true) задан в pyproject.toml; там же — исключения по файлам, включая блок «ВРЕМЕННО, технический долг» (сложность и число аргументов у ещё не разрезанных функций). Обе проверки должны проходить без замечаний.

Минимальная версия — Python 3.9, и CI гоняет тесты на 3.9–3.13. Часть ошибок видна только на старых версиях (например, str | None в аннотации вычисляется при импорте, а urllib.error.HTTPError без тела ответа на 3.9 открывает временный файл). Проверить самую старую версию локально, ничего не устанавливая в систему:

uv run --python 3.9 --with pytest --no-project pytest -q

Правило FA в ruff ловит первый из этих случаев ещё до запуска тестов.

MIT.