Наводим порядок в AI Salebot перед публикацией

Проект AI Agents Salebot накопил хороший функционал — целых 17 модулей в исходном коде, интеграция с Claude API, работающие тесты. Но перед публикацией на GitLab нужно было всё привести в порядок. Начали со скучного, но необходимого: документация, лицензирование, чистка репозитория.

Лицензия и авторство

MIT, который стоял в README, — это пермиссивная лицензия. Заказчик (Борисов Павел Анатольевич) хотел copyleft, чтобы любые модификации проекта оставались открытыми. Выбрали GPL-3.0 — классическую copyleft-лицензию, которая это гарантирует. Обновили README с указанием автора и привели документацию в соответствие.

Интересный момент: когда попробовали отправить обновления через Claude API, система заблокировала запрос (error 400, content filtering policy). Пришлось работать с файлами напрямую через Python и Git.

Чистка проекта и .gitignore

94 файла, 29 708 строк кода — нужно было избавиться от мусора перед первым коммитом:

• data/ исключили — там БД и логи, которые не нужны в репозитории
• vosk-model-* — модели распознавания речи весят мегабайты, не место в Git
• docs/archive/ — внутренние записи о фиксах и экспериментах, чистая история разработки, нужна только разработчикам

Получился чистый .gitignore с исключениями для окружения (.env, env.example наоборот оставили как шаблон) и локальных артефактов.

Инициализация и первый коммит

git init --initial-branch=main --object-format=sha1

Хеш-функция SHA1 явно указали — для совместимости с GitLab и чистоты истории. Remote настроили на корпоративный GitLab (ai-agents/promotion-bot.git).

Первый коммит получился содержательный: 94 файла, от точки входа bot.py до полного дерева структуры. Коммит успешно создан с хешем 4ef013c.

Развёртывание

Push на сервер gitlab.dev.borisovai.ru не удался — DNS не резолвится, сервер недоступен на момент работы. Это временная задержка; когда GitLab станет доступен, команда просто выполнит:

git push --set-upstream origin main

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

Кстати, если VS Code работает — не трогай. Если не работает — тоже не трогай, станет хуже 😄