ناب‌گل مستندات فنی

مرجع فنی پلتفرم

هرچه از ساختار ناب‌گل روی سرور می‌دانیم

این صفحه خلاصهٔ زندهٔ معماری عمومی است: خانواده‌های محصول، مسیرهای ورود، قرارداد API، و فهرست ربات‌های فعال — بدون رمز و کلید.

هدف پلتفرم

ناب‌گل یک پلتفرم دستیار هوشمند است که کار واقعی انجام می‌دهد؛ نه فقط چت. ترتیب ساخت: اول زیرساخت سرور، بعد اپ مرجع روی همان کاتالوگ، بعد کپی محصولات بعدی با تغییر جزئی.

  • چت چندرباته با پرونده و UI پویا
  • گفتگوی زنده صوتی/تصویری + TTS روی موتور NabGol
  • خروجی PDF / Word
  • کاتالوگ اپ و قرارداد API نسخه‌دار روی اینترنت
  • دو خانوادهٔ جدا: معلم خصوصی و دستیار (XOR — قاطی نمی‌شوند)

مسیرهای عمومی

مسیرنقش
/صفحهٔ معرفی پلتفرم
/assistants.phpفهرست دستیارها و تخصص‌های غیرمعلم
/tutor.phpدرگاه معلم خصوصی (پایه → درس)
/{robot_id}چت همان ربات
/platform-docs.phpهمین مستندات فنی

خانواده‌های محصول

شمارش از روی فهرست زندهٔ ربات‌های فعال سرور.

  • ۱۷۷معلم خصوصی (`dabir-*` / `moalem-*`)
  • ۶دستیار (`assistant-*`)
  • ۴تخصص آزاد (مثل گیاه‌پزشک)
  • ۱۸۷جمع ربات‌های عمومی فعال

قانون خانواده: هر ربات حداکثر عضو یک خانواده است. فیچر معلم به دستیار نشت نمی‌کند و برعکس.

قرارداد و API عمومی

نسخهٔ قرارداد: 1.0 · UI Schema: 3.0

کلیدآدرس
contract /api_contract.php
app_catalog /app_catalog.php
platform_tools /platform_tools.php
chat /chat_api.php
live_token /live_token.php

نمونهٔ کشف:

  • GET /api_contract.php — قفل قرارداد ماشین‌خوان
  • GET /app_catalog.php?list=1 — فهرست اپ‌ها
  • GET /platform_tools.php?list=1 — ابزارهای ثبت‌شدهٔ پلتفرم

اپ‌های شناخته‌شده

app_idنقش / توضیح
nabgol web_reference — مرجع وب / چندربات عمومی
myclinic android_client — اپ اندروید فقط با این app_id کاتالوگ را می‌خواند؛ لیست ربات هاردکد نشود

نقشهٔ فایل‌های اصلی سرور

ریشهٔ وب ≈ /var/www/html/ · توسعه محلی ≈ پوشهٔ live/

live/  ≈  /var/www/html/
├── index.php / home.php     صفحهٔ اول (معرفی)
├── assistants.php           پرتال دستیارها
├── platform-docs.php        همین مستندات
├── tutor.php                درگاه معلم خصوصی
├── robots.json              فهرست ربات‌ها
├── chat_api.php             مغز پاسخ چت
├── live_token.php           بلیط گفتگوی زنده
├── app_catalog.php          کاتالوگ اپ → ربات
├── api_contract.php|.json   قرارداد API
├── platform_tools.php       ابزارهای پلتفرم
├── templates/               قالب موبایل/دسکتاپ چت
├── assets/js/chat/          چت + پرونده + PDF/Word
├── assets/js/live/          گفتگوی زنده
├── includes/                موتورها (tutor / assistant / steering / …)
├── bin/nabgol_live_gateway.js   موتور گفتگوی زنده NabGol
└── tools/                   تست و دروازه — صفحهٔ عمومی نیست

کاتالوگ ربات‌های فعال

۱۸۷ مورد عمومی — شناسه برای آدرس مستقیم /{id}

