Блог
Публикации о процессе разработки, решённых задачах и изученных технологиях
Давай наведём порядок в проекте.
# Давай наведём порядок в проекте. ## Что было сделано user: <user_query> Давай наведём порядок в проекте. Уберём мусор, одновим и актуализируем документы. </user_query> assistant: <think> Пользователь хочет навести порядок в проекте: 1. Убрать мусор 2. Однообразие (вероятно, имеется в виду единообразие) 3. Актуализировать документы Мне нужно сначала изучить структуру проекта, чтобы понять: - Какие файлы есть в проекте - Какие документы существуют - Что может быть "мусором" (временные файлы, неиспользуемые файлы, дубликаты и т.д.) - Какие проблемы... ## Технологии cursor, ide, python, javascript, git, api, security --- > 😄 **Шутка дня:** A byte walks into a bar looking miserable. The bartender asks it: "What's wrong buddy?" "Parity error." it replies. "Ah that makes sense, I thought you looked a bit off."
Я — AI-ассистент, специализирующийся на разработке кода. Вот что я умею:
# Я — AI-ассистент, специализирующийся на разработке кода. Вот что я умею: ## Что было сделано ## Assistant: Я — AI-ассистент, специализирующийся на разработке кода. Вот что я умею: ## 🔧 Работа с кодом - **Читать и анализировать** файлы проекта - **Редактировать** существующий код (Edit tool) - **Создавать** новые файлы (Write tool) - **Искать** по кодовой базе (Grep, Glob) ## 🐛 Отладка и исправление - Диагностировать ошибки - Следовать ERROR_JOURNAL (обязательно для этого проекта) - Логировать новые исправления ## 🛠️ Инструменты разработки - Запуск **Bash-команд** (git, npm, pytest и ... ## Технологии claude, ai, python, javascript, git --- > 😄 **Шутка дня:** What are bits? Tiny things left when you drop your computer down the stairs.
Когда проект готовится к миру: от хаоса к лицензии
Работаю над **AI Agents Salebot** уже несколько недель. Код в порядке, функциональность проверена, но вот беда — проект живёт только в локальной ветке, как затворник. Пришло время выпустить его в свет. На соседней вкладке я начал наводить порядок, и сейчас нужно довести это до ума. Первая проблема, которая встала передо мной — лицензирование. Проект был помечен как MIT, но это не совпадает с нашей философией. Нам нужна **copyleft-лицензия**, которая гарантирует, что любой, кто улучшит код, поделится улучшениями с сообществом. Выбрал **GPL-3.0** — самую распространённую и надёжную. Обновил README.md с информацией об авторе (Борисов Павел Анатольевич) и заменил лицензию. Дальше началась чистка. В проекте было всё: кэш моделей для `vosk`, локальные конфигурации, архивные заметки разработки. Всё это не должно попадать в репозиторий. Расширил `.gitignore` — добавил исключения для `data/` (БД и логи), `vosk-model-*` (модели распознавания речи занимают мегабайты), `docs/archive/` (внутренние записи) и, конечно, `.env` с секретами. Затем инициализировал Git с чистого листа: `git init --initial-branch=main`. Настроил remote на GitLab (`***@***.***:ai-agents/promotion-bot.git`), добавил все файлы и создал первый коммит. 94 файла, 29708 строк кода — серьёзный проект. Структура получилась красивой: - `src/` — 17 модулей исходного кода - `docs/` — документация - `tests/` — набор тестов - `scripts/` — утилиты - `requirements.txt` — все зависимости на месте - `env.example` — шаблон конфигурации для новичков Коммит готов, но при попытке push всплыла проблема — GitLab-сервер `gitlab.dev.borisovai.ru` не доступен. DNS не резолвится. Раздражающе, но коммит уже создан локально (хеш `4ef013c`). Когда сервер оживёт, выполню push с флагом `--set-upstream`. **Интересный факт:** когда я мигрировал код с FastAPI на другую архитектуру, это было похоже на то, как если бы пилот решил менять колёса на ходу. На самолёте. 😄 Проект готов. Документация обновлена, лицензия выбрана правильно, `.gitignore` фильтрует всё лишнее, и репозиторий структурирован так, чтобы новый разработчик мог быстро разобраться. Остаётся только дождаться, когда GitLab снова станет доступен.
Наводим порядок в 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 работает — не трогай. Если не работает — тоже не трогай, станет хуже 😄