# TOPBD — Bangladesh's Live Ranking & Outbid Marketplace

TOPBD is a production-grade live bidding leaderboard and outbid marketplace engineered specifically for Bangladesh. It enables brands, creators, startups, and influencers to claim and hold top promotional positions through real-time outbidding with native Bangladeshi payment gateways.

---

## 🌟 Key Features

- **Dynamic Outbid Leaderboard**: Instant rank sorting by verified bid amount with deterministic tie-breaking (most recent verified payment wins).
- **Claim #1 Hero Banner**: Displays live next minimum bid calculation (`Top Bid + ৳1`).
- **Bangladeshi Payment Gateways**: Built-in support for **bKash**, **Nagad**, **Rocket (DBBL)**, **SSLCommerz**, and **shurjoPay** with Sandbox test simulator and Live modes.
- **Heartbeat Active Visitors**: Real-time active visitor counter with automatic session cleanup.
- **Dynamic Category Filtering**: Categories with custom slug and icon support + "More" modal.
- **Interactive Metrics**: Live click tracker and heart toggle with session deduplication.
- **Full-Featured Admin Panel**:
  - Live revenue analytics and metric counters
  - Listings management (Edit, hide, delete, manual bid adjustments)
  - Category manager (CRUD + reordering)
  - Payment transactions ledger with IPN idempotency
  - Design & color customization with real-time CSS variable generation
  - Frontend texts editor
  - Navigation menu manager
  - Markdown pages editor (Rules, Terms, Privacy, Stats)
- **1-Click Web Installer**: Automated installation script for cPanel, Hostinger, Apache, and Nginx.

---

## 🚀 Quick Start (cPanel / Shared Hosting)

1. Upload contents to `public_html`.
2. Visit `https://yourdomain.com/installer.php`.
3. Follow the wizard to initialize the database and admin account.
4. Log in at `https://yourdomain.com/admin/login.php`.

For detailed setup instructions, read `HOSTINGER_CPANEL_GUIDE.md`.
