درسی و آموزشی
GAAM11
گام ۱۱
برنامهریز مطالعهٔ پایهٔ یازدهم، برای امتحان نهایی و کنکور
یک برنامهریز تخصصی برای دانشآموز پایهٔ یازدهم رشتهٔ ریاضی: ثبت ساعت مطالعه، آزمونهای آزمایشی، مرور فاصلهدار لایتنر، کارنامه و یک مشاور هوش مصنوعی. بهصورت اپ نصبشدنی روی گوشی کار میکند و آفلاین هم بالا میآید.
- وضعیت
- پایدار
- پلتفرم
- مرورگر
- فناوری
- Go 1.22+
- پورت پیشفرض
- 3000
چرا ساخته شده
مشکلی که حل میکند
برنامههای مطالعهٔ عمومی برای کنکور ایران ساخته نشدهاند: بودجهبندی آزمونهای آزمایشی، مرور فاصلهدار و نسبت تست به تشریحی را نمیفهمند.
برای چه کسی
دانشآموز پایهٔ یازدهم ریاضی که هم امتحان نهایی دارد هم باید برای کنکور پایهسازی کند.
قابلیتها
8 قابلیت، هر کدام با توضیح کوتاه و مشخص.
- 01
داشبورد و شمارش معکوس
فاصلهٔ باقیمانده تا امتحان نهایی، کنکور و آزمون آزمایشی بعدی روی یک صفحه.
- 02
ثبت پارت مطالعه
هر جلسهٔ مطالعه با درس، مدت و تعداد تست ثبت میشود و در نمودار روزانه مینشیند.
- 03
بودجهبندی آزمونهای ماز
مباحث و بازهٔ صفحات هر مرحلهٔ آزمون، بههمراه امکان ثبت مستقیم پارت مطالعه از همانجا.
- 04
مرور فاصلهدار لایتنر
پنج ایستگاه مرور با فاصلههای ۱، ۳، ۷، ۱۵ و ۳۰ روز؛ هر مبحث خودش در ایستگاه بعدی مینشیند.
- 05
کارنامه و تحلیل
ثبت نتیجهٔ هر آزمون و مقایسهٔ درصدها در طول زمان.
- 06
مشاور هوش مصنوعی
یک دستیار که با توجه به دادههای واقعی مطالعه، پیشنهاد برنامه میدهد.
- 07
پشتیبانگیری چرخشی
از دادهها نسخهٔ پشتیبان نگه داشته میشود تا اطلاعات مطالعه از دست نرود.
- 08
کارکرد آفلاین
بهصورت اپ وب نصب میشود و بدون اینترنت هم باز میشود.
رابط در عمل
این تصاویر از اجرای واقعی خود برنامه گرفته شدهاند، نه ماکت طراحیشده.
موبایل همان رابط روی صفحهٔ کوچک
-
همان داشبورد روی موبایل
راهاندازی
دستورها همانهایی هستند که در خود پروژه اجرا میشوند. هر بلوک یک دکمهٔ کپی دارد.
پیشنیازها
- Go 1.22.2 یا بالاتر برای ساخت از سورس
- یک کلید API برای بخش مشاور هوش مصنوعی (اختیاری)
پیشنیاز این روش: Go 1.22.2+
-
پروژه را بساز
bashcd /home/ubuntu/gaam11 go build -o gaam11 ./cmd/gaam11 -
فایل تنظیمات را بساز
کلید هوش مصنوعی اختیاری است؛ بدون آن بقیهٔ برنامه کامل کار میکند.
json{ "port": 3000, "bind": "0.0.0.0", "data_path": "gaam11_data.json", "gemini_api_key": "<YOUR_API_KEY>", "gemini_model": "gemini-3.8-flash" }کلید واقعی را داخل مخزن نگه ندار. برای بخش مشاور، کلید در سرور خوانده میشود نه در مرورگر.
-
اجرا کن
bash./gaam11 --port 3000 --bind 0.0.0.0 -
بهصورت سرویس اجرا کن
bashsudo tee /etc/systemd/system/gaam11.service >/dev/null <<'UNIT' [Unit] Description=Gaam11 Study Planner After=network.target [Service] Type=simple User=ubuntu WorkingDirectory=/home/ubuntu/gaam11 ExecStart=/home/ubuntu/gaam11/gaam11 --port 3000 --bind 0.0.0.0 Restart=always RestartSec=3 [Install] WantedBy=multi-user.target UNIT sudo systemctl daemon-reload sudo systemctl enable --now gaam11
نشانهٔ موفقیت: بعد از باز کردن http://<HOST>:3000 باید داشبورد با شمارش معکوس بیاید.
-
آدرس را در مرورگر باز کن
صفحه را در مرورگر گوشی باز کن و از منوی مرورگر گزینهٔ افزودن به صفحهٔ اصلی را بزن. برنامه مثل یک اپ نصب میشود و آفلاین هم کار میکند.
در عمل
ثبت یک جلسهٔ مطالعه
از دکمهٔ ثبت پارت، درس و مدت و تعداد تست را وارد کن. برنامه خودش نسبت تست به تشریحی را در داشبورد حساب میکند.
مرور لایتنر
هر مبحثی که اضافه میکنی، در پنج ایستگاه با فاصلههای ۱ تا ۳۰ روز تکرار میشود. ایستگاههایی که موعدشان رسیده در تب لایتنر فهرست میشوند.
پشتیبانگیری و بازگردانی
دادهها در یک فایل JSON کنار برنامه ذخیره میشوند و از رابط هم میتوان خروجی گرفت و دوباره وارد کرد.
محدودیتها و عیبیابی
این بخش عمداً صریح است؛ محدودیتها پنهان نشدهاند.
- دادهها در یک فایل JSON محلی ذخیره میشوند؛ برای استفادهٔ چندنفره در مقیاس بزرگ ساخته نشده.
- بخش مشاور هوش مصنوعی بدون کلید API کار نمیکند.
- مخزن عمومی برای این پروژه وجود ندارد.
مشکلهای واقعی و راهحلشان
بخش مشاور پاسخ نمیدهد
علت کلید API تنظیم نشده یا نامعتبر است.
راهحل کلید را در فایل تنظیمات بگذار و سرویس را دوباره اجرا کن.
بعد از بهروزرسانی، نسخهٔ قدیمی در گوشی میماند
علت اپ وب نسخهٔ کششده را نگه داشته است.
راهحل سرویسورکر را دوباره ثبت کن یا صفحه را با پاککردن کش باز کن.
ارتباط با ابزارهای دیگر
فقط ارتباطهایی که در خود پروژهها قابل اثباتاند.
منابع این اطلاعات
- go.mod و ساختار بستههای internal
- unit سرویس systemd
- فایل manifest و داراییهای رابط
- اجرای واقعی برنامه و رندر تمام تبها
این پروژه مخزن عمومی ندارد، پس هیچ لینک مخزن یا دانلودی برای آن ساخته نشده است.