# Repo Health: natsyapirogova/python-3lab

https://sourcecraft.dev/natsyapirogova/python-3lab

Статический сайт с использованием возможностей MkDocs и SourceCraft Sites / Лабораторная работа №3 в курсе "Программирование на Python"

| Показатель | Значение |
|---|---|
| **Repo Health Score** | **15.4 / 100** — Предварительная оценка: критическое состояние (данных недостаточно для уверенного вывода) |
| Охват данных | 17% (метрик с данными: 26.5%) |
| Основной язык | JavaScript |
| Последняя активность | 27.05.2026 |
| Дата анализа | 30.09.2026 12:39 UTC |
| Вид анализа | облегчённый (без клонирования) |
| Оценки сообщества | 0 реакций |
| Воспроизводимость | методика v1.6, снапшот `6e0bc428f982` |

> **Внимание.** Запуски CI недоступны: оценка по конфигурации и проверкам pull request

> **Внимание.** Малый охват данных: доступно меньше трёх категорий

## Оценки по категориям

| Категория | Оценка | Вес | Ключевой факт |
|---|---|---|---|
| Безопасность | **Нет данных** | 18% | нет прав SourceCraft на просмотр AppSec этого репозитория |
| Состояние кода и техдолг | **Нет данных** | 21% | облегчённый анализ: без сканирования кода |
| Активность проекта | **Нет данных** | 18% | облегчённый анализ: без git-истории |
| Документация и практики | 15.4/100 | 17% | Лицензия (распознанный SPDX): нет |
| CI/CD | **Нет данных** | 13% | запуски CI видны только участникам репозитория, а в merge-checks PR нет данных о workflow |
| Работа с issues | **Нет данных** | 13% | в репозитории нет issues |

**Как получен итог.** Score = (15.4×17) / 17 = 15.4. Охват данных 17% — доля веса категорий, по которым есть данные. Категории без данных (Безопасность, Состояние кода и техдолг, Активность проекта, CI/CD, Работа с issues) исключены из расчёта, их вес перераспределён.

## Слабые стороны

- **README: наличие, объём и ключевые разделы** — 25%
- **Лицензия (распознанный SPDX)** — нет
- **CONTRIBUTING, CODEOWNERS, CHANGELOG, SECURITY.md** — 0 из 4
- **Правила ревью и политики веток** — 0 из 2
- **Инструкция запуска и сборки** — нет

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

### 1. Дополнить README недостающими разделами

- **Приоритет:** Средний, трудоёмкость низкая, категория «Документация»
- **Проблема:** В README нет части ключевых разделов (установка, запуск, сборка, тесты, использование, лицензия).
- **Почему это важно:** Неполная документация увеличивает порог входа и число вопросов в issues.
- **Что сделать:** Добавьте недостающие разделы с командами в блоках кода.
- **Ожидаемый эффект:** +38.4 к Repo Health Score