نامشناسهخانواده
Test Robot test تخصصی
باهوش A تخصصی
برنامه‌نویس coder تخصصی
دکتر ناب‌گل plant-doctor تخصصی
دستیار اداری assistant-office دستیار
دستیار زندگی روزمره assistant-daily دستیار
دستیار فروش assistant-sales دستیار
دستیار معلم زبان assistant-language-teacher دستیار
دستیار معلم مدرسه assistant-school-teacher دستیار
دستیار پرواربندی assistant-parvar دستیار
دبیر آزمایشگاه علوم تجربی دهم dabir-azmayeshgah-olum-10 معلم خصوصی
دبیر آزمایشگاه علوم تجربی یازدهم dabir-azmayeshgah-olum-11 معلم خصوصی
دبیر آمادگی دفاعی دهم dabir-amadegi-defai-10 معلم خصوصی
دبیر آمادگی دفاعی نهم dabir-amadegi-defai-9 معلم خصوصی
دبیر آمار و احتمال یازدهم dabir-amar-ehtemal-11 معلم خصوصی
دبیر آموزش قرآن نهم dabir-quran-9 معلم خصوصی
دبیر آموزش قرآن هشتم dabir-quran-8 معلم خصوصی
دبیر آموزش قرآن هفتم dabir-quran-7 معلم خصوصی
دبیر از ایرانمان دفاع می کنیم (دوره دوم متوسطه) دهم dabir-defa-iran-10 معلم خصوصی
دبیر از ایرانمان دفاع می‌کنیم نهم dabir-defa-iran-9 معلم خصوصی
دبیر از ایرانمان دفاع می‌کنیم هشتم dabir-defa-iran-8 معلم خصوصی
دبیر از ایرانمان دفاع می‌کنیم هفتم dabir-defa-iran-7 معلم خصوصی
دبیر اقتصاد دهم dabir-eghtesad-10 معلم خصوصی
دبیر انسان و محیط زیست یازدهم dabir-ensan-mohitzist-11 معلم خصوصی
دبیر انگلیسی دهم dabir-english-10 معلم خصوصی
دبیر انگلیسی دوازدهم dabir-english-12 معلم خصوصی
دبیر انگلیسی نهم dabir-english-9 معلم خصوصی
دبیر انگلیسی هشتم dabir-english-8 معلم خصوصی
دبیر انگلیسی هفتم dabir-english-7 معلم خصوصی
دبیر انگلیسی یازدهم dabir-english-11 معلم خصوصی
دبیر تاریخ - ایران و جهان معاصر دوازدهم dabir-tarikh-12 معلم خصوصی
دبیر تاریخ 1 (ایران و جهان باستان) دهم dabir-tarikh-10 معلم خصوصی
دبیر تاریخ معاصر ایران یازدهم dabir-tarikh-moaser-iran-11 معلم خصوصی
دبیر تاریخ یازدهم dabir-tarikh-11 معلم خصوصی
دبیر تحلیل فرهنگی دوازدهم dabir-tahlil-farhangi-12 معلم خصوصی
دبیر تربیت دینی (از من تا خدا) هفتم dabir-tarbiyat-dini-7 معلم خصوصی
دبیر تعلیمات ادیان الهی و اخلاق دهم — ویژه اقلیت های دینی dabir-taalimat-adyan-10 معلم خصوصی
دبیر تعلیمات ادیان الهی و اخلاق دوازدهم — ویژه اقلیت های دینی dabir-taalimat-adyan-12 معلم خصوصی
دبیر تعلیمات ادیان الهی و اخلاق یازدهم — ویژه اقلیت های دینی dabir-taalimat-adyan-11 معلم خصوصی
دبیر تفکر و سبک زندگی هشتم dabir-tafakor-zendegi-8 معلم خصوصی
دبیر تفکر و سبک زندگی هفتم dabir-tafakor-zendegi-7 معلم خصوصی
دبیر تفکر و سواد رسانه ای دهم dabir-tafakor-savad-resane-10 معلم خصوصی
دبیر جامعه شناسی دهم dabir-jameeshenasi-10 معلم خصوصی
دبیر جامعه شناسی دوازدهم dabir-jameeshenasi-12 معلم خصوصی
دبیر جامعه شناسی یازدهم dabir-jameeshenasi-11 معلم خصوصی
دبیر جغرافیا (کاربردی) دوازدهم dabir-joghrafia-12 معلم خصوصی
دبیر جغرافیای ایران دهم dabir-joghrafia-iran-10 معلم خصوصی
دبیر جغرافیای ـ جغرافیای ناحیه ای یازدهم dabir-joghrafia-11 معلم خصوصی
دبیر حسابان دوازدهم dabir-hesaban-12 معلم خصوصی
دبیر حسابان یازدهم dabir-hesaban-11 معلم خصوصی
دبیر دین و زندگی دهم — انسانی dabir-din-zendegi-10-ensani معلم خصوصی
دبیر دین و زندگی دهم — ریاضی و تجربی dabir-din-zendegi-10-riazi-tajrobi معلم خصوصی
دبیر دین و زندگی دوازدهم — انسانی dabir-din-zendegi-12-ensani معلم خصوصی
دبیر دین و زندگی دوازدهم — ریاضی و تجربی dabir-din-zendegi-12-riazi-tajrobi معلم خصوصی
دبیر دین و زندگی یازدهم — انسانی dabir-din-zendegi-11-ensani معلم خصوصی
دبیر دین و زندگی یازدهم — ریاضی و تجربی dabir-din-zendegi-11-riazi-tajrobi معلم خصوصی
دبیر روان شناسی یازدهم dabir-ravanshenasi-11 معلم خصوصی
دبیر ریاضی دهم dabir-riazi-10 معلم خصوصی
دبیر ریاضی دوازدهم dabir-riazi-12 معلم خصوصی
دبیر ریاضی نهم dabir-riazi-9 معلم خصوصی
دبیر ریاضی هشتم dabir-riazi-8 معلم خصوصی
دبیر ریاضی هفتم dabir-riazi-7 معلم خصوصی
دبیر ریاضی و آمار دهم dabir-riazi-amar-10 معلم خصوصی
دبیر ریاضی و آمار دوازدهم dabir-riazi-amar-12 معلم خصوصی
دبیر ریاضی و آمار یازدهم dabir-riazi-amar-11 معلم خصوصی
دبیر ریاضی یازدهم dabir-riazi-11 معلم خصوصی
دبیر ریاضیات گسسته دوازدهم dabir-riaziyat-goseste-12 معلم خصوصی
دبیر زمین شناسی یازدهم dabir-zamin-shenasi-11 معلم خصوصی
دبیر زیست شناسی دهم dabir-zist-shenasi-10 معلم خصوصی
دبیر زیست شناسی دوازدهم dabir-zist-shenasi-12 معلم خصوصی
دبیر زیست شناسی یازدهم dabir-zist-shenasi-11 معلم خصوصی
دبیر سلامت و بهداشت دوازدهم dabir-salamat-behdasht-12 معلم خصوصی
دبیر شیمی دهم dabir-shimi-10 معلم خصوصی
دبیر شیمی دوازدهم dabir-shimi-12 معلم خصوصی
دبیر شیمی یازدهم dabir-shimi-11 معلم خصوصی
دبیر ضمیمه دین و زندگی یازدهم — ویژه اهل سنت dabir-zamime-din-zendegi-sunni-11 معلم خصوصی
دبیر عربی نهم dabir-arabi-9 معلم خصوصی
دبیر عربی هشتم dabir-arabi-8 معلم خصوصی
دبیر عربی هفتم dabir-arabi-7 معلم خصوصی
دبیر عربی، زبان قرآن دهم — انسانی dabir-arabi-10-ensani معلم خصوصی
دبیر عربی، زبان قرآن دهم — ریاضی و تجربی dabir-arabi-10-riazi-tajrobi معلم خصوصی
دبیر عربی، زبان قرآن دوازدهم — انسانی dabir-arabi-12-ensani معلم خصوصی
دبیر عربی، زبان قرآن دوازدهم — ریاضی و تجربی dabir-arabi-12-riazi-tajrobi معلم خصوصی
دبیر عربی، زبان قرآن یازدهم — انسانی dabir-arabi-11-ensani معلم خصوصی
دبیر عربی، زبان قرآن یازدهم — ریاضی و تجربی dabir-arabi-11-riazi-tajrobi معلم خصوصی
دبیر علوم تجربی نهم dabir-olum-9 معلم خصوصی
دبیر علوم تجربی هشتم dabir-olum-8 معلم خصوصی
دبیر علوم تجربی هفتم dabir-olum-7 معلم خصوصی
دبیر علوم و فنون ادبی دهم dabir-olum-fonun-adabi-10 معلم خصوصی
دبیر علوم و فنون ادبی یازدهم dabir-olum-fonun-adabi-11 معلم خصوصی
دبیر فارسی دهم dabir-farsi-10 معلم خصوصی
دبیر فارسی دوازدهم dabir-farsi-12 معلم خصوصی
دبیر فارسی نهم dabir-farsi-9 معلم خصوصی
دبیر فارسی هشتم dabir-farsi-8 معلم خصوصی
دبیر فارسی هفتم dabir-farsi-7 معلم خصوصی
دبیر فارسی یازدهم dabir-farsi-11 معلم خصوصی
دبیر فرهنگ و هنر نهم dabir-farhang-honar-9 معلم خصوصی
دبیر فرهنگ و هنر هشتم dabir-farhang-honar-8 معلم خصوصی
دبیر فرهنگ و هنر هفتم dabir-farhang-honar-7 معلم خصوصی
دبیر فلسفه دوازدهم dabir-falsafe-12 معلم خصوصی
دبیر فلسفه یازدهم dabir-falsafe-11 معلم خصوصی
دبیر فیزیک دهم — تجربی dabir-fizik-10-tajrobi معلم خصوصی
دبیر فیزیک دهم — ریاضی dabir-fizik-10-riazi معلم خصوصی
دبیر فیزیک دوازدهم — تجربی dabir-fizik-12-tajrobi معلم خصوصی
دبیر فیزیک دوازدهم — ریاضی dabir-fizik-12-riazi معلم خصوصی
دبیر فیزیک یازدهم — تجربی dabir-fizik-11-tajrobi معلم خصوصی
دبیر فیزیک یازدهم — ریاضی dabir-fizik-11-riazi معلم خصوصی
دبیر مدیریت خانواده و سبک زندگی (دختران) دوازدهم dabir-modiriyat-khanevade-dokhtaran-12 معلم خصوصی
دبیر مدیریت خانواده و سبک زندگی (پسران) دوازدهم dabir-modiriyat-khanevade-pesaran-12 معلم خصوصی
دبیر مطالعات اجتماعی نهم dabir-motaleat-ejtemaei-9 معلم خصوصی
دبیر مطالعات اجتماعی هشتم dabir-motaleat-ejtemaei-8 معلم خصوصی
دبیر مطالعات اجتماعی هفتم dabir-motaleat-ejtemaei-7 معلم خصوصی
دبیر منطق دهم dabir-mantegh-10 معلم خصوصی
دبیر نگارش دهم dabir-negaresh-10 معلم خصوصی
دبیر نگارش دوازدهم dabir-negaresh-12 معلم خصوصی
دبیر نگارش نهم dabir-negaresh-9 معلم خصوصی
دبیر نگارش هشتم dabir-negaresh-8 معلم خصوصی
دبیر نگارش هفتم dabir-negaresh-7 معلم خصوصی
دبیر نگارش یازدهم dabir-negaresh-11 معلم خصوصی
دبیر هندسه دهم dabir-hendese-10 معلم خصوصی
دبیر هندسه دوازدهم dabir-hendese-12 معلم خصوصی
دبیر هندسه یازدهم dabir-hendese-11 معلم خصوصی
دبیر هنر دهم dabir-honar-10 معلم خصوصی
دبیر هنر یازدهم dabir-honar-11 معلم خصوصی
دبیر هویت اجتماعی دوازدهم dabir-hoviyat-ejtemaei-12 معلم خصوصی
دبیر پیام‌های آسمان نهم dabir-payam-asemani-9 معلم خصوصی
دبیر پیام‌های آسمان هشتم dabir-payam-asemani-8 معلم خصوصی
دبیر پیام‌های آسمان هفتم dabir-payam-asemani-7 معلم خصوصی
دبیر کار و فناوری نهم dabir-karofanavari-9 معلم خصوصی
دبیر کار و فناوری هشتم dabir-karofanavari-8 معلم خصوصی
دبیر کار و فناوری هفتم dabir-karofanavari-7 معلم خصوصی
دبیر کارگاه کارآفرینی و تولید دهم dabir-kargah-karafarini-10 معلم خصوصی
دبیر کتاب کار انگلیسی دهم dabir-english-workbook-10 معلم خصوصی
دبیر کتاب کار انگلیسی دوازدهم dabir-english-workbook-12 معلم خصوصی
دبیر کتاب کار انگلیسی یازدهم dabir-english-workbook-11 معلم خصوصی
معلم از ایرانمان دفاع می‌کنیم ششم moalem-defa-iran-6 معلم خصوصی
معلم از ایرانمان دفاع می‌کنیم پنجم moalem-defa-iran-5 معلم خصوصی
معلم تفکر و پژوهش ششم moalem-tafakor-pazhuhesh-6 معلم خصوصی
معلم حرکت و بازی اول moalem-harekat-1 معلم خصوصی
معلم خط تحریری ششم moalem-khat-6 معلم خصوصی
معلم خط تحریری پنجم moalem-khat-5 معلم خصوصی
معلم خط تحریری چهارم moalem-khat-4 معلم خصوصی
معلم ریاضی اول moalem-riazi-1 معلم خصوصی
معلم ریاضی دوم moalem-riazi-2 معلم خصوصی
معلم ریاضی سوم moalem-riazi-3 معلم خصوصی
معلم ریاضی ششم moalem-riazi-6 معلم خصوصی
معلم ریاضی پنجم moalem-riazi-5 معلم خصوصی
معلم ریاضی چهارم moalem-riazi-4 معلم خصوصی
معلم علوم تجربی اول moalem-olum-1 معلم خصوصی
معلم علوم تجربی دوم moalem-olum-2 معلم خصوصی
معلم علوم تجربی سوم moalem-olum-3 معلم خصوصی
معلم علوم تجربی ششم moalem-olum-6 معلم خصوصی
معلم علوم تجربی پنجم moalem-olum-5 معلم خصوصی
معلم علوم تجربی چهارم moalem-olum-4 معلم خصوصی
معلم فارسی اول moalem-farsi-1 معلم خصوصی
معلم فارسی دوم moalem-farsi-2 معلم خصوصی
معلم فارسی سوم moalem-farsi-3 معلم خصوصی
معلم فارسی ششم moalem-farsi-6 معلم خصوصی
معلم فارسی پنجم moalem-farsi-5 معلم خصوصی
معلم فارسی چهارم moalem-farsi-4 معلم خصوصی
معلم قرآن اول moalem-quran-1 معلم خصوصی
معلم قرآن دوم moalem-quran-2 معلم خصوصی
معلم قرآن سوم moalem-quran-3 معلم خصوصی
معلم قرآن ششم moalem-quran-6 معلم خصوصی
معلم قرآن پنجم moalem-quran-5 معلم خصوصی
معلم قرآن چهارم moalem-quran-4 معلم خصوصی
معلم مطالعات اجتماعی سوم moalem-motaleat-ejtemaei-3 معلم خصوصی
معلم مطالعات اجتماعی ششم moalem-motaleat-ejtemaei-6 معلم خصوصی
معلم مطالعات اجتماعی پنجم moalem-motaleat-ejtemaei-5 معلم خصوصی
معلم مطالعات اجتماعی چهارم moalem-motaleat-ejtemaei-4 معلم خصوصی
معلم نگارش اول moalem-negaresh-1 معلم خصوصی
معلم نگارش دوم moalem-negaresh-2 معلم خصوصی
معلم نگارش سوم moalem-negaresh-3 معلم خصوصی
معلم نگارش ششم moalem-negaresh-6 معلم خصوصی
معلم نگارش پنجم moalem-negaresh-5 معلم خصوصی
معلم نگارش چهارم moalem-negaresh-4 معلم خصوصی
معلم هدیه‌های آسمان اقلیت‌ها دوم moalem-hediye-aghaliyat-2 معلم خصوصی
معلم هدیه‌های آسمان اقلیت‌ها سوم moalem-hediye-aghaliyat-3 معلم خصوصی
معلم هدیه‌های آسمان اقلیت‌ها ششم moalem-hediye-aghaliyat-6 معلم خصوصی
معلم هدیه‌های آسمان اقلیت‌ها پنجم moalem-hediye-aghaliyat-5 معلم خصوصی
معلم هدیه‌های آسمان دوم moalem-hediye-aseman-2 معلم خصوصی
معلم هدیه‌های آسمان سوم moalem-hediye-aseman-3 معلم خصوصی
معلم هدیه‌های آسمان ششم moalem-hediye-aseman-6 معلم خصوصی
معلم هدیه‌های آسمان پنجم moalem-hediye-aseman-5 معلم خصوصی
معلم هدیه‌های آسمان چهارم moalem-hediye-aseman-4 معلم خصوصی
معلم هنر و خلاقیت اول moalem-honar-1 معلم خصوصی
معلم کار و فناوری ششم moalem-karofanavari-6 معلم خصوصی

قواعد پایدار توسعه

  • کد سایت فقط در ریشهٔ وب؛ سیستم موازی برای چت/ایجنت نساز.
  • معلم خصوصی و دستیار با پرچم خانواده از هم جدا می‌مانند.
  • اپ‌ها ربات را هاردکد نکنند؛ از کاتالوگ و قرارداد بخوانند.
  • دیپلوی فقط با تأیید؛ پراکسی ایران محل آپلود کد نیست.
  • رمز، کلید API و فایل‌های مخفی در این صفحه نمی‌آید.