# 🚀 TG TOOLBOX — Setup Guide

## ফাইল লিস্ট
| ফাইল | কাজ |
|---|---|
| `config.php` | বট টোকেন, DB, লিমিট, AI key — সব সেটিংস |
| `install.sql` | ডাটাবেস স্কিমা (users, usage_logs, referrals) |
| `db.php` | ডাটাবেস কানেকশন + ইউজার/রেফারেল/লিমিট লজিক |
| `functions.php` | Telegram Bot API wrapper (sendMessage, sendPhoto, ইত্যাদি) |
| `keyboards.php` | সব ইনলাইন মেনু/বাটন |
| `tools.php` | প্রতিটা টুলের আসল লজিক (QR, image convert, AI, dev tools...) |
| `webhook.php` | মূল এন্ট্রি পয়েন্ট — Telegram এখানে POST করে |
| `set_webhook.php` | একবার ব্রাউজারে খুলে webhook সেট/চেক করার হেল্পার |

## ধাপে ধাপে সেটআপ

### ১. রিকোয়ারমেন্ট
- PHP **8.0+** (with `curl`, `gd`, `pdo_mysql` extensions)
- MySQL / MariaDB
- HTTPS ডোমেইন (Telegram webhook শুধু HTTPS এ কাজ করে)

### ২. ডাটাবেস বসাও
```bash
mysql -u root -p < install.sql
```
অথবা phpMyAdmin দিয়ে `install.sql` import করো।

### ৩. `config.php` এডিট করো
- `BOT_TOKEN` — BotFather থেকে নাও
- `BOT_USERNAME` — @ ছাড়া বটের ইউজারনেম
- `ADMIN_ID` — তোমার নিজের Telegram user ID
- `DB_HOST`, `DB_NAME`, `DB_USER`, `DB_PASS` — তোমার হোস্টিং এর ডাটাবেস তথ্য
- `AI_API_KEY` — (ঐচ্ছিক) AI টুলগুলো চালাতে OpenAI/Groq/অন্য যেকোনো OpenAI-compatible API key

### ৪. সব ফাইল সার্ভারে আপলোড করো
`webhook.php`, `set_webhook.php` সহ সব ফাইল একই ফোল্ডারে রাখো, যেমন:
`https://yourdomain.com/tgtoolbox/`

`temp/` ফোল্ডারে write পারমিশন দাও:
```bash
chmod 755 temp/
```

### ৫. Webhook সেট করো
ব্রাউজারে খোলো:
```
https://yourdomain.com/tgtoolbox/set_webhook.php?action=set
```
`"ok": true` দেখলে webhook সেট হয়ে গেছে। চেক করতে `?action=info` ব্যবহার করো।

### ৬. বট টেস্ট করো
Telegram এ গিয়ে বটকে `/start` পাঠাও — মেনু চলে আসবে।

---

## ✅ যা এই মুহূর্তে পুরোপুরি কাজ করে
- 👤 Telegram: My ID, Username→Link, Profile Card (GD দিয়ে জেনারেট করা ইমেজ)
- 📁 File: Image ↔ JPG/PNG/WebP, Image→PDF, Resize/Compress, File Info
- 🎨 Creator: QR Code, Stylish Text (৭টা unicode variant), Color/Gradient, Hashtag, AI Caption
- 🤖 AI: AI Chat, Rewrite, Translate, Summarize, Content Idea (AI_API_KEY লাগবে)
- 🧑‍💻 Dev: JSON Formatter, Base64, URL Encode/Decode, Timestamp Converter, Regex Tester
- ⭐ Favorites / 🕑 Recent (ব্যবহার অনুযায়ী অটো ট্র্যাক)
- 🎁 Referral System (৫ জনে ৭ দিন PRO, স্বয়ংক্রিয়)
- 👑 Free/PRO দৈনিক usage limit সিস্টেম

## 🧩 পরে যোগ করার মতো জিনিস (স্কোপ বাইরে রাখা হয়েছে)
- **Mini App Dashboard** (Telegram WebApp) — এটা একটা আলাদা ফ্রন্টএন্ড (HTML/CSS/JS) প্রজেক্ট, চাইলে আমি আলাদাভাবে বানিয়ে দিতে পারি।
- Payment gateway ইন্টিগ্রেশন (bKash/Nagad/Stripe) — এখন PRO ম্যানুয়ালি admin থেকে `grantPremium($userId, $days)` কল করে দেওয়া যায়, অথবা পেমেন্ট গেটওয়ে যোগ করতে হবে।
- Voice→Text, Audio extraction — Telegram থেকে ফাইল ডাউনলোড হয়ে যাবে, কিন্তু transcription এর জন্য একটা speech-to-text API (Whisper ইত্যাদি) লাগাতে হবে।
- Admin panel (broadcast, ব্যান, স্ট্যাটস) — চাইলে বলো, আলাদা `admin.php` বানিয়ে দিচ্ছি।

## 🔧 নতুন টুল যোগ করবে কীভাবে
1. `tools.php` এ একটা ফাংশন লেখো
2. `keyboards.php` এ সংশ্লিষ্ট মেনুতে বাটন যোগ করো (`callback_data => 'tool_xxx'`)
3. `webhook.php` এর `startTool()`-এ prompt যোগ করো (যদি ইনপুট লাগে) এবং `processToolInput()`-এ কেস যোগ করো