8000 GitHub - avpetkun/the-prime: A gamified reward system within Telegram Miniapp
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

avpetkun/the-prime

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ThePrime — Telegram Reward System

ThePrime is a gamified reward system built for Telegram. Users complete tasks to earn points and redeem them for digital goods like Telegram Stars or Telegram Premium, delivered via direct integration with Fragment.

All tasks are based on either TON transfers or advertiser-sponsored actions. The system is deeply integrated with the TON blockchain and optimized for performance and minimalism — both in backend logic and frontend load.


📐 UI & Flow

The full user flow and interface design are available in Figma and Notion:

⚙️ Tech Stack

  • Backend: Go v1.23.3
  • Frontend: Svelte + Webpack (via Yarn)
  • Database: PostgreSQL
  • Cache: Redis
  • Message Queue: NATS
  • CI/CD: GitLab
  • Deployment: Docker + Docker Compose

🧩 Architecture

ThePrime uses a microservice architecture consisting of:

  • api — Scalable HTTP API serving frontend and bot requests.
  • worker — Handles business logic: task verification, PostgreSQL access, and TON blockchain interactions. Scales via configurable goroutines.
  • webhook — Captures all webhook calls and pushes them into NATS to ensure reliable delivery across services.
  • support — Separate Telegram-based support service for user assistance.

🧠 Task Logic

All user-facing tasks are one of two types:

  • TON-based tasks — Blockchain operations such as sending TON, verifying wallet ownership, etc.
  • Advertiser tasks — Actions requested by sponsors (e.g. following channels, joining bots), verified asynchronously.

📄 Local launch

docker compose -f compose.local.yml up -d

export CONFIG=$(cat ../../config.local.api.yml)

🙏 Credits

Our amazing designer Anna Gordeeva:

  • ✉️ Email: by.anna1990@gmail.com
  • 💬 Telegram: @gordee_va

Full development (backend/frontend/deploy) by me:

  • ✉️ Email: avpetkun@gmail.com
  • 💬 Telegram: @avpetkun

About

A gamified reward system within Telegram Miniapp

Topics

Resources

License

Stars

Watchers

Forks

0