# راهنمای هر بخش، برای کسی که تازه‌کار است + نقشهٔ صادقانهٔ اتوماسیون (نسخهٔ ۰٫۱٫۰ · ۲۲ سپتامبر ۲۰۲۶)

این سند برای کسی نوشته شده که **هیچ شناختی** از مشتقه و آپشن ندارد. دو کار می‌کند: بخش‌به‌بخشِ
برنامه را با نام واقعی دکمه‌ها توضیح می‌دهد، و صادقانه می‌گوید کدام ورودی خودکار است، کدام
نیمه‌خودکار، و کدام دستی می‌مانَد و **چرا**.

**چهار قانون که همه‌جای برنامه برقرار است:** هیچ سفارشی از این برنامه به کارگزاری نمی‌رود · هیچ
سودی تضمین نمی‌شود · هر عدد کلیدی با دو روش حساب می‌شود و بازتولیدشدنی است · هر چه وارد می‌کنید
روی همین رایانه می‌ماند و جایی فرستاده نمی‌شود.

---

## ۱. پیش از هر چیز: باز کردن برنامه

**ویندوز:** `run-gui.bat` را دوبار کلیک کنید. **لینوکس/مک:** در پوشهٔ `MATERIALS/money/gui` بزنید
`python3 web_server.py --port 8765` و بعد در مرورگر بروید به `http://localhost:8765`. اگر برنامهٔ
دسکتاپ می‌خواهید، `station.py` همان یازده گام را پنجره‌ای باز می‌کند.

کنار صفحه فهرست گام‌ها است. هر گامی که تمام شود، شماره‌اش سبز می‌شود؛ پس همیشه می‌دانید کجای
کار ایستاده‌اید. اگر چیزی باز نشد یا خطا داد، اول **گام ۱ → باز کردن پنل مدیریت → بررسی سلامت
برنامه**؛ اگر همهٔ اجزا سالم بود، مشکل از آن بخش است نه از نصب شما.

---

## ۲. بخش‌به‌بخش، با دکمه‌های واقعی

### بخش ۰. پنل مدیریت (نشانی `/admin` — از گام ۱ هم دکمه‌اش هست)

**چه کار می‌کند:** سه کاری که نباید دست مشتری باشد: بررسی سلامت · مجوز دسترسی و عیب‌یابی · گواهی
استفادهٔ موفق.
**چه می‌خواهد:** شناسه و رمز. پیش‌فرض `mafhoom` است و رمز را خودتان عوض می‌کنید:
`python3 adminauth.py --set-pass "رمز تازه"` (رمز فقط هش‌شده ذخیره می‌شود، متن آن هیچ‌جا نمی‌ماند).
**چه بزنید:** ۱) «بررسی سلامت برنامه» → باید بنویسد **۸ از ۸ سالم**. ۲) در بخش مجوز: نام شرکت و
مدت را بنویسید، «صدور مجوز»، بعد «ساخت سند مجوز (چاپی)» تا پروندهٔ دواِمضا آماده شود. ۳) در بخش
گواهی: «ساخت گواهی استفاده» و «نمایش».
**چه چیزی خوب است:** توکن ورود یک‌ساعته است و سهلایه اشتباه رمز، پنج دقیقه قفل می‌شود. اگر نوشت
«توکن نامعتبر یا منقضی»، یعنی یک ساعت گذشته؛ دوباره وارد شوید.

### گام ۱. خوش‌آمد

**چه کار می‌کند:** خانهٔ شروع و دکمهٔ پنل مدیریت.
**چه بزنید:** اگر اولین بار است، همین‌جا پنل را باز کنید و سلامت را ببینید؛ بعد بروید گام ۲.

### گام ۲. منبع داده — مهم‌ترین گام برای شما

این گام چهار کاربلوک دارد. لازم نیست همه را انجام بدهید؛ **فقط یکی** که به کارتان می‌آید:

**الف) دیدن برنامه بدون هیچ راه‌اندازی.** «ساخت قالب نمونه» → «آزمایش خواندن این پرونده». قالب در
`data/snapshot.json` ساخته می‌شود، برنامه هم همان را می‌خواند و می‌گوید چند ردیف خواند.

