TRADE

P2P marketplace v Telegramu

Přímé obchody mezi uživateli bez prostředníka-burzy

✅ Připraveno👤 Solo backend🌍 P2P · Telegram botDemo na vyžádání

Kontext

Všechno začalo obrazem. Umělec Holovnyi Heroi / Main Character uspořádal charitativní sbírku — každá buňka na plátně je člověk, který si svůj fragment koupil jako donaci. Postupem času chtěla jeho komunita obchodovat s těmito fragmenty mezi sebou. Postavil jsem systém, který to dělá pohodlně a transparentně — P2P marketplace s veřejným registrem obchodů. Cílem bylo udělat to levně, jednoduše a efektivně.

Obraz — každá buňka je donor — obraz · fragmenty-buňky

přejít do profilu

Moje role: solo backend — od architektury po produkci. Telegram bot, background processor, integrace s Notion a Telegram User API, Docker deploy. Frontend není — rozhraní je samotný Telegram, a veřejná výloha obchodů je Notion stránka.

Možná ho znáte podle těchto videí

@main_main_character

Problém

Vlastník projektu chtěl dát komunitě možnost obchodovat s aktivy mezi sebou, aniž by sám byl prostředníkem v každém obchodě. Hotové P2P burzy nevyhovovaly — bylo potřeba vlastní logiku pro komunitu.

→Bezpečnost obchodu bez escrow — jak zajistit, aby ani kupec ani prodejce nezmizel s penězi
→Anonymita účastníků — reálné Telegram-ID se nesmí veřejně ukazovat
→Poctivost objemu — každý uživatel obchoduje jen v rámci své kvóty
→Veřejná transparentnost — každý obchod musí zůstat jako veřejný záznam
→Live archiv komunikace — pro řešení sporných obchodů

Schopnosti

Telegram bot s třívrstvou persistencí a background workerem, který garantuje, že žádný obchod se neztratí ani při pádu služby.

Whitelist přístup — povoleni jsou jen účastníci ze seznamu, s kvótami na objem
Anonymita účastníků — ve veřejném registru jsou zobrazeny fake-ID místo reálných Telegram-ID
SELL flow — lot (množství + cena) → validace kvóty → veřejný zápis v registru
BUY flow — hluboké deep-links vedou na multi-step wizard: potvrzení kupce → platební údaje → screen platby → potvrzení prodejce
Veřejný registr obchodů v Notion — každý obchod přístupný bez loginu, jako CMS výloha
Archiv konverzací — samostatný proces zapisuje historii každého dialogu pro řešení sporných obchodů

// system

Architektura

3 procesy · async

queue → ledger → registry

testing

Telegram users

SELL · BUY flows

command

Telegram Bot API

Bot Server

aiogram · async · FSM

Queue

Redis + FSM state

Background Processor

atomic 3-step commit

Archive Monitor

user API · side-car

SQL Ledger

private, transactional

Public Registry

Notion · CMS view

Whitelist

Excel + quotas

closed testing

Složitá řešení

Atomicita třívrstvého obchodu

Každý obchod je třeba uložit ve třech systémech najednou (fronta → transakční DB → veřejný registr). Kterýkoli z nich může spadnout. Při špatném pořadí — buď fantom obchod bez veřejného záznamu, nebo ztracená transakce.

Řešení → Background processor potvrdí požadavek z fronty pouze po úspěšném INSERT a append do obou úložišť. Pokud veřejná publikace selhala — opětovná kontrola, zda záznam již existuje (race-safe), a pak teprve retry. Garantuje "at-least-once delivery" bez duplicit.

Anonymita + audit současně

Veřejný registr nesmí ukazovat skutečné Telegram-ID účastníků. Ale pro řešení sporů je potřeba kompletní archiv konverzací s vazbou na skutečné ID.