- **Основание:** [files.readme](https://sourcecraft.dev/natsyapirogova/python-3lab/-/blob/main/README.md)

### 2. Добавить инструкцию запуска и сборки

- **Приоритет:** Средний, трудоёмкость низкая, категория «Документация»
- **Проблема:** Не найдены ни раздел запуска в README, ни Makefile/Dockerfile/compose.
- **Почему это важно:** Без воспроизводимого запуска проект сложно оценить и в него сложно вносить вклад.
- **Что сделать:** Добавьте раздел «Запуск» с командами или Makefile/docker-compose.
- **Ожидаемый эффект:** +15.4 к Repo Health Score

- **Основание:** [files.readme](https://sourcecraft.dev/natsyapirogova/python-3lab/-/blob/main/README.md)

### 3. Добавить файл LICENSE

- **Приоритет:** Низкий, трудоёмкость низкая, категория «Документация»
- **Проблема:** В репозитории нет лицензии.
- **Почему это важно:** Для открытого проекта явные условия использования упрощают повторное применение кода.
- **Что сделать:** Если хотите разрешить повторное использование кода, добавьте подходящую лицензию в корень репозитория.
- **Ожидаемый эффект:** +15.4 к Repo Health Score

- **Основание:** [files.license](https://sourcecraft.dev/natsyapirogova/python-3lab)

## Нет данных

Эти показатели не участвовали в расчёте и не подменялись нулями. Подтверждённое отсутствие компонента, например файла конфигурации CI, оценивается отдельно.

| Показатель | Почему нет данных |
|---|---|
| Открытые уязвимости, взвешенные по критичности | нет прав SourceCraft на просмотр AppSec этого репозитория |
| Доля исправленных findings за 90 дней | нет прав SourceCraft на просмотр AppSec этого репозитория |
| Открытые секреты в коде | нет прав SourceCraft на просмотр AppSec этого репозитория |
| Свежий скан безопасности (≤ 30 дней) | нет прав SourceCraft на просмотр AppSec этого репозитория |
| Плотность TODO/FIXME/HACK на 1000 строк кода | облегчённый анализ: без сканирования кода |
| Доля TODO старше 6 месяцев | облегчённый анализ: без сканирования кода |
| Тесты: наличие и доля тестового кода | облегчённый анализ: без сканирования кода |
| Зафиксированные зависимости (lockfile) при наличии манифеста | облегчённый анализ: без сканирования кода |
| Доля крупных и бинарных файлов | облегчённый анализ: без сканирования кода |
| Давность последнего осмысленного коммита | облегчённый анализ: без git-истории |
| Осмысленные коммиты за 90 дней | облегчённый анализ: без git-истории |
| Живые авторы за год (без ботов) | облегчённый анализ: без git-истории |
| Bus factor (авторов, покрывающих 50% коммитов за год) | облегчённый анализ: без git-истории |
| Влитые PR за 90 дней | облегчённый анализ: без git-истории |
| Разных авторов влитых PR за год | облегчённый анализ: без git-истории |
| Давность последнего релиза или тега | облегчённый анализ: без git-истории |
| Успешные прогоны среди последних 30 (с весом по свежести) | запуски CI видны только участникам репозитория, а в merge-checks PR нет данных о workflow |
| Последний прогон успешен | запуски CI видны только участникам репозитория, а в merge-checks PR нет данных о workflow |
| Нестабильность: чередование успех/провал | запуски CI видны только участникам репозитория, а в merge-checks PR нет данных о workflow |
| Медианная длительность прогона | запуски CI видны только участникам репозитория, а в merge-checks PR нет данных о workflow |
| Зависшие открытые issues (без обновления > 60 дней) | в репозитории нет issues |
| Медиана первого ответа или текущего ожидания | в репозитории нет issues |
| Медианное время закрытия (за 180 дней) | в репозитории нет issues |
| Закрытые / созданные за 90 дней | в репозитории нет issues |
| Использование меток, приоритетов, исполнителей | в репозитории нет issues |

## Как посчитана каждая категория

### Безопасность — нет данных (вес 18%)

нет прав SourceCraft на просмотр AppSec этого репозитория

| Метрика | Значение | Норм. | Вес | Вклад |
|---|---|---|---|---|
| Открытые уязвимости, взвешенные по критичности | нет данных | — | 5 | — |
| Доля исправленных findings за 90 дней | нет данных | — | 2 | — |
| Открытые секреты в коде | нет данных | — | 3 | — |
| Свежий скан безопасности (≤ 30 дней) | нет данных | — | 1 | — |

### Состояние кода и техдолг — нет данных (вес 21%)

облегчённый анализ: без сканирования кода

| Метрика | Значение | Норм. | Вес | Вклад |
|---|---|---|---|---|
| Плотность TODO/FIXME/HACK на 1000 строк кода | нет данных | — | 3 | — |
| Доля TODO старше 6 месяцев | нет данных | — | 2 | — |
| Тесты: наличие и доля тестового кода | нет данных | — | 3 | — |
| Зафиксированные зависимости (lockfile) при наличии манифеста | нет данных | — | 1 | — |
| Доля крупных и бинарных файлов | нет данных | — | 1 | — |
| Линтеры, форматтеры, editorconfig | 0 инструментов | 0% | 1 | — |

### Активность проекта — нет данных (вес 18%)

облегчённый анализ: без git-истории

| Метрика | Значение | Норм. | Вес | Вклад |
|---|---|---|---|---|
| Давность последнего осмысленного коммита | нет данных | — | 3 | — |
| Осмысленные коммиты за 90 дней | нет данных | — | 2 | — |
| Живые авторы за год (без ботов) | нет данных | — | 2 | — |
| Bus factor (авторов, покрывающих 50% коммитов за год) | нет данных | — | 2 | — |
| Влитые PR за 90 дней | нет данных | — | 1 | — |
| Разных авторов влитых PR за год | нет данных | — | 1 | — |
| Давность последнего релиза или тега | нет данных | — | 1 | — |

### Документация и практики — 15.4/100 (вес 17%)

| Метрика | Значение | Норм. | Вес | Вклад |
|---|---|---|---|---|
| README: наличие, объём и ключевые разделы | 25% | 25% | 4 | 7.69 |
| Лицензия (распознанный SPDX) | нет | 0% | 2 | 0.0 |
| CONTRIBUTING, CODEOWNERS, CHANGELOG, SECURITY.md | 0 из 4 | 0% | 2 | 0.0 |
| Описание репозитория заполнено в SourceCraft | да | 100% | 1 | 7.69 |
| Правила ревью и политики веток | 0 из 2 | 0% | 2 | 0.0 |
| Инструкция запуска и сборки | нет | 0% | 2 | 0.0 |

### CI/CD — нет данных (вес 13%)

запуски CI видны только участникам репозитория, а в merge-checks PR нет данных о workflow

| Метрика | Значение | Норм. | Вес | Вклад |
|---|---|---|---|---|
| Есть конфигурация CI (.sourcecraft/ci.yaml) | да | 100% | 3 | — |
| Успешные прогоны среди последних 30 (с весом по свежести) | нет данных | — | 4 | — |
| Последний прогон успешен | нет данных | — | 2 | — |
| Нестабильность: чередование успех/провал | нет данных | — | 2 | — |
| Медианная длительность прогона | нет данных | — | 1 | — |
| CI запускается на pull request | нет | 0% | 1 | — |

### Работа с issues — нет данных (вес 13%)

в репозитории нет issues

| Метрика | Значение | Норм. | Вес | Вклад |
|---|---|---|---|---|
| Зависшие открытые issues (без обновления > 60 дней) | нет данных | — | 3 | — |
| Медиана первого ответа или текущего ожидания | нет данных | — | 3 | — |
| Медианное время закрытия (за 180 дней) | нет данных | — | 2 | — |
| Закрытые / созданные за 90 дней | нет данных | — | 2 | — |
| Использование меток, приоритетов, исполнителей | нет данных | — | 1 | — |

## Подтверждающие факты

| Факт | Значение | Источник |
|---|---|---|
| `meta.description` | Статический сайт с использованием возможностей MkDocs и SourceCraft Sites / Лабораторная … | [meta](https://sourcecraft.dev/natsyapirogova/python-3lab) |
| `releases.count` | 0 | [releases](https://sourcecraft.dev/natsyapirogova/python-3lab/releases) |
| `tags.count` | 0 | [releases](https://sourcecraft.dev/natsyapirogova/python-3lab/tags) |
| `tree.files` | 153 | [tree](https://sourcecraft.dev/natsyapirogova/python-3lab) |
| `tree.sourcecraft_files` | ["ci.yaml", "sites.yaml"] | [tree](https://sourcecraft.dev/natsyapirogova/python-3lab/.sourcecraft) |
| `files.readme` | {"length": 497, "present": true, "sections": ["description"]} | [files](https://sourcecraft.dev/natsyapirogova/python-3lab/-/blob/main/README.md) |
| `files.license` | {"spdx": null, "present": false} | [files](https://sourcecraft.dev/natsyapirogova/python-3lab) |
| `files.ci_config` | да | [files](https://sourcecraft.dev/natsyapirogova/python-3lab/-/blob/main/.sourcecraft/ci.yaml) |
| `files.practices` | {"changelog": false, "codeowners": false, "security_md": false, "contributing": false, "b… | [files](https://sourcecraft.dev/natsyapirogova/python-3lab) |
| `files.dependencies` | {"unlocked": [], "lockfiles": [], "manifests": []} | [files](https://sourcecraft.dev/natsyapirogova/python-3lab) |
| `files.tooling` | {"linters": [], "editorconfig": false} | [files](https://sourcecraft.dev/natsyapirogova/python-3lab) |
| `metric.ci.pr_trigger` | {"result": false, "saved_inputs": {"config_triggers": {"count": 1, "sample": ["push"]}, "… | [Данные на дату анализа · CI/CD](https://sourcecraft.dev/natsyapirogova/python-3lab/cicd/runs) |
| `metric.docs.description` | {"result": true, "saved_inputs": {"description": "Статический сайт с использованием возмо… | [Данные на дату анализа · Описание проекта](https://sourcecraft.dev/natsyapirogova/python-3lab) |
| `metric.docs.run_instructions` | {"result": false, "saved_inputs": {"run_instructions": false, "inventory_complete": true}} | [Данные на дату анализа · Файлы](https://sourcecraft.dev/natsyapirogova/python-3lab/-/tree/main) |
| `metric.code.quality_tooling` | {"result": 0, "saved_inputs": {"linters": {"count": 0, "sample": []}, "editorconfig": fal… | [Данные на дату анализа · Файлы](https://sourcecraft.dev/natsyapirogova/python-3lab/-/tree/main) |

## Сбор данных

| Источник | Статус | Комментарий |
|---|---|---|
| Issues | нет таких данных | в репозитории нет issues |
| Pull requests | нет таких данных | в репозитории нет pull requests |
| CI/CD | нет доступа | запуски CI видны только участникам репозитория; учтены конфиг и merge-checks PR |
| Релизы и теги | нет таких данных | нет релизов и тегов |
| Дерево файлов | собрано |  |
| Ключевые файлы | собрано | raw |
| История git | нет таких данных | облегчённый анализ: без git-истории |
| Содержимое кода | нет таких данных | облегчённый анализ: без сканирования кода |
| AppSec SourceCraft | нет доступа | нет прав SourceCraft на просмотр AppSec этого репозитория |

## Динамика

| Дата | Score | Место в рейтинге |
|---|---|---|
| 30.09.2026 | 15.4 | — |
| 01.10.2026 | 15.4 | 7769 |

---

Отчёт сформирован сервисом SourceCraft Repo Health 01.10.2026 02:25 UTC.
Описание методики: `docs/methodology.md`.