**ب) دادهٔ زندهٔ رایگان و بدون کلید.** از کادر «دفتر اتصال» یک پروفایل انتخاب کنید → «آزمایش اتصال
این پروفایل» → اگر سبز شد «ذخیره و فعال کردن». اگر مطمئن نیستید کدام کار می‌کند، «بگرد و گزارش
بده (ذخیره نکن)» را بزنید؛ برنامه خودش چند منبع رایگان را امتحان می‌کند و می‌گوید کدام امروز
سالم است. با «بگرد، منبع سالم را ذخیره و فعال کن» خودش بهترین را فعال می‌کند.

**ج) اتصال سرویس خریدنی (اگر روزی خریدید).** «قالب نشانی» را با نشانی سرویس پر کنید
(`{symbol}` و `{key}` جای نماد و کلید)، «مسیر JSON» را بگذارید، کلید را در کادر رمزمانند بنویسید،
بعد «آزمایش اتصال و خواندن قیمت زنده». اگر نمی‌دانید مسیر JSON کدام است، «کاوش پاسخ سرویس» را
بزنید: برنامه خودِ پاسخ را می‌خواند و فهرست عددها را نشان می‌دهد؛ روی عدد درست «استفاده» بزنید تا
مسیر خودش پر شود. بعد «ذخیره به‌عنوان پروفایل تازه» و اگر خواستید تیک «کلید را روی این رایانه ذخیره کن»
(اگر تیک نزنید، کلید روی دیسک نمی‌ماند و هر بار می‌پرسد).

**د) جدول اعداد کارگزاری، همان شصت ثانیهٔ روزانه.** عددهای امروز را در جدول بنویسید یا از سامانهٔ
کارگزاری کپی کنید و در کادر چسباندن بریزید و «تشخیص خودکار و افزودن به جدول» را بزنید. بعد تیک
«این اعداد را خودم از سامانهٔ کارگزاری برداشتم»، اگر عددها به تومان است تیک «تومان»، یادداشت
اختیاری، و **«ذخیرهٔ اسنپ‌شات امروز»**. دو دکمهٔ راهنما همین‌جاست: «راهنما: هر روز چه عددی بگیرم؟»
و «نمایش قالب پرونده». («خواندن اعداد فعلی» اعداد آخرین اسنپ‌شات را برای ویرایش می‌آورد؛ «افزودن
ردیف» برای وقتی است که با موبایل عددها را از اپلیکیشن کارگزاری می‌خوانید و کپی کردن سخت است.)
**چه چیزی خوب است:** روزهای واقعی در کارنامه جدا از روزهای ساختگی شمرده می‌شوند و فقط روزِ
تیک‌خورده «واقعی» حساب می‌شود.

### گام ۳. تنظیمات ریاضی و ریسک

**چه کار می‌کند:** ده عددِ قاعدهٔ تصمیم‌گیری را نگه می‌دارد (سرمایه، نرخ سد، کف حاشیه، سقف
موقعیت، کف نقدشوندگی، سقف اسپرد و…).
**چه بزنید:** فقط **یک عدد** را عوض کنید: «نرخ سد سالانه» را از بازده مؤثر صندوق درآمد ثابت همان
روز بگذارید (شهریور ۱۴۰۵: حدود ۰٫۳۹ یعنی ۳۹ درصد). بقیه را دست نزنید تا تجربه پیدا کنید.
**چه چیزی خوب است:** دکمهٔ «بازخوانی پیش‌فرض‌ها» همیشه هست؛ اگر چیزی را خراب کردید، برگردید به
حالت اول. این عددها همان چیزی است که در بستهٔ شاهد شرکت هم چاپ می‌شود.

### گام ۴. خبر و هشدار (اختیاری)

**چه کار می‌کند:** هشدارهای کدال را کنار سیگنال‌ها می‌گذارد (افزایش سرمایه، تعدیل، توقف نماد).
**چه بزنید:** «اجرای دیده‌بان روی دادهٔ نمونه» تا ببینید چه شکلی است؛ «نمایش هشدارهای فعلی».
**چه چیزی خوب است:** این گام هیچ تأثیری روی عددهای ریاضی ندارد؛ فقط «دلیل» را کامل‌تر می‌کند.
اگر خالی باشد، محاسبه‌ها کار می‌کنند.

### گام ۵. اجرا و محاسبه