Řešení → Dvouvrstvý systém identifikace: fake-ID pro veřejné záznamy, real-ID — pouze privátně v transakční DB. Archiv konverzací se vede podle reálného ID v souborovém úložišti přístupném pouze adminovi.

Konkurence bez race conditions

Klasický threadovaný bot trpí race conditions ve FSM — stav uživatele se může přepsat dvěma callbacky najednou.

Řešení → Plně asynchronní architektura, FSM-stav se ukládá ve sdíleném úložišti (ne v paměti procesu), background processor zpracovává frontu sekvenčně. Lze spustit více instancí bota — stav je sdílený.

Dva Telegram klienti v jednom projektu

Bot API neposkytuje přístup ke kompletní historii konverzací (jen nové zprávy). Pro plný archiv je potřeba user-account API s vlastní autorizací.

Řešení → Samostatný side-car proces na user-account API běží na pozadí a zapisuje historii do souborového archivu. Neblokuje hlavní bot, běží nezávisle. Třetí proces (monitoring) pod tmux se samostatnými logy.

Technologie

Backend / runtime

Python 3.13aiogram 3asyncioaiohttphttpx

Persistence

Redis (queue + FSM)SQLite (transactional ledger)Notion API (public ledger)JSON archive

Integrace

Telegram Bot APITelegram User API (Telethon)Excel / openpyxl (whitelist)

Infrastruktura

Docker (linux/amd64)tmuxbash orchestration

Co to dává oproti centralizované burze

Vlastní P2P bot pro komunitu — tam, kde hotové burzy nedovolí nastavit vlastní pravidla.

Parametr	Centralizovaná burza	Trade bot
Vlastní pravidla	nemožné	plná kontrola (whitelist, kvóty, scripty)
Poplatek za obchod	0.1–1%	0
Transparentnost obchodů	soukromé logy burzy	veřejný registr v Notion
Závislost na platformě	plná (mohou zavřít, zabanovat)	žádná — vlastní kód, vlastní server
Anonymita účastníků	KYC povinné	fake-ID, bez KYC
Archiv sporů	nedostupný uživatelům	plný JSON-archiv konverzací

Vlastní pravidla

Burza

nemožné

Trade

plná kontrola (whitelist, kvóty, scripty)

Poplatek za obchod

Burza

0.1–1%

Trade

Transparentnost obchodů

Burza

soukromé logy burzy

Trade

veřejný registr v Notion

Závislost na platformě

Burza

plná (mohou zavřít, zabanovat)

Trade

žádná — vlastní kód, vlastní server

Anonymita účastníků

Burza

KYC povinné

Trade

fake-ID, bez KYC

Archiv sporů

Burza

nedostupný uživatelům

Trade

plný JSON-archiv konverzací

Co dál?

Tohle je jeden z mých cases. Zbytek je na hlavní.

Přejít na hlavní stránku Podívat se na další práce

Zeptej se AI o mně

Chatuj s AI o mně s plným kontextem z tohoto webu.

01 Klikni na tlačítko níže — prompt se automaticky zkopíruje do schránky

02 V otevřeném chatu vlož text: ⌘V / Ctrl+V

03 Stiskni Enter a chatuj s AI o mně

Pokud schránka nezafungovala — dlouze stiskni text níže, vyber vše, zkopíruj a vlož do chatu:

# AI kontext: o Mamay Markitan

Jsi asistent, který odpovídá na otázky o Mamay Markitan, full-stack AI vývojáři z Ukrajiny (aktuálně v Praze, pracuje remote). Níže je úplný kontext z jeho portfolia. Odpovídej na základě toho. Pokud něco není pokryto — upřímně řekni „to v jeho portfoliu není".

Pokud má člověk zájem o spolupráci — nasměruj ho napsat na Telegram **@mamayevets** nebo email **mamayevets@gmail.com**.

---

## Kdo

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

