Грешный Котикsinnercode

Грешный Котик · full-stack разработчик · Python, TypeScript и Go sinnercode · full-stack developer · Python, TypeScript and Go

Бэкенд, фронтенд, интеграции и AI в одних руках Backend, frontend, integrations and AI in one pair of hands

Делаю веб-продукты целиком, от схемы базы данных до продакшена. Можно отдать мне продукт с нуля, подключить к проекту, который уже работает, или взять в свою команду.

I build web products end to end, from the database schema to production. Hand me a product from scratch, bring me onto one that's already live, or add me to your team.

Сбои продумываю заранее. Платёж, о котором Telegram сообщил дважды, две одновременные записи на один слот, отказ карты при продлении подписки: в проектах ниже это обработано и проверено тестами.

I plan for failure up front. A payment Telegram reports twice, two bookings of one slot at the same moment, a card declined at renewal: the projects below handle these, and tests check that they do.

в коммерческой разработке с 20196 PR приняты в aiogram и unstructured3 библиотеки на PyPIберу новые проекты

commercial work since 20196 PRs merged into aiogram and unstructured3 libraries on PyPItaking on new projects

Slotbook: расписание дня салона с записями, удержанием слота и блокировкой
Slotbook — онлайн-запись для салоновSlotbook, online booking for salons открыть демо ↗open the demo ↗

Открытый кодOpen source

Принятые PR и свои библиотекиMerged pull requests and my own libraries

PR в aiogram и unstructuredPull requests to aiogram and unstructured

  • aiogram #1954

    InlineKeyboardBuilder.as_markup() больше не теряет переданные параметры. Закрывает #1423

    InlineKeyboardBuilder.as_markup() no longer drops its options. Fixes #1423

  • aiogram #1956

    Необязательный tasks_shutdown_timeout: при остановке polling можно дождаться хендлеров, которые ещё работают. Закрывает #1955

    Opt-in tasks_shutdown_timeout, so polling shutdown can wait for running handlers. Fixes #1955

  • unstructured #4568

    translate_text() больше не повторяет первые 512 токенов в каждом фрагменте. Закрывает #3607

    translate_text() no longer repeats the first 512 tokens for every chunk. Fixes #3607

  • unstructured #4597

    partition_email() больше не падает на вложенных письмах (message/rfc822).

    partition_email() no longer fails on attached emails (message/rfc822).

  • unstructured #4599

    Файлы .markdown определяются как Markdown. Продолжение #3670

    .markdown files are detected as Markdown. Follow-up to #3670

  • unstructured #4602

    Отладочные слои partition_pdf() берут DPI и пароль PDF, переданные при разборе. Закрывает #3985

    partition_pdf() debug overlays now use the DPI and PDF password passed to partitioning. Fixes #3985

Библиотеки на PyPILibraries on PyPI

Все три под лицензией MIT, ставятся через pip, нужен Python 3.10 или новее.

All three are MIT licensed, install with pip and need Python 3.10 or newer.

Оплата в TelegramTelegram payments270 тестов270 tests

aiogram-stars 0.2.0

Оплата в Telegram Stars для ботов на aiogram 3, вынесена из платёжного кода Zernolist, который теперь работает на ней. От вас две функции: check решает, принимать ли платёж, on_paid выдаёт товар. Библиотека подписывает payload счёта, отвечает на pre-checkout в пределах 10 секунд, которые даёт Telegram, вызывает on_paid один раз на каждый платёж, а неудачные возвраты повторяет из outbox в базе.

Telegram Stars payments for aiogram 3 bots, extracted from Zernolist's payment code; Zernolist now runs on it. You write two functions: check decides whether to take a payment, on_paid hands over the goods. The library signs the invoice payload, answers pre-checkout within Telegram's 10-second deadline, calls on_paid once per charge and retries failed refunds from an outbox in the database.

Pythonaiogram 3SQLAlchemy 2PostgreSQLSQLite

Тесты не ходят в Telegram: Bot API в них поддельный, но его ответы разбирает сам aiogram.

The tests don't call Telegram: the Bot API is a fake, but aiogram itself parses its replies.

pip install aiogram-stars

Клиент API amoCRMamoCRM API client354 теста354 tests