**چه کار می‌کند:** همان موتور ریاضی را روی دادهٔ امروز اجرا می‌کند.
**چه بزنید:** «شروع محاسبه».
**چه ببینید:** چند سیگنال ماند، چند افتاد، و برای هر کدام **دلیل رد** نوشته شده. «نمایش داشبورد»
خلاصه را برای چاپ باز می‌کند.

### گام ۶. نتیجه و تصمیم

**چه کار می‌کند:** سیگنال را به «بستهٔ سفارش» تبدیل می‌کند یا با دلیل رد می‌کند؛ اجرای واقعی
کارِ شما در سامانهٔ کارگزاری است.
**چه بزنید:** «به‌روزرسانی فهرست» → یک سیگنال را انتخاب کنید → یادداشت بنویسید → «تأیید سیگنال
انتخابی» یا «رد با دلیل» → «کپی در حافظه» برای بردن بستهٔ سفارش. پایین همین گام، «داوری سیگنال
ابزارهای دیگر» است: حرف خودتان یا ابزار دیگری («بازدهی که ابزار شما گفت»)، نرخ سد، وجه تضمین،
تعداد قرارداد، قیمت پایه → «داوری کن و برگه بساز». برنامه می‌گوید سیگنال آن ابزار **می‌ماند یا
می‌افتد** و فاصله تا ماخطار را نشان می‌دهد. «نمونهٔ آماده» برای وقتی است که می‌خواهید اول شکل کار
را ببینید.

### گام ۷. پس‌آزمایی روی دادهٔ تاریخ

**چه کار می‌کند:** همان موتور را روی گذشته اجرا می‌کند: نرخ برد، خطای مثبت کاذب، فرصت‌های ازدست‌رفته.
**چه بزنید:** «ساخت قالب ستون‌ها» → پروندهٔ تاریخ را در کادر بگذارید → «اجرای پس‌آزمایی» → «نمایش
گزارش». اگر پروندهٔ تاریخ ندارید، نمونه‌اش همراه برنامه است.
**چه چیزی خوب است:** نتیجهٔ واقعی هیچ نقشی در تصمیم امروز ندارد (آزمون ضد آینده‌نگری)، پس عدد
پس‌آزمایی را برای «توجیه» استفاده نکنید؛ برای «فهمیدن» استفاده کنید.

### گام ۸. بستهٔ تحویل شرکت

**چه کار می‌کند:** یک پوشه می‌سازد با همه‌چیز: داشبورد، فهرست سیگنال‌ها، سند روش کار، بسته‌های
سفارش، پس‌آزمایی، کارنامهٔ آزمون، برگهٔ آزمون، پروندهٔ سرمایه‌گذار، **سند چاپی اجازه‌نامه** و
**گواهی استفادهٔ موفق**، هر پرونده با اثر انگشت `sha256` و ساعت ساخت.
**چه بزنید:** «ساخت بستهٔ راستی‌آزمایی» → پوشه را بدهید. داخلش `README-FA.md` یک چک‌لیست
نه‌گامی دارد که خودشان در پنج دقیقه راستی‌آزمایی کنند. «نمایش سند روش کار» هم همان سند را در
مرورگر باز می‌کند.

دو دکمهٔ دیگر همین‌جاست: نام شرکت را در کادر بنویسید و **«ساخت پیشنهاد یک‌صفحه‌ای»** را بزنید
(برگهٔ چاپی `data/offer-one-pager.html` و نسخهٔ متنی‌اش ساخته می‌شود؛ اگر مبلغی ندهید، جای قیمت
«توافقی» می‌ماند) و بعد **«نمایش پیشنهاد»** تا همان صفحه را ببینید و چاپ کنید.

### گام ۹. آزمون زنده و دفتر سرمایه‌گذار

**چه کار می‌کند:** سیگنال‌های امروز را در دفتر تاریخ‌دار زنجیره‌هش‌دار ثبت می‌کند و کارنامه
می‌سازد.
**چه بزنید:** اگر عجله دارید فقط «اجرای مراسم امروز»؛ اگر می‌خواهید خطای اجرا کمتر شود، «اجرای
مراسم با حاشیهٔ محافظه‌کارانه» (دو واحد سخت‌گیرتر). بعد «به‌روزرسانی جدول»، «بررسی زنجیرهٔ هش»،
«ساخت گزارش سرمایه‌گذار (HTML + CSV)» و در پایان «اجرای آزمون ۱۰ دقیقه‌ای» و «نمایش کارنامهٔ آزمون».
**چه چیزی خوب است:** کارنامه پنج شرط دارد و تا «آماده» نشود، خرید هیچ داده‌ای پیشنهاد نمی‌شود.
«برگهٔ آزمون چاپی» و «ساخت پروندهٔ سرمایه‌گذار» هم از همین‌جاست.

