ptsytsagovorun/spb-building-report

A FastAPI-based service that ingests public building data, stores it in PostgreSQL, and generates analytical reports on structural wear and urban redevelopment risk with exportable JSON, HTML, and PDF outputs.

Python · рейтинг 0 · TOP 46% · 👍 0 · ❤️ 0 · 💎 0 · 0 форков · ссылка на SourceCraft

Дата анализа: 29.09.2026 22:55

Repo Health Score

Почему такой балл

Документация 0
- README · вес 37% · нет файла 0
- Лицензия · вес 25% · нет файла 0
- CONTRIBUTING и CODEOWNERS · вес 19% 0
- Структура и шаблоны · вес 19% 0
Активность 0
- Свежесть · вес 40% · 155,9 дн. назад 0
- Merge requests · вес 30% · 0 за 30 дней 0
- Релизы · вес 30% · 0 за 30 дней 0
Issues Нет данных
Состояние кода 52
- Тесты · вес 29% · не найдены 0
- Чистота репозитория · вес 24% · лишних файлов нет 100
- Структура кода · вес 16% · код разложен по каталогам 100
- Линтер · вес 16% · конфига нет 0
- Зависимости · вес 10% · манифест есть, lockfile нет 70
- TODO и FIXME · вес 5% · нет 100

Категории без данных не обнуляют итог: их вес перераспределяется между категориями, где балл есть.

Сильные и слабые стороны

Слабые: Документация: 0, Активность: 0, Issues: нет данных, Проект давно не проявлял активность, Не найдено тестов, Мало релизов за последние 30 дней, Мало merge requests за последние 30 дней, Отсутствует README

Сводка YandexGPT

Находки и рекомендации

Проект давно не проявлял активность Активность · критическая +13 к Score
Последняя известная активность была около 155 дней назад (источник: repository.last_updated).

Проверьте актуальность проекта, backlog и владельцев активных направлений.
Не найдено тестов Состояние кода · высокая +12 к Score
В дереве репозитория не обнаружено ни каталогов tests/test/spec, ни файлов с типовыми именами тестов.

Добавьте тесты хотя бы для критичной части кодовой базы и подключите их к CI.
Мало релизов за последние 30 дней Активность · высокая +10 к Score
Подметрика «Релизы» — 0 из 100. Полный балл — от 3 релизов за 30 дней.

Выпустите релиз или опишите, почему проект их не использует — балл считает отсутствие релизов недобором.
Мало merge requests за последние 30 дней Активность · высокая +10 к Score
Подметрика «Merge requests» — 0 из 100. Полный балл — от 10 merge requests.

Проверьте, что изменения проходят через merge requests, а не только прямыми коммитами.
Отсутствует README Документация · критическая +9 к Score
В корне репозитория не найден файл README. Это первое, что видит новый пользователь проекта.

Добавьте README.md с описанием проекта, быстрым стартом, инструкциями сборки и тестов.
Нет конфигурации линтера/форматтера Состояние кода · средняя +7 к Score
В репозитории не найдено конфигов известных линтеров/форматтеров (ESLint, Ruff/Flake8, Prettier, rustfmt и т.п.).

Подключите линтер и форматтер под используемый стек и зафиксируйте правила в конфиге.
Отсутствует лицензия Документация · высокая +6 к Score
В корне репозитория нет файла LICENSE/COPYING. Без лицензии использование проекта юридически неясно.

Добавьте LICENSE с выбранной лицензией (MIT, Apache-2.0, GPL и т.п.).
Нет CONTRIBUTING и CODEOWNERS Документация · средняя +5 к Score
Не найдены файлы CONTRIBUTING и CODEOWNERS — внешним контрибьюторам неясен процесс.

Добавьте CONTRIBUTING.md с процессом PR и CODEOWNERS для автоназначения ревьюеров.
Нет CHANGELOG и каталога docs/ Документация · средняя +5 к Score
Не найдены CHANGELOG и каталог docs/ — история изменений и подробная документация отсутствуют.

Заведите CHANGELOG.md и каталог docs/ для пользовательской и разработческой документации.
Нет lockfile Состояние кода · низкая +1 к Score
Манифест зависимостей есть, но lockfile не найден — версии зависимостей не зафиксированы.

Добавьте и закоммитьте lockfile (package-lock.json/poetry.lock/go.sum и т.п.) для воспроизводимых сборок.

История проверок

29.09.2026 22:55 — 22

Безопасность (AppSec) и CI/CD здесь не оцениваются: к ним есть доступ только по PAT владельца репозитория.