# Repo Health: ivan-igorevich-yushin/computational-chemistry-course

- Репозиторий: https://sourcecraft.dev/ivan-igorevich-yushin/computational-chemistry-course
- Язык: Jupyter Notebook
- Дата анализа: 29.09.2026 22:51

## Итоговый Score

**29/100**

## Категории

- **Документация:** 15/100
- **CI/CD:** Нет данных (публичный запуск — категория не сканировалась)
- **Безопасность:** Нет данных (публичный запуск — категория не сканировалась)
- **Активность:** 40/100
- **Issues:** Нет данных (Не найдено ни одной задачи — оценить категорию Issues невозможно)
- **Состояние кода:** 32/100


Категории без данных не обнуляют итог: их вес перераспределяется между категориями, где балл есть.



## Рекомендации

- **[критическая]** Не найдено тестов (Состояние кода)
  - В дереве репозитория не обнаружено ни каталогов tests/test/spec, ни файлов с типовыми именами тестов.
  - Действие: Добавьте тесты хотя бы для критичной части кодовой базы и подключите их к CI.
  - Ожидаемый прирост Repo Health Score: +12

- **[высокая]** Нет конфигурации линтера/форматтера (Состояние кода)
  - В репозитории не найдено конфигов известных линтеров/форматтеров (ESLint, Ruff/Flake8, Prettier, rustfmt и т.п.).
  - Действие: Подключите линтер и форматтер под используемый стек и зафиксируйте правила в конфиге.
  - Ожидаемый прирост Repo Health Score: +7

- **[высокая]** Репозиторий похож на набор данных, а не на код (Состояние кода)
  - В дереве найдены только data-файлы (CSV/JSON/...) и ни одного файла исходного кода.
  - Действие: Если это действительно data-репозиторий — уберите его из анализа кода; если код должен быть, проверьте, не потерялся ли он.
  - Ожидаемый прирост Repo Health Score: +7

- **[высокая]** Отсутствует лицензия (Документация)
  - В корне репозитория нет файла LICENSE/COPYING. Без лицензии использование проекта юридически неясно.
  - Действие: Добавьте LICENSE с выбранной лицензией (MIT, Apache-2.0, GPL и т.п.).
  - Ожидаемый прирост Repo Health Score: +6

- **[высокая]** Нет инструкции локального запуска (Документация)
  - В README нет явного блока про установку и запуск проекта локально.
  - Действие: Добавьте раздел Quick Start: зависимости, установка, запуск, типовые команды.
  - Ожидаемый прирост Repo Health Score: +3

- **[высокая]** Нет инструкций по сборке и тестам (Документация)
  - В README не описано, как собрать проект и запустить тесты.
  - Действие: Добавьте разделы Build и Test с командами и необходимыми зависимостями.
  - Ожидаемый прирост Repo Health Score: +3

- **[средняя]** Мало релизов за последние 30 дней (Активность)
  - Подметрика «Релизы» — 0 из 100. Полный балл — от 3 релизов за 30 дней.
  - Действие: Выпустите релиз или опишите, почему проект их не использует — балл считает отсутствие релизов недобором.
  - Ожидаемый прирост Repo Health Score: +9

- **[средняя]** Нет merge requests за последние 30 дней (Активность)
  - За последние 30 дней не найдено merge requests, созданных, обновлённых, объединённых или закрытых.
  - Действие: Проверьте, соответствует ли фактический процесс разработки ожидаемому review/workflow-процессу.
  - Ожидаемый прирост Repo Health Score: +9

- **[средняя]** README неполный (Документация)
  - README есть, но «README» — 50 из 100: не хватает объёма или раздела о структуре.
  - Действие: Допишите README: зачем проект и из чего состоит репозиторий.
  - Ожидаемый прирост Repo Health Score: +5

- **[средняя]** Нет CHANGELOG и каталога docs/ (Документация)
  - Не найдены CHANGELOG и каталог docs/ — история изменений и подробная документация отсутствуют.
  - Действие: Заведите CHANGELOG.md и каталог docs/ для пользовательской и разработческой документации.
  - Ожидаемый прирост Repo Health Score: +5

- **[средняя]** Нет CONTRIBUTING и CODEOWNERS (Документация)
  - Не найдены файлы CONTRIBUTING и CODEOWNERS — внешним контрибьюторам неясен процесс.
  - Действие: Добавьте CONTRIBUTING.md с процессом PR и CODEOWNERS для автоназначения ревьюеров.
  - Ожидаемый прирост Repo Health Score: +5