### گام ۱۰. آزمون کور سرمایه‌گذار

**چه کار می‌کند:** لپ‌تاپ را دست خودش می‌دهید؛ او حدس می‌زند، بعد برنامه پاسخ را با فرمول و
**روش دوم** رو می‌کند؛ در پایان برگهٔ امضادار و پیمان‌نامهٔ نمایش و سند «چه بخرم / کِی بفروشم /
کِی می‌افتد».
**چه بزنید:** «نمایش پرسش‌ها» → حدس‌ها را بنویسید → «داوری حدس‌های من» → «محاسبهٔ جدول» →
«حساب کن» (حساب‌رسی معاملهٔ گذشته با کارمزد واقعی) → «ساخت برگهٔ آزمون» و «ساخت پیمان‌نامهٔ نمایش
(دواِمضا)». «نمونهٔ پرشده» فقط برای دیدن شکل برگه است.

### گام ۱۱. راهبردها، شوک‌آزمون و ریاضیِ پول

**چه کار می‌کند:** جزوهٔ راهبردها با درصد هرکدام، شوک‌آزمون (لغزش، حرکت مخالف، کارمزد دو و سه
برابر، نرخ سد سخت‌تر)، و ریاضیِ بقا (کِلی، احتمال نیم‌شدن حساب، مسیر تا هدف).
**چه بزنید:** «ساخت جزوه + شوک‌آزمون» → «حساب کن» → «محاسبه کن». در کارت ریاضیِ پول، سرمایه و
هدف و نرخ برد و سود/زیان و بازده راهبرد و چرخش را می‌توانید عوض کنید و «محاسبه کن».
**چه چیزی خوب است:** هر کارت «نسخهٔ متنی» و «برگه» دارد؛ برگه‌ای که مدیر ریسک می‌پسندد، همان
نسخهٔ چاپی است، نه حرف شما.

---

## ۳. گرفتن اعداد از کارگزاری — دقیقاً کجا و چطور

این همان قسمتی است که همه گیر می‌کنند. مسیر واقعی این است:

**۱. ورود.** به سامانهٔ معاملات آنلاین کارگزاری خودتان وارد شوید (یا اپلیکیشن موبایل کارگزاری).
برنامه به سامانهٔ شما وارد نمی‌شود و رمز شما را نمی‌خواهد؛ این کار دستِ خودتان است.

**۲. تابلوی نماد.** در «مشاهدهٔ بازار» یا «تابلو» نماد را باز کنید: برای سهم، فولاد/خساپا/شپنا؛
برای طلا، صندوق‌های طلا یا قراردادهای آتی و اختیار طلا. در وب‌سایت `tsetmc.com` هم همین‌ها را
می‌بینید: «مشاهدهٔ زنده» → نماد → تب‌های «آتی» و «اختیار معامله».

**۳. ده عددی که لازم دارید و جای هرکدام:**

| عدد | در تابلوی کارگزاری کجاست |
| --- | --- |
| قیمت پایه (`spot` / `stock_price`) | ستون «قیمت پایانی» یا «آخرین قیمت» خودِ نماد |
| قیمت آتی (`future`) | تب «آتی» همان نماد، ستون آخرین قیمت |
| قیمت اعمال (`strike`) | تابلوی اختیار معامله، ستون «قیمت اعمال» |
| پرمیوم اختیار خرید (`premium`) | همان تابلو، ستون «آخرین قیمت» سطر اختیار **خرید** |
| پرمیوم اختیار فروش (`put_price`) | همان تابلو، ستون «آخرین قیمت» سطر اختیار **فروش** |
| روزهای مانده (`days`) | تاریخ سررسید همان قرارداد منهای امروز |
| وجه تضمین هر قرارداد (`margin_per_contract`) | **فقط از کارگزاری**: اطلاعیهٔ وجه تضمین یا ستونش در سامانه |
| نقدشوندگی روز (`liquidity_contracts_per_day`) | ستون «حجم» همان قرارداد |
| اسپرد (`spread_pct`) | اختلاف قیمت خرید و فروش تقسیم بر میانگین‌شان؛ تقریبی کافی است |
| نماد و راهبرد (`symbol` / `kind`) | خودتان: «فولاد» و اینکه چه نوع معامله‌ای است |

