NENVEST

Stripe payment bot + Telegram-native admin

Підпискова платформа для закритої інвестиційної спільноти Capitalist Invest / Риночок

👤 Solo full-stack🌍 SubTech / Wealth-tech✅ ProductionDemo on request

Контекст

Capitalist Invest / Риночок — закрита інвестиційна спільнота за платну підписку: щоденна аналітика ринків, тижневі research-звіти, 8 тематичних каналів (акції, облігації, волатильність, крипта, макро, commodity, research, портфель), live-чат. 500+ учасників, партнерство з медіа «Останній Капіталіст».

Я побудував дві системи, які працюють разом: Stripe Payment Bot — Telegram-фронтенд для оплати підписок (єдина точка взаємодії з користувачем), і Admin Panel — Telegram-native адмінку для команди (промо, тарифи, бродкасти, міграції).

Моя роль: solo full-stack — від архітектури до прода. Stripe-bot, Telegram-native адмінка, webhook-pipeline, operational dashboard у Google Sheets, Docker-деплой і Cloudflare Tunnels. До цього я керував digital-спільнотою близько 1000 людей — вручну робив розсилки, комунікацію з клієнтами, повторні платежі, додавання і видалення учасників. Ці знання та досвід дозволили мені побудувати комплексну платформу для автоматичного управління учасниками.

Що з цього вийшло

Дві системи, які працюють разом: Stripe-бот для користувачів і адмінка для команди.

Підписка через Telegram-бот: користувач обирає тариф → платить → потрапляє у закритий чат і канал
Скасування / поновлення підписки прямо в Telegram, автоматичне видалення при простроченні
Адмін-панель у Telegram: промо-коди, зміна цін, міграція підписок при зміні тарифу
Розумні розсилки: фільтри по тарифу та статусу, тестовий режим з прев'ю до відправки, HTML-форматування, звіт по доставці
Канали: Telegram + Email
Стан підписок у Google Sheets з формулами — статус, дати, дії рахуються автоматично, CEO бачить картину очима без SQL

// system

Архітектура

2 окремі сервіси

user-facing + team-facing

01 — user-facing

Stripe Payment Bot

live

Користувач (Telegram)

/subscribe · /cancel · /status

command

Stripe Payment Link

+ metadata: telegram_id, product_id

Webhook Receiver

Flask · :3001 · idempotent (event.json)

Schedulers

warning · delete

Event Transmitter

routing per event type

Bot Notifier

success · failed · expiring

Stripe

DUAL accounts

Google Sheets

state machine

Closed Chat

invite / kick

02 — team-facing

Admin Panel

live

Адмін / команда

whitelist Telegram-ID

inline keyboard

Cloudflare Tunnel

no public IP needed

Admin Bot

Flask · :3003 · 7-step state machine

JSON store

atomic writes

Promo

CRUD

Pricing

change · sync

Mass-sender

filter · test · send

Migration

2-step pipeline

Stripe API

subs · prices

Google Sheets

read-only sync

Bot API

broadcast

production

Технічна інформація

Структура, інфраструктура і процеси розробки.

Stripe-domain depth

Повний lifecycle підписки: Payment Links з metadata-routing, Subscription Schedules для price-migrations без шкоди для активних, webhook idempotency з 30-day TTL event-registry (захист від ретраїв і подвійних нарахувань), failed-payment escalation з retry-логікою.

Reliability & atomicity

Атомарна 3-стадійна обробка webhook-події: підтвердження фіксується ТІЛЬКИ після успіху всіх кроків. Mutex-protected JSON-storage з atomic writes (tempfile → rename) замість окремої БД — обґрунтовано обʼємом команди, працює рік без інцидентів.

Multi-process orchestration

Паралельні async-процеси (бот, webhook receiver, API server, Telegram monitor, warning/delete checkers) під tmux, з окремими логами. Координація через Stripe events + спільний Sheets — без оркестратора типу Celery чи Kubernetes.

CI/CD + observability

GitLab pipelines: lint → tests (Pytest з mock Stripe через recorded fixtures) → build → deploy. Daily log rotation, structured logs per-process. Cloudflare Tunnel для webhook ingress без публічного IP.

Pragmatic architecture

JSON-файли замість БД, Google Sheets замість окремого dashboard, in-memory FSM з atomic snapshots замість Redis. Кожне рішення обґрунтоване розміром команди і обʼємами — overkill'у нема, ремонтопридатність максимальна.

Hot-reload & zero-downtime

Configs (тарифи, whitelist, промо) перечитуються через mtime-tracking — зміна без рестарту бота. Rolling-деплой через Docker: новий контейнер піднімається поряд, трафік перемикається, старий зупиняється — нуль розривів активних оплат.

Технології

Backend / runtime

Python 3.11+Flask 3.1pyTelegramBotAPI 4.27python-telegram-bot 22Telethon 1.24asynciomulti-process orchestration

