# open-education-club-by-yandex/visualgenai

- Ссылка на площадке: https://sourcecraft.dev/open-education-club-by-yandex/visualgenai
- Пометки: зеркало (отсутствие политик веток и ревью не штрафуем: настроить их здесь нельзя)
- Дата снимка: 2026-10-08
- Дата выгрузки: 2026-10-09 09:27 UTC

## Балл

**45–65** (D–C — есть куда расти–неплохо), применимый вес 65%.

## Категории

| Категория | Вес (номинал / применён) | Состояние | Балл | Охват |
| --- | --- | --- | --- | --- |
| Документация и лучшие практики | 20 / 30,77 | частично | 36,33–64,11 | 72% |
| CI/CD | 15 / 23,08 | частично | 0–50 | 50% |
| Безопасность | 20 / 0 | нет данных | – | 0% |
| Активность проекта | 20 / 30,77 | оценено | 65,29 | 100% |
| Задачи | 15 / 0 | нет данных | – | 0% |
| Здоровье кода | 10 / 15,38 | оценено | 87,1 | 100% |

## Сильные стороны

- **последний коммит** (Активность проекта): набрано 5,13 из 5,13
- **коммиты за год** (Активность проекта): набрано 5,13 из 5,13
- **активность по неделям** (Активность проекта): набрано 5,13 из 5,13
- **Dockerfile** (Документация и лучшие практики): набрано 3,42 из 3,42
- **доля коротких сообщений коммитов** (Документация и лучшие практики): набрано 1,61 из 1,71

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

- **добавьте конфигурацию CI SourceCraft (.sourcecraft/ci.yaml); внешний CI сервис не видит** [критично] (CI/CD) — конфигурация CI SourceCraft, может вернуть до +11,54 (сборка и проверки воспроизводимы у того, кто берёт код)
- **опубликуйте релиз или проставьте тег версии** [критично] (Активность проекта) — последний релиз, может вернуть до +5,13 (сборка и проверки воспроизводимы у того, кто берёт код)
- **делитесь работой с другими участниками** [средне] (Активность проекта) — доля коммитов автора-лидера, может вернуть до +4,53 (работа не держится на одном человеке)
- **добавьте раздел быстрого старта в README** [средне] (Документация и лучшие практики) — README, может вернуть до +4,1 (новый человек поймёт, как запустить проект и куда смотреть)
- **добавьте файл лицензии** [средне] (Документация и лучшие практики) — файл лицензии, может вернуть до +3,42 (условия использования названы, а не угадываются)
- **добавьте файл блокировки зависимостей** [средне] (Документация и лучшие практики) — файл блокировки зависимостей, может вернуть до +3,42 (сборка и проверки воспроизводимы у того, кто берёт код)
- **разберите пометки TODO/FIXME в коде** [по желанию] (Здоровье кода) — плотность пометок TODO/FIXME, может вернуть до +1,98 (код можно развивать: помеченный долг не копится)
- **привлеките второго сопровождающего** [по желанию] (Активность проекта) — уникальные авторы, может вернуть до +1,03 (работа не держится на одном человеке)
- **пишите содержательные сообщения коммитов** [по желанию] (Документация и лучшие практики) — доля коротких сообщений коммитов, может вернуть до +0,1 (изменение проходит проверку, а история читается)

## Не удалось измерить — ширина интервала

Это не штраф: нижняя граница балла считает метрику нулём, верхняя — полной.

- **Документация и лучшие практики** — частично
  - каталог тестов: до −3,42 — площадка отдала неполные данные — значение узнать не вышло
  - каталог документации: до −3,42 — площадка отдала неполные данные — значение узнать не вышло
  - инструкция для контрибьюторов: до −1,71 — площадка отдала неполные данные — значение узнать не вышло
- **CI/CD** — частично
  - прогоны CI: до −11,54 — доступ к источнику закрыт

## В балл не входит и почему

- **Безопасность** — нет данных
  - основание не сохранено: измерять было нечего либо причина в снимок не записана
- **Задачи** — нет данных
  - основание не сохранено: измерять было нечего либо причина в снимок не записана
