diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000..d3b742d --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,47 @@ +--- +name: Bug Report ๐Ÿ› +about: Report a bug to help us improve +title: '[BUG] ' +labels: bug +assignees: '' +--- + +## ๐Ÿ› Bug Description + +A clear and concise description of what the bug is. + +## ๐Ÿ“‹ Steps to Reproduce + +1. Go to '...' +2. Click on '....' +3. Scroll down to '....' +4. See error + +## โœ… Expected Behavior + +A clear and concise description of what you expected to happen. + +## โŒ Actual Behavior + +A clear and concise description of what actually happened. + +## ๐Ÿ“ธ Screenshots + +If applicable, add screenshots to help explain your problem. + +## ๐Ÿ–ฅ๏ธ Environment + +- OS: [e.g. Ubuntu 22.04] +- Python Version: [e.g. 3.11] +- Docker Version: [e.g. 24.0.0] +- Bot Version: [e.g. v1.0.0] + +## ๐Ÿ“ Additional Context + +Add any other context about the problem here. + +## ๐Ÿ”’ License Information + +- Customer ID: [e.g. M0001] +- License Status: [Valid/Expired] +- Expiration Date: [e.g. 2025-02-17] diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000..def3217 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,43 @@ +--- +name: Feature Request ๐Ÿ’ก +about: Suggest an idea for this project +title: '[FEATURE] ' +labels: enhancement +assignees: '' +--- + +## ๐Ÿ’ก Feature Description + +A clear and concise description of the feature you'd like to see. + +## ๐ŸŽฏ Problem Statement + +Is your feature request related to a problem? Please describe. +Example: I'm always frustrated when [...] + +## ๐Ÿ’ญ Proposed Solution + +A clear and concise description of what you want to happen. + +## ๐Ÿ”„ Alternatives Considered + +A clear and concise description of any alternative solutions or features you've considered. + +## ๐Ÿ“Š Use Case + +Describe the use case for this feature. Who would benefit from it? + +## ๐Ÿ“ธ Mockups/Examples + +If applicable, add mockups or examples to help explain your feature. + +## ๐Ÿ“ Additional Context + +Add any other context or screenshots about the feature request here. + +## ๐Ÿ’ฐ Willingness to Pay + +Would you be willing to sponsor this feature? +- [ ] Yes, I'd like to discuss pricing +- [ ] No, but I think it would be valuable +- [ ] Not sure diff --git a/.github/ISSUE_TEMPLATE/question.md b/.github/ISSUE_TEMPLATE/question.md new file mode 100644 index 0000000..52ec7d3 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/question.md @@ -0,0 +1,37 @@ +--- +name: Question โ“ +about: Ask a question about the project +title: '[QUESTION] ' +labels: question +assignees: '' +--- + +## โ“ Question + +A clear and concise question. + +## ๐Ÿ“‹ Context + +Provide any relevant context or background information. + +## ๐Ÿ” What I've Tried + +Describe what you've already tried to solve this issue. + +## ๐Ÿ“š Documentation Checked + +- [ ] I've read the README +- [ ] I've checked the FAQ +- [ ] I've searched existing issues +- [ ] I've checked the documentation + +## ๐Ÿ–ฅ๏ธ Environment (if relevant) + +- OS: [e.g. Ubuntu 22.04] +- Python Version: [e.g. 3.11] +- Docker Version: [e.g. 24.0.0] +- Bot Version: [e.g. v1.0.0] + +## ๐Ÿ“ Additional Information + +Any other information that might be helpful. diff --git a/README.en.md b/README.en.md new file mode 100644 index 0000000..046b569 --- /dev/null +++ b/README.en.md @@ -0,0 +1,358 @@ +# ๐Ÿค– Fakabot - Professional Telegram Auto-Delivery Bot + +[![GitHub release](https://img.shields.io/github/v/release/GUGEGEBAIDU/fakabot?style=flat-square)](https://github.com/GUGEGEBAIDU/fakabot/releases) +[![GitHub stars](https://img.shields.io/github/stars/GUGEGEBAIDU/fakabot?style=flat-square)](https://github.com/GUGEGEBAIDU/fakabot/stargazers) +[![GitHub forks](https://img.shields.io/github/forks/GUGEGEBAIDU/fakabot?style=flat-square)](https://github.com/GUGEGEBAIDU/fakabot/network) +[![GitHub issues](https://img.shields.io/github/issues/GUGEGEBAIDU/fakabot?style=flat-square)](https://github.com/GUGEGEBAIDU/fakabot/issues) +[![License](https://img.shields.io/badge/license-Commercial-blue.svg?style=flat-square)]() +[![Python](https://img.shields.io/badge/python-3.11-blue.svg?style=flat-square)]() +[![Telegram](https://img.shields.io/badge/Telegram-Bot-blue.svg?style=flat-square)](https://t.me/sonhshu) +[![Docker](https://img.shields.io/badge/docker-ready-blue.svg?style=flat-square)]() + +
+ +### ๐Ÿš€ Automated Delivery System | Multiple Payment Methods | Redis High-Performance Cache + +๐Ÿ’ณ Alipay ยท WeChat ยท USDT | ๐Ÿณ Docker One-Click Deploy | โšก 100x Performance Boost + +**Use Cases**: Digital Products ยท Online Courses ยท Software Licenses ยท Memberships + +๐ŸŽฌ [Live Demo](https://t.me/fakawan_bot) ยท ๐Ÿ“ฑ [Contact](https://t.me/sonhshu) ยท ๐Ÿ“– [Documentation](#-quick-start) + +[ไธญๆ–‡ๆ–‡ๆกฃ](README.md) | English + +
+ +--- + +## โš ๏ธ Important Notice + +This project requires a **license key** to run. The code includes a built-in authorization system that cannot be bypassed. + +- โœ… License keys use signature verification and cannot be forged +- โœ… Automatic reminder 7 days before expiration +- โœ… Automatic stop after expiration +- โœ… Support remote renewal without redeployment + +--- + +## โœจ Core Features + +### ๐Ÿ’ณ Payment System + +Supports **4 mainstream payment methods**: + +| Payment Method | Features | Settlement Speed | +|----------------|----------|------------------| +| **Alipay** | Face-to-face payment, QR code | Real-time | +| **WeChat Pay** | Native payment, QR code | Real-time | +| **USDT (TOKEN188)** | TRC20/ERC20, on-chain verification | 1-3 minutes | +| **USDT (Lemon Pay)** | Multi-chain support, low fees | Seconds | + +**Features**: +- โœ… Automatic payment confirmation ยท โœ… Payment callback handling ยท โœ… Order status sync ยท โœ… Payment timeout handling + +### ๐ŸŽฏ Auto-Delivery System + +**Delivery Methods**: +- ๐Ÿ“ Text content (activation codes, accounts, etc.) +- ๐Ÿ”— Download links (files, resources, etc.) +- ๐Ÿ‘ฅ Group invitations (Telegram groups, channels) + +**Features**: +- โšก Instant delivery after payment +- ๐Ÿ”„ Automatic retry on failure +- ๐Ÿ“Š Delivery record tracking +- ๐Ÿ”’ One-time invitation links (auto-revoke after use) + +### โšก Performance Optimization + +**Redis Cache System**: +- ๐Ÿ’พ Product info cache (5 min) +- โš™๏ธ Config cache (10 min) +- ๐Ÿ‘ค User session cache (1 hour) +- ๐Ÿ“ˆ 100x performance improvement + +**Rate Limiting**: +- ๐Ÿ›ก๏ธ User payment limit (5 times/5 min) +- ๐Ÿšซ IP callback limit (100 times/min) +- โฑ๏ธ User command limit (20 times/min) + +### ๐Ÿ“Š Order Management + +**Admin Features**: +- ๐Ÿ“‹ Order list (all, pending, completed, failed) +- ๐Ÿ” Order search (by ID, user, product) +- ๐Ÿ“ˆ Sales statistics (daily, weekly, monthly) +- ๐Ÿ’ฐ Revenue statistics (by product, by payment method) +- ๐Ÿ“Š Data export (CSV, Excel) + +### ๐Ÿ‘ฅ User Management + +**User System**: +- ๐Ÿ‘ค User profiles (ID, username, registration time) +- ๐Ÿ“Š Purchase history (order count, total amount) +- ๐Ÿท๏ธ User tags (VIP, blacklist, etc.) +- ๐Ÿ“ User notes (remarks, special instructions) + +### ๐Ÿ›๏ธ Product Management + +**Product Features**: +- โž• Add/edit/delete products +- ๐Ÿ“ฆ Inventory management (auto-deduct, low stock alert) +- ๐Ÿ’ฐ Price management (original price, sale price) +- ๐ŸŽจ Product display (name, description, image) +- ๐Ÿ“Š Sales statistics (sales count, revenue) + +### ๐ŸŽจ Admin Panel + +**Management Interface**: +- ๐Ÿ“Š Dashboard (today's orders, revenue, users) +- ๐Ÿ“ˆ Data charts (sales trends, revenue trends) +- โš™๏ธ System settings (payment config, notification config) +- ๐Ÿ”” Message notifications (new orders, payment success) + +--- + +## ๐Ÿš€ Quick Start + +### ๐ŸŽ‰ First-Time Setup + +> ๐Ÿ’ก **For**: First-time deployment after purchasing license + +#### Step 1: Clone Project + +```bash +git clone https://github.com/GUGEGEBAIDU/fakabot.git +cd fakabot +``` + +#### Step 2: Configure + +```bash +# Copy config example +cp config.json.example config.json + +# Edit config +vim config.json +``` + +**Required fields**: + +```json +{ + "BOT_TOKEN": "Your Bot Token", // Get from @BotFather + "ADMIN_ID": 123456789, // Your Telegram ID (from @userinfobot) + "DOMAIN": "https://yourdomain.com", // Optional + "PAYMENTS": { + // Payment configuration + } +} +``` + +**Get Bot Token**: +1. Find [@BotFather](https://t.me/BotFather) +2. Send `/newbot` +3. Follow prompts to create bot +4. Get Token + +**Get Admin ID**: +1. Find [@userinfobot](https://t.me/userinfobot) +2. Send any message +3. Get your ID + +#### Step 3: Save License Key (Important!) + +```bash +# Paste your complete license key +echo "your_license_key" > license.key + +# Example: +echo "M0001|1738310400|abc123def456..." > license.key +``` + +**Notes**: +- โœ… License key must be complete, no extra spaces or newlines +- โœ… Filename must be `license.key` +- โœ… File location in project root directory + +#### Step 4: Start Service + +```bash +# Start with Docker Compose +docker-compose up -d +``` + +#### Step 5: Verify + +```bash +# Check logs +docker-compose logs -f + +# Should see: +# ============================================================ +# โœ… License verified +# ๐Ÿ“ Customer ID: M0001 +# ๐Ÿ“… Expiration: 2025-02-17 +# โฐ Days remaining: 30 days +# ============================================================ +``` + +#### Step 6: Test Bot + +Search for your bot on Telegram, send `/start` + +**If you see welcome message, deployment successful!** ๐ŸŽ‰ + +--- + +### ๐Ÿ”„ Renewal Guide + +> ๐Ÿ’ก **For**: License expiring or expired, need renewal + +**Important: Renewal only requires replacing license key, all data will be preserved!** โœ… + +#### Step 1: Contact for Renewal + +Contact [@sonhshu](https://t.me/sonhshu), choose renewal plan: + +| Plan | Price | Discount | +|------|-------|----------| +| Monthly | 50 USDT | - | +| Quarterly | 135 USDT | 10% | +| Yearly | 510 USDT | 15% | + +#### Step 2: Get New License + +After payment, you'll receive a file: `renewal_license_M0001_xxx.txt` + +File content example: +``` +Customer ID: M0001 +New License: M0001|1740902400|def456... +Renewal Period: 30 days +New Expiration: 2025-03-19 +``` + +#### Step 3: SSH to Server + +```bash +ssh root@your_server_ip +``` + +#### Step 4: Navigate to Project + +```bash +cd fakabot +``` + +#### Step 5: Replace License + +```bash +# Method 1: Direct input +echo "new_license_key" > license.key + +# Example: +echo "M0001|1740902400|def456..." > license.key + +# Method 2: Use editor +vim license.key +# Delete old license, paste new license, save and exit +``` + +#### Step 6: Restart Service + +```bash +docker-compose restart +``` + +#### Step 7: Verify Renewal + +```bash +# Check logs +docker-compose logs -f + +# Should see: +# ============================================================ +# โœ… License verified +# ๐Ÿ“ Customer ID: M0001 +# ๐Ÿ“… Expiration: 2025-03-19 โ† New expiration date +# โฐ Days remaining: 30 days +# ============================================================ +``` + +**If you see new expiration date, renewal successful!** ๐ŸŽ‰ + +#### โœ… Data Preservation After Renewal + +**All data preserved**: +- โœ… All product configurations +- โœ… All order records +- โœ… All customer data +- โœ… config.json settings +- โœ… Database files + +**No need to reconfigure anything!** โœ… + +--- + +## ๐Ÿ’ฐ Subscription Pricing + +### Purchase Options + +| Plan | Duration | Price | Discount | Best For | +|------|----------|-------|----------|----------| +| **Monthly** | 30 days | 50 USDT | - | Trial users | +| **Quarterly** | 90 days | 135 USDT | 10% off | Regular users | +| **Yearly** | 365 days | 510 USDT | 15% off | Long-term users | + +### How to Purchase + +1. **Contact Customer Service** + - Telegram: [@sonhshu](https://t.me/sonhshu) + - Provide your requirements + +2. **Make Payment** + - USDT (TRC20): `TDZM5DSSq8SrB8QTSBHyNwrcTswtCjKs9t` + - Provide transaction hash + +3. **Receive License** + - Get license key file within 5 minutes + - Includes complete deployment guide + +4. **Deploy and Use** + - Follow documentation to deploy + - Start earning immediately + +--- + +## ๐Ÿ“ž Contact Us + +### Customer Service + +- **Telegram**: [@sonhshu](https://t.me/sonhshu) +- **Demo Bot**: [@fakawan_bot](https://t.me/fakawan_bot) +- **Response Time**: 24/7 online + +### Technical Support + +- **GitHub Issues**: [Submit Issue](https://github.com/GUGEGEBAIDU/fakabot/issues) +- **Documentation**: [Complete Documentation](https://github.com/GUGEGEBAIDU/fakabot#readme) + +--- + +## ๐Ÿ“„ License + +This project is a commercial software and requires a license key to run. + +**Copyright ยฉ 2025 Fakabot Team. All rights reserved.** + +--- + +
+ +Made with โค๏ธ by Fakabot Team + +[Get Started](#-quick-start) ยท [View Demo](https://t.me/fakawan_bot) ยท [Contact](https://t.me/sonhshu) + +
diff --git a/README.md b/README.md index ce9eb8c..d7800d9 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,13 @@ # ๐Ÿค– Fakabot - ไธ“ไธš็š„ Telegram ่‡ชๅŠจๅ‘ๅกๆœบๅ™จไบบ -[![License](https://img.shields.io/badge/license-Commercial-blue.svg)]() -[![Python](https://img.shields.io/badge/python-3.11-blue.svg)]() -[![Telegram](https://img.shields.io/badge/Telegram-Bot-blue.svg)](https://t.me/sonhshu) -[![Docker](https://img.shields.io/badge/docker-ready-blue.svg)]() +[![GitHub release](https://img.shields.io/github/v/release/GUGEGEBAIDU/fakabot?style=flat-square)](https://github.com/GUGEGEBAIDU/fakabot/releases) +[![GitHub stars](https://img.shields.io/github/stars/GUGEGEBAIDU/fakabot?style=flat-square)](https://github.com/GUGEGEBAIDU/fakabot/stargazers) +[![GitHub forks](https://img.shields.io/github/forks/GUGEGEBAIDU/fakabot?style=flat-square)](https://github.com/GUGEGEBAIDU/fakabot/network) +[![GitHub issues](https://img.shields.io/github/issues/GUGEGEBAIDU/fakabot?style=flat-square)](https://github.com/GUGEGEBAIDU/fakabot/issues) +[![License](https://img.shields.io/badge/license-Commercial-blue.svg?style=flat-square)]() +[![Python](https://img.shields.io/badge/python-3.11-blue.svg?style=flat-square)]() +[![Telegram](https://img.shields.io/badge/Telegram-Bot-blue.svg?style=flat-square)](https://t.me/sonhshu) +[![Docker](https://img.shields.io/badge/docker-ready-blue.svg?style=flat-square)]()
@@ -15,6 +19,8 @@ ๐ŸŽฌ [ๅœจ็บฟๆผ”็คบ](https://t.me/fakawan_bot) ยท ๐Ÿ“ฑ [่”็ณปๅฎขๆœ](https://t.me/sonhshu) ยท ๐Ÿ“– [ๅฎŒๆ•ดๆ–‡ๆกฃ](#-ๅฟซ้€Ÿๅผ€ๅง‹) +ไธญๆ–‡ๆ–‡ๆกฃ | [English](README.en.md) +
---