aioamocrm 0.1.1

Асинхронный клиент API v4 amoCRM и Kommo. Берёт на себя OAuth2-токены, которые меняются при каждом обновлении, лимит 7 запросов в секунду, постраничные списки с фильтрами и разбор вебхуков. POST повторяется только с retry=True: ключей идемпотентности в amoCRM нет. Сделки, контакты, компании и задачи приходят моделями pydantic.

An async client for the amoCRM and Kommo API v4. It takes care of OAuth2 tokens that rotate on every refresh, the limit of 7 requests per second, paginated lists with filters and webhook parsing. A POST is resent only with retry=True, because amoCRM has no idempotency keys. Leads, contacts, companies and tasks come back as pydantic models.

Pythonhttpxpydantic 2OAuth2

Тесты идут на замоканном HTTP, не на живом аккаунте amoCRM. Форматы запросов и ответов сверены с официальным PHP SDK.

Tested on mocked HTTP, not a live amoCRM account. The request and response shapes are checked against amoCRM's official PHP SDK.

pip install aioamocrm

Клиент API МойСкладMoySklad API client643 теста643 tests

aiomoysklad 0.1.0

Асинхронный клиент JSON API 1.2 МойСклад, который держится в пределах лимитов API. Вес запроса зависит от вида токена, с учётом изменения с 1 декабря 2026 года. Одновременно выполняется не больше 5 запросов, на 429 запрос повторяется по заголовкам Lognex. Клиент останавливается сам, не доходя до автоматического отключения со стороны МойСклад. Есть постраничные списки, конструктор фильтров, отчёты об остатках, заказы покупателей и вебхуки с приёмником и проверкой работоспособности.

An async client for the MoySklad JSON API 1.2 that keeps to the API's limits. Request weights depend on the token kind, including the change on 1 December 2026. At most 5 requests are in flight at once, a 429 is retried using the Lognex headers, and the client stops before MoySklad's automatic cut-off. It covers pagination, a filter builder, stock reports, customer orders, and webhooks with a receiver and a health check.

PythonJSON API 1.2

Тесты идут на замоканном HTTP, не на живом аккаунте МойСклад.

Tested on mocked HTTP, not a live MoySklad account.

pip install aiomoysklad

ФорматыWays to work

Как можно со мной работатьHow we can work together

Цену называю после разговора о задаче: за проект — фиксированную, за долгую работу — ставку в час или в месяц.

I quote after we talk the task through: a fixed price for a project, an hourly or monthly rate for longer work.

  • Продукт с нуляA product from scratch

    MVP, SaaS, CRM, личный кабинет или внутренняя система. Проектирую данные и API, пишу бэкенд и интерфейс, настраиваю деплой и CI.

    An MVP, a SaaS, a CRM, a customer portal or an internal system. I design the data model and API, write the backend and the UI, and set up deployment and CI.

    фиксированная цена, оплата по этапамfixed price, paid by milestone

  • Разработчик в вашу командуA developer on your team

    Part-time или full-time по контракту. Работаю в вашем репозитории и трекере, беру задачи из бэклога, код проходит ваше ревью.

    Part-time or full-time on contract. I work in your repository and tracker, take tickets from the backlog, and my code goes through your review.

    ставка в час или в месяцhourly or monthly rate

  • Развитие продуктаOngoing development

    Продукт уже работает, и его нужно развивать: новые функции, интеграции, ускорение, исправление ошибок.

    The product is live and needs to keep moving: new features, integrations, speed-ups, bug fixes.

    почасово или помесячноhourly or monthly

  • Аудит и спасение проектаAudit and rescue

    Проект застрял или остался без разработчика. Разбираю код, говорю, что сломано и что опасно, потом чиню, покрываю тестами и довожу до релиза.

    The project is stuck or its developer is gone. I go through the code, tell you what's broken and what's risky, then fix it, add tests and get it to release.

    сначала аудит, потом оценкаaudit first, then an estimate

Небольшие задачи тоже беру: бота, интеграцию с CRM, парсер, отчёт или лендинг. Примеры — в проектах поменьше.

Smaller jobs are welcome too: a bot, a CRM integration, a scraper, a report or a landing page. See the smaller projects for examples.

Что умеюSkills

