راهنمای سریع

راهنماهای کاملِ تحویل، آموزش و پشتیبانی:

• تحویل به مشتری: docs/CUSTOMER_HANDOFF_FA.md
• آموزش مدیر: docs/ADMIN_TRAINING_FA.md
• آموزش اپراتور: docs/OPERATOR_TRAINING_FA.md
• Runbook پشتیبانی: docs/SUPPORT_RUNBOOK_FA.md
• اسکریپت اولین دمو: docs/FIRST_CUSTOMER_DEMO_SCRIPT_FA.md
• امنیت: docs/SECURITY_OVERVIEW_FA.md
• بکاپ و بازیابی: docs/BACKUP_RESTORE_FA.md، docs/DISASTER_RECOVERY_FA.md
• پیش‌نویس SLA: docs/SLA_DRAFT_FA.md
• گزارش آمادگی: docs/ENTERPRISE_READINESS_REPORT_FA.md
• چک‌لیست پذیرش: docs/CUSTOMER_ACCEPTANCE_CHECKLIST_FA.md
• ظرفیت و آزمون بار: docs/CAPACITY_REPORT_FA.md، docs/LOAD_TEST_GUIDE_FA.md

1. روی سرور فقط کد راه‌اندازی اولیه بسازید:

   bash scripts/create_first_setup_key.sh

2. بروید به راه‌اندازیِ اولیه (/setup) و شماره‌ی مدیر کل و کد را وارد کنید.
3. در گامِ «تنظیمات پیامک»، اطلاعاتِ BehinSMS (نام کاربری، رمز، شماره فرستنده) را وارد و ذخیره کنید.
4. «ارسال پیامک تست» را بزنید؛ پس از موفقیت، ورودِ عادیِ پیامکی فعال می‌شود: شماره موبایل → دریافت کد پیامکی → ورود.

راهنمای کامل: docs/SETUP_FROM_FRONTEND_FA.md

برای دیدنِ وضعیتِ کاملِ سیستم (دیتابیس، Redis، پیامک، زمان‌بند، بکاپ، خطاهای اخیر) به سلامت عملیاتی (/admin/ops) بروید. خلاصه هم در بررسی سلامت هست. راهنما: docs/OPS_HEALTH_FA.md

برای افزودن کاربر، دادنِ نقش و غیرفعال/فعال‌سازی به کاربران و دسترسی‌ها بروید. معنی هر نقش در راهنمای نقش‌ها است. کاربرِ جدید با «دریافت کد پیامکی» وارد می‌شود. «تنها مدیر کل سیستم» قابلِ غیرفعال‌سازی نیست. راهنما:docs/USER_MANAGEMENT_FA.md، docs/ROLE_TEMPLATES_FA.md

پیش از هر به‌روزرسانی یک بکاپ بگیرید: روی سرور bash scripts/backup_now.sh. سالم بودنِ بکاپ را با bash scripts/restore_verify.sh بررسی کنید. وضعیت را در تنظیمات بکاپ و سلامت عملیاتی ببینید. بازیابیِ تولید نیازمندِ تأییدِ صریح است. راهنما: docs/BACKUP_RESTORE_FA.md،docs/DISASTER_RECOVERY_FA.md. هرگز docker compose down -v نزنید.

کلیدها و رمزها همیشه ماسک و رمزنگاری‌شده‌اند و اطلاعاتِ حساس (شماره تماس، کد ملی، کارت، شبا، کدِ ورود) پیش از لاگ و پیش از ارسال به هوش مصنوعی حذف می‌شوند. وضعیت را در امنیت و حریم خصوصی ببینید. راهنما: docs/SECURITY_OVERVIEW_FA.md

1. وارد شوید (شماره‌ی موبایل + کدی که برایتان می‌آید).
2. از منوی «منابع داده»، دیتابیسِ شرکت را وصل کنید.
3. «شناسایی جدول‌ها» را بزنید تا سیستم جدول‌های شما را ببیند.
4. بگویید «شماره تماس مشتری» در کدام ستون است و آن را نهایی کنید.
5. سراغِ «عامل‌های سازمانی» بروید، «آماده بودن» را ببینید و اجرا کنید.
6. نتیجه را در «پرونده‌ها» ببینید.

