← К отчётуPDF-версия отчёта
В окне печати выберите «Сохранить как PDF» Repo Health · отчёт о здоровье репозитория6 ноя 2026sekal01/hackrnd2025
sourcecraft.dev/sekal01/hackrnd2025Обновлено 14 дней назадОценка по открытым данным
- Данные
- 4 категории из 6Security, CI/CD: видны только участникам. 24 из 24 метрик с данными
- Место в рейтинге
- 16 244–16 803 из 21 908
Есть серьёзные проблемы. Что тянет вниз: проект не обновлялся 361 день, Документация слабее остальных категорий.
Категории
| Категория | Вес | Оценка | Вывод |
|---|
| Security | 25% | — | нет данных |
| CI/CD | 20% | — | нет данных |
| Активность | 15% | 10 | 10/100: Последний коммит 2025-10-26, за 361 дн. до анализа |
| Документация | 15% | 0 | 0/100: Нет README или он пустой |
| Issues | 15% | 50 | 50/100 |
| Code health | 10% | 43 |
Что стоит улучшить
- Документация · нет README или он пустой
- Документация · README нет, полнота 0
- Активность · последний коммит 2025-10-26, за 361 дн. до анализа
- Активность · недель с коммитами за 90 дней: 0 из 13, доля самой плотной недели 0%
- Code health · TODO/FIXME на 1000 строк: 1,7 (8 на 4 616 строк)
- Code health · тестовых файлов: 0 на 48 исходных
Рекомендации
1. Возобновить развитие проекта
+6,5Активность 10 → 34Высокий приоритет· Активность
- Проблема
- Проект не обновлялся 361 день
- Почему важно
- Долгое отсутствие изменений — признак заброшенного проекта: уязвимости и баги не исправляются.
- Что сделать
- Обновите зависимости и документацию. Если проект закрыт, пометьте его архивным: оценка от этого не вырастет, но пользователи поймут его статус.
- Основание
- История коммитовПоследний коммит 2025-10-26
2. Разобрать TODO/FIXME
+6,3Code health 43 → 78Высокий приоритет· Code health
- Проблема
- Много TODO/FIXME: 1,7 на 1000 строк
- Почему важно
- Накопленные TODO/FIXME — отложенные исправления, которые мешают сопровождению кода.
- Что сделать
- Заведите по TODO/FIXME задачи в трекере, выполните или удалите неактуальные.
- Основание
- cli-for-sourcecraft/internal/api/client.go:446 · 361 день без изменений
| 43/100: TODO/FIXME на 1000 строк: 1,7 (8 на 4 616 строк) |
cli-for-sourcecraft/internal/api/client.go:537 · 361 день без изменений
cli-for-sourcecraft/internal/api/client.go:557 · 361 день без изменений
cli-for-sourcecraft/internal/api/client.go:648 · 361 день без изменений
cli-for-sourcecraft/internal/api/client.go:667 · 361 день без изменений
TODO: 8, FIXME: 0
Строк кода проверено: 4616
3. Добавить в README инструкцию локального запуска
+4,4Документация 0 → 16Высокий приоритет· Документация
- Проблема
- Нет инструкции локального запуска
- Почему важно
- Без неё новый участник тратит часы на то, чтобы просто запустить проект.
- Что сделать
- Добавьте в README раздел «Запуск» с командами установки зависимостей и старта.
- Основание
- В README и docs/ не найден раздел запуска или команда запуска
4. Добавить README
+2,2Документация 0 → 8Высокий приоритет· Документация
- Проблема
- В репозитории нет README
- Почему важно
- README — первое, что видит пользователь; без него непонятно, что это за проект и как им пользоваться.
- Что сделать
- Добавьте README.md: назначение проекта, установка, запуск, пример использования.
- Основание
- Файл README не найден в корне, docs/, .github/ и .sourcecraft/
5. Добавить лицензию
+2,2Документация 0 → 8Высокий приоритет· Документация
- Проблема
- Нет лицензии
- Почему важно
- Без лицензии код формально нельзя использовать и дорабатывать, это блокирует внешних пользователей.
- Что сделать
- Выберите лицензию (MIT, Apache-2.0 и т.п.) и добавьте файл LICENSE в корень.
- Основание
- Файл LICENSE/COPYING не найден в корне
6. Описать запуск тестов
+3,3Документация 0 → 12Средний приоритет· Документация
- Проблема
- Не описан запуск тестов
- Почему важно
- Воспроизводимая сборка и запуск тестов нужны, чтобы изменения проверялись одинаково у всех.
- Что сделать
- Опишите команды тестов в README или docs/.
- Основание
- Тесты: описание не найдено в README и docs/
7. Вести историю изменений
+3,3Документация 0 → 12Средний приоритет· Документация
- Проблема
- Нет changelog
- Почему важно
- Без истории изменений нельзя понять, что менялось между версиями.
- Что сделать
- Добавьте CHANGELOG.md или раздел «История изменений» в README.
- Основание
- CHANGELOG/CHANGES/HISTORY не найден, в README нет раздела Changelog
8. Пересмотреть старые TODO/FIXME
+2,3Code health 43 → 55Средний приоритет· Code health
- Проблема
- 8 TODO/FIXME старше 180 дней
- Почему важно
- Старые TODO обычно уже никто не выполнит: это технический долг, который только растёт.
- Что сделать
- Пересмотрите старые TODO/FIXME: превратите в задачи или удалите.
- Основание
- cli-for-sourcecraft/internal/api/client.go:446 · 361 день без измененийcli-for-sourcecraft/internal/api/client.go:537 · 361 день без измененийcli-for-sourcecraft/internal/api/client.go:557 · 361 день без измененийcli-for-sourcecraft/internal/api/client.go:648 · 361 день без измененийcli-for-sourcecraft/internal/api/client.go:667 · 361 день без измененийСтарых TODO/FIXME на 1000 строк: 1,73 (8 из 8 проверенных старше 180 дней)
9. Описать запуск сборки
+1,9Документация 0 → 7Средний приоритет· Документация
- Проблема
- Не описан запуск сборки
- Почему важно
- Воспроизводимая сборка и запуск тестов нужны, чтобы изменения проверялись одинаково у всех.
- Что сделать
- Опишите команды сборки в README или docs/.
- Основание
- Сборка: описание не найдено в README и docs/
10. Добавить тесты
+1,8Code health 43 → 53Средний приоритет· Code health
- Проблема
- В проекте нет тестов
- Почему важно
- Без тестов любое изменение может незаметно сломать поведение.
- Что сделать
- Покройте тестами ключевую логику и запускайте их в CI.
- Основание
- Тестовых файлов: 0 на 48 исходных
11. Выделить тесты в отдельный каталог
+1,4Документация 0 → 5Средний приоритет· Документация
- Проблема
- В структуре проекта нет каталога с тестами
- Почему важно
- По структуре репозитория сразу видно, где тесты и как их запускать; это основа для CI.
- Что сделать
- Добавьте тесты (каталог tests/ или файлы *_test / *.test) и опишите их запуск.
- Основание
- Каталоги верхнего уровня: cli-for-sourcecraft
12. Добавить CONTRIBUTING.md
+1,1Документация 0 → 4Низкий приоритет· Документация
- Проблема
- Нет CONTRIBUTING.md
- Почему важно
- CONTRIBUTING.md объясняет, как вносить изменения.
- Что сделать
- Добавьте CONTRIBUTING.md.
- Основание
- Файл CONTRIBUTING.md не найден
13. Добавить CODEOWNERS
+0,8Документация 0 → 3Низкий приоритет· Документация
- Проблема
- Нет CODEOWNERS
- Почему важно
- CODEOWNERS назначает ревьюеров на части кода.
- Что сделать
- Добавьте CODEOWNERS.
- Основание
- Файл CODEOWNERS не найден
14. Добавить SECURITY.md
+0,8Документация 0 → 3Низкий приоритет· Документация
- Проблема
- Нет SECURITY.md
- Почему важно
- SECURITY.md говорит, куда сообщать об уязвимостях.
- Что сделать
- Добавьте SECURITY.md.
- Основание
- Файл SECURITY.md не найден
Нет данных
Эти метрики не вошли в расчёт и не снизили оценку: веса перенормированы, охват метрик 100%.
- Security — в публичном рейтинге не учитывается: данные AppSec видны только участникам репозитория (доступно в анализе собственного репозитория по токену)
- CI/CD — в публичном рейтинге не учитывается: данные CI видны только участникам репозитория (доступно в анализе собственного репозитория по токену)
Как рассчитана оценка
В среднее вошли Активность, Документация, Issues, Code health. Security, CI/CD без данных: вес ушёл в собранные, ноля за них нет.
(15 * 10 + 15 * 0 + 15 * 50 + 10 * 43) / 55 = 24,2
Округлили до 24. Ограничение не сработало.
| Категория | Вес | Оценка | Вклад | Охват |
|---|
| Security | 25 | — | — | 0% |
| CI/CD | 20 | — | — | 0% |
| Активность | 15 | 10 | 1,54 | 100% |
| Документация | 15 | 0 | 0,00 | 100% |
| Issues | 15 | 50 | 7,50 | 100% |
| Code health | 10 | 43 | 4,28 | 100% |
| Оценка | 55 | | 24,2 | 100% |
Как считается оценка
Актуальная версия отчёта — guap.pro/repos/sekal01/hackrnd2025