Что умею и где это видно в кодеWhat I do, and where to see it in the code

У каждой строки есть ссылка на конкретный файл или демо, где это сделано.

Every row links to the exact file or demo where it's done.

ПроектыProjects

Проекты, в которые можно заглянутьProjects you can look inside

Код заказчиков остаётся у них, поэтому здесь отдельные проекты на выдуманных данных. У каждого есть тесты и CI, весь код лежит на GitHub. Демо Zernolist, Slotbook и DocMind работают прямо в браузере, API в них замокан. У tg-paid-club демо в браузере нет: это бот, а его дашборд на смоделированных данных запускается локально.

Client code stays with clients, so these are standalone projects on made-up data. Each has tests and CI, and all the code is on GitHub. The Zernolist, Slotbook and DocMind demos run right in your browser with the API mocked. tg-paid-club has no browser demo: it's a bot, and its dashboard on simulated data runs locally.

tg-paid-club: дашборд владельца клуба с MRR, выручкой и оттоком. Данные смоделированы командой paidclub simulate, это не настоящий клуб
Смоделированные данные: 300 выдуманных участников за 120 днейSimulated data: 300 made-up members over 120 days
Платный клуб в TelegramPaid Telegram club506 тестов506 tests

tg-paid-club

Бот продаёт доступ в закрытый канал или группу по подписке: картой через ЮKassa с автопродлением или звёздами Telegram. Напоминает о продлении за 3 дня и за 1 день, повторяет неудачное списание через 1 и 3 дня льготного периода, потом удаляет из чата. Владельцу — /stats, выгрузка в CSV и дашборд с выручкой, MRR и оттоком.

A bot that sells access to a private channel or group by subscription: by card through YooKassa with auto-renewal, or with Telegram Stars. It reminds members 3 days and 1 day before a renewal, retries a failed charge 1 and 3 days into a grace period, then removes them from the chat. The owner gets /stats, CSV export and a dashboard with revenue, MRR and churn.

Как сделаноВ чат пускают только по заявке: ссылка одна, с creates_join_request, бот одобряет заявку, только если подписка даёт доступ, а вошедших в обход удаляет. Удаление — бан на 10 минут и сразу разбан, поэтому после новой оплаты та же ссылка снова работает. Сообщения идут через outbox с уникальным ключом, и одно напоминание не попадёт в очередь дважды.

How it worksMembers get in only through join requests: each chat has one link with creates_join_request, a request is approved only when the subscription gives access, and anyone who gets in another way is removed. Removal is a 10-minute ban and an immediate unban, so the same link works again once the person pays. Messages go through an outbox with a unique key, so one reminder can't be queued twice.

Pythonaiogram 3FastAPISQLAlchemy 2PostgreSQLDocker

Живого запуска и демо в браузере нет: дашборд со скриншота запускается локально через make demo, без Telegram и без денег. Автоплатежи в боевом магазине ЮKassa включает её менеджер; звёздами подписка только помесячная.

No live deployment and no browser demo: the dashboard in the screenshot runs locally with make demo, with no Telegram and no money. In a live YooKassa shop, a YooKassa manager turns autopayments on; Stars subscriptions are monthly only.

Zernolist: каталог, карточка товара и оплата в Telegram Stars
Telegram Mini App171 тест171 tests

Zernolist

Магазин кофе и чая внутри Telegram: каталог с поиском, промокоды, курьер или самовывоз, оплата в Telegram Stars или при получении. Заказы приходят админу в бот, статус он меняет кнопками под уведомлением.

A coffee and tea shop inside Telegram: a searchable catalog, promo codes, courier or pickup, payment with Telegram Stars or on receipt. Orders reach the admin in the bot, and the status changes with buttons under the notification.

Как сделаноЦену каждого заказа сервер считает сам по каталогу, поэтому подменить её из браузера не выйдет. Оплата звёздами идёт через aiogram-stars: если Telegram пришлёт уведомление об оплате дважды, заказ второй раз не проведётся.

How it worksThe server prices every order from the catalog itself, so nobody can change the price in the browser. Stars payments go through aiogram-stars: if Telegram sends the same payment update twice, the order goes through only once.

ReactViteaiogram 3aiogram-starsFastAPISQLAlchemy

