-- Run this once in phpMyAdmin (select the database, then SQL tab).
-- «📘 راهنمای استفاده» با زیرمجموعه (آموزش‌ها + دانلود نرم‌افزار).
--
-- یک درخت ساده:
--   root      = 'guide' (آموزش‌ها) یا 'download' (دانلود نرم‌افزار)
--   parent_id = NULL → مستقیم زیر همان بخش؛ وگرنه داخل یک پوشه
--   kind      = 'folder' پوشه | 'post' پست کانال تلگرام (url = لینک پست) | 'link' لینک دانلود/سایت (url + note)
-- (اجرای دستی لازم نیست؛ ربات هنگام اولین استفاده همین جدول را خودش می‌سازد.)
CREATE TABLE IF NOT EXISTS help_items (
    id         INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    root       ENUM('guide','download') NOT NULL,
    parent_id  INT UNSIGNED NULL,
    kind       ENUM('folder','post','link') NOT NULL,
    title      VARCHAR(100) NOT NULL,
    url        VARCHAR(500) NULL,
    note       TEXT NULL,
    sort_order INT NOT NULL DEFAULT 0,
    enabled    TINYINT(1) NOT NULL DEFAULT 1,
    KEY idx_tree (root, parent_id, sort_order)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