Payments

Stripe 12.2dual-account orchestrationSubscription SchedulesPayment Linkswebhook idempotency

Persistence / data

JSON files (atomic writes)Google Sheets (gspread 6.2).env confighot-reloadable configs

Інтеграції

Telegram Bot APIStripe APIGoogle Sheets APIEmail (SMTP)

Інфраструктура

DockerCloudflare Tunnelsshell-orchestrationdaily log rotationEurope/Kyiv TZ

Що далі?

Це один з моїх кейсів. Решта зібрана на головній.

Перейти на головний екран Подивитись інші кейси

Спитай AI про мене

Поспілкуйся з AI про мене на основі повного контексту з сайту.

01 Натисни кнопку нижче — промт автоматично скопіюється у буфер обміну

02 У відкритому чаті встав текст: ⌘V / Ctrl+V

03 Натисни Enter і поспілкуйся з AI про мене

Не вийшло автоматично — довгий тап на текст нижче, виділи все, скопіюй і встав у чаті:

# Контекст для AI: про Mamay Markitan

Ти — асистент, що відповідає на запитання про Mamay Markitan, full-stack AI-розробника з України (зараз у Празі, працює remote). Нижче — повний контекст з його портфоліо. Відповідай на основі цього. Якщо щось не покрито — чесно скажи "цього немає в його портфоліо".

Якщо людина зацікавлена у співпраці — направ її написати у Telegram **@mamayevets** або email **mamayevets@gmail.com**.

---

## Хто

**Mamay Markitan** — Full-Stack AI Engineer.

- Пишу AI-продукти повністю — AI-агенти, MCP, бекенд, інтеграції, запуск.
- Сам закриваю обсяг, який зазвичай ділять між 3-5 розробниками.
- Працюю remote з Праги (Чехія).
- Доступний для нових проєктів.

## Кому підходжу

**01. Стартапам, що запускають AI-продукт з нуля.**
Пишу весь продукт сам — AI-агенти, бекенд, інтеграції, запуск. Без часу на пошук і координацію кількох спеціалістів. Приклад — PILOT.

**02. Командам, де стандартні AI не справляються з вашими задачами.**
Кастомний агент, який знає ваш API і базу, а не дає загальні відповіді з коробки.

**03. Командам, де багато рутини між Slack, Notion і CRM.**
Пишу агента, який сам читає дані, виконує дії і бере рутину на себе.

**04. Окремо — командам, де треба надійний бекенд без AI.**
Пишу систему для платежів, підписок та інтеграцій із зовнішніми API. Крутиться 24/7 без втрачених транзакцій. Приклади — NENVEST, TRADE.

## Кому я не підходжу

- Низькорівневі / system-level задачі — C, C++, Rust embedded, drivers, firmware.
- Mobile native і gamedev — Swift/SwiftUI, Kotlin/Compose, Unity, Unreal. Це окрема професія.
- Казино і гамблінг (навіть з ліцензіями), scam-схеми, порушення ToS платформ.

## Як я працюю

Більше двох років працюю з AI-агентами як зі співавторами — не тільки **будую** AI-tools, а й щоденно **користуюсь** ними у власному workflow.

Що це означає на практиці:
- Документую проєкти — правила, контекст-файли, project-rules — щоб агенти правильно розуміли codebase.
- Створюю кастомні skills і tools для агентів — розширюю їх можливості під специфіку проєкту.
- Оркеструю кілька агентів паралельно — кожен на своєму скоупі.
- Розбиваю складні задачі на підзадачі під контекст агента.
- Пишу системні промпти, інструкції, eval-сценарії.
- Code-review згенерованого коду перед merge.
- Налаштовую автоматичні тести і власні бенчмарки для перевірки агентів.

Працюю з великими кодовими базами і складними проєктами — агенти **масштабують виконання**, я тримаю **архітектурні рішення**.

## Проєкти

### PILOT — SaaS · AI-асистент для бізнесу
AI-асистент, що замінює менеджера у продажах в Instagram-Direct. Multi-tenant SaaS для салонів, барбершопів, клінік і соло-фрілансерів — від однієї точки до мережі з десятками майстрів. Розуміє текст, фото, голос і відео в одному діалозі. Інтегрується з CRM (Altegio) і Google Calendar. ТОВ "МАРК1".

Стек: Python, FastAPI, Flask, MCP, LLM + vision, Meta Graph, Altegio, Google Calendar, Telegram.

### NENVEST — B2C · Платформа для управління спільнотою
Підпискова платформа для закритої інвестиційної спільноти Capitalist Invest / Риночок. Stripe-bot для платежів, Telegram-native адмінка з 7-кроковим бродкастом, dual-account orchestration, Google Sheets як operational dashboard для CEO. 500+ учасників, 800+ webhook events.

