← К отчётуPDF-версия отчёта
В окне печати выберите «Сохранить как PDF» Repo Health · отчёт о здоровье репозитория6 ноя 2026ka4e6/koalageddon
sourcecraft.dev/ka4e6/koalageddonОбновлено 13 дней назадОценка по открытым данным
- Данные
- 4 категории из 6Security, CI/CD: видны только участникам. 24 из 24 метрик с данными
- Место в рейтинге
- 8 433–8 690 из 21 909
Есть серьёзные проблемы. Что тянет вниз: проект не обновлялся 299 дней, много TODO/FIXME: 1,2 на 1000 строк.
Категории
| Категория | Вес | Оценка | Вывод |
|---|
| Security | 25% | — | нет данных |
| CI/CD | 20% | — | нет данных |
| Активность | 15% | 10 | 10/100: Последний коммит 2025-12-28, за 299 дн. до анализа |
| Документация | 15% | 25 | 25/100: README выполняет 3 из 7 проверок, нет: примеры кода, запуск, сборка, тесты |
| Issues | 15% | 50 | 50/100 |
| Code health | 10% | 59 |
Что стоит улучшить
- Активность · последний коммит 2025-12-28, за 299 дн. до анализа
- Активность · недель с коммитами за 90 дней: 0 из 13, доля самой плотной недели 0%
- Документация · README выполняет 3 из 7 проверок, нет: примеры кода, запуск, сборка, тесты
- Документация · нет инструкции локального запуска
- Code health · TODO/FIXME на 1000 строк: 1,2 (7 на 5 660 строк)
- Code health · тестовых файлов: 0 на 87 исходных
Рекомендации
1. Возобновить развитие проекта
+6,5Активность 10 → 34Высокий приоритет· Активность
- Проблема
- Проект не обновлялся 299 дней
- Почему важно
- Долгое отсутствие изменений — признак заброшенного проекта: уязвимости и баги не исправляются.
- Что сделать
- Обновите зависимости и документацию. Если проект закрыт, пометьте его архивным: оценка от этого не вырастет, но пользователи поймут его статус.
- Основание
- История коммитовПоследний коммит 2025-12-28
2. Разобрать TODO/FIXME
+4,5Code health 59 → 84Высокий приоритет· Code health
- Проблема
- Много TODO/FIXME: 1,2 на 1000 строк
- Почему важно
- Накопленные TODO/FIXME — отложенные исправления, которые мешают сопровождению кода.
- Что сделать
- Заведите по TODO/FIXME задачи в трекере, выполните или удалите неактуальные.
- Основание
- Unlocker/src/platforms/steam/steam_hooks.cpp:121 · 5 лет без изменений
| 59/100: TODO/FIXME на 1000 строк: 1,2 (7 на 5 660 строк) |
Unlocker/src/platforms/steam/steam_hooks.h:3 · 5 лет без изменений
Common/src/util.cpp:366 · 5 лет без изменений
Common/src/Logger.cpp:15 · 5 лет без изменений
IntegrationWizard/src/IntegrationWizard.cpp:124 · 5 лет без изменений
TODO: 7, FIXME: 0
Строк кода проверено: 5660
3. Добавить в README инструкцию локального запуска
+4,4Документация 25 → 41Высокий приоритет· Документация
- Проблема
- Нет инструкции локального запуска
- Почему важно
- Без неё новый участник тратит часы на то, чтобы просто запустить проект.
- Что сделать
- Добавьте в README раздел «Запуск» с командами установки зависимостей и старта.
- Основание
- README.mdВ README и docs/ не найден раздел запуска или команда запуска
4. Снизить зависимость от одного разработчика
+4,1Активность 10 → 25Высокий приоритет· Активность
- Проблема
- Проект зависит от одного разработчика
- Почему важно
- Если единственный автор уйдёт, развитие остановится (низкий bus factor).
- Что сделать
- Привлеките второго мейнтейнера, проводите ревью через merge requests.
- Основание
- Авторов коммитов за 90 дней: 0Bus factor за год: 1
5. Дополнить README
+3,4Документация 25 → 38Средний приоритет· Документация
- Проблема
- README неполный
- Почему важно
- Короткий README без разделов и примеров не помогает начать работу с проектом.
- Что сделать
- Добавьте заголовки разделов, примеры кода и описание запуска, объём — от 100 слов.
- Основание
- README.mdНе выполнены проверки: has_code_examples, local_run, build, testing
6. Описать запуск тестов
+3,3Документация 25 → 37Средний приоритет· Документация
- Проблема
- Не описан запуск тестов
- Почему важно
- Воспроизводимая сборка и запуск тестов нужны, чтобы изменения проверялись одинаково у всех.
- Что сделать
- Опишите команды тестов в README или docs/.
- Основание
- Тесты: описание не найдено в README и docs/
7. Вести историю изменений
+3,3Документация 25 → 37Средний приоритет· Документация
- Проблема
- Нет changelog
- Почему важно
- Без истории изменений нельзя понять, что менялось между версиями.
- Что сделать
- Добавьте CHANGELOG.md или раздел «История изменений» в README.
- Основание
- CHANGELOG/CHANGES/HISTORY не найден, в README нет раздела Changelog
8. Публиковать релизы
+2,7Активность 10 → 20Средний приоритет· Активность
- Проблема
- Нет свежих релизов
- Почему важно
- Релизы дают пользователям стабильные версии и понятную историю изменений.
- Что сделать
- Публикуйте релизы с тегом и описанием изменений.
- Основание
- РелизыНет опубликованных релизов
9. Описать запуск сборки
+1,9Документация 25 → 32Средний приоритет· Документация
- Проблема
- Не описан запуск сборки
- Почему важно
- Воспроизводимая сборка и запуск тестов нужны, чтобы изменения проверялись одинаково у всех.
- Что сделать
- Опишите команды сборки в README или docs/.
- Основание
- Сборка: описание не найдено в README и docs/
10. Вносить изменения через merge requests
+1,8Активность 10 → 17Средний приоритет· Активность
- Проблема
- Изменения вносятся без merge requests
- Почему важно
- Без MR нет ревью кода и истории обсуждения изменений.
- Что сделать
- Защитите основную ветку и вносите изменения через merge requests с ревью.
- Основание
- Merge requests в репозитории отсутствуют
11. Добавить тесты
+1,8Code health 59 → 69Средний приоритет· Code health
- Проблема
- В проекте нет тестов
- Почему важно
- Без тестов любое изменение может незаметно сломать поведение.
- Что сделать
- Покройте тестами ключевую логику и запускайте их в CI.
- Основание
- Тестовых файлов: 0 на 87 исходных
12. Выделить тесты в отдельный каталог
+1,4Документация 25 → 30Средний приоритет· Документация
- Проблема
- В структуре проекта нет каталога с тестами
- Почему важно
- По структуре репозитория сразу видно, где тесты и как их запускать; это основа для CI.
- Что сделать
- Добавьте тесты (каталог tests/ или файлы *_test / *.test) и опишите их запуск.
- Основание
- Каталоги верхнего уровня: Common, Injector, Integration, IntegrationWizard, Unlocker
13. Добавить CONTRIBUTING.md
+1,1Документация 25 → 29Низкий приоритет· Документация
- Проблема
- Нет CONTRIBUTING.md
- Почему важно
- CONTRIBUTING.md объясняет, как вносить изменения.
- Что сделать
- Добавьте CONTRIBUTING.md.
- Основание
- Файл CONTRIBUTING.md не найден
14. Добавить CODEOWNERS
+0,8Документация 25 → 28Низкий приоритет· Документация
- Проблема
- Нет CODEOWNERS
- Почему важно
- CODEOWNERS назначает ревьюеров на части кода.
- Что сделать
- Добавьте CODEOWNERS.
- Основание
- Файл CODEOWNERS не найден
15. Добавить SECURITY.md
+0,8Документация 25 → 28Низкий приоритет· Документация
- Проблема
- Нет SECURITY.md
- Почему важно
- SECURITY.md говорит, куда сообщать об уязвимостях.
- Что сделать
- Добавьте SECURITY.md.
- Основание
- Файл SECURITY.md не найден
Нет данных
Эти метрики не вошли в расчёт и не снизили оценку: веса перенормированы, охват метрик 100%.
- Security — в публичном рейтинге не учитывается: данные AppSec видны только участникам репозитория (доступно в анализе собственного репозитория по токену)
- CI/CD — в публичном рейтинге не учитывается: данные CI видны только участникам репозитория (доступно в анализе собственного репозитория по токену)
Как рассчитана оценка
В среднее вошли Активность, Документация, Issues, Code health. Security, CI/CD без данных: вес ушёл в собранные, ноля за них нет.
(15 * 10 + 15 * 25 + 15 * 50 + 10 * 59) / 55 = 34,1
Округлили до 34. Ограничение не сработало.
| Категория | Вес | Оценка | Вклад | Охват |
|---|
| Security | 25 | — | — | 0% |
| CI/CD | 20 | — | — | 0% |
| Активность | 15 | 10 | 1,54 | 100% |
| Документация | 15 | 25 | 3,82 | 100% |
| Issues | 15 | 50 | 7,50 | 100% |
| Code health | 10 | 59 | 5,90 | 100% |
| Оценка | 55 | | 34,1 | 100% |
Как считается оценка
Актуальная версия отчёта — guap.pro/repos/ka4e6/koalageddon