← К отчётуPDF-версия отчёта
В окне печати выберите «Сохранить как PDF» Repo Health · отчёт о здоровье репозитория6 ноя 2026ka4e6/koalabox
sourcecraft.dev/ka4e6/koalaboxОбновлено 14 дней назадОценка по открытым данным
- Данные
- 4 категории из 6Security, CI/CD: видны только участникам. 24 из 24 метрик с данными
- Место в рейтинге
- 8 689–10 212 из 21 903
Есть серьёзные проблемы. Что тянет вниз: проект не обновлялся 405 дней, много TODO/FIXME: 1,6 на 1000 строк.
Категории
| Категория | Вес | Оценка | Вывод |
|---|
| Security | 25% | — | нет данных |
| CI/CD | 20% | — | нет данных |
| Активность | 15% | 10 | 10/100: Последний коммит 2025-09-13, за 405 дн. до анализа |
| Документация | 15% | 29 | 29/100: README выполняет 3 из 7 проверок, нет: примеры кода, запуск, сборка, тесты |
| Issues | 15% | 50 | 50/100 |
| Code health | 10% | 45 |
Что стоит улучшить
- Активность · последний коммит 2025-09-13, за 405 дн. до анализа
- Активность · недель с коммитами за 90 дней: 0 из 13, доля самой плотной недели 0%
- Документация · README выполняет 3 из 7 проверок, нет: примеры кода, запуск, сборка, тесты
- Документация · нет файла лицензии в корне
- Code health · TODO/FIXME на 1000 строк: 1,6 (8 на 4 870 строк)
- Code health · тестовых файлов: 0 на 74 исходных
Рекомендации
1. Возобновить развитие проекта
+6,5Активность 10 → 34Высокий приоритет· Активность
- Проблема
- Проект не обновлялся 405 дней
- Почему важно
- Долгое отсутствие изменений — признак заброшенного проекта: уязвимости и баги не исправляются.
- Что сделать
- Обновите зависимости и документацию. Если проект закрыт, пометьте его архивным: оценка от этого не вырастет, но пользователи поймут его статус.
- Основание
- История коммитовПоследний коммит 2025-09-13
2. Разобрать TODO/FIXME
+6,0Code health 45 → 78Высокий приоритет· Code health
- Проблема
- Много TODO/FIXME: 1,6 на 1000 строк
- Почему важно
- Накопленные TODO/FIXME — отложенные исправления, которые мешают сопровождению кода.
- Что сделать
- Заведите по TODO/FIXME задачи в трекере, выполните или удалите неактуальные.
- Основание
- .github/workflows/build-and-package.yml:26 · 1 год без изменений
| 45/100: TODO/FIXME на 1000 строк: 1,6 (8 на 4 870 строк) |
include/koalabox/win.hpp:16 · 1 год без изменений
src/dll_monitor_win.cpp:125 · 1 год без изменений
include/koalabox/module.hpp:15 · 1 год без изменений
src/dll_monitor_linux.cpp:7 · 1 год без изменений
TODO: 8, FIXME: 0
Строк кода проверено: 4870
3. Добавить в README инструкцию локального запуска
+4,4Документация 29 → 45Высокий приоритет· Документация
- Проблема
- Нет инструкции локального запуска
- Почему важно
- Без неё новый участник тратит часы на то, чтобы просто запустить проект.
- Что сделать
- Добавьте в README раздел «Запуск» с командами установки зависимостей и старта.
- Основание
- README.mdВ README и docs/ не найден раздел запуска или команда запуска
4. Снизить зависимость от одного разработчика
+4,1Активность 10 → 25Высокий приоритет· Активность
- Проблема
- Проект зависит от одного разработчика
- Почему важно
- Если единственный автор уйдёт, развитие остановится (низкий bus factor).
- Что сделать
- Привлеките второго мейнтейнера, проводите ревью через merge requests.
- Основание
- Авторов коммитов за 90 дней: 0Bus factor за год: 0
5. Добавить лицензию
+2,2Документация 29 → 37Высокий приоритет· Документация
- Проблема
- Нет лицензии
- Почему важно
- Без лицензии код формально нельзя использовать и дорабатывать, это блокирует внешних пользователей.
- Что сделать
- Выберите лицензию (MIT, Apache-2.0 и т.п.) и добавьте файл LICENSE в корень.
- Основание
- Файл LICENSE/COPYING не найден в корне
6. Дополнить README
+3,4Документация 29 → 42Средний приоритет· Документация
- Проблема
- README неполный
- Почему важно
- Короткий README без разделов и примеров не помогает начать работу с проектом.
- Что сделать
- Добавьте заголовки разделов, примеры кода и описание запуска, объём — от 100 слов.
- Основание
- README.mdНе выполнены проверки: has_code_examples, local_run, build, testing
7. Вести историю изменений
+3,3Документация 29 → 41Средний приоритет· Документация
- Проблема
- Нет changelog
- Почему важно
- Без истории изменений нельзя понять, что менялось между версиями.
- Что сделать
- Добавьте CHANGELOG.md или раздел «История изменений» в README.
- Основание
- CHANGELOG/CHANGES/HISTORY не найден, в README нет раздела Changelog
8. Публиковать релизы
+2,7Активность 10 → 20Средний приоритет· Активность
- Проблема
- Нет свежих релизов
- Почему важно
- Релизы дают пользователям стабильные версии и понятную историю изменений.
- Что сделать
- Публикуйте релизы с тегом и описанием изменений.
- Основание
- РелизыНет опубликованных релизов
9. Пересмотреть старые TODO/FIXME
+2,3Code health 45 → 57Средний приоритет· Code health
- Проблема
- 8 TODO/FIXME старше 180 дней
- Почему важно
- Старые TODO обычно уже никто не выполнит: это технический долг, который только растёт.
- Что сделать
- Пересмотрите старые TODO/FIXME: превратите в задачи или удалите.
- Основание
- .github/workflows/build-and-package.yml:26 · 1 год без измененийinclude/koalabox/win.hpp:16 · 1 год без измененийsrc/dll_monitor_win.cpp:125 · 1 год без измененийinclude/koalabox/module.hpp:15 · 1 год без измененийsrc/dll_monitor_linux.cpp:7 · 1 год без измененийСтарых TODO/FIXME на 1000 строк: 1,64 (8 из 8 проверенных старше 180 дней)
10. Описать запуск сборки
+1,9Документация 29 → 36Средний приоритет· Документация
- Проблема
- Не описан запуск сборки
- Почему важно
- Воспроизводимая сборка и запуск тестов нужны, чтобы изменения проверялись одинаково у всех.
- Что сделать
- Опишите команды сборки в README или docs/.
- Основание
- Сборка: описание не найдено в README и docs/
11. Вносить изменения через merge requests
+1,8Активность 10 → 17Средний приоритет· Активность
- Проблема
- Изменения вносятся без merge requests
- Почему важно
- Без MR нет ревью кода и истории обсуждения изменений.
- Что сделать
- Защитите основную ветку и вносите изменения через merge requests с ревью.
- Основание
- Merge requests в репозитории отсутствуют
12. Добавить тесты
+1,8Code health 45 → 55Средний приоритет· Code health
- Проблема
- В проекте нет тестов
- Почему важно
- Без тестов любое изменение может незаметно сломать поведение.
- Что сделать
- Покройте тестами ключевую логику и запускайте их в CI.
- Основание
- Тестовых файлов: 0 на 74 исходных
13. Выделить тесты в отдельный каталог
+1,4Документация 29 → 34Средний приоритет· Документация
- Проблема
- В структуре проекта нет каталога с тестами
- Почему важно
- По структуре репозитория сразу видно, где тесты и как их запускать; это основа для CI.
- Что сделать
- Добавьте тесты (каталог tests/ или файлы *_test / *.test) и опишите их запуск.
- Основание
- Каталоги верхнего уровня: .github, .idea, cmake, docs, include, res, src, templates, tools
14. Добавить CONTRIBUTING.md
+1,1Документация 29 → 33Низкий приоритет· Документация
- Проблема
- Нет CONTRIBUTING.md
- Почему важно
- CONTRIBUTING.md объясняет, как вносить изменения.
- Что сделать
- Добавьте CONTRIBUTING.md.
- Основание
- Файл CONTRIBUTING.md не найден
15. Добавить CODEOWNERS
+0,8Документация 29 → 32Низкий приоритет· Документация
- Проблема
- Нет CODEOWNERS
- Почему важно
- CODEOWNERS назначает ревьюеров на части кода.
- Что сделать
- Добавьте CODEOWNERS.
- Основание
- Файл CODEOWNERS не найден
16. Добавить SECURITY.md
+0,8Документация 29 → 32Низкий приоритет· Документация
- Проблема
- Нет SECURITY.md
- Почему важно
- SECURITY.md говорит, куда сообщать об уязвимостях.
- Что сделать
- Добавьте SECURITY.md.
- Основание
- Файл SECURITY.md не найден
Нет данных
Эти метрики не вошли в расчёт и не снизили оценку: веса перенормированы, охват метрик 100%.
- Security — в публичном рейтинге не учитывается: данные AppSec видны только участникам репозитория (доступно в анализе собственного репозитория по токену)
- CI/CD — в публичном рейтинге не учитывается: данные CI видны только участникам репозитория (доступно в анализе собственного репозитория по токену)
Как рассчитана оценка
В среднее вошли Активность, Документация, Issues, Code health. Security, CI/CD без данных: вес ушёл в собранные, ноля за них нет.
(15 * 10 + 15 * 29 + 15 * 50 + 10 * 45) / 55 = 32,6
Округлили до 33. Ограничение не сработало.
| Категория | Вес | Оценка | Вклад | Охват |
|---|
| Security | 25 | — | — | 0% |
| CI/CD | 20 | — | — | 0% |
| Активность | 15 | 10 | 1,54 | 100% |
| Документация | 15 | 29 | 4,42 | 100% |
| Issues | 15 | 50 | 7,50 | 100% |
| Code health | 10 | 45 | 4,46 | 100% |
| Оценка | 55 | | 32,6 | 100% |
Как считается оценка
Актуальная версия отчёта — guap.pro/repos/ka4e6/koalabox