📚 افزودن کتاب، بازبینی چانک‌ها و پک‌های آموزشی

1. PDF رسمی کتاب (با لایه‌ی متن، مثل فایل‌های chap.sch.ir) را در پوشه‌ی Books/ ریپو بگذار. PDF اسکن‌شده (بدون متن) پذیرفته نمی‌شود.
2. برنامه‌نویس برای کتاب یک manifest می‌نویسد: نام، پایه، درس، سال تحصیلی (ویرایش) و مرز فصل‌ها با شماره‌ی صفحه‌ی PDF. برای ویرایش سال جدیدِ همان کتاب، همان فایل با سال و مرزهای تازه به‌روز می‌شود.
3. اول اجرای آزمایشی (dry-run): خروجی متن فصل‌ها و گزارش کیفیت را نگاه کنید (فصل بی‌متن؟ شماره‌ی صفحه درست است؟).
4. سپس ingest واقعی: کتاب به‌صورت پیش‌نویس وارد می‌شود، متن به تکه‌های کوچک («چانک») بریده می‌شود و عکس صفحه‌ها برای بازبینی ذخیره می‌شود. embedding چانک‌ها خودکار در صف انجام می‌شود (چند دقیقه).

جزئیات فرمان‌ها و پیش‌نیازها در runbook فنی infra/runbooks/content-books.md است.

• هر ویرایش (سال تحصیلی) یک ردیف است: تعداد فصل و چانک، پیشرفت embedding (مثلاً «۳۰۰/۴۱۲ · در صف»)، تعداد چانک پرچم‌دار، پک‌ها per وضعیت و وضعیت کتاب.
• روی نام کتاب بزن تا همه‌ی فصل‌ها باز شود (حتی فصلی که هنوز پک ندارد): صفحه‌ها، تعداد چانک، embedding ناتمام و چانک پرچم‌دار، وضعیت سه نسخه‌ی پک (ن۱ تا ن۳) با رنگ وضعیت، و برچسب‌های «متن تغییر کرد» (متن فصل بعد از ساخت پک عوض شده — پک تازه لازم است)، «در صف تولید…» و «بازمصرف از ویرایش قبل». دکمه‌ها: «چانک‌ها»، «پک‌ها» و «تولید پک» / «بازتولید پک».
• «پک فصل‌های بی‌پک»: تولید پک برای همه‌ی فصل‌های کتاب که پک ندارند. تولید فقط با دستور شماست (هر فصل حدود ۰٫۰۳ دلار برای سه نسخه)؛ صف هر دقیقه یک نسخه می‌سازد.
• «job شکست» یعنی embedding یا تولید پک بعد از ۳ تلاش ناموفق مانده. دکمه‌ی «تلاش دوباره» کنار همان عدد آن‌ها را دوباره در صف می‌گذارد (برای فصلی که همین حالا در صف تولید است، تکراری ساخته نمی‌شود).

کارت «بودجه‌ی AI محتوا» بالای این تب: مصرف کل در برابر سقف (نوار بالای ۸۰٪ کهربایی و در ۱۰۰٪ قرمز با پیام «jobها متوقف شدند»)، تفکیک embedding / پک / جست‌وجو و مدل‌های فعلی. کلید «jobهای AI محتوا: روشن/خاموش» همه‌ی embedding و تولید پک را نگه می‌دارد (کارها در صف می‌مانند، خراب نمی‌شوند). سقف را در همان کارت عوض کن و «ذخیره‌ی سقف» بزن؛ هر تغییر با نام ادمین ثبت می‌شود. تعویض مدل‌ها از صفحه‌ی «نرخ‌ها و قیمت‌ها» است (فازهای بعد).

جست‌وجوی آزمایشی پایین همین تب همان جست‌وجویی است که چت دانش‌آموز استفاده می‌کند: یک پرسش به زبان دانش‌آموز بنویس، کتاب و مخاطب را انتخاب کن و اگر کتاب هنوز منتشر نشده «شامل پیش‌نویس» را بزن. نتیجه باید فصل درست را در سه نتیجه‌ی اول بیاورد. کلیک روی نتیجه همان چانک را در تب بازبینی باز می‌کند. هر جست‌وجو هزینه‌ی خیلی کوچکی دارد.

1. پیش‌فرض ۲۰ چانک تصادفی است (برای هر کتاب تازه حداقل همین ۲۰ تا را نگاه کن). می‌توانی کتاب را فیلتر کنی، فقط پرچم‌دارها را ببینی، یا با «ترتیبی» چانک‌ها را پشت سر هم مرور کنی.
2. سمت چپ عکس صفحه‌ی PDF است (با شماره‌ی PDF و چاپی)؛ چانک دوصفحه‌ای دکمه‌ی جابه‌جایی بین صفحه‌ها دارد. سمت راست متن چانک.
3. اگر متن غلط استخراج شده (حرف جاافتاده، ترتیب به‌هم‌ریخته) همان‌جا اصلاح کن و ذخیره بزن؛ embedding آن چانک دوباره ساخته می‌شود.
4. مخاطب: یادداشت‌هایی مثل «از دانش‌آموزان بخواهید…» یا «توجه فرزند خود را…» را روی «راهنمای معلم/ولی» بگذار؛ این متن‌ها فقط در چت معلم و ولی استفاده می‌شوند، نه در پک و پاسخ به دانش‌آموز.
5. پرچم: متن خراب یا مشکوک (مثل دستوری که انگار برای هوش مصنوعی نوشته شده) را پرچم بزن تا در هیچ جست‌وجویی نیاید. پرچم‌های خودکار را هم همین‌جا بررسی و در صورت سالم بودن بردار.
6. «درست است، بعدی» یعنی بدون تغییر رد شو. کلید ← بعدی و → قبلی است.

