b1gggu5nr0n073cr47lk/monjaro-faq-alisa-bot

🚗 AI Community Helper (на примере Geely Monjaro) О проекте Открытый фреймворк для создания интеллектуальных Telegram-ботов для автомобильных сообществ. Проект решает проблему хаотичного поиска технической информации в перегруженных клубных чатах. Бот использует YandexGPT для анализа естественных запросов пользователей (в том числе "своими словами") и предоставления точных выжимок из официальных сервисных мануалов и проверенного опыта комьюнити. На данный момент архитектура успешно обкатывается на базе знаний клуба Geely Monjaro (@Monjaro_FAQ_Bot), но благодаря Open Source лицензии система может быть развернута для абсолютно любого автоклуба за 15 минут. 🛠 Технологический стек * Язык: Python 3.10+ * LLM Интеграция: Yandex Foundation Models (YandexGPT API) * Инфраструктура: Yandex Cloud (развертывание и CI/CD через SourceCraft Pipelines) 🎯 Вектор развития (Поддержка Yandex Open Source) Средства гранта будут направлены на качественный скачок проекта: * Внедрение векторной БД (RAG): Переход от статических ответов к интеллектуальному семантическому поиску по загруженным PDF-мануалам (схемы предохранителей, регламенты ТО, артикулы запчастей). * Голосовой ассистент водителя: Оплата мощностей облака для интеграции Yandex SpeechKit. Водитель сможет задавать вопросы за рулем голосом и получать озвученный ответ от YandexGPT. * No-Code развертывание: Разработка скриптов автоматического деплоя, чтобы модераторы других автоклубов могли запускать свои копии бота без глубоких знаний программирования.

язык не указан · рейтинг 0 · 👍 0 · ❤️ 0 · 💎 0 · 0 форков · ссылка на SourceCraft

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

Repo Health Score

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

Документация 31
- README · вес 30% · 1542 символов 71
- Лицензия · вес 20% · нет файла 0
- Локальный запуск · вес 10% 0
- Сборка и тесты · вес 10% 100
- CONTRIBUTING и CODEOWNERS · вес 15% 0
- Структура и шаблоны · вес 15% 0
Активность 0
- Свежесть · вес 40% · 205,6 дн. назад 0
- Merge requests · вес 30% · 0 за 30 дней 0
- Релизы · вес 30% · 0 за 30 дней 0
Issues Нет данных
Состояние кода 50
- Тесты · вес 32% · не найдены 0
- Чистота репозитория · вес 27% · лишних файлов нет 100
- Структура кода · вес 18% · код разложен по каталогам 100
- Линтер · вес 18% · конфига нет 0
- TODO и FIXME · вес 5% · нет 100

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

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

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

Сводка YandexGPT

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

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

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

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

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

Проверьте, что изменения проходят через merge requests, а не только прямыми коммитами.
Нет конфигурации линтера/форматтера Состояние кода · средняя +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/ для пользовательской и разработческой документации.
Нет инструкции локального запуска Документация · высокая +3 к Score
В README нет явного блока про установку и запуск проекта локально.

Добавьте раздел Quick Start: зависимости, установка, запуск, типовые команды.
README неполный Документация · средняя +3 к Score
README есть, но «README» — 71 из 100: не хватает объёма или раздела о структуре.

Допишите README: зачем проект и из чего состоит репозиторий.

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

29.09.2026 22:56 — 28

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