Slotbook: расписание дня салона с записями, удержанием слота и блокировкой
Онлайн-запись, GoBooking, Go393 теста393 tests

Slotbook

Онлайн-запись для салонов и клиник. Клиент выбирает услугу, мастера и время, слот держится за ним 10 минут, пока он вводит контакты, а потом приходит ссылка, чтобы перенести или отменить визит. У сотрудников расписание дня, напоминания уходят в Telegram.

Online booking for salons and clinics. The customer picks a service, a specialist and a time, the slot is held for 10 minutes while they type their details, and then they get a link to reschedule or cancel. Staff get a day schedule, and reminders go out on Telegram.

Как сделаноДвойную запись запрещает сама база: ограничение EXCLUDE в PostgreSQL не даёт пересечься двум записям одного мастера, и из 20 одновременных попыток занять слот проходит одна. В дни перевода часов сетка времени остаётся верной, это проверяют 23 общих теста для Go и TypeScript.

How it worksThe database itself rules out double booking: an EXCLUDE constraint in PostgreSQL keeps two bookings of one specialist from overlapping, and of 20 simultaneous attempts to take a slot exactly one succeeds. The time grid stays right on DST change days, checked by 23 test vectors shared by Go and TypeScript.

GopgxPostgreSQLReactTypeScript

Откройте демо в двух вкладках и выберите одно и то же время: запись получит только одна вкладка.

Open the demo in two tabs and pick the same time in both: only one tab gets the booking.

DocMind: ответ со сносками на источники
AI, RAG139 тестов139 tests

DocMind

Ассистент, который отвечает по вашим документам: PDF, DOCX, страницам сайта. Ответ идёт потоком со сносками, клик по сноске открывает фрагмент источника. Есть веб-интерфейс и Telegram-бот.

An assistant that answers from your documents: PDF, DOCX, web pages. The answer streams in with citations, and clicking one opens the source passage. It has a web UI and a Telegram bot.

Как сделаноИсточники приходят по SSE раньше первого токена ответа, поэтому, когда в тексте появляется сноска [n], её карточка уже на экране.

How it worksSources arrive over SSE before the first answer token, so when a [n] citation appears in the text, its card is already on screen.

PythonFastAPIpgvectorClaude / OpenAI APIReact

В демо нет LLM: ответ собирается из найденных в документах предложений.

The demo has no LLM: answers are put together from sentences found in the documents.

Проекты поменьшеSmaller projects

  • Лендинг с калькуляторомLanding page with a calculator

    Смета дома по строкам, ссылка на расчёт, заявка в Telegram или на почту.

    A house estimate line by line, a shareable link to the calculation, leads to Telegram or e-mail.

    демо ↗demo ↗кодcode
  • Бот для заявокLead bot

    Анкета в 4 шага, карточка заявки менеджеру с кнопками статусов, выгрузка в CSV, рассылка.

    A 4-step form, a lead card for managers with status buttons, CSV export, broadcasts.

    кодcode
  • ПарсерScraper

    Ограничение запросов в секунду, повторы, кэш на диске; выгрузка в Excel, CSV, JSON и Google Sheets.

    A requests-per-second limit, retries, a disk cache; exports to Excel, CSV, JSON and Google Sheets.

    кодcode
  • Отчёт в ExcelExcel report

    Книги Excel из сырых CSV: дашборд с фильтрами и счёт с маржой, все итоги считают формулы.

    Excel workbooks built from raw CSVs: a dashboard with filters and an invoice with margin, every total is a formula.

    кодcode
  • Сценарии для n8nn8n workflows

    Заметки со встреч в Notion через Claude, ответы по документам на локальной LLM, утренняя сводка календарей. Проверены на тестовых данных, с живыми аккаунтами не запускались.

    Meeting notes to Notion through Claude, answers from documents on a local LLM, a morning calendar digest. Tested on sample data, not run against live accounts.

    кодcode

РазборыWrite-ups

Как устроены проекты, по строкам кодаHow the projects work, line by line

Тексты о том, как работают отдельные части проектов и библиотек выше. Я цитирую код со ссылками на строки в конкретном коммите и пишу, что покрывают тесты. Два из них — про ошибки, которые я нашёл у себя и исправил: в aiogram-stars перед первым релизом и в одновременных записях на один слот в Slotbook.

