GitHub Repository Metrics Analyzer

👥 Участники

• Ilya_Sleptsov
• pul-stack
• nanashi

🔹 Роль

Student 2

выполнял у: Ilya_Sleptsov

🧠 Как выполнялась работа

• Инструменты: Python 3.10+, Django 4.2, DRF, pandas, numpy

• Модель:

  • Однофайловая реализация (
    main.py
    ) для упрощения развёртывания,
  • Виртуальный модуль для
    ROOT_URLCONF
    — совместимость с Colab/Jupyter,
  • wsgiref
    вместо
    runserver
    — обход
    SynchronousOnlyOperation
    ,
  • lru_cache
    для инвалидации кэша при изменении
    mtime
    файла.

• Соответствие спецификации:
  ✅

  /trending
  — возвращает Δstars, не
  stars
  
  ✅
  /languages
  —
  trending_languages
  ≠ топ по
  total_stars
  (расчёт по приросту за квартал)
  ✅
  /health/{repo}
  —
  health_score ∈ [0, 100]
  , нормировка через
  P95
  по языку
  ✅ Все ответы содержат
  meta.timestamp
  и
  meta.data_freshness
  
  ✅ Обработка
  language: null
  , дубликатов (
  max(updated_date)
  ),
  updated_date < created_date

📁 Структура репозитория

├── spec/
│ └── codex.md ← Спецификация по моему заданию
├── dev/
│ ├── solution.py ← Реализация задачи
│ └── repositories.json ← Входные данные
├── demo/
│ └── logs.txt ← Логи запросов
└── README.md ← Данный файл

⚙️ Как запустить

Требования

Шаги

1. Положите
   repositories.json
   в корень (см. пример в
   codex.md
   )
2. Запустите:

3. API будет доступно на:
   http://127.0.0.1:8000

Примеры запросов

📊 Примеры ответов (соответствуют ТЗ)

/languages

/health/microsoft/vscode

🙌 Работа выполнена в соответствии со спецификацией.
Все критерии приёмки (функциональность, формат, устойчивость, производительность) соблюдены.

---