پک آموزشی هر فصل = خلاصه + اهداف یادگیری + ۸ تا ۱۲ سؤال با پاسخ و دلیل، در سه نسخه (سه مجموعه سؤال متفاوت). دانش‌آموز آن را رایگان و بدون هوش مصنوعی اجرا می‌کند (در نسخه‌های بعدی اپ)، پس کیفیتش به بازبینی شما بسته است.

1. تب‌های پیش‌نویس (تازه تولیدشده)، بازبینی‌شده (آماده‌ی انتشار) و کهنه (متن فصل بعد از تولید عوض شده). منتشرشده‌ها و ردشده‌ها زیر «بیشتر…».
2. روی ردیف بزن: خلاصه، اهداف و سؤال‌ها را بخوان. پاسخ درست سبز است و زیر هر سؤال «دلیل» آمده. سؤالی که مشکل انتشار دارد قاب قرمز و متن مشکل دارد (مثلاً «پاسخ درست مشخص نیست»).
3. با مداد هر بخش را درجا ویرایش کن (صورت سؤال، گزینه‌ها، پاسخ درست، برچسب مبحث، دلیل) یا سؤال بد را حذف کن؛ بعد ذخیره. کمتر از ۸ سؤال خودش یک مشکل است. ویرایشِ پکِ بازبینی‌شده آن را به پیش‌نویس برمی‌گرداند.
4. «بازبینی شد» فقط وقتی فعال است که هیچ مشکلی نمانده و تغییر ذخیره‌نشده‌ای نداری. بعد از آن دکمه‌ی «انتشار» می‌آید؛ انتشار نسخه‌ی قبلیِ منتشرشده‌ی همان فصل و همان شماره‌نسخه را کنار می‌گذارد.
5. «رد…» با دلیل (برای خودتان و همکارتان) و «بازتولید همین نسخه» برای وقتی پک کلاً بد است؛ پک فعلی تا انتشار جایگزین سر جایش می‌ماند.

• در تب «کتاب‌ها» دکمه‌ی انتشار: کتاب در انتخاب‌گر زمینه‌ی چت و جست‌وجوی کاربران می‌آید. پنجره‌ی تأیید هشدار می‌دهد اگر embedding تمام نشده، چانک پرچم‌دار بازبینی‌نشده دارد یا هنوز هیچ پک منتشرشده‌ای ندارد — می‌توانی با وجود هشدار منتشر کنی، ولی بهتر است اول کامل شود.
• انتشار ویرایش سال جدید، ویرایش سال قبلِ همان کتاب را خودکار بایگانی می‌کند (از انتخاب‌گر بیرون می‌رود؛ گفتگوهای قدیمی که به آن ارجاع داده‌اند سالم می‌مانند).
• «لغو انتشار» کتاب را به پیش‌نویس برمی‌گرداند و از دید کاربران پنهان می‌کند.

«پک فصل‌های بی‌پک» زدم ولی چیزی تولید نمی‌شود.

کارت بودجه را ببین: یا کلید jobها خاموش است یا سقف پر شده (jobها متوقف می‌شوند، نه شکست). کلید را روشن کن یا سقف را بالا ببر؛ اگر خود اعتبار OpenRouter تمام شده، اول آن را شارژ کن.

پیام «ادمین دیگری همین حالا این مورد را تغییر داده».

همکارت هم‌زمان همان پک یا چانک را ذخیره کرده. برای این‌که کار او پاک نشود، ذخیره‌ی تو انجام نشد. «بارگذاری نسخه‌ی تازه» را بزن، تغییرش را ببین و اگر لازم بود ویرایشت را دوباره انجام بده.

جست‌وجوی آزمایشی می‌گوید «فقط جست‌وجوی متنی».

embedding پرسش ممکن نبوده (همان دو دلیل بالا). نتیجه‌ها فقط بر اساس تطابق کلمات است و معیار ارزیابی نیست.

دکمه‌ی «بازبینی شد» خاکستری است.

روی دکمه تعداد مشکل نوشته شده؛ سؤال‌های قاب‌قرمز را درست کن یا حذف کن و «ذخیره» بزن. اگر تغییر ذخیره‌نشده داری هم غیرفعال می‌ماند.

عکس صفحه لود نمی‌شود.

لینک عکس کوتاه‌عمر است؛ تب را تازه کن («۲۰ تصادفی تازه» یا تغییر فیلتر).