Стек: Python, Flask, Stripe, Telegram Bot, Google Sheets, Cloudflare Tunnels, Docker.

### TRADE — P2P marketplace
Telegram-бот, через який донори перепродають один одному частки картини українського художника. Збір на гуманітарне розмінування.

Стек: aiogram 3, Redis FSM, SQLite, Notion API.

## Досвід по категоріям

**AI / LLM.** Fine-tuning open-source моделей (Llama, Gemma, Mistral) через PyTorch + Transformers / Unsloth. Інтеграція commercial моделей (Claude, GPT, Gemini) через API. Multimodal-pipelines (text + image + voice + video). MCP-сервери, function calling, multi-agent оркестрація.

**Дані для AI.** Збір даних з відкритих джерел (web, API, datasets). Очистка, нормалізація, dedup на pandas / polars. Підготовка датасетів під fine-tuning — токенізація, формати JSONL / ChatML. Augmentation і synthetic data generation через LLM.

**Backend & Інтеграції.** Python (FastAPI, Flask), асинхронні pipelines на asyncio + uvloop. Node.js / TypeScript для serverless. REST API, webhook-ingress. Інтеграції — Stripe, Telegram Bot API, Meta Graph, Google APIs (Calendar, Sheets, Vertex), Notion.

**Frontend.** React 19 + TypeScript, Vite. Tailwind CSS + shadcn/ui для UI. Astro для статичних сайтів. Mobile-first responsive, iOS-оптимізація (safe-area, touch-feedback). Кастомні UI-компоненти з нуля.

**DevOps & CI/CD.** CI/CD pipelines (GitHub Actions, GitLab CI). Docker для production-deployments — multi-stage builds, docker-compose. Моніторинг, бекапи, secret-management через .env / Vault. Logs aggregation.

**Cloud platforms.** AWS (EC2, S3, RDS, IAM). Google Cloud (Vertex AI, Compute Engine, Cloud Storage). Cloudflare (DNS, Tunnels, Workers, R2). Hetzner і bare-metal VPS для self-hosted сценаріїв.

**Системи та залізо.** Linux server administration: systemd, nginx, iptables, SSL/TLS. Proxmox virtualization — VM management, snapshots, кластери. Hardware: збірка серверів, BIOS-конфіги, мережеві налаштування.

## Стек

- **AI / LLM**: MCP Protocol, Claude, GPT, Gemini, Llama, Vision models, Function calling, Fine-tuning, Multi-agent, PyTorch, Transformers, Unsloth.
- **Backend**: Python, FastAPI, Flask, Node.js, TypeScript, asyncio + uvloop, PostgreSQL, Redis, SQLite.
- **Frontend**: React 19, TypeScript, Vite, Astro, Tailwind 4, shadcn/ui.
- **DevOps & Cloud**: Docker, GitHub Actions, GitLab CI, Nginx, Cloudflare, AWS, GCP, Hetzner, VPS.
- **Системи**: Linux, systemd, Proxmox, iptables, SSL/TLS.
- **Інтеграції**: Stripe, Telegram Bot API, Meta Graph, Google Calendar, Google Sheets, Vertex AI, Notion.

## Поза кодом — MARKUSHA

Раніше працював у рекламній агенції, потім мав власний SMM-продакшн. З цим досвідом запустив проєкт MARKUSHA на TikTok разом зі своїм батьком — колишнім вчителем, який має фішки і досягнення в покращенні сільськогосподарської техніки.

В Україні не було якісного освітнього контенту про DIY-ремонт техніки: великі канали з продакшеном — нудне і відірване від простого глядача, поодинокі майстри — не вміли цікаво подати складну інформацію. MARKUSHA закрив цю дірку.

Результат: 9.2M переглядів, 119K лайків, 16K поширень, 2.6K коментарів. 66% переглядів з України, 34% — з усього світу, від Польщі до Америки. Фермери удосконалюють трактори, комбайни та інше агрообладнання за відео.

TikTok: https://www.tiktok.com/@markushavlad

## Контакти

- **Telegram**: @mamayevets — найкраще написати тут, відповідаю швидко.
- **Email**: mamayevets@gmail.com.
- **LinkedIn**: https://www.linkedin.com/in/mamay-markitan-b33656263.
- **Локація**: Прага, Чехія. Працюю remote.

---

**Інструкції для тебе як AI:**

1. Відповідай українською (якщо людина пише українською) або відповіддю мовою співрозмовника.
2. Будь конкретним — спирайся на реальні факти з цього файлу.
3. Якщо людина запитує щось, чого немає у цьому контексті — не вигадуй, скажи "цього у його портфоліо немає, можна уточнити в Telegram @mamayevets".
4. Якщо людина описує свою задачу — порівняй з пунктами "Кому підходжу" / "Кому я не підходжу" і чесно скажи, чи це для нього.
5. Не нав'язуй співпрацю. Просто відповідай на питання.