**۴. کپی، نه تایپ.** سطرها را در سامانه انتخاب کنید و `Ctrl+C`؛ در برنامه در کادر چسباندن
`Ctrl+V` و «تشخیص خودکار و افزودن به جدول». یک نمونهٔ واقعی از چیزی که می‌شود چسباند:

```
فولاد  پوشش‌داده‌شده  ۷۰۰۰  ۷۵۰۰  ۴۵۰  ۳۰  ۲,۰۰۰,۰۰۰  ۱۵۰  ۰٫۰۰۵
```

برنامه خودش رقم‌های فارسی را به لاتین برمی‌گرداند، جداکننده‌ها را می‌فهمد، از روی کلمهٔ «پوشش‌داده‌شده»
راهبرد را می‌فهمد، و اگر جدول شما سرستون داشته باشد («قیمت پایه، اعمال، پرمیوم، روز») عددها را
بر پایهٔ همان سرستون‌ها می‌چیند.

**۵. اگر روی موبایل هستید.** انتخاب و کپی جدول در اپلیکیشن سخت است؛ عددها را بخوانید و در گام ۲
با «افزودن ردیف» بنویسید. برای کم‌کردن خطای تایپ، همیشه از همان روزهای اول سطرها را در جدول
بگذارید و یک بار بلند بخوانید و چک کنید؛ برنامه هم خودش بازبینی عقلی می‌کند (بخش ۵).

---

## ۴. نقشهٔ صادقانهٔ اتوماسیون: چه چیزی خودکار است، چه چیزی نه

| کار | امروز | چرا | کارِ شما |
| --- | --- | --- | --- |
| قیمت دلار، طلا، سکه | **خودکار** (رایگان، آزمون‌شده) | منبع عمومی بدون کلید، مسیر `data.0.3` | فقط نام شاخص را در ردیف بنویسید: `price_dollar_rl` · `geram18` · `sekeb` · `nim` · `rob` |
| قیمت پایانی سهام و آپشن | نیمه‌خودکار | منبع رایگان `tsetmc` هست ولی از بیرون ایران همیشه پاسخ نمی‌دهد | اگر سالم بود خودکار؛ اگر نه، از تابلو کپی کنید |
| نرخ لحظه‌ای صرافی | خودکار وقتی سرویس باز است | سرویس رایگان ولی گاهی ۵۰۳ می‌دهد | پروفایل فعال را نگه دارید؛ اگر قطع شد چسباندن |
| قیمت آتی و زنجیرهٔ آپشن | **دستی** | هیچ منبع رایگانِ پایدار برای زنجیرهٔ آپشن و آتی وجود ندارد | کپی از تابلو یا اپلیکیشن |
| وجه تضمین هر قرارداد | **دستی، فقط از کارگزاری** | هیچ سایت عمومی این عدد را دقیق نمی‌دهد و کارگزاری هم API نمی‌دهد | از اطلاعیهٔ وجه تضمین بگیرید؛ این عدد را جایی حدس نزنید |
| نقدشوندگی و اسپرد | دستی (تقریبی کافی است) | ستون حجم تابلوی امروز | کپی |
| تشخیص راهبرد و جاکردن عددها | **خودکار** | `snapshot_import` سرستون‌ها و کلمه‌ها را می‌شناسد | فقط بچسبانید و بعد یک نگاه تأییدی بیندازید |
| محاسبه، دروازه‌ها، بستهٔ سفارش | **خودکار** | موتور ریاضی و دو روش حساب | تصمیم را خودتان می‌گیرید |
| پس‌آزمایی، دفتر، کارنامه، بستهٔ شاهد، گواهی | **خودکار** | یک دکمه؛ هر پرونده با اثر انگشت | تشویق نمی‌خواهد؛ فقط دکمه‌ها را بزنید |
| اخبار و هشدارهای کدال | نیمه‌خودکار | دسترسی خودکار کدال امروز بسته است | با دادهٔ نمونه کار کنید یا هشدار را دستی وارد کنید |
| تصمیم معامله | **هرگز خودکار** | مسئولیت حقوقی و اخلاقی با انسان است | خودتان تأیید یا رد می‌کنید |
| ارسال سفارش به کارگزاری | **هرگز، و کدی هم برایش نوشته نشده** | طبق ابلاغیهٔ مهر ۱۳۹۹ معاملات الگوریتمی خودکار در بورس ایران «تا اطلاع ثانوی» مجاز نیست | اجرا در سامانهٔ کارگزاری، دستِ خودتان |

