← К отчётуPDF-версия отчёта
В окне печати выберите «Сохранить как PDF» Repo Health · отчёт о здоровье репозитория10 ноя 2026maksim-eltratov/homemq2t
home automation project
sourcecraft.dev/maksim-eltratov/homemq2tОбновлено 18 дней назадОценка по открытым данным
- Данные
- 4 категории из 6Security, CI/CD: видны только участникам. 24 из 24 метрик с данными
- Место в рейтинге
- 5 340–6 117 из 21 894
Есть серьёзные проблемы. Что тянет вниз: В репозитории нет issues, Активность слабее остальных категорий.
Категории
| Категория | Вес | Оценка | Вывод |
|---|
| Security | 25% | — | нет данных |
| CI/CD | 20% | — | нет данных |
| Активность | 15% | 32 | 32/100: Последний коммит 2026-09-21, за 31 дн. до анализа |
| Документация | 15% | 34 | 34/100: Нет инструкции локального запуска |
| Issues | 15% | 35 | 35/100: Issues нет: трекер не ведут |
| Code health | 10% | 58 |
Что стоит улучшить
- Активность · последний коммит 2026-09-21, за 31 дн. до анализа
- Активность · недель с коммитами за 90 дней: 8 из 13, доля самой плотной недели 40%
- Документация · нет инструкции локального запуска
- Документация · не описана сборка
- Issues · issues нет: трекер не ведут
- Code health · TODO/FIXME на 1000 строк: 1,5 (15 на 9 767 строк)
Рекомендации
1. Начать вести задачи в issues
+17,7Issues 35 → 100Высокий приоритет· Issues
- Проблема
- В репозитории нет issues
- Почему важно
- Без трекера не видно, как проект сопровождают: чужому человеку некуда писать о проблеме.
- Что сделать
- Заведите issues на известные задачи и баги, даже если команда маленькая.
- Основание
- Открытых и закрытых issues: 0
2. Разобрать TODO/FIXME
+5,6Code health 58 → 89Высокий приоритет· Code health
- Проблема
- Много TODO/FIXME: 1,5 на 1000 строк
- Почему важно
- Накопленные TODO/FIXME — отложенные исправления, которые мешают сопровождению кода.
- Что сделать
- Заведите по TODO/FIXME задачи в трекере, выполните или удалите неактуальные.
- Основание
- app/src/main/java/ru/maxeltr/homeMq2t/Mqtt/MqttPublishHandlerImpl.java:320 · 1 год без измененийapp/src/main/java/ru/maxeltr/homeMq2t/Mqtt/MqttPublishHandlerImpl.java:293 · 1 год без изменений
| 58/100: TODO/FIXME на 1000 строк: 1,5 (15 на 9 767 строк) |
app/src/main/java/ru/maxeltr/homeMq2t/Mqtt/MqttAckMediatorImpl.java:82 · 1 год без изменений
app/src/main/java/ru/maxeltr/homeMq2t/Service/ServiceMediatorImpl.java:165 · 1 год без изменений
app/src/main/java/ru/maxeltr/homeMq2t/Service/UI/ConnectManagerImpl.java:55 · 1 год без изменений
TODO: 15, FIXME: 0
Строк кода проверено: 9767
3. Возобновить развитие проекта
+5,3Активность 32 → 51Высокий приоритет· Активность
- Проблема
- Проект не обновлялся 31 день
- Почему важно
- Долгое отсутствие изменений — признак заброшенного проекта: уязвимости и баги не исправляются.
- Что сделать
- Обновите зависимости и документацию. Если проект закрыт, пометьте его архивным: оценка от этого не вырастет, но пользователи поймут его статус.
- Основание
- История коммитовПоследний коммит 2026-09-21
4. Добавить в README инструкцию локального запуска
+4,4Документация 34 → 50Высокий приоритет· Документация
- Проблема
- Нет инструкции локального запуска
- Почему важно
- Без неё новый участник тратит часы на то, чтобы просто запустить проект.
- Что сделать
- Добавьте в README раздел «Запуск» с командами установки зависимостей и старта.
- Основание
- readme.mdВ README и docs/ не найден раздел запуска или команда запуска
5. Снизить зависимость от одного разработчика
+3,3Активность 32 → 44Средний приоритет· Активность
- Проблема
- Проект зависит от одного разработчика
- Почему важно
- Если единственный автор уйдёт, развитие остановится (низкий bus factor).
- Что сделать
- Привлеките второго мейнтейнера, проводите ревью через merge requests.
- Основание
- Авторов коммитов за 90 дней: 1Bus factor за год: 1
6. Описать запуск тестов
+3,3Документация 34 → 46Средний приоритет· Документация
- Проблема
- Не описан запуск тестов
- Почему важно
- Воспроизводимая сборка и запуск тестов нужны, чтобы изменения проверялись одинаково у всех.
- Что сделать
- Опишите команды тестов в README или docs/.
- Основание
- Тесты: описание не найдено в README и docs/
7. Вести историю изменений
+3,3Документация 34 → 46Средний приоритет· Документация
- Проблема
- Нет changelog
- Почему важно
- Без истории изменений нельзя понять, что менялось между версиями.
- Что сделать
- Добавьте CHANGELOG.md или раздел «История изменений» в README.
- Основание
- CHANGELOG/CHANGES/HISTORY не найден, в README нет раздела Changelog
8. Публиковать релизы
+2,7Активность 32 → 42Средний приоритет· Активность
- Проблема
- Нет свежих релизов
- Почему важно
- Релизы дают пользователям стабильные версии и понятную историю изменений.
- Что сделать
- Публикуйте релизы с тегом и описанием изменений.
- Основание
- РелизыНет опубликованных релизов
9. Дополнить README
+2,6Документация 34 → 43Средний приоритет· Документация
- Проблема
- README неполный
- Почему важно
- Короткий README без разделов и примеров не помогает начать работу с проектом.
- Что сделать
- Добавьте заголовки разделов, примеры кода и описание запуска, объём — от 100 слов.
- Основание
- readme.mdНе выполнены проверки: local_run, build, testing
10. Описать запуск сборки
+1,9Документация 34 → 41Средний приоритет· Документация
- Проблема
- Не описан запуск сборки
- Почему важно
- Воспроизводимая сборка и запуск тестов нужны, чтобы изменения проверялись одинаково у всех.
- Что сделать
- Опишите команды сборки в README или docs/.
- Основание
- Сборка: описание не найдено в README и docs/
11. Покрыть код тестами
+0,9Code health 58 → 63Средний приоритет· Code health
- Проблема
- Мало тестов
- Почему важно
- Без тестов любое изменение может незаметно сломать поведение.
- Что сделать
- Покройте тестами ключевую логику и запускайте их в CI.
- Основание
- Тестовых файлов: 1 на 92 исходных
12. Добавить CONTRIBUTING.md
+1,1Документация 34 → 38Низкий приоритет· Документация
- Проблема
- Нет CONTRIBUTING.md
- Почему важно
- CONTRIBUTING.md объясняет, как вносить изменения.
- Что сделать
- Добавьте CONTRIBUTING.md.
- Основание
- Файл CONTRIBUTING.md не найден
13. Добавить CODEOWNERS
+0,8Документация 34 → 37Низкий приоритет· Документация
- Проблема
- Нет CODEOWNERS
- Почему важно
- CODEOWNERS назначает ревьюеров на части кода.
- Что сделать
- Добавьте CODEOWNERS.
- Основание
- Файл CODEOWNERS не найден
14. Добавить SECURITY.md
+0,8Документация 34 → 37Низкий приоритет· Документация
- Проблема
- Нет SECURITY.md
- Почему важно
- SECURITY.md говорит, куда сообщать об уязвимостях.
- Что сделать
- Добавьте SECURITY.md.
- Основание
- Файл SECURITY.md не найден
Нет данных
Эти метрики не вошли в расчёт и не снизили оценку: веса перенормированы, охват метрик 100%.
- Security — в публичном рейтинге не учитывается: данные AppSec видны только участникам репозитория (доступно в анализе собственного репозитория по токену)
- CI/CD — в публичном рейтинге не учитывается: данные CI видны только участникам репозитория (доступно в анализе собственного репозитория по токену)
Как рассчитана оценка
В среднее вошли Активность, Документация, Issues, Code health. Security, CI/CD без данных: вес ушёл в собранные, ноля за них нет.
(15 * 32 + 15 * 34 + 15 * 35 + 10 * 58) / 55 = 37,9
Округлили до 38. Ограничение не сработало.
| Категория | Вес | Оценка | Вклад | Охват |
|---|
| Security | 25 | — | — | 0% |
| CI/CD | 20 | — | — | 0% |
| Активность | 15 | 32 | 4,78 | 100% |
| Документация | 15 | 34 | 5,03 | 100% |
| Issues | 15 | 35 | 5,25 | 100% |
| Code health | 10 | 58 | 5,80 | 100% |
| Оценка | 55 | | 37,9 | 100% |
Как считается оценка
Актуальная версия отчёта — guap.pro/repos/maksim-eltratov/homemq2t