1. نصبِ داکر فقط چند تنظیمِ پایه می‌گیرد (پورت‌ها، دیتابیس، کلیدِ امنیتی).
2. بقیه‌ی تنظیمات را داخلِ پنل انجام می‌دهید: راه‌اندازیِ گام‌به‌گام (/setup).
3. در آنجا: آدرس‌های سیستم، تنظیمات پیامک، کلید هوش مصنوعی، تنظیمات ایمیل، مسیر بکاپ و اطلاعات شرکت را تنظیم می‌کنید — بدونِ ویرایشِ فایل.

چه چیزهایی داخل پنل قابل تغییر است؟ آدرس‌های سیستم، تنظیمات پیامک، کلید هوش مصنوعی، تنظیمات ایمیل، مسیر بکاپ و اطلاعات شرکت.

چه چیزهایی هنوز در فایل نصب (.env) می‌ماند؟ پورت‌ها، اتصالِ دیتابیس و Redis، کلیدِ امنیتی و مسیرِ ذخیره — چون قبل از بالا آمدنِ برنامه لازم‌اند و تغییرشان نیازمندِ راه‌اندازیِ مجدد است.

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

این آدرس بیشتر برای بررسی‌های فنی، سلامتِ سیستم و پشتیبانی است. کاربرِ عادی معمولاً به این آدرس کاری ندارد.

1. به راهنمای گام‌به‌گامِ عاملِ تماس بروید.
2. اگر دیتابیسِ واقعی ندارید، دکمهٔ «ساختِ دادهٔ نمایشی» را بزنید (پیام: «داده نمایشی است، نه داده واقعی شرکت»).
3. ستون شماره تماس به‌صورتِ خودکار پیشنهاد می‌شود؛ «ساخت، اعتبارسنجی، انتشار و اتصال» را بزنید.
4. اگر «نیازمندِ تأییدِ مدیرِ دوم» شد، یک مدیرِ دیگر همان صفحه را باز کند و تأیید کند.
5. «اجرای آزمایشی» و بعد «اجرای با داده‌ی واقعی» را بزنید و نتیجه را در «پرونده‌ها» ببینید.

فرض کنید دیتابیسِ شما یک جدولِ مشتری دارد به نامِ customers با ستون‌هایِ id، full_name، mobile، created_at.

1. دیتابیس را از «منابع داده» وصل کنید.
2. «شناسایی جدول‌ها» را بزنید و جدولِ customers را انتخاب کنید.
3. ستونِ mobile را به‌عنوانِ «شماره تماس مشتری» انتخاب کنید (نام و شناسه اختیاری‌اند).
4. ذخیره و نهایی کنید.
5. در «لیستِ عامل‌ها»، «آماده بودن» را ببینید.
6. اول «اجرای آزمایشی»، و اگر آماده بود «اجرای واقعی» را بزنید.
7. نتیجه را در «پرونده‌ها» ببینید.

راهِ ساده‌تر: صفحه‌ی راهنمای گام‌به‌گامِ همین عامل در مسیرِ «آماده‌سازیِ عاملِ تماسِ از دست‌رفته» همه‌ی این کارها را برایتان انجام می‌دهد.

• اگر بعد از نصب صفحه باز نشد، ۳۰ تا ۶۰ ثانیه صبر کنید؛ اولین بالا آمدن کمی طول می‌کشد.
• اگر «هنوز ستون شماره تماس مشخص نشده» را دیدید، به مرحله‌ی وصل‌کردنِ ستون‌ها برگردید.
• اگر دکمه‌ی «اجرای واقعی» غیرفعال بود، یعنی هنوز آماده نیست — اتصال را نهایی کنید.
• برای مشکلاتِ فنی، مستنداتِ docs/TROUBLESHOOTING_FA.md و پشتیبانی.

راهنماهای متنیِ کامل (برای مدیر/اپراتور/ادمین) در پوشه‌ی مستنداتِ نرم‌افزار:

• docs/QUICK_START_FA.md — شروعِ سریع
• docs/USER_GUIDE_FA.md — راهنمای کاربر
• docs/GLOSSARY_SIMPLE_FA.md — معنیِ ساده‌ی کلمه‌ها
• docs/FEATURE_DEPENDENCIES_FA.md — ترتیبِ مراحل