How specific parts of the projects and libraries above work. I quote the code with links to the exact lines at a fixed commit and say what the tests cover. Two are about bugs I found in my own code and fixed: in aiogram-stars before its first release, and in Slotbook's simultaneous bookings of one slot.

Как работаюProcess

Как проходит работаHow a project runs

  1. 01

    РазговорFirst talk

    Обсуждаем задачу, сроки и формат работы. Если код уже есть, смотрю его до оценки.

    We go over the task, the timeline and the format. If there's existing code, I look at it before estimating.

  2. 02

    ОценкаEstimate

    За проект — объём, срок и фиксированная цена, за долгую работу — ставка. Цена не меняется, пока не меняется объём.

    For a project: scope, timeline and a fixed price. For longer work: a rate. The price holds unless the scope changes.

  3. 03

    ЭтапыMilestones

    Большую задачу делю на этапы. Каждый заканчивается рабочей версией, которую можно открыть и проверить.

    Big jobs get split into milestones. Each one ends with a working build you can open and check.

  4. 04

    Код у васYour code

    С первого дня пишу в ваш репозиторий, с тестами и CI. Проект не привязан ко мне.

    From day one I commit to your repository, with tests and CI. The project isn't tied to me.

  5. 05

    ЗапускLaunch

    Деплой, README и инструкция по запуску. Дальше могу остаться на развитии и поддержке.

    Deployment, a README and run instructions. After that I can stay on for support and new features.

ВопросыFAQ

Что обычно спрашиваютWhat people usually ask

Не нашли ответ? Спросите напрямую в Telegram, там я отвечаю быстрее всего.

Didn't find your answer? Ask me on Telegram, that's where I reply fastest.

Спросить в Telegram ↗Ask on Telegram ↗
Беретесь за большие проекты?Do you take on large projects?

Да. Могу вести продукт один, от схемы базы до продакшена, или работать частью вашей команды. Большой проект делим на этапы, и каждый сдаётся рабочей версией, так что месяцами ждать результата не придётся.

Yes. I can build a product on my own, from the database schema to production, or work as part of your team. A big project is split into milestones, each delivered as a working build, so you never wait months to see results.

Сколько это стоит?How much does it cost?

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

It depends on the scope and the format. I estimate a project after we talk and fix the price before we start. For longer work or a spot on your team, I quote an hourly or monthly rate.

Как платить?How does payment work?

Проект с фиксированной ценой: 50% на старте и 50% после приёмки, большой — по этапам. Почасовая и помесячная работа оплачивается по ставке, периодичность договорим на старте.

A fixed-price project is 50% upfront and 50% on acceptance; a large one is paid by milestone. Hourly and monthly work is billed at the rate, on a schedule we agree at the start.

Можете разобраться в чужом коде?Can you take over someone else's code?

Да, это отдельный формат. Сначала читаю код и говорю, что в нём сломано и что опасно, потом оцениваю, сколько займёт исправление или доработка.

Yes, that's a format of its own. I read the code first and tell you what's broken and what's risky, then estimate the fix or the rest of the work.

Работаете с зарубежными заказчиками?Can we work in English?

Да. Общаться можем на русском или английском, у этой страницы и у README всех проектов есть английская версия.

Yes. We can talk in English or Russian, and this page and every project README have English versions.

Почему в портфолио демо, а не проекты клиентов?Why demos and not client projects?

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

I don't publish client code; it belongs to the clients. The open projects run on made-up data so you can open them, click around and read the code.

Как будем общаться?How do we keep in touch?

Первый разговор — в Telegram. Если работаю в вашей команде, подключаюсь к вашему мессенджеру и трекеру задач.

The first conversation is on Telegram. If I join your team, I use your messenger and your task tracker.

Расскажите о проектеTell me about your project

Готовое ТЗ не нужно: напишите, что строите, что уже есть и к какому сроку. Отвечу с вопросами и следующим шагом.

You don't need a written spec: tell me what you're building, what exists already and when you need it. I'll reply with questions and a next step.

Telegram · @sinnercode GitHub · sinnercode228
Написать в TelegramMessage me on Telegram