راهنمای نصب و استفاده از سایت اپ‌مارکت
=========================================

ساختار فایل‌ها:
----------------
index.php              -> صفحه اصلی سایت (خانه، لیست برنامه‌ها، جزئیات برنامه، درباره ما، تماس با ما)
telegram.php            -> صفحه اختصاصی تلگرام بدون فیلتر
admin.php               -> پنل مدیریت کامل سایت
track.php               -> اندپوینت سبک برای ثبت آمار (آنلاین‌ها، کلیک دانلود) - توسط script.js صدا زده می‌شود
includes/functions.php  -> توابع مشترک (دیتابیس JSON، احراز هویت، آمار، دریافت اطلاعات گوگل‌پلی)
includes/header.php     -> هدر مشترک HTML
includes/footer.php     -> فوتر مشترک HTML
assets/style.css        -> استایل کامل و ریسپانسیو با فونت وزیرمتن
assets/script.js         -> جاوااسکریپت (منوی موبایل، هارت‌بیت آنلاین، ستاره امتیازدهی)
data/*.json              -> دیتابیس ساده مبتنی بر JSON (apps, telegram, comments, settings, stats, admin)
uploads/                 -> پوشه پیشنهادی برای آپلود عکس‌های اپ‌ها و تلگرام

نصب:
----
1. تمام فایل‌ها را روی هاست/سرور PHP (نسخه ۷.۴ به بالا، ترجیحاً ۸.۱+) آپلود کنید.
2. مطمئن شوید پوشه‌های data و uploads برای PHP قابل نوشتن هستند (پرمیشن ۷۵۵ یا ۷۷۷).
3. به آدرس yourdomain.com/admin.php?action=login بروید.
4. نام کاربری: admin
   رمز عبور پیش‌فرض: admin123
   (حتما بلافاصله بعد از ورود، از بخش "تنظیمات و سئو" پایین صفحه، رمز عبور را تغییر دهید.)

نکات مهم:
---------
- دیتابیس این سایت به صورت فایل‌های JSON پیاده‌سازی شده (بدون نیاز به MySQL) و برای
  سایت‌های کوچک تا متوسط مناسب است. اگر ترافیک بسیار بالا رفت، بهتر است به MySQL مهاجرت شود.
- بخش «دریافت خودکار از گوگل‌پلی» با اسکرپینگ صفحه عمومی Play Store کار می‌کند چون
  گوگل API رسمی و رایگان برای این کار ارائه نمی‌دهد. این روش ممکن است با تغییر ساختار
  گوگل‌پلی در آینده نیاز به به‌روزرسانی داشته باشد. برای پایداری بیشتر می‌توانید یک
  سرویس واسط مثل RapidAPI (Google Play Scraper API) تهیه کرده و کلید آن را در بخش
  تنظیمات پنل وارد کنید.
- همه بخش‌های سئو (عنوان، توضیحات متا، کلمات کلیدی) برای هر صفحه به صورت جداگانه
  از پنل قابل ویرایش هستند.
- کامنت‌ها پیش از نمایش عمومی نیاز به تایید ادمین دارند و پس از تایید، در میانگین
  امتیاز واقعی همان برنامه لحاظ می‌شوند.
- آمار «کاربران آنلاین» بر اساس هارت‌بیت هر ۳۰ ثانیه از مرورگر کاربر محاسبه می‌شود.

امنیت:
------
- پنل ادمین با session + رمز عبور هش‌شده (bcrypt) و توکن CSRF محافظت می‌شود.
- پیشنهاد می‌شود روی هاست نهایی، دسترسی به admin.php را با یک IP Whitelist یا
  Basic Auth سطح سرور نیز محدود کنید و از HTTPS استفاده کنید.
