# تقویم محتوایی ۳۰روزه (v101)

مسیر: ادمین هوشمند ← مقصد ← «🗓 تقویم محتوایی»

## جریان ساخت
1. نوع: مناسب پست / استوری / پست و استوری (استوری فقط برای مقصد اینستاگرام)
2. هدف: فروش، تعامل، جذب (چندتایی)
3. فاصله: هر ۲ روز (۱۵ محتوا) یا هر ۳ روز (۱۰ محتوا)
4. ایده‌ها: AI پیشنهاد می‌دهد، یا کاربر همه را می‌نویسد (هر خط یک ایده)؛ حذف، ویرایش، «جایگزین با AI»، تغییر نوع و هدف هر ایده، افزودن ایده‌ی دستی، «تکمیل با AI»
5. تایید نهایی: خلاصه + برآورد سکه + تاریخ شروع (فردا / ۲ / ۳ / ۷ روز دیگه) ← «تایید و فعال‌سازی»

## بعد از فعال‌سازی
- ساخت اتوماتیک پست/استوری همان مقصد تا پایان تقویم خاموش می‌شود و بعد از پایان/توقف/حذف به حالت قبل برمی‌گردد.
- شب قبل (ساعت ۱۸، تنظیم `news_cal_remind_hour`): «خودت می‌سازی یا من؟» با دکمه‌های خودم / تو بساز / رد.
  - «تو بساز» ← ساعت ۹ روز موعود (تنظیم `news_cal_gen_hour`) ساخته می‌شود.
  - بی‌پاسخ: ساعت ۱۲ یک یادآوری دوم، ساعت ۲۱ «رد شده» (بدون خرج سکه).
- یادآوری خاموش: «همه با AI» (خودکار می‌سازد) یا «همه خودم» (فقط پیام ایده‌ی روز).
- پست: مثل ساخت دستی (تصویر AI + تیتر/کپشن طبق «تنظیمات پست»)، برای تایید ادمین می‌آید؛ مقصد تلگرام با «انتشار خودکار» مستقیم منتشر می‌شود.
- استوری: طبق «تنظیمات استوری» مقصد؛ فقط «موضوع» و «هدف» از ایده‌ی تقویم می‌آید.
- «خودم می‌سازم» برای ایده‌های استوری: کارت «ارسال محتوا»ی استوری همان لحظه می‌آید (جریان موجود)؛ موضوع/هدف از ایده‌ی تقویم است.
- «📊 گزارش» در خانه‌ی تقویم: شمار وضعیت‌ها و ناموفق‌ها.
- «خودم می‌سازم» برای ایده‌های پست: عکس خودت (با توضیح اختیاری) رو بفرست؛ تیتر و کپشن ساخته می‌شه و برای تایید می‌آد.
- توقف / ادامه / حذف تقویم از صفحه‌ی خانه‌ی تقویم.
- بعد از پایان تقویم: «🔁 مثل ماه قبل» همان تنظیمات رو با ایده‌های تازه (بدون تکرار) می‌سازه.

## فایل‌ها
- `includes/news/calendar.php` — منطق، دیتابیس، کرون
- `bot/news_calendar_ui.php` — صفحه‌ها و callbackها (`news:cal:*`)
- `cron/news_calendar.php` + ثبت در `includes/cron_scheduler.php` (هر ۱۰ دقیقه؛ از «⏱ تنظیم کرون‌ها» روشن بماند)
- جدول‌های `news_calendars` و `news_calendar_items` (schema v35، migrate خودکار)
- تغییر کوچک: `includes/news/story.php` (یک خط: override هدف/موضوع استوری از ایده)

## هنوز انجام نشده
- آمار پیشرفته (مصرف سکه‌ی هر تقویم)
- PHP در محیط ساخت نبود: کد اجرا/لینت نشده؛ بعد از آپلود `php -l` و `php tests/calendar_smoke_test.php` را روی سرور بزن.

## پنل مدیریت ربات — بخش ادمین هوشمند (v104)
مسیر: پنل ادمین ربات ← «📰 ادمین هوشمند» (فایل `bot/admin_news_extra.php`؛ مجوز: manage_settings)
- 📊 نمای کلی، 👥 مشتری‌ها (صفحه‌بندی؛ هر مشتری ← سکه/اشتراک/توقف)، 🧯 منابع با خطا
- 🎬 وضعیت محیط و آمار استوری (ffmpeg، GD، فونت، AI تصویر، کرون‌ها، ۸ استوری آخر)
- 🪙 گزارش سکه (۷/۳۰/۹۰ روز) و 🎁 هدیه‌ی همگانی (انتخاب گروه ← تعداد ← تایید)
- 🖼 تنظیمات سراسری بازسازی اینستاگرام (روشن/خاموش، صف، حداکثر ویدیو و اسلاید) + وضعیت محیط
- 🗓 تقویم‌های محتوایی: شمار تقویم‌ها، تقویم‌های جاری، تنظیم ساعت یادآوری و ساعت ساخت
- از قبل موجود بود: پلن‌ها، بسته‌های سکه، سکه/روز آزمایشی، توقف سراسری، پرامپت‌ها، جستجوی مشتری

## پنل مدیریت ربات — دستیارها (v105)
مسیر: پنل ادمین ربات ← «🤖 دستیارها» (فایل `bot/admin_assistants_ui.php`؛ مجوز manage_assistants)
- فهرست دستیارها + ساخت دستیار جدید (ویزارد ۶ مرحله‌ای: نام، آیکون، نوع خروجی، اتصال، مدل، پرامپت)
- ویرایش هر فیلد: نام، آیکون، پرامپت، مدل، اتصال، نوع خروجی، دکمه‌ی شروع، هزینه‌ی سکه، ترتیب، سقف‌ها، سایز/کیفیت تصویر، نمایش پرامپت، فعال/غیرفعال، حذف
- ❓ سوال‌ها: افزودن، ویرایش متن/متغیر/برچسب/مثال، نوع (متنی/تک/چندانتخابی) + گزینه‌ها + «سایر»، اجباری، پیش‌فرض از پروفایل برند، جابه‌جایی، حذف
- 📄 توضیحات معرفی: متن، عکس، صدا، ویدیو (آپلود از همان چت) و حذف
- 📊 آمار فرم دستیارها (۷/۳۰/۹۰ روز) + نرخ پرشدن سوال‌ها
- 🔌 اتصالات AI: ساخت (با پیشنهاد دیپ‌فا)، ویرایش، تغییر کلید (پیام حاوی کلید پاک می‌شود)، فعال/غیرفعال، حذف (فقط اگر دستیاری استفاده نکند)
- 📚 دانش پشتیبانی (مجوز manage_settings): افزودن، ویرایش، فعال/غیرفعال، حذف
- hook جدید در `bot/index.php` برای ورودی متن/مدیای فرم‌ها