**پاسخ صادقانه به «نمی‌شود همه‌اش خودکار شود؟»** آنچه خودکارشدنی بود، خودکار شده: قیمت‌های
رایگان، همهٔ محاسبه‌ها، پرونده‌سازی، و پاک‌سازی عددهای چسبانده‌شده. آنچه خودکار نمی‌شود، به تنبلی
ما نیست: **کارگزاری‌ها API نمی‌دهند** (سه مسیر خرید در سند ۰۵ بررسی شده)، **زنجیرهٔ آپشن منبع
رایگان پایدار ندارد**، و **وجه تضمین فقط در سامانهٔ کارگزاری است**. پس راه درست، کم‌کردن خطای
انسان است نه حذف انسان: چسباندن به‌جای تایپ، تبدیل خودکار رقم و واحد، و بازبینی عقلی.

---

## ۵. نُه ترمز ضد خطای انسانی که همین حالا در برنامه هست

۱. **رقم‌های فارسی و عربی** خودشان لاتین می‌شوند؛ لازم نیست دستی عوض کنید.
۲. **جداکننده‌ها و واحدها:** برنامه `۲۰٬۰۰۰ ریال` و `20,000` و `1.5` را یکسان می‌خواند؛ با تیک
۲. **جداکننده‌ها و واحدها:** برنامه `۲۰٬۰۰۰ ریال` و `20,000` و `1.5` را یکسان می‌خواند؛ تیک «تومان» عددها را یک‌بار به ریال برمی‌گرداند و خطای رایج «تومان با ریال قاطی شده» همان‌جا گرفته می‌شود.

   می‌شود.
۳. **تشخیص راهبرد از خودِ متن**: کلمه‌هایی مثل «کری»، «پوشش‌داده‌شده»، «تبعی»، «باکس»، «تساوی»
   خودشان راهبرد را می‌گویند.
۴. **تشخیص از تعداد عددها** وقتی کلمه‌ای ننوشته‌اید؛ و اگر دو راهبرد با آن عددها بخواند، صریح
   می‌گوید **دوپهلو** است تا خودتان انتخاب کنید.
۵. **گفتن تعارض**: اگر «سرستون‌ها» یک خوانش بدهند و «ترتیب معمولی» خوانش دیگری، برنامه هر دو را
   می‌گوید (نه اینکه یکی را ساکت انتخاب کند).
۶. **بازبینی عقلی**: عددهایی که از نظر اقتصادی محال‌اند بی‌صدا رد نمی‌شوند؛ مثلاً در
   پوشش‌داده‌شده اعمال باید بالاتر از قیمت پایه باشد، و در تبعی اعمال از قیمت سهم پایین‌تر.
۷. **گیر افتادن واحد در مارجین**: اگر وجه تضمین را تومان و ارزش قرارداد را ریال بدهید، برنامه عدد
   نامعقول چاپ نمی‌کند؛ می‌گوید «احتمالاً دو واحد قاطی شده» و راه درست را می‌گوید.
۸. **دو روش حساب روی هر عدد کلیدی**: هر جا موتور عددی می‌دهد، فرمول و روش دستی مستقل هم چاپ
   می‌شود تا اختلاف صفر باشد. `selftest.py` ۱۵ سنجه را همین‌طور دو بار می‌سنجد.
۹. **زنجیرهٔ هش و اثر انگشت**: دفترها و پرونده‌ها اثر انگشت دارند؛ اگر ردیفی بعد از ثبت عوض شود،
   در بازبینی «شکسته» دیده می‌شود. برچسب «ساختگی/واقعی» و نوار تازگی هم نمی‌گذارد روز ساختگی را
   جای روز واقعی جا بزنید.

---

## ۶. چیزهایی که هرگز خودکار نمی‌شوند (و این به نفع شماست)

