تولید خودکار کارنامه با Google Apps Script

شرح پروژه: هدف این پروژه ساخت یک سیستم خودکار (Automated System) برای تولید کارنامه‌ی هدایت تحصیلی دانش‌آموزان است که از داده‌های تست‌های روان‌شناختی و تحصیلی جمع‌آوری‌شده در Google Sheets استفاده می‌کند و خروجی نهایی را به‌صورت PDF استاندارد و قابل دانلود تولید می‌کند. این پروژه کاملاً بر بستر Google Workspace اجرا می‌شود و نیازی به سرور یا دیتابیس جداگانه ندارد. خروجی نهایی باید از روی یک Google Slides Template ساخته شود که طراحی و Placeholderهای آن آماده است. جزئیات کار: اطلاعات هر دانش‌آموز از چند منبع در Google Sheets جمع می‌شود: نتایج تست هالند (Holland) نتایج تست گاردنر (Gardner) نتایج تست شوارتز (Schwartz) نظرسنجی والدین (فرم Google Form با مقیاس لیکرت) سوابق تحصیلی (نمرات دروس کلیدی) این داده‌ها با استفاده از Apps Script خوانده و تجمیع می‌شوند. برای هر دانش‌آموز، سیستم باید: آخرین رکورد هر منبع را تشخیص دهد. امتیاز نهایی مسیرهای شغلی را بر اساس ضرایب تعیین‌شده محاسبه کند. نمودارهای گرافیکی (4 نمودار: هالند، گاردنر، شوارتز، والدین) تولید کند. داده‌ها را در تمپلیت Google Slides جایگزین کند. خروجی PDF بسازد و در پوشه مشخص در Google Drive ذخیره کند. لینک دانلود PDF را برگرداند یا در Google Sheet ثبت کند. ساختار فنی مورد انتظار: Google Sheets برای ذخیره داده‌ها و قوانین (Rules) Google Slides برای قالب (Template) Google Apps Script برای منطق برنامه، پردازش داده‌ها و ساخت PDF اسکریپت‌ها شامل ماژول‌های زیر باشند: ETL.gs → جمع‌آوری و تجمیع داده‌ها RulesEngine.gs → محاسبه امتیازها و پیشنهاد مسیر تحصیلی Charts.gs → تولید نمودارها و تبدیل به تصویر Report.gs → جایگزینی داده‌ها در Slides و ساخت PDF Utils.gs → توابع کمکی Config.gs → شناسه فایل‌ها و تنظیمات عمومی تمام تنظیمات (وزن‌دهی، ضرایب و قواعد) باید از داخل شیت‌ها خوانده شود تا بدون تغییر کد قابل ویرایش باشند. ورودی‌ها: Google Sheets آماده با شیت‌های: Students Holland_Assessments Gardner_Assessments Schwartz_Assessments Parent_Survey Academic_Records Rules_Weights / Rules_Mapping / Rules_Adjust / Rules_Thresholds Google Slides Template آماده با Placeholderهای متنی و باکس نمودارها داده‌های تستی برای 5–10 دانش‌آموز نمونه جهت تست خروجی خروجی مورد انتظار: فایل PDF استاندارد با ظاهر مشخص‌شده در Template نمودارهای رنگی (4 عدد) در صفحات مربوطه جدول سوابق تحصیلی و لیست مسیرهای پیشنهادی تحصیلی (3 تا 5 گزینه) لینک دانلود فایل PDF برای هر دانش‌آموز (در Sheet یا لاگ خروجی) امکان اجرای دسته‌ای (Batch) برای چند دانش‌آموز به‌صورت همزمان الزامات و مهارت‌های لازم: تسلط کامل بر Google Apps Script تجربه در کار با Google Sheets API, SlidesApp, DriveApp توانایی کار با داده‌های JSON و جایگزینی Placeholderها در Slides آشنایی با ساخت Charts در Sheets یا با Charts Service آشنایی با متون فارسی و جهت RTL (برای خروجی تمیز PDF) معیارهای پذیرش (Acceptance Criteria): برای هر دانش‌آموز با داده کامل، فایل PDF به‌درستی ساخته و ذخیره شود. تمامی Placeholderهای متنی و تصویری با داده واقعی جایگزین شوند. تغییر ضرایب در Google Sheets بدون نیاز به ویرایش کد اعمال شود. در صورت ناقص بودن داده‌ها، فیلدها با «—» پر و گزارش ساخته شود. اجرای دسته‌ای حداقل 30 گزارش بدون خطای بحرانی. فایل‌ها و منابع در اختیار فریلنسر: Google Sheets MasterData (خالی با ستون‌های مشخص) Google Slides Template با Placeholderها PDF نمونه کارنامه نهایی لینک شیت‌های تست هالند و گاردنر توضیحات و قواعد وزن‌دهی در قالب شیت Rules نکته پایانی: انتظار می‌رود پروژه به‌صورت تمیز، ساختارمند و مستندسازی‌شده تحویل داده شود تا در آینده امکان ویرایش و توسعه‌ی آن وجود داشته باشد.