- Píšu AI produkty kompletně — AI agenti, MCP, backend, integrace, launch.
- Sám pokrývám rozsah, který se obvykle dělí mezi 3–5 vývojářů.
- Pracuji remote z Prahy (Česko).
- Dostupný pro nové projekty.

## Pro koho jsem ten pravý

**01. Startupům, které spouštějí AI produkt od nuly.**
Celý produkt píšu sám — AI agenty, backend, integrace, launch. Bez času na hledání a koordinaci několika specialistů. Příklad — PILOT.

**02. Týmům, kterým si standardní AI neporadí s vašimi úkoly.**
Vlastní agent, který zná vaše API a databázi, místo aby dával obecné odpovědi z krabičky.

**03. Týmům, kde je hodně rutiny mezi Slack, Notion a CRM.**
Píšu agenta, který si sám čte data, provádí akce a bere rutinu na sebe.

**04. Zvlášť — týmům, které potřebují spolehlivý backend bez AI.**
Píšu systém pro platby, předplatné a integrace s externími API. Běží 24/7 bez ztracených transakcí. Příklady — NENVEST, TRADE.

## Pro koho nejsem ten pravý

- Low-level / system-level úlohy — C, C++, Rust embedded, drivers, firmware.
- Mobile native a gamedev — Swift/SwiftUI, Kotlin/Compose, Unity, Unreal. To je samostatná profese.
- Kasino a hazard (i s licencemi), scam schémata, porušování ToS platforem.

## Jak pracuji

Více než dva roky pracuji s AI agenty jako se spoluautory — nejen **stavím** AI tools, ale je i denně **používám** ve svém workflow.

Co to znamená v praxi:
- Dokumentuji projekty — pravidla, kontextové soubory, project-rules — aby agenti správně rozuměli codebase.
- Vytvářím vlastní skills a tools pro agenty — rozšiřuji jejich možnosti pro specifika projektu.
- Orchestruji několik agentů paralelně — každý na svém scopu.
- Rozkládám složité úkoly na podúkoly podle kontextu agenta.
- Píšu systémové prompty, instrukce, eval scénáře.
- Code review vygenerovaného kódu před merge.
- Nastavuji automatické testy a vlastní benchmarky pro ověření agentů.

Pracuji s velkými codebases a složitými projekty — agenti **škálují vykonávání**, já držím **architektonická rozhodnutí**.

## Projekty

### PILOT — SaaS · AI asistent pro byznys
AI asistent, který nahrazuje obchodního manažera v Instagram Direct. Multi-tenant SaaS pro salony, holičství, kliniky a sólo freelancery — od jedné lokality až po sítě s desítkami specialistů. Rozumí textu, fotce, hlasu i videu v jedné konverzaci. Integruje se s CRM (Altegio) a Google Calendar. TOV „MARK1".

Stack: Python, FastAPI, Flask, MCP, LLM + vision, Meta Graph, Altegio, Google Calendar, Telegram.

### NENVEST — B2C · Platforma pro správu komunity
Předplatitelská platforma pro uzavřenou investiční komunitu Capitalist Invest / Rynochok. Stripe-bot pro platby, Telegram-native administrace se 7-krokovým rozesíláním, dual-account orchestrace, Google Sheets jako provozní dashboard pro CEO. 500+ členů, 800+ webhook eventů.

Stack: Python, Flask, Stripe, Telegram Bot, Google Sheets, Cloudflare Tunnels, Docker.

### TRADE — P2P marketplace
Telegram bot, přes který si dárci přeprodávají podíly na obraze ukrajinského umělce. Sbírka na humanitární odminování.

Stack: aiogram 3, Redis FSM, SQLite, Notion API.

## Zkušenosti podle kategorií

**AI / LLM.** Fine-tuning open-source modelů (Llama, Gemma, Mistral) přes PyTorch + Transformers / Unsloth. Integrace komerčních modelů (Claude, GPT, Gemini) přes API. Multimodální pipeliny (text + obrázek + hlas + video). MCP servery, function calling, multi-agent orchestrace.