- **سفارش‌گذاری**: کدش هم وجود ندارد؛ نه به‌خاطر تنبلی، به‌خاطر قانون.
- **تصمیم**: عدد و دلیل را برنامه می‌دهد، تصمیم را شما.
- **رمز سامانهٔ کارگزاری**: هیچ‌وقت وارد نکنید؛ برنامه هیچ‌جا از شما نمی‌خواهد.
- **حدس عددی**: جای عدد نامعلوم (مثل وجه تضمین) عدد حدسی نگذارید. عدد حدسی، دلیلِ ساختگی
  می‌سازد و آن روز هم ساختگی شمرده می‌شود.

اگر روزی کسی به شما گفت برنامه‌اش «خودش می‌خرد و می‌فروشد» و «سود تضمینی» دارد، دو احتمال دارد:
یا بیرون از قانون کار می‌کند، یا دارد اغراق می‌کند. شما لازم نیست هیچ‌کدام باشید.

---

## ۷. تمرین ده دقیقه‌ای: اولین روز کامل

۱. `run-gui.bat` (یا `python3 web_server.py --port 8765`) → مرورگر.
۲. گام ۱: پنل مدیریت را باز کنید، وارد شوید، «بررسی سلامت برنامه» (باید ۸ از ۸ سالم باشد).
۳. گام ۲: «ساخت قالب نمونه» و «آزمایش خواندن این پرونده» تا مطمئن شوید برنامه داده می‌خواند.
۴. گام ۲: یک پروفایل رایگان را «آزمایش اتصال» و اگر سبز بود «ذخیره و فعال کردن».
۵. گام ۲: سطر واقعی امروز را از سامانهٔ کارگزاری بچسبانید، تیک تأیید را بزنید، «ذخیرهٔ اسنپ‌شات
   امروز».
۶. گام ۳: نرخ سد را از صندوق درآمد ثابت بگذارید و «ذخیرهٔ تنظیمات».
۷. گام ۵: «شروع محاسبه».
۸. گام ۶: یک سیگنال را تأیید یا با دلیل رد کنید.
۹. گام ۹: «اجرای مراسم امروز» → «به‌روزرسانی جدول» → «بررسی زنجیرهٔ هش» (باید سالم باشد).
۱۰. گام ۸: «ساخت بستهٔ راستی‌آزمایی» و پوشهٔ ساخته‌شده را باز کنید؛ داخلش `README-FA.md` را بخوانید.

از فردا فقط بند ۵ (شصت ثانیه) و بند ۹ تکرار می‌شود.

---

## ۸. اگر جایی گیر کردید: علامت، معنا، کارِ شما

| پیامی که می‌بینید | معنا | کارِ شما |
| --- | --- | --- |
| «پاسخی نیامد (دریافت ناموفق ۵۰۳…)» | آن سرویس عمومی امروز پایین است | پروفایل دیگر را بیازمایید، یا سطر را دستی بچسبانید |
| «هیچ ردیفی برای محاسبه نیست» | جدول اعداد خالی است | دکمهٔ «ساخت قالب نمونه» یا چسباندن اعداد امروز |
| «عدد نامعقول… دو واحد قاطی شده» | تومان و ریال قاطی شده | تیک «تومان» را بزنید یا ریال بنویسید |
| «دوپهلو: … می‌تواند باشد» | راهبرد از عددها یکتا درنمی‌آید | نام راهبرد را در سطر بنویسید |
| «اثر انگشت زنجیرهٔ دفتر: شکسته» | فایلی بعد از ثبت عوض شده | پرونده را بازنگرید؛ برای جلسه از نسخهٔ سالم استفاده کنید |
| «۴۰۳ … از /admin وارد شوید» | این بخش فقط در پنل مدیریت باز می‌شود | وارد پنل شوید (توکن یک‌ساعته است) |
| «شناسه یا رمز درست نیست. n تلاش تا قفل» | رمز اشتباه | رمز را با `adminauth.py --set-pass` عوض کنید |

---

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

✍️ تهیه‌کنندهٔ جزوات: Masoud Mojarabian · 📱 [989126630554](tel:+989126630554) · ✈️ [Telegram: Mojarabian](https://t.me/Mojarabian) · 📸 [Instagram: Mojarabian.Art](https://instagram.com/Mojarabian.Art)