TG Shop Architect — Telegram E-Commerce Operator

TG Shop Architect is a production-grade Telegram e-commerce systems architect. Not tutorials. Not demo stores. Every code snippet, anti-pattern, and decision framework comes from real stores processing real payments with real customers.

There are 1,200+ listings on Claw Mart. TG Forge covers bot fundamentals — but nobody covers the e-commerce layer: the payment flow that silently double-charges customers, the cart expiration bug that oversells out-of-stock items, the callback_data overflow that ships wrong products, and the broadcast rate limit that gets your bot banned mid-promotion.

TG Shop Architect fills that gap. It knows:

• Telegram Stars (XTR) payment edge cases — refund windows, idempotency, pre_checkout validation
• Mini App catalog patterns — lazy loading, pagination, 1000+ products without lag
• Server-side cart with stock reservation and expiration
• Order state machines that prevent race conditions
• Admin panels with real-time stats and order management
• Rate-limited broadcast that won't get your bot banned

5 files included:

• SOUL.md — Core persona with 10 hard anti-patterns (each from a real production loss), 5-level decision framework, Telegram API hard numbers for e-commerce, and opinionated tech stack for small/medium/large stores.

• SKILL.md — 8 production skills with copy-paste code:

  1. Store Architecture & Database Schema (PostgreSQL)
  2. Telegram Stars Payment Flow (Full Cycle with idempotency)
  3. Mini App Catalog with Lazy Loading & Pagination
  4. Server-Side Cart with Stock Validation & Expiration
  5. Product Search (Full-Text Russian with PostgreSQL)
  6. Stars Refund Handler (with edge cases)
  7. Admin Panel (Order Management + Statistics)
  8. Broadcast & Notifications (Rate-Limited)

• REFERENCE_ARCHITECTURE.md — System architecture diagrams, payment flow sequence, order state machine, and deployment checklist.

• REFERENCE_ECOMMERCE_PATTERNS.md — Stars pricing strategy, catalog organization patterns, cart recovery, notification templates, loyalty system, referral system, and analytics events to track.

• LISTING_DESCRIPTION.md — This file (meta).

Who is this for?

• Developers building Telegram stores with Stars or fiat payments
• Agencies creating e-commerce bots for clients
• Entrepreneurs launching product sales through Telegram
• Anyone who's lost money to a payment bug they didn't see coming

What makes this different from TG Forge?

TG Forge covers bot operations in general. TG Shop Architect is specifically about selling things in Telegram — payments, catalogs, carts, orders, refunds, and the business logic that connects them. They complement each other.