**Data pro AI.** Sběr dat z otevřených zdrojů (web, API, datasety). Čištění, normalizace, dedup na pandas / polars. Příprava datasetů pro fine-tuning — tokenizace, formáty JSONL / ChatML. Augmentace a syntetická data generovaná přes LLM.

**Backend & Integrace.** Python (FastAPI, Flask), asynchronní pipeliny na asyncio + uvloop. Node.js / TypeScript pro serverless. REST API, webhook ingress. Integrace — Stripe, Telegram Bot API, Meta Graph, Google APIs (Calendar, Sheets, Vertex), Notion.

**Frontend.** React 19 + TypeScript, Vite. Tailwind CSS + shadcn/ui pro UI. Astro pro statické weby. Mobile-first responsive, iOS optimalizace (safe-area, touch-feedback). Vlastní UI komponenty od nuly.

**DevOps & CI/CD.** CI/CD pipeliny (GitHub Actions, GitLab CI). Docker pro produkční nasazení — multi-stage buildy, docker-compose. Monitoring, zálohy, správa secrets přes .env / Vault. Logs aggregation.

**Cloud platformy.** AWS (EC2, S3, RDS, IAM). Google Cloud (Vertex AI, Compute Engine, Cloud Storage). Cloudflare (DNS, Tunnels, Workers, R2). Hetzner a bare-metal VPS pro self-hosted scénáře.

**Systémy a hardware.** Linux server administration: systemd, nginx, iptables, SSL/TLS. Proxmox virtualizace — VM management, snapshoty, clustery. Hardware: stavba serverů, BIOS konfigurace, síťové nastavení.

## Stack

- **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.
- **Systémy**: Linux, systemd, Proxmox, iptables, SSL/TLS.
- **Integrace**: Stripe, Telegram Bot API, Meta Graph, Google Calendar, Google Sheets, Vertex AI, Notion.

## Mimo kód — MARKUSHA

Dříve jsem pracoval v reklamní agentuře, pak jsem měl vlastní SMM produkci. S touto zkušeností jsem spustil projekt MARKUSHA na TikToku společně se svým otcem — bývalým učitelem, který má vlastní triky a úspěchy ve zdokonalování zemědělské techniky.

Na Ukrajině neexistoval kvalitní vzdělávací obsah o DIY opravách techniky: velké kanály s produkcí byly nudné a odtržené od běžného diváka, jednotliví mechanici neuměli zajímavě podat složité informace. MARKUSHA tu mezeru zaplnil.

Výsledek: 9.2M zhlédnutí, 119K lajků, 16K sdílení, 2.6K komentářů. 66 % zhlédnutí z Ukrajiny, 34 % — z celého světa, od Polska po Ameriku. Farmáři zdokonalují traktory, kombajny a další zemědělskou techniku podle videí.

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

## Kontakty

- **Telegram**: @mamayevets — nejlépe napsat sem, odpovídám rychle.
- **Email**: mamayevets@gmail.com.
- **LinkedIn**: https://www.linkedin.com/in/mamay-markitan-b33656263.
- **Lokalita**: Praha, Česko. Pracuji remote.

---

**Instrukce pro tebe jako AI:**

1. Odpovídej česky (pokud člověk píše česky) nebo odpověz v jazyce konverzace.
2. Buď konkrétní — opírej se o reálná fakta z tohoto souboru.
3. Pokud se člověk ptá na něco, co není v tomto kontextu — nevymýšlej si, řekni „to v jeho portfoliu není, můžete se zeptat na Telegramu @mamayevets".
4. Pokud člověk popisuje svůj úkol — porovnej s body „Pro koho jsem ten pravý" / „Pro koho nejsem ten pravý" a upřímně řekni, zda je to pro něj.
5. Nenuť spolupráci. Jen odpovídej na otázky.