درسی و آموزشی

GAAM11

گام ۱۱

برنامه‌ریز مطالعهٔ پایهٔ یازدهم، برای امتحان نهایی و کنکور

یک برنامه‌ریز تخصصی برای دانش‌آموز پایهٔ یازدهم رشتهٔ ریاضی: ثبت ساعت مطالعه، آزمون‌های آزمایشی، مرور فاصله‌دار لایتنر، کارنامه و یک مشاور هوش مصنوعی. به‌صورت اپ نصب‌شدنی روی گوشی کار می‌کند و آفلاین هم بالا می‌آید.

وضعیت
پایدار
پلتفرم
مرورگر
فناوری
Go 1.22+
پورت پیش‌فرض
3000
داشبورد گام ۱۱
FIG. 01 داشبورد با شمارش معکوس و آمار روز
01

چرا ساخته شده

مشکلی که حل می‌کند

برنامه‌های مطالعهٔ عمومی برای کنکور ایران ساخته نشده‌اند: بودجه‌بندی آزمون‌های آزمایشی، مرور فاصله‌دار و نسبت تست به تشریحی را نمی‌فهمند.

برای چه کسی

دانش‌آموز پایهٔ یازدهم ریاضی که هم امتحان نهایی دارد هم باید برای کنکور پایه‌سازی کند.

02

قابلیت‌ها

8 قابلیت، هر کدام با توضیح کوتاه و مشخص.

  1. 01

    داشبورد و شمارش معکوس

    فاصلهٔ باقی‌مانده تا امتحان نهایی، کنکور و آزمون آزمایشی بعدی روی یک صفحه.

  2. 02

    ثبت پارت مطالعه

    هر جلسهٔ مطالعه با درس، مدت و تعداد تست ثبت می‌شود و در نمودار روزانه می‌نشیند.

  3. 03

    بودجه‌بندی آزمون‌های ماز

    مباحث و بازهٔ صفحات هر مرحلهٔ آزمون، به‌همراه امکان ثبت مستقیم پارت مطالعه از همان‌جا.

  4. 04

    مرور فاصله‌دار لایتنر

    پنج ایستگاه مرور با فاصله‌های ۱، ۳، ۷، ۱۵ و ۳۰ روز؛ هر مبحث خودش در ایستگاه بعدی می‌نشیند.

  5. 05

    کارنامه و تحلیل

    ثبت نتیجهٔ هر آزمون و مقایسهٔ درصدها در طول زمان.

  6. 06

    مشاور هوش مصنوعی

    یک دستیار که با توجه به داده‌های واقعی مطالعه، پیشنهاد برنامه می‌دهد.

  7. 07

    پشتیبان‌گیری چرخشی

    از داده‌ها نسخهٔ پشتیبان نگه داشته می‌شود تا اطلاعات مطالعه از دست نرود.

  8. 08

    کارکرد آفلاین

    به‌صورت اپ وب نصب می‌شود و بدون اینترنت هم باز می‌شود.

03

رابط در عمل

این تصاویر از اجرای واقعی خود برنامه گرفته شده‌اند، نه ماکت طراحی‌شده.

موبایل همان رابط روی صفحهٔ کوچک

  • گام ۱۱ روی موبایل
    همان داشبورد روی موبایل
04

راه‌اندازی

دستورها همان‌هایی هستند که در خود پروژه اجرا می‌شوند. هر بلوک یک دکمهٔ کپی دارد.

پیش‌نیازها

  • Go 1.22.2 یا بالاتر برای ساخت از سورس
  • یک کلید API برای بخش مشاور هوش مصنوعی (اختیاری)

پیش‌نیاز این روش: Go 1.22.2+

  1. پروژه را بساز

    bash
    cd /home/ubuntu/gaam11
    go build -o gaam11 ./cmd/gaam11
  2. فایل تنظیمات را بساز

    کلید هوش مصنوعی اختیاری است؛ بدون آن بقیهٔ برنامه کامل کار می‌کند.

    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"
    }

    کلید واقعی را داخل مخزن نگه ندار. برای بخش مشاور، کلید در سرور خوانده می‌شود نه در مرورگر.

  3. اجرا کن

    bash
    ./gaam11 --port 3000 --bind 0.0.0.0
  4. به‌صورت سرویس اجرا کن

    bash
    sudo 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 باید داشبورد با شمارش معکوس بیاید.

05

در عمل

ثبت یک جلسهٔ مطالعه

از دکمهٔ ثبت پارت، درس و مدت و تعداد تست را وارد کن. برنامه خودش نسبت تست به تشریحی را در داشبورد حساب می‌کند.

مرور لایتنر

هر مبحثی که اضافه می‌کنی، در پنج ایستگاه با فاصله‌های ۱ تا ۳۰ روز تکرار می‌شود. ایستگاه‌هایی که موعدشان رسیده در تب لایتنر فهرست می‌شوند.

پشتیبان‌گیری و بازگردانی

داده‌ها در یک فایل JSON کنار برنامه ذخیره می‌شوند و از رابط هم می‌توان خروجی گرفت و دوباره وارد کرد.

06

محدودیت‌ها و عیب‌یابی

این بخش عمداً صریح است؛ محدودیت‌ها پنهان نشده‌اند.

  • داده‌ها در یک فایل JSON محلی ذخیره می‌شوند؛ برای استفادهٔ چندنفره در مقیاس بزرگ ساخته نشده.
  • بخش مشاور هوش مصنوعی بدون کلید API کار نمی‌کند.
  • مخزن عمومی برای این پروژه وجود ندارد.

مشکل‌های واقعی و راه‌حلشان

بخش مشاور پاسخ نمی‌دهد

علت کلید API تنظیم نشده یا نامعتبر است.

راه‌حل کلید را در فایل تنظیمات بگذار و سرویس را دوباره اجرا کن.

بعد از به‌روزرسانی، نسخهٔ قدیمی در گوشی می‌ماند

علت اپ وب نسخهٔ کش‌شده را نگه داشته است.

راه‌حل سرویس‌ورکر را دوباره ثبت کن یا صفحه را با پاک‌کردن کش باز کن.

07

ارتباط با ابزارهای دیگر

فقط ارتباط‌هایی که در خود پروژه‌ها قابل اثبات‌اند.

منابع این اطلاعات

  • go.mod و ساختار بسته‌های internal
  • unit سرویس systemd
  • فایل manifest و دارایی‌های رابط
  • اجرای واقعی برنامه و رندر تمام تب‌ها

این پروژه مخزن عمومی ندارد، پس هیچ لینک مخزن یا دانلودی برای آن ساخته نشده است.