diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000000000000000000000000000000000000..e815a785a4cffbfd007a8c524a6a9e5f251c3cf8
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,24 @@
+# تصویر اجرا روی Hugging Face Spaces (Docker SDK) و Render.
+# تفاوتش با Dockerfile سرور: درگاه ۷۸۶۰ (قرار HF)، بدون volume، و اجرای برنامه با boot.sh
+# که از متغیرهای محیطی، دو حساب را میسازد و دروازه را روشن میکند.
+FROM python:3.13-slim
+
+ENV PYTHONUNBUFFERED=1 \
+ PYTHONDONTWRITEBYTECODE=1 \
+ STATION_PORT=7860
+
+WORKDIR /app
+COPY . /app
+
+# کاربر غیر ریشه (قرار خود HF) + پوشههای نوشتنی برنامه
+RUN useradd -m -u 1000 desk \
+ && mkdir -p /app/data /app/config /app/export \
+ && chmod +x /app/boot.sh \
+ && chown -R desk:desk /app
+USER desk
+
+EXPOSE 7860
+HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
+ CMD python -c "import urllib.request as u; u.urlopen('http://127.0.0.1:' + __import__('os').environ.get('PORT', '7860') + '/login', timeout=4)"
+
+CMD ["bash", "boot.sh"]
diff --git a/HF-BUNDLE-MANIFEST.json b/HF-BUNDLE-MANIFEST.json
new file mode 100644
index 0000000000000000000000000000000000000000..3ceb47ccf2fe9fc1af8ced37257f1b847309ac00
--- /dev/null
+++ b/HF-BUNDLE-MANIFEST.json
@@ -0,0 +1,26 @@
+{
+ "name": "iran-desk-hf",
+ "files": 148,
+ "root": [
+ "Dockerfile",
+ "README-HF-FA.md",
+ "README.md",
+ "boot.sh",
+ "desk",
+ "kodal-alert",
+ "render.yaml",
+ "station",
+ "strategies",
+ "tools"
+ ],
+ "key_files": {
+ "Dockerfile": "9b941f077aa74a77",
+ "README.md": "b00e906f1d15480b",
+ "boot.sh": "2c620a90ffba5922",
+ "README-HF-FA.md": "7fa085a85f68a812",
+ "render.yaml": "2adcdff48d7c2c42"
+ },
+ "secret_like_literals_found": 0,
+ "phone_occurrences": 15,
+ "note": "ساختهشده برای میزبان ابری مجانی: درگاه ۷۸۶۰، دروازه از متغیرهای محیطی، بدون رمز در بسته"
+}
diff --git a/README-HF-FA.md b/README-HF-FA.md
new file mode 100644
index 0000000000000000000000000000000000000000..ecfe5ef791e7d8adc711473ff3bc3b6c1c4ffe3b
--- /dev/null
+++ b/README-HF-FA.md
@@ -0,0 +1,121 @@
+# بردن برنامه روی یک میزبان مجانی (Hugging Face Spaces)
+
+**این پرونده برای خودت است، نه برای کارفرما.** اینجا نوشتهام چطور در حدود پنج دقیقه برنامه را
+روی یک فضای مجانی بالا بیاوری، بدون سرور، بدون دامنه و **بدون کارت بانکی**. حساب کاربری را باید
+خودت بسازی (ثبتنام به ایمیل خودت نیاز دارد)، ولی همهٔ کار فنی آماده است.
+
+## چه چیزی مجانی است و چه چیزی نیست (بیپرده)
+
+| موضوع | واقعیت |
+| --- | --- |
+| هزینه | صفر. HF برای Space با CPU رایگان (۲ vCPU و ۱۶ گیگ رم) کارت بانکی نمیخواهد |
+| نشانی | آدرس `https` روی دامنهٔ خودشان (`*.hf.space`) با گواهی SSL |
+| داده | روی دیسک موقت (حدود ۵۰ گیگ)؛ **با هر بازسازی پاک میشود** |
+| خواب رفتن | بعد از حدود ۴۸ ساعت بیکاری میخوابد؛ اولین بازدید ۳۰ تا ۹۰ ثانیه بیدارش میکند |
+| خصوصی بودن | Space مجانی **عمومی** است؛ یعنی آدرسش برای همه باز است. پس دروازه باید روشن بماند و رمزها محرمانه |
+| دادهٔ واقعی | **روی HF دادهٔ واقعی معاملات نگذار.** این نسخه برای نمایش و آزمون است |
+
+## گامبهگام
+
+۱. **حساب بساز:** [huggingface.co/join](https://huggingface.co/join) (ایمیل و رمز؛ کارت نمیخواهد).
+
+۲. **Space بساز:** [huggingface.co/new-space](https://huggingface.co/new-space)
+ - **Name:** مثل `desk-station`
+ - **SDK:** `Docker` · **Template:** `Blank`
+ - **Space hardware:** `CPU basic · FREE`
+ - **Visibility:** `Public` → بعد `Create Space`
+
+۳. **بستهٔ آماده را بالا بگذار.** روی رایانهٔ خودت:
+
+```bash
+# ۱) بسته را بساز (همین یک فرمان؛ خروجی در MATERIALS/money/delivery/iran-desk-hf)
+cd MATERIALS/money/gui/deploy
+python3 make_hf.py --zip
+
+# ۲) ابزار آپلود
+pip install -U huggingface_hub
+hf auth login # توکن را از Settings → Access Tokens بساز و بچسبان
+
+# ۳) آپلود
+hf upload <نامکاربری>/desk-station ../../../delivery/iran-desk-hf . --repo-type space
+```
+
+روش جایگزین با git:
+
+```bash
+git clone https://huggingface.co/spaces/<نامکاربری>/desk-station
+cp -r ../../../delivery/iran-desk-hf/. desk-station/
+cd desk-station && git add -A && git commit -m "ایستگاه تصمیم مشتقه" && git push
+```
+
+۴. **پنج مقدار محرمانه** را در `Settings` → `Variables and secrets` → `New secret` بگذار:
+
+| نام | مقدار |
+| --- | --- |
+| `STATION_ADMIN_ID` | شناسهٔ مدیر (مثل `mafhoom`) |
+| `STATION_ADMIN_PASS` | رمز قوی پنل مدیریت (خودت بساز: ۱۲ نویسهٔ تصادفی) |
+| `STATION_GUEST_ID` | شناسهٔ کارفرما (مثل `masoud`) |
+| `STATION_GUEST_PASS` | رمز قوی کارفرما (این را به او میدهی) |
+| `STATION_GUEST_OFF` | اختیاری: `1` یعنی کارفرما فعلاً نتواند وارد شود |
+
+اگر اینها را نگذاری، برنامه موقع بالا آمدن **خودش رمز تصادفی میسازد و در گزارش (Logs) چاپ میکند** —
+کار میکند، ولی رمز در گزارش میماند؛ برای آزمون سریع خوب است، برای کار جدی نه.
+
+۵. وقتی وضعیت Space روی `Running` رفت، این آدرس را باز کن و یکبار خودت با حساب مدیر وارد شو:
+
+```
+https://<نامکاربری>-desk-station.hf.space/login
+```
+
+بعد همان آدرس `/login` را با **رمز کارفرما** برایش بفرست. رمز مدیر را هرگز نفرست.
+
+## مهم: دو راه HF داریم و یکی از آنها مجانی است
+
+آزمودیم (۲۲ سپتامبر ۲۰۲۶): Space **داکری** روی حساب مجانی HF پاسخ ۴۰۲ میدهد و اشتراک PRO لازم
+دارد. ولی Space **ایستا** برای همه مجانی است. پس دو ابزار داریم:
+
+| راه | فرمان | چه میدهد |
+| --- | --- | --- |
+| نمونهٔ ثابت (مجانی) | `./activate_demo_site.sh` | خودِ رابط + تمام خروجیهای واقعی، روی یک لینک عمومی ثابت، بدون کارتی |
+| برنامهٔ زندهٔ داکری | `./activate_hf.sh` | اگر روزی PRO داشتی: سرور کامل با دروازهٔ ورود و دادهٔ زنده |
+
+نمونهٔ ثابت از اینها ساخته میشود: `tools/record_static_demo.mjs` (ضبط پاسخهای واقعی در حاشیهٔ
+همان آزمون ۱۹۲ بررسی) → `deploy/make_demo_site.py` (ساخت سایت ایستا + لایهٔ پاسخهای ضبطشده) →
+`deploy/huggingface/activate_demo_site.py` (نشر + آزمودن زنده با `tools/check_demo_site.mjs`).
+
+## آزمودن سمت خودت (پیش از آپلود)
+
+خود `boot.sh` همان کاری را میکند که HF میکند؛ میتوانی محلی هم بیازمایی:
+
+```bash
+cd ../../../delivery/iran-desk-hf
+STATION_ADMIN_PASS='<رمز-آزمون-مدیر>' STATION_GUEST_ID=masoud STATION_GUEST_PASS='<رمز-آزمون-کارفرما>' \
+ STATION_PORT=7860 bash boot.sh
+# در مرورگر: http://127.0.0.1:7860 (بدون ورود ۴۰۱ · با حساب کارفرما ۲۰۰ · پنل مدیر ۴۰۳ برای کارفرما)
+```
+
+## بیدار نگه داشتن (اختیاری، مجانی)
+
+Space مجانی بعد از حدود ۴۸ ساعت بیکاری میخوابد. اگر میخواهی همیشه بیدار باشد، در یک سرویس
+زمانبند مجانی (مثل cron-job.org) یک کار بساز که هر یک ساعت آدرس `https://<...>.hf.space/login`
+را باز کند. این کار هم مجانی است، ولی تضمین آپتایم نمیدهد.
+
+## خاموش کردن و حذف
+
+- **خاموش موقت:** در `Settings` → `Pause this Space`
+- **حذف کامل:** در `Settings` → `Delete this Space`
+- **قطع فقط کارفرما، بدون خواباندن برنامه:** `STATION_GUEST_OFF=1` را در Secrets بگذار (یا در
+ پنل مدیریت نشستهای مهمان را ببند)
+
+هیچچیز اینجا گروگان نیست: هر وقت سرور یا دامنهٔ خودت را آوردی، همین برنامه را با پوشهٔ `deploy/`
+روی آن ببر و Space را حذف کن؛ داده و رمزها سمت خودت میمانند.
+
+## اگر HF را نخواستی: Render
+
+`deploy/render/render.yaml` هم گذاشتهام (یک میزبان مجانی دیگر، بدون کارت بانکی). فرقش: فقط
+۵۱۲ مگ رم و ۰٫۱ پردازنده دارد، **بعد از ۱۵ دقیقه بیکاری میخوابد** و بیدار شدنش ۳۰ تا ۶۰ ثانیه
+طول میکشد؛ برای نمایش زندهٔ نیمساعته خوب نیست، برای تستهای گاهبهگاه بهکار میآید. راهش:
+کد را روی یک مخزن GitHub بگذار و در Render گزینهٔ `Blueprint` را انتخاب کن.
+
+> **پرسش باز:** اگر حساب HF یا GitHub داری و میخواهی خودم گامها را با تو جلو ببرم، بگو کدام گام
+> گیر کردی؛ ولی ساختن حساب و زدن توکن باید دست خودت باشد (رمز و ایمیل تو را نمیپرسم).
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..43a427389fdc5f3ba981392dc3fe0f2fb713f824
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# Iran Desk Station — Docker bundle (for Render / any Docker host)
+
+Full trading-decision station (Python stdlib server). Build: `docker build .` then run with env:
+`STATION_ADMIN_ID`, `STATION_ADMIN_PASS`, `STATION_GUEST_ID`, `STATION_GUEST_PASS`.
+Listens on `$PORT` (default 7860). Health check: `/login`.
diff --git a/boot.sh b/boot.sh
new file mode 100644
index 0000000000000000000000000000000000000000..e9642502d705ebf71f18d677db180414383c86a7
--- /dev/null
+++ b/boot.sh
@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# بالا آوردن ایستگاه روی میزبان ابری (Hugging Face Spaces یا Render).
+#
+# ترتیب کار: از محیط، شناسه و رمزها را میخواند → دروازه را روشن میکند → برنامه را اجرا میکند.
+# اگر رمزی در محیط نبود، خودش رمز قوی میسازد و در گزارش چاپ میکند (برای آزمون سریع).
+set -euo pipefail
+HERE="$(cd "$(dirname "$0")" && pwd)"
+cd "$HERE/station" # برنامه، پوشهٔ «desk» و «kodal-alert» را همسایهٔ خودش میخواهد
+
+# میزبانها درگاه را خودشان میدهند: HF انتظار ۷۸۶۰ دارد، Render متغیر PORT میفرستد.
+PORT="${PORT:-${STATION_PORT:-7860}}"
+ADMIN_ID="${STATION_ADMIN_ID:-mafhoom}"
+GUEST_ID="${STATION_GUEST_ID:-masoud}"
+ADMIN_PASS="${STATION_ADMIN_PASS:-}"
+GUEST_PASS="${STATION_GUEST_PASS:-}"
+
+gen() { python3 -c "import secrets; print('Desk-' + secrets.token_hex(4))"; }
+
+echo "── ایستگاه تصمیم مشتقه، نسخهٔ میزبان ابری ──"
+echo " درگاه: $PORT · شناسهٔ مدیر: $ADMIN_ID · شناسهٔ کارفرما: $GUEST_ID"
+
+if [ -z "$ADMIN_PASS" ]; then
+ ADMIN_PASS="$(gen)"
+ echo " ⚠️ STATION_ADMIN_PASS نبود؛ رمز مدیر ساخته شد: $ADMIN_PASS"
+ echo " این رمز را در Secrets بگذار (این پیام فقط برای خودت است، ولی در گزارش میماند)."
+fi
+python3 adminauth.py --set-id "$ADMIN_ID" --set-pass "$ADMIN_PASS" >/dev/null
+
+if [ -z "$GUEST_PASS" ]; then
+ GUEST_PASS="$(gen)"
+ echo " ⚠️ STATION_GUEST_PASS نبود؛ رمز کارفرما ساخته شد: $GUEST_PASS"
+fi
+python3 gate.py --sync-admin >/dev/null
+python3 gate.py --guest-id "$GUEST_ID" --guest-pass "$GUEST_PASS" >/dev/null
+if [ "${STATION_GUEST_OFF:-0}" = "1" ]; then
+ python3 gate.py --guest-off >/dev/null
+ echo " کارفرما فعلاً بسته است (STATION_GUEST_OFF=1)."
+else
+ python3 gate.py --guest-on >/dev/null
+fi
+python3 gate.py --on >/dev/null
+echo " دروازه روشن است: بدون شناسه و رمز، هیچ صفحهای باز نمیشود."
+python3 gate.py --status | sed 's/^/ /'
+
+echo " آماده است. آدرس درگاه: 0.0.0.0:$PORT (بدون ورود: 401)"
+exec python3 -m web_server --port "$PORT" --host 0.0.0.0 --no-browser
diff --git a/desk/README-FA.md b/desk/README-FA.md
new file mode 100644
index 0000000000000000000000000000000000000000..4dda3556711b7d1593bd743d2a7aeeb74eb7b2f1
--- /dev/null
+++ b/desk/README-FA.md
@@ -0,0 +1,100 @@
+# میز معاملات (دستیار تصمیم با تأیید انسان) — راهنمای فارسی
+
+نسخهٔ ۰٫۱٫۰ · صفر وابستگی · اجرا روی ویندوز یا لینوکس · بدون اینترنت هم کار میکند
+
+## این برنامه چه کار میکند
+
+۱. یک **اسنپشات بازار** (پروندهٔ JSON ساده) را میگیرد: قیمت پایه، زنجیرهٔ آپشن، آتی، اوراق تبعی، وجه تضمین.
+۲. هر ردیف را روی **موتور ریاضی** (`../tools/derivatives_scout.py`) میگذارد: پایهٔ نقدیآتی، باکس اسپرد، تبعی، پوششدادهشده، تساوی پوتکال.
+۳. خبرها و هشدارهای **دیدهبان کدال** را به همان نمادها میچسباند (خبر بهتنهایی سیگنال نیست؛ خبرها موتور را دوباره حسابشده نگه میدارند).
+۴. **دروازههای ریسک** را اعمال میکند و اندازهٔ هر موقعیت را از بودجهٔ وجه تضمین درمیآورد.
+۵. یک **داشبورد HTML** میسازد و **بستهٔ سفارش** چاپ میکند تا **انسان** آن را در سامانهٔ کارگزاری اجرا کند.
+
+## این برنامه چه کار نمیکند (مهم)
+
+- **هیچ سفارشی ارسال نمیکند.** طبق ابلاغیهٔ مهر ۱۳۹۹ سازمان بورس، معاملات الگوریتمی و تقسیم سفارشات توسط مشتریان برخط در بورس و فرابورس «تا اطلاع ثانوی» ممنوع است و کارگزاران موظفاند چنین دسترسیهایی را ببندند.
+- سود تضمین نمیکند، قیمت پیشبینی نمیکند، و هیچجا «سیگنال خرید» به معنای توصیه نمیدهد. خروجی، «تفاوت ریاضی با نرخ سد» است.
+
+## چرخهٔ کار (هفت گام)
+
+```
+اسنپشات بازار → موتور ریاضی → چسباندن هشدارهای کدال → دروازههای ریسک
+ ↓
+اندازهگذاری از بودجهٔ وجه تضمین → داشبورد تصمیم → تأیید یا رد انسانی → بستهٔ سفارش → اجرا در کارگزاری
+```
+
+## اجرا
+
+```bash
+python desk.py selftest
+python desk.py run --market market-demo.json --kodal-db ../kodal-alert/data/demo.sqlite3
+python desk.py list --status pending
+python desk.py approve 3ed6c3f0710c --note "ریسک پذیرفته شد و منبع خبر هم بررسی شد"
+python desk.py reject f9c3112e6ff2 --note "عمق بازار کافی نیست"
+python desk.py packet 3ed6c3f0710c
+python -m unittest discover -s tests # ۲۶ آزمون واحد
+```
+
+## قالب اسنپشات بازار
+
+```json
+{"as_of": "2026-09-22", "hurdle": 0.39, "capital": 20000000000,
+ "rows": [
+ {"symbol": "اهرم", "kind": "basis", "spot": 20000, "future": 22800, "days": 90,
+ "margin_per_contract": 20000000, "unit": "قرارداد",
+ "liquidity_contracts_per_day": 900, "spread_pct": 0.005},
+ {"symbol": "فولاد", "kind": "covered_call", "spot": 7000, "strike": 7600,
+ "premium": 400, "days": 45, "margin_per_contract": 7000, "unit": "سهم"}
+ ]}
+```
+
+انواع `kind`: `basis` (پایهٔ نقدیآتی) · `box` (باکس اسپرد) · `tabei` (اوراق اختیار فروش تبعی) · `covered_call` (فروش کال پوششدادهشده) · `parity` (تساوی پوتکال).
+
+کلیدهای هر ردیف: `symbol`، `kind`، پارامترهای ریاضی همان راهبرد (مثل `spot`، `future`، `strike`، `premium`، `put_price`، `days`)، `margin_per_contract` (وجه تضمین یا بهای هر واحد)، `unit` (قرارداد یا سهم)، `liquidity_contracts_per_day` و `spread_pct` برای دروازهٔ نقدشوندگی.
+
+## قواعد ریسک پیشفرض (`config.json`)
+
+| قاعده | پیشفرض | معنا |
+|---|---|---|
+| `max_margin_pct` | ۲۰ درصد | سقف کل سرمایهٔ درگیر در وجه تضمین |
+| `max_position_pct` | ۳۵ درصد از بودجه | سقف هر موقعیت، تا یک معامله همهٔ بودجه را نخورد |
+| `max_positions` | ۳ | سقف موقعیتهای تأییدشدهٔ همزمان |
+| `min_liquidity_contracts_per_day` | ۲۰ | کف نقدشوندگی |
+| `max_spread_pct` | ۳ درصد | سقف اسپرد خریدوفروش |
+| `min_edge_arbitrage_pct` | ۳ واحد درصد | کف حاشیه برای راهبردهای آربیتراژی |
+| `min_edge_leveraged_pct` | ۵ واحد درصد | کف حاشیه برای راهبردهای اهرمی |
+
+تأیید انسانی هم از همین سقفها عبور نمیکند: اگر تأیید سیگنالی سقف ریسک را رد کند، برنامه با کد خروج ۳ متوقف میشود و فقط با `--force` و ثبت دلیل در دفتر، رد میشود.
+
+## هفت چیزی که در نمونهٔ آماده میبینید
+
+۱. «اهرم · پایهٔ نقدیآتی» با حاشیهٔ ۲۹٫۴۸ واحد درصد منتظر تأیید است، چون نرخ تلویحی آتی از نرخ سد جلوتر است.
+۲. «فولاد · پوششدادهشده» با حاشیهٔ ۱۷٫۵۶ واحد درصد منتظر است؛ پرمیوم گران است.
+۳. «کگل · تبعی» با حاشیهٔ ۳٫۳۶ واحد درصد بهسختی از دروازه رد میشود.
+۴. «خساپا · تبعی» رد میشود، چون بازده تضمینیاش از صندوق درآمد ثابت کمتر است؛ این درسِ اصلی این بازار است.
+۵. «وبملت · تساوی پوتکال» رد میشود، چون نیمهٔ دیگر آربیتراژ به فروش استقراضی نیاز دارد و در ایران ممکن نیست.
+۶. «شپنا · باکس اسپرد» با وجود بازده خوب رد میشود، چون حجم روزانهاش ۱۲ و اسپردش ۴٫۵ درصد است.
+۷. «طلا · پایهٔ نقدیآتی» رد میشود، چون مبنای آتی از نرخ صندوق درآمد ثابت کمتر است.
+
+## وصل شدن به دیدهبان کدال
+
+پایگاهدادهٔ دیدهبان را با `--kodal-db` بدهید. برنامه سه کار میکند:
+
+- هشدارهای همان نماد را در داشبورد زیر سیگنال نشان میدهد.
+- برای نمادهایی که خبر مهم دارند ولی در اسنپشات بازار نیستند، «کار بازبینی» میسازد.
+- برای سیگنالهای بدون پشتوانهٔ خبری و حاشیهٔ کم، دروازهٔ اولویتپایین فعال میشود.
+
+## اجرا در شرایط ایران
+
+- روی رایانهٔ خودتان اجرا کنید؛ هیچ سرویس ابری و هیچ پرداخت ارزی لازم نیست.
+- اگر اینترنت یا سامانهٔ داده در دسترس نیست، اسنپشات را دستی از سامانهٔ کارگزاری در `market.json` وارد کنید و همان را اجرا کنید.
+- پایگاهداده روی دیسک است؛ قطعی برق تصمیمهای ثبتشده را از بین نمیبرد و اجرای بعدی، وضعیتها را حفظ میکند.
+- تصمیمهای انسان (تأیید و رد) قفل میشوند و اجرای دوبارهٔ `run` آنها را بازنویسی نمیکند.
+
+## قدم بعدی
+
+اتصال خودکار دادهٔ `tsetmc` و زنجیرهٔ آپشن، و گزارش روزانهای که بازده انتظاری را با نتیجهٔ واقعی مقایسه کند. تا آن زمان، ورود دستی اسنپشات کامل است.
+
+## تهیهکننده
+
+✍️ تهیهکنندهٔ جزوات: Masoud Mojarabian · 📱 [+989126630554](tel:+989126630554) · ✈️ [Telegram: Mojarabian](https://t.me/Mojarabian) · 📸 [Instagram: Mojarabian.Art](https://www.instagram.com/Mojarabian.Art/)
diff --git a/desk/config.json b/desk/config.json
new file mode 100644
index 0000000000000000000000000000000000000000..99f6ed2b2b079095ab69acb6cad7c83a60f2f42c
--- /dev/null
+++ b/desk/config.json
@@ -0,0 +1,18 @@
+{
+ "capital": 5000000000,
+ "hurdle": 0.39,
+ "min_edge_arbitrage_pct": 3.0,
+ "min_edge_leveraged_pct": 5.0,
+ "max_margin_pct": 0.2,
+ "max_positions": 3,
+ "min_liquidity_contracts_per_day": 20,
+ "max_spread_pct": 0.03,
+ "alert_score_threshold": 60,
+ "desk_db": "",
+ "report_path": "",
+ "credit": "تهیهکننده: Masoud Mojarabian · https://www.instagram.com/Mojarabian.Art/ · tel:+989126630554 · https://t.me/Mojarabian",
+ "report_title": "میز معاملات — داشبورد تصمیم",
+ "max_position_pct": 0.35,
+ "max_plausible_arb_pct": 250.0,
+ "max_plausible_lev_pct": 400.0
+}
\ No newline at end of file
diff --git a/desk/desk.py b/desk/desk.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5d5a2e64aab11c8d3e734a2ce631b43060f1002
--- /dev/null
+++ b/desk/desk.py
@@ -0,0 +1,775 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""میز معاملات (دستیار تصمیم با تأیید انسان) — نسخهٔ ۰٫۱٫۰
+
+این برنامه سه کار میکند:
+ ۱. دادهٔ بازار (اسنپشات JSON) را روی موتور ریاضی مشتقه میگذارد.
+ ۲. هشدارهای «دیدهبان کدال» را به سیگنالهای ریاضی میچسباند.
+ ۳. بستهٔ سفارش آماده میکند تا **انسان** آن را در سامانهٔ کارگزاری اجرا کند.
+
+هیچ سفارشی از این برنامه ارسال نمیشود. علت: معاملات الگوریتمی خودکار در
+بورس و فرابورس ایران، طبق ابلاغیهٔ مهر ۱۳۹۹ سازمان بورس، «تا اطلاع ثانوی» ممنوع است.
+
+دستورها:
+ python desk.py selftest
+ python desk.py run --market market-demo.json --kodal-db ../kodal-alert/data/demo.sqlite3
+ python desk.py list --status pending
+ python desk.py approve 3f2a... --note "ریسک پذیرفته شد"
+ python desk.py reject 3f2a... --note "نقدشوندگی کم"
+ python desk.py packet 3f2a...
+"""
+from __future__ import annotations
+
+import argparse
+import hashlib
+import html
+import importlib.util
+import json
+import sqlite3
+import sys
+from dataclasses import dataclass, field
+from datetime import datetime, timezone
+from pathlib import Path
+
+VERSION = "0.1.0"
+BASE = Path(__file__).resolve().parent
+DEFAULT_DB = BASE / "data" / "desk.sqlite3"
+DEFAULT_REPORT = BASE / "data" / "dashboard.html"
+SCOUT_PATH = (BASE.parent / "tools" / "derivatives_scout.py").resolve()
+CREDIT = ("تهیهکننده: Masoud Mojarabian · https://www.instagram.com/Mojarabian.Art/ · "
+ "tel:+989126630554 · https://t.me/Mojarabian")
+
+DEFAULT_CONFIG: dict = {
+ "capital": 5_000_000_000,
+ "hurdle": 0.39,
+ "min_edge_arbitrage_pct": 3.0,
+ "min_edge_leveraged_pct": 5.0,
+ "max_margin_pct": 0.20,
+ "max_positions": 3,
+ "max_position_pct": 0.35,
+ "min_liquidity_contracts_per_day": 20,
+ "max_spread_pct": 0.03,
+ "alert_score_threshold": 60,
+ "max_plausible_arb_pct": 250.0, # سقف باورپذیری بازده سالانهٔ راهبردهای آربیتراژی
+ "max_plausible_lev_pct": 400.0, # سقف باورپذیری بازده سالانهٔ راهبردهای اهرمی
+ "desk_db": "",
+ "report_path": "",
+ "credit": CREDIT,
+ "report_title": "میز معاملات — داشبورد تصمیم",
+}
+
+# ---------------------------------------------------------------- دسترسی به موتور ریاضی
+_SCOUT_CACHE: dict[str, object] = {}
+
+
+def load_scout(path: Path = SCOUT_PATH):
+ """موتور ریاضی مشتقه را از پروندهٔ همسایه بارگذاری میکند (بدون نصب بسته).
+
+ نتیجه در حافظه میماند: بی این کش، پسآزمایی هر سطر یک بار کل موتور را از نو
+ بارگذاری میکرد و صد سطر تاریخ چند ثانیه طول میکشید.
+ """
+ key = str(Path(path).resolve())
+ cached = _SCOUT_CACHE.get(key)
+ if cached is not None:
+ return cached
+ p = Path(path)
+ if not p.exists():
+ raise FileNotFoundError(f"موتور ریاضی پیدا نشد: {path}")
+ spec = importlib.util.spec_from_file_location("derivatives_scout", str(p))
+ module = importlib.util.module_from_spec(spec)
+ assert spec.loader is not None
+ # ثبت در sys.modules پیش از اجرا لازم است، وگرنه dataclass داخل موتور خطا میدهد
+ sys.modules["derivatives_scout"] = module
+ spec.loader.exec_module(module)
+ _SCOUT_CACHE[key] = module
+ return module
+
+
+# ---------------------------------------------------------------- ابزار پایه
+def now_iso() -> str:
+ return datetime.now(timezone.utc).isoformat(timespec="seconds")
+
+
+def g2j(gy: int, gm: int, gd: int) -> tuple[int, int, int]:
+ g_d_m = [0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334]
+ gy2 = gy + 1 if gm > 2 else gy
+ days = 355666 + (365 * gy) + ((gy2 + 3) // 4) - ((gy2 + 99) // 100) + ((gy2 + 399) // 400) + gd + g_d_m[gm - 1]
+ jy = -1595 + 33 * (days // 12053)
+ days %= 12053
+ jy += 4 * (days // 1461)
+ days %= 1461
+ if days > 365:
+ jy += (days - 1) // 365
+ days = (days - 1) % 365
+ jm = 1 + days // 31 if days < 186 else 7 + (days - 186) // 30
+ jd = 1 + days % 31 if days < 186 else 1 + (days - 186) % 30
+ return jy, jm, jd
+
+
+def fa_time(dt: datetime | None = None) -> str:
+ dt = dt or datetime.now(timezone.utc)
+ jy, jm, jd = g2j(dt.year, dt.month, dt.day)
+ return f"{jy:04d}/{jm:02d}/{jd:02d} {dt.hour:02d}:{dt.minute:02d}"
+
+
+def log(msg: str) -> None:
+ print(f"[{fa_time()}] {msg}")
+
+
+def load_config(path: str | None = None) -> dict:
+ cfg = json.loads(json.dumps(DEFAULT_CONFIG, ensure_ascii=False))
+ p = Path(path) if path else BASE / "config.json"
+ if p.exists():
+ try:
+ user = json.loads(p.read_text(encoding="utf-8"))
+ for k, v in user.items():
+ if isinstance(v, dict) and isinstance(cfg.get(k), dict):
+ cfg[k].update(v)
+ else:
+ cfg[k] = v
+ except json.JSONDecodeError as e:
+ log(f"تنظیمات خوانده نشد ({e})؛ پیشفرض به کار میرود.")
+ return cfg
+
+
+# ---------------------------------------------------------------- دادهها
+@dataclass
+class Signal:
+ sid: str
+ symbol: str
+ kind: str
+ name: str
+ annualized_pct: float | None
+ score_pp: float
+ go: bool
+ detail: dict = field(default_factory=dict)
+ margin_per_contract: float = 0.0
+ contracts: int = 0
+ margin_locked: float = 0.0
+ status: str = "pending"
+ gate_note: str = ""
+ alerts: list[dict] = field(default_factory=list)
+
+ @property
+ def unit(self) -> str:
+ return str(self.detail.get("unit") or "قرارداد")
+
+ def as_row(self) -> tuple:
+ return (self.sid, now_iso(), self.symbol, self.kind, self.name,
+ self.annualized_pct, self.score_pp, int(self.go),
+ json.dumps(self.detail, ensure_ascii=False), self.margin_per_contract,
+ self.contracts, self.margin_locked, self.status, self.gate_note,
+ json.dumps(self.alerts, ensure_ascii=False))
+
+ @staticmethod
+ def from_row(row) -> "Signal":
+ (sid, _ts, symbol, kind, name, annualized, score_pp, go,
+ detail, margin, contracts, locked, status, gate_note, alerts) = row
+ return Signal(sid=sid, symbol=symbol, kind=kind, name=name, annualized_pct=annualized,
+ score_pp=score_pp, go=bool(go), detail=json.loads(detail or "{}"),
+ margin_per_contract=margin or 0.0, contracts=contracts or 0,
+ margin_locked=locked or 0.0, status=status, gate_note=gate_note or "",
+ alerts=json.loads(alerts or "[]"))
+
+
+SIGNAL_SELECT = ("SELECT sid, ts, symbol, kind, name, annualized, score_pp, go, detail, "
+ "margin_per_contract, contracts, margin_locked, status, gate_note, alerts FROM signals")
+
+
+class Desk:
+ def __init__(self, path: Path | str = DEFAULT_DB):
+ self.path = Path(path)
+ self.path.parent.mkdir(parents=True, exist_ok=True)
+ self.conn = sqlite3.connect(str(self.path))
+ self.conn.executescript("""
+ CREATE TABLE IF NOT EXISTS signals (
+ sid TEXT PRIMARY KEY, ts TEXT, symbol TEXT, kind TEXT, name TEXT,
+ annualized REAL, score_pp REAL, go INTEGER, detail TEXT,
+ margin_per_contract REAL, contracts INTEGER, margin_locked REAL,
+ status TEXT, gate_note TEXT, alerts TEXT);
+ CREATE TABLE IF NOT EXISTS decisions (
+ id INTEGER PRIMARY KEY AUTOINCREMENT, ts TEXT, sid TEXT, action TEXT, note TEXT);
+ """)
+ self.conn.commit()
+
+ # ── بستن تمیز (پایان کار / پروندههای موقت)
+ def close(self) -> None:
+ """پیوند پایگاهداده را میبندد. چند بار صدا زدنش بیخطر است."""
+ try:
+ self.conn.close()
+ except Exception: # noqa: BLE001 — بستن نباید برنامه را بیندازد
+ pass
+
+ def __enter__(self) -> "Desk":
+ return self
+
+ def __exit__(self, *exc) -> None:
+ self.close()
+
+ def __del__(self) -> None:
+ self.close()
+
+
+ # ---------- ثبت سیگنال
+ def upsert(self, sig: Signal, keep_status: bool = True) -> None:
+ old = self.get(sig.sid)
+ if old and keep_status:
+ sig.status = old.status
+ if old.gate_note and not sig.gate_note:
+ sig.gate_note = old.gate_note
+ self.conn.execute("DELETE FROM signals WHERE sid = ?", (sig.sid,))
+ self.conn.execute(
+ "INSERT INTO signals VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)", sig.as_row())
+ self.conn.commit()
+
+ def get(self, sid: str) -> Signal | None:
+ cur = self.conn.execute(SIGNAL_SELECT + " WHERE sid = ?", (sid,))
+ row = cur.fetchone()
+ return Signal.from_row(row) if row else None
+
+ def all(self, status: str | None = None, limit: int = 200) -> list[Signal]:
+ q = SIGNAL_SELECT + (" WHERE status = ?" if status else "") + " ORDER BY score_pp DESC LIMIT ?"
+ args = (status, limit) if status else (limit,)
+ return [Signal.from_row(r) for r in self.conn.execute(q, args).fetchall()]
+
+ def locked_margin(self, exclude_sid: str | None = None) -> float:
+ cur = self.conn.execute(
+ "SELECT COALESCE(SUM(margin_locked),0) FROM signals WHERE status = 'approved' AND sid IS NOT ?",
+ (exclude_sid,))
+ return float(cur.fetchone()[0])
+
+ def decide(self, sid: str, action: str, note: str) -> bool:
+ sig = self.get(sid)
+ if not sig:
+ return False
+ sig.status = action
+ if note:
+ sig.gate_note = note
+ self.upsert(sig, keep_status=False) # وضعیت تازه، عمداً بر وضعیت قبلی نوشته میشود
+ self.conn.execute("INSERT INTO decisions (ts, sid, action, note) VALUES (?,?,?,?)",
+ (now_iso(), sid, action, note))
+ self.conn.commit()
+ return True
+
+ def human_decided(self, sid: str) -> bool:
+ cur = self.conn.execute("SELECT 1 FROM decisions WHERE sid = ? LIMIT 1", (sid,))
+ return cur.fetchone() is not None
+
+ def decisions(self, limit: int = 50) -> list[tuple]:
+ return self.conn.execute(
+ "SELECT ts, sid, action, note FROM decisions ORDER BY id DESC LIMIT ?", (limit,)).fetchall()
+
+
+# ---------------------------------------------------------------- خواندن هشدارهای کدال
+def read_alerts(kodal_db: Path | str, min_score: int = 60, limit: int = 50) -> list[dict]:
+ """هشدارهای دیدهبان را میخواند. اگر پایگاهداده نبود، فهرست خالی برمیگرداند."""
+ p = Path(kodal_db)
+ if not p.exists():
+ log(f"پایگاهداده دیدهبان پیدا نشد: {p}")
+ return []
+ try:
+ conn = sqlite3.connect(f"file:{p}?mode=ro", uri=True)
+ rows = conn.execute(
+ "SELECT title, symbol, category, direction, score, url FROM items "
+ "WHERE score >= ? ORDER BY score DESC LIMIT ?", (min_score, limit)).fetchall()
+ conn.close()
+ except sqlite3.Error as e:
+ log(f"خواندن هشدارها ممکن نشد: {e}")
+ return []
+ return [{"title": t, "symbol": s, "category": c, "direction": d, "score": sc, "url": u}
+ for t, s, c, d, sc, u in rows]
+
+
+def related_alerts(symbol: str, alerts: list[dict]) -> list[dict]:
+ out = []
+ for a in alerts:
+ sym = (a.get("symbol") or "").strip()
+ if sym and (sym == symbol or sym in symbol or symbol in sym):
+ out.append(a)
+ elif not sym and symbol and symbol in (a.get("title") or ""):
+ out.append(a)
+ return out
+
+
+# ---------------------------------------------------------------- موتور ریاضی
+KIND_LABELS = {
+ "basis": "پایهٔ نقدیآتی",
+ "box": "باکس اسپرد",
+ "tabei": "اوراق تبعی",
+ "covered_call": "پوششدادهشده",
+ "parity": "تساوی پوتکال",
+}
+
+
+def math_for_row(row: dict, hurdle: float) -> dict:
+ """هر ردیف اسنپشات را روی موتور ریاضی میگذارد و خروجی استاندارد برمیگرداند."""
+ scout = load_scout()
+ sc = scout.Scenario(name=row.get("symbol", "?"), rows=[{k: v for k, v in row.items() if k != "margin_per_contract"}],
+ hurdle=hurdle)
+ result = scout.run_scenario(sc)[0]
+ if "error" in result:
+ raise ValueError(f"ردیف نامعتبر است: {result['error']}")
+ result["kind"] = row.get("kind", "نامشخص") # برچسب فارسی راهبرد در گزارشها
+ result["margin_per_contract"] = float(row.get("margin_per_contract", 0) or 0)
+ return result
+
+
+def signal_from_result(symbol: str, res: dict, cfg: dict) -> Signal:
+ kind = str(res.get("kind") or res.get("strategy") or "نامشخص")
+ name = f"{symbol} · {KIND_LABELS.get(kind, kind)}"
+ annual = res.get("annualized_pct")
+ sid = hashlib.sha1(f"{symbol}|{kind}|{json.dumps(res.get('detail', res), sort_keys=True, default=str)}"
+ .encode("utf-8")).hexdigest()[:12]
+ return Signal(sid=sid, symbol=symbol, kind=kind, name=name,
+ annualized_pct=annual if isinstance(annual, (int, float)) else None,
+ score_pp=float(res.get("score_pp", -999)),
+ go=bool(res.get("go")), detail=res,
+ margin_per_contract=float(res.get("margin_per_contract", 0) or 0))
+
+
+def gate_checks(sig: Signal, cfg: dict, desk: Desk) -> list[str]:
+ """دروازههای ریسک بدون اندازهگذاری: نقدشوندگی، اسپرد، تأیید موتور، سقف موقعیت."""
+ d = sig.detail
+ reasons: list[str] = []
+ if not sig.go:
+ reasons.append("موتور ریاضی این فرصت را تأیید نکرد.")
+ edge = sig.score_pp
+ threshold = (cfg["min_edge_arbitrage_pct"] if sig.kind in ("box", "parity", "tabei")
+ else cfg["min_edge_leveraged_pct"])
+ if edge < threshold:
+ reasons.append(f"حاشیهٔ {edge:.2f} واحد درصد کمتر از کف {threshold:.2f} درصدی این راهبرد است.")
+ liq = d.get("liquidity_contracts_per_day", 999)
+ if isinstance(liq, (int, float)) and liq < cfg["min_liquidity_contracts_per_day"]:
+ reasons.append(f"حجم روزانهٔ {liq} کمتر از کف نقدشوندگی {cfg['min_liquidity_contracts_per_day']} است.")
+ # دروازهٔ باورپذیری: بازده غیرمنطقی یعنی داده اشتباه است، نه فرصت تاریخی
+ ceiling = (cfg.get("max_plausible_arb_pct", 250.0) if sig.kind in ("box", "parity", "tabei")
+ else cfg.get("max_plausible_lev_pct", 400.0))
+ if isinstance(sig.annualized_pct, (int, float)) and abs(sig.annualized_pct) > ceiling:
+ reasons.append(f"بازده محاسبهشده {sig.annualized_pct:,.0f} درصد از سقف باورپذیری ({ceiling:,.0f} درصد) "
+ f"بیشتر است؛ یعنی یکی از اعداد ورودی غلط یا کهنه است. اول داده را بازبینی کنید.")
+ spread = d.get("spread_pct", 0) or 0
+ if spread > cfg["max_spread_pct"]:
+ reasons.append(f"اسپرد {spread * 100:.2f} درصد از سقف مجاز بیشتر است.")
+ if not sig.alerts and edge < threshold * 2:
+ reasons.append("بدون پشتوانهٔ خبری و با حاشیهٔ کم؛ اولویت پایین است.")
+ return reasons
+
+
+def size_position(sig: Signal, budget: float) -> str:
+ """اندازهٔ موقعیت را از بودجهٔ باقیمانده حساب میکند؛ در صورت نبود جا، پیام دلیل را میدهد."""
+ unit = sig.unit
+ if (sig.margin_per_contract or 0) <= 0:
+ sig.contracts = 0
+ return f"نرخ وجه تضمین هر {unit} در اسنپشات مشخص نشده؛ از مشخصات قرارداد بخوانید."
+ n = int(budget // sig.margin_per_contract)
+ if n < 1:
+ sig.contracts = 0
+ return f"بودجهٔ وجه تضمین (سقف {sig.margin_per_contract:,.0f} ریال برای هر {unit}) تمام شده است."
+ sig.contracts = n
+ sig.margin_locked = n * sig.margin_per_contract
+ return ""
+
+
+def apply_risk_gates(sig: Signal, cfg: dict, desk: Desk) -> Signal:
+ """نسخهٔ تکسیگنالی (برای آزمون و بازبینی دستی)."""
+ reasons = gate_checks(sig, cfg, desk)
+ approved_so_far = len([s for s in desk.all("approved") if s.sid != sig.sid])
+ if approved_so_far >= cfg["max_positions"]:
+ reasons.append(f"سقف {cfg['max_positions']} موقعیت تأییدشده پر است؛ اول یکی را ببندید.")
+ budget = cfg["capital"] * cfg["max_margin_pct"] - desk.locked_margin(exclude_sid=sig.sid)
+ budget = max(budget, 0.0)
+ note = size_position(sig, budget)
+ if reasons or note:
+ sig.status = "rejected"
+ sig.gate_note = " | ".join(reasons + ([note] if note else []))
+ else:
+ sig.status = "pending"
+ sig.gate_note = (f"حاشیهٔ {sig.score_pp:.2f} واحد درصد · {sig.contracts:,} {sig.unit} · "
+ f"سرمایهٔ درگیر {sig.margin_locked:,.0f} ریال")
+ return sig
+
+
+def scan_market(market_path: Path | str, cfg: dict, desk: Desk,
+ kodal_db: Path | str | None = None) -> list[Signal]:
+ """محاسبهٔ همهٔ ردیفها، سپس تخصیص بودجهٔ وجه تضمین بهترتیب امتیاز."""
+ data = json.loads(Path(market_path).read_text(encoding="utf-8"))
+ hurdle = float(data.get("hurdle", cfg["hurdle"]))
+ if data.get("capital"):
+ cfg["capital"] = float(data["capital"])
+ alerts = read_alerts(kodal_db, cfg["alert_score_threshold"]) if kodal_db else []
+ candidates: list[Signal] = []
+ for row in data.get("rows", []):
+ symbol = str(row.get("symbol", "?"))
+ try:
+ res = math_for_row(row, hurdle)
+ except Exception as e: # ورودی ناقص یا فرمول نامعتبر
+ log(f"ردیف {symbol} محاسبه نشد: {type(e).__name__}: {e}")
+ continue
+ res.setdefault("unit", row.get("unit") or ("سهم" if row.get("kind") in
+ ("tabei", "covered_call", "parity") else "قرارداد"))
+ sig = signal_from_result(symbol, res, cfg)
+ sig.alerts = related_alerts(symbol, alerts)
+ sig.gate_note = " | ".join(gate_checks(sig, cfg, desk))
+ candidates.append(sig)
+
+ candidates.sort(key=lambda s: s.score_pp, reverse=True)
+ budget_total = max(cfg["capital"] * cfg["max_margin_pct"] - desk.locked_margin(), 0.0)
+ policy = {"capital": cfg["capital"], "max_margin_pct": cfg["max_margin_pct"],
+ "cap_total": cfg["capital"] * cfg["max_margin_pct"],
+ "max_positions": cfg["max_positions"], "hurdle": hurdle}
+ for sig in candidates:
+ sig.detail["_policy"] = policy
+ budget = budget_total
+ per_position = budget_total * float(cfg.get("max_position_pct", 1.0))
+ for sig in candidates:
+ existing = desk.get(sig.sid)
+ if existing and desk.human_decided(sig.sid):
+ # تصمیم انسان بازنویسی نمیشود: اندازه و یادداشت همان میماند
+ sig.status, sig.contracts = existing.status, existing.contracts
+ sig.margin_locked, sig.gate_note = existing.margin_locked, existing.gate_note
+ desk.upsert(sig)
+ continue
+ if sig.gate_note:
+ sig.status = "rejected"
+ else:
+ note = size_position(sig, max(min(budget, per_position), 0.0))
+ if note:
+ sig.status = "rejected"
+ sig.gate_note = note
+ else:
+ budget -= sig.margin_locked
+ sig.status = "pending"
+ sig.gate_note = (f"حاشیهٔ {sig.score_pp:.2f} واحد درصد · {sig.contracts:,} {sig.unit} · "
+ f"سرمایهٔ درگیر {sig.margin_locked:,.0f} ریال")
+ desk.upsert(sig)
+ return candidates
+
+
+def recheck_tasks(cfg: dict, desk: Desk, kodal_db: Path | str, market_path: Path | str) -> list[dict]:
+ """نمادهایی که خبر مهم داشتهاند ولی در اسنپشات بازار ردیفی ندارند."""
+ data = json.loads(Path(market_path).read_text(encoding="utf-8"))
+ covered = {str(r.get("symbol", "")) for r in data.get("rows", [])}
+ out = []
+ for a in read_alerts(kodal_db, cfg["alert_score_threshold"]):
+ sym = (a.get("symbol") or "").strip()
+ if sym and sym in covered:
+ continue
+ if sym:
+ out.append({"symbol": sym, "reason": "خبر مهم، ولی دادهٔ آپشن/آتی این نماد در اسنپشات نیست",
+ "alert": a})
+ return out
+
+
+# ---------------------------------------------------------------- بستهٔ سفارش
+def order_packet(sig: Signal) -> str:
+ d = sig.detail
+ lines = [
+ "بستهٔ سفارش (اجرا فقط توسط انسان در سامانهٔ کارگزاری)",
+ "=" * 62,
+ f"نماد: {sig.symbol} راهبرد: {KIND_LABELS.get(sig.kind, sig.kind)}",
+ f"شمارهٔ سیگنال: {sig.sid}",
+ f"بازده سالانهٔ خالص برآوردی: {sig.annualized_pct if sig.annualized_pct is not None else '—'} درصد",
+ f"امتیاز نسبت به نرخ سد: {sig.score_pp} واحد درصد",
+ f"تعداد پیشنهادی: {sig.contracts:,} {sig.unit}",
+ f"سرمایهٔ درگیر (وجه تضمین یا بهای خرید): {sig.margin_locked:,.0f} ریال",
+ "",
+ "جزئیات ریاضی:",
+ ]
+ for k, v in d.items():
+ if k in ("name", "strategy", "kind", "liquidity_contracts_per_day", "spread_pct", "leverage_used"):
+ continue
+ lines.append(f" · {k}: {v}")
+ if sig.alerts:
+ lines.append("")
+ lines.append("خبرهای مرتبط (فقط برای زمینه؛ خبر بهتنهایی سیگنال نیست):")
+ for a in sig.alerts:
+ lines.append(f" · [{a.get('score')}] {a.get('title')}")
+ lines += [
+ "",
+ "یادآوریهای اجرایی:",
+ " ۱. پیش از ثبت، قیمت لحظهای و عمق بازار را دوباره ببینید؛ اعداد اسنپشات، تاریخیاند.",
+ " ۲. پاهای آربیتراژ را در یک پنجرهٔ زمانی کوتاه و همزمان اجرا کنید، وگرنه ریسک اجرا میگیرید.",
+ " ۳. این بسته «پیشنهاد» است؛ تصمیم و مسئولیت با شماست. سود تضمینی وجود ندارد.",
+ ]
+ return "\n".join(lines)
+
+
+# ---------------------------------------------------------------- داشبورد HTML
+def build_dashboard(desk: Desk, cfg: dict, path: Path | str = DEFAULT_REPORT,
+ tasks: list[dict] | None = None) -> Path:
+ path = Path(path)
+ path.parent.mkdir(parents=True, exist_ok=True)
+ all_sigs = desk.all(limit=500)
+ pending = [s for s in all_sigs if s.status == "pending"]
+ approved = [s for s in all_sigs if s.status == "approved"]
+ rejected = [s for s in all_sigs if s.status == "rejected"]
+
+ def rows(items: list[Signal], show_gate: bool = True) -> str:
+ out = []
+ for s in items:
+ color = "#0a7d33" if s.score_pp > 10 else ("#8a6d00" if s.score_pp > 0 else "#b3261e")
+ news = " ".join(html.escape(a.get("title", "")[:110]) for a in s.alerts[:3]) or "—"
+ out.append(f"""
+ {html.escape(s.sid)}
+ {html.escape(s.symbol)}
+ {html.escape(KIND_LABELS.get(s.kind, s.kind))}
+ {'' if s.annualized_pct is None else f'{s.annualized_pct:.2f}'}
+ {s.score_pp:.2f}
+ {s.contracts:,} {html.escape(s.unit)}
+ {s.margin_locked:,.0f}
+ {html.escape(s.status)}
+ {html.escape(s.gate_note)}{f'{news}
' if news != '—' else ''}
+ """)
+ return "".join(out) or 'موردی نیست. '
+
+ tasks_html = "".join(
+ f"{html.escape(t['symbol'])} — {html.escape(t['reason'])} "
+ f"{html.escape(str(t['alert'].get('title', ''))[:120])} "
+ for t in (tasks or [])) or "موردی نیست. "
+
+ doc = f"""
+
+{html.escape(cfg['report_title'])} — {fa_time()}
+
+
+
+
+
سرمایه
{cfg['capital']:,.0f}
+
سیگنال منتظر تأیید
{len(pending)}
+
+
وجه تضمین قفلشده
{desk.locked_margin():,.0f}
+
+
+
+ این داشبورد «دستیار تصمیم» است. هیچ سفارشی خودکار ارسال نمیشود؛
+ معاملات الگوریتمی خودکار در بورس و فرابورس ایران مجاز نیست. تصمیم نهایی و مسئولیت آن با انسان است و هیچ سود تضمینی وجود ندارد.
+
+ سیگنالهای منتظر تأیید
+ شناسه نماد راهبرد بازده سالانهٔ خالص (٪)
+ حاشیه (واحد ٪) تعداد وجه تضمین وضعیت یادداشت دروازه / خبر مرتبط
+ {rows(pending)}
+
+ تأییدشده (آمادهٔ اجرای انسانی)
+ شناسه نماد راهبرد بازده سالانهٔ خالص (٪)
+ حاشیه (واحد ٪) تعداد وجه تضمین وضعیت یادداشت دروازه / خبر مرتبط
+ {rows(approved)}
+
+ ردشدهها و دلیل
+ شناسه نماد راهبرد بازده سالانهٔ خالص (٪)
+ حاشیه (واحد ٪) تعداد وجه تضمین وضعیت یادداشت دروازه / خبر مرتبط
+ {rows(rejected)}
+
+ کارهای بازبینی (خبر مهم بدون دادهٔ بازار)
+
+
+ دستورهای تأیید و اجرا
+
+ python desk.py list --status pending فهرست سیگنالها
+ python desk.py approve <شناسه> --note "ریسک پذیرفته شد" تأیید انسانی
+ python desk.py reject <شناسه> --note "نقدشوندگی کم" رد با دلیل
+ python desk.py packet <شناسه> چاپ بستهٔ سفارش برای اجرا در سامانهٔ کارگزاری
+
+
+ ساختهٔ میز معاملات نسخهٔ {VERSION} · {html.escape(cfg['credit'])}
+ """
+ path.write_text(doc, encoding="utf-8")
+ return path
+
+
+# ---------------------------------------------------------------- دستورها
+def cmd_scan(args) -> int:
+ cfg = load_config(args.config)
+ desk = Desk(cfg.get("desk_db") or DEFAULT_DB)
+ sigs = scan_market(args.market, cfg, desk, args.kodal_db)
+ for s in sigs[:20]:
+ mark = "✅" if s.status == "pending" else ("🟢" if s.status == "approved" else "✖")
+ ann = f"{s.annualized_pct:.2f}٪" if isinstance(s.annualized_pct, (int, float)) else "—"
+ print(f"{mark} [{s.sid}] {s.symbol:<8} {KIND_LABELS.get(s.kind, s.kind):<16} بازده {ann:<9} حاشیه {s.score_pp:>7.2f} قرارداد {s.contracts}")
+ if s.status == "rejected":
+ print(f" دلیل: {s.gate_note}")
+ log(f"{len(sigs)} سیگنال محاسبه شد؛ {len([s for s in sigs if s.status == 'pending'])} منتظر تأیید.")
+ return 0
+
+
+def cmd_run(args) -> int:
+ cfg = load_config(args.config)
+ desk = Desk(cfg.get("desk_db") or DEFAULT_DB)
+ sigs = scan_market(args.market, cfg, desk, args.kodal_db)
+ tasks = recheck_tasks(cfg, desk, args.kodal_db, args.market) if args.kodal_db else []
+ path = build_dashboard(desk, cfg, cfg.get("report_path") or DEFAULT_REPORT, tasks)
+ log(f"{len(sigs)} سیگنال · {len(tasks)} کار بازبینی · داشبورد: {path}")
+ for s in sigs:
+ if s.status == "pending":
+ print(f" → منتظر تأیید: [{s.sid}] {s.name} با حاشیهٔ {s.score_pp:.2f} واحد درصد")
+ return 0
+
+
+def cmd_list(args) -> int:
+ cfg = load_config(args.config)
+ desk = Desk(cfg.get("desk_db") or DEFAULT_DB)
+ items = desk.all(args.status, args.limit)
+ if not items:
+ print("موردی نیست.")
+ return 0
+ for s in items:
+ ann = f"{s.annualized_pct:.2f}٪" if isinstance(s.annualized_pct, (int, float)) else "—"
+ print(f"[{s.sid}] {s.status:<9} {s.symbol:<8} {KIND_LABELS.get(s.kind, s.kind):<16} "
+ f"بازده {ann:<9} حاشیه {s.score_pp:>7.2f} {s.contracts:,} {s.unit}")
+ if s.gate_note:
+ print(f" {s.gate_note}")
+ return 0
+
+
+def cmd_decide(args, action: str) -> int:
+ cfg = load_config(args.config)
+ desk = Desk(cfg.get("desk_db") or DEFAULT_DB)
+ sig = desk.get(args.sid)
+ if not sig:
+ print("شناسه پیدا نشد.")
+ return 2
+ if action == "approved":
+ policy = sig.detail.get("_policy") or {}
+ cap = float(policy.get("cap_total") or cfg["capital"] * cfg["max_margin_pct"])
+ max_positions = int(policy.get("max_positions") or cfg["max_positions"])
+ used = desk.locked_margin(exclude_sid=sig.sid) + sig.margin_locked
+ count = len([s for s in desk.all("approved") if s.sid != sig.sid])
+ if used > cap or count >= max_positions:
+ print(f"توقف: تأیید این سیگنال سقف ریسک را رد میکند "
+ f"(سرمایهٔ درگیر {used:,.0f} از سقف {cap:,.0f} ریال · موقعیتهای تأییدشده {count} از {max_positions}).")
+ if not getattr(args, "force", False):
+ print("اگر آگاهانه میخواهید رد کنید، دستور را با --force تکرار کنید.")
+ return 3
+ print("با --force رد شد؛ این تصمیم در دفتر ثبت میشود.")
+ desk.decide(args.sid, action, args.note or "")
+ print(f"{'تأیید' if action == 'approved' else 'رد'} شد: {args.sid}")
+ if action == "approved":
+ sig = desk.get(args.sid)
+ assert sig is not None
+ print()
+ print(order_packet(sig))
+ return 0
+
+
+def cmd_packet(args) -> int:
+ cfg = load_config(args.config)
+ desk = Desk(cfg.get("desk_db") or DEFAULT_DB)
+ sig = desk.get(args.sid)
+ if not sig:
+ print("شناسه پیدا نشد.")
+ return 2
+ if sig.status != "approved":
+ print(f"هشدار: وضعیت این سیگنال «{sig.status}» است، نه تأییدشده. "
+ f"برای اجرا اول با دستور approve تأیید کنید.")
+ print(order_packet(sig))
+ return 0
+
+
+def cmd_stats(args) -> int:
+ cfg = load_config(args.config)
+ desk = Desk(cfg.get("desk_db") or DEFAULT_DB)
+ rows = desk.conn.execute(
+ "SELECT status, COUNT(*), COALESCE(SUM(margin_locked),0) FROM signals GROUP BY status").fetchall()
+ print(f"{'وضعیت':<12}{'تعداد':>8}{'وجه تضمین قفلشده':>22}")
+ for st, n, locked in rows:
+ print(f"{st:<12}{n:>8}{locked:>22,.0f}")
+ print(f"\nتصمیمهای ثبتشده: {len(desk.decisions(1000))}")
+ return 0
+
+
+def cmd_selftest(args) -> int:
+ checks = 0
+ scout = load_scout()
+ assert hasattr(scout, "box_spread") and hasattr(scout, "tabei_min_yield")
+ checks += 1
+ cfg = json.loads(json.dumps(DEFAULT_CONFIG))
+ desk = Desk(BASE / "data" / "_selftest.sqlite3")
+ desk.conn.execute("DELETE FROM signals")
+ desk.conn.commit()
+ market = BASE / "market-demo.json"
+ if market.exists():
+ sigs = scan_market(market, cfg, desk)
+ assert sigs, "اسنپشات نمونه سیگنالی تولید نکرد"
+ checks += 1
+ assert any(s.status == "pending" for s in sigs) or all(s.gate_note for s in sigs)
+ checks += 1
+ assert g2j(2026, 9, 22) == (1405, 6, 31)
+ checks += 1
+ print(f"خودآزمون: {checks} بررسی موفق")
+ return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+ ap = argparse.ArgumentParser(description="میز معاملات — دستیار تصمیم با تأیید انسان (بدون ارسال سفارش)")
+ ap.add_argument("--config", help="مسیر config.json")
+ sub = ap.add_subparsers(dest="cmd")
+
+ p_scan = sub.add_parser("scan", help="محاسبهٔ ریاضی روی اسنپشات بازار")
+ p_scan.add_argument("--market", required=True)
+ p_scan.add_argument("--kodal-db", help="پایگاهدادهٔ دیدهبان کدال")
+ p_scan.set_defaults(func=cmd_scan)
+
+ p_run = sub.add_parser("run", help="محاسبه + چسباندن خبرها + داشبورد")
+ p_run.add_argument("--market", required=True)
+ p_run.add_argument("--kodal-db")
+ p_run.set_defaults(func=cmd_run)
+
+ p_list = sub.add_parser("list", help="فهرست سیگنالها")
+ p_list.add_argument("--status", choices=["pending", "approved", "rejected"])
+ p_list.add_argument("--limit", type=int, default=50)
+ p_list.set_defaults(func=cmd_list)
+
+ p_app = sub.add_parser("approve", help="تأیید انسانی سیگنال")
+ p_app.add_argument("sid")
+ p_app.add_argument("--note", default="")
+ p_app.add_argument("--force", action="store_true", help="رد کردن آگاهانهٔ سقف ریسک")
+ p_app.set_defaults(func=lambda a: cmd_decide(a, "approved"))
+
+ p_rej = sub.add_parser("reject", help="رد سیگنال با دلیل")
+ p_rej.add_argument("sid")
+ p_rej.add_argument("--note", default="")
+ p_rej.set_defaults(func=lambda a: cmd_decide(a, "rejected"))
+
+ p_list.set_defaults(func=cmd_list) # نگهبان
+
+ p_pack = sub.add_parser("packet", help="چاپ بستهٔ سفارش")
+ p_pack.add_argument("sid")
+ p_pack.set_defaults(func=cmd_packet)
+
+ sub.add_parser("stats", help="آمار وضعیتها").set_defaults(func=cmd_stats)
+ sub.add_parser("selftest", help="آزمون سریع").set_defaults(func=cmd_selftest)
+ sub.add_parser("version", help="نسخه").set_defaults(func=lambda a: (print(f"desk {VERSION}"), 0)[1])
+
+ args = ap.parse_args(argv)
+ if not getattr(args, "cmd", None):
+ ap.print_help()
+ return 0
+ return int(args.func(args) or 0)
+
+
+if __name__ == "__main__":
+ sys.exit(main())
diff --git a/desk/market-demo.json b/desk/market-demo.json
new file mode 100644
index 0000000000000000000000000000000000000000..81675c88b2f5d2b43801766cb9a344c888948989
--- /dev/null
+++ b/desk/market-demo.json
@@ -0,0 +1,36 @@
+{
+ "as_of": "2026-09-22",
+ "hurdle": 0.39,
+ "capital": 20000000000,
+ "note": "اعداد این اسنپشات نمونه و ساختگیاند و قیمت واقعی بازار نیستند؛ فقط برای نمایش کارکرد میز معاملات ساخته شدهاند. وجه تضمینها به ریال است.",
+ "rows": [
+ {"symbol": "اهرم", "kind": "basis", "spot": 20000, "future": 22800, "days": 90, "storage_annual": 0.0,
+ "margin_per_contract": 20000000, "unit": "قرارداد",
+ "liquidity_contracts_per_day": 900, "spread_pct": 0.005, "leverage_used": 1},
+
+ {"symbol": "فولاد", "kind": "covered_call", "spot": 7000, "strike": 7600, "premium": 400, "days": 45,
+ "margin_per_contract": 7000, "unit": "سهم",
+ "liquidity_contracts_per_day": 160, "spread_pct": 0.018},
+
+ {"symbol": "کگل", "kind": "tabei", "stock_price": 9800, "put_price": 40, "strike": 14210, "days": 365,
+ "margin_per_contract": 9840, "unit": "سهم",
+ "liquidity_contracts_per_day": 240, "spread_pct": 0.02},
+
+ {"symbol": "خساپا", "kind": "tabei", "stock_price": 2500, "put_price": 12, "strike": 3000, "days": 270,
+ "margin_per_contract": 2512, "unit": "سهم",
+ "liquidity_contracts_per_day": 320, "spread_pct": 0.012},
+
+ {"symbol": "طلا", "kind": "basis", "spot": 20000, "future": 20600, "days": 60, "storage_annual": 0.01,
+ "margin_per_contract": 20000000, "unit": "قرارداد",
+ "liquidity_contracts_per_day": 700, "spread_pct": 0.006},
+
+ {"symbol": "شپنا", "kind": "box", "call_low": 300, "put_low": 430, "call_high": 175, "put_high": 585,
+ "strike_low": 1200, "strike_high": 1500, "days": 45,
+ "margin_per_contract": 250000, "unit": "قرارداد",
+ "liquidity_contracts_per_day": 12, "spread_pct": 0.045},
+
+ {"symbol": "وبملت", "kind": "parity", "call": 420, "put": 380, "spot": 9000, "strike": 9000, "days": 30, "rate": 0.39,
+ "margin_per_contract": 9000, "unit": "سهم",
+ "liquidity_contracts_per_day": 80, "spread_pct": 0.02}
+ ]
+}
diff --git a/desk/run-demo.bat b/desk/run-demo.bat
new file mode 100644
index 0000000000000000000000000000000000000000..57d9d7ddb2a32b561f7612531b9c53df763dc873
--- /dev/null
+++ b/desk/run-demo.bat
@@ -0,0 +1,5 @@
+@echo off
+chcp 65001 >nul
+cd /d "%~dp0"
+python desk.py run --market market-demo.json --kodal-db ..\kodal-alert\data\demo.sqlite3
+start "" "data\dashboard.html"
diff --git a/desk/tests/test_desk.py b/desk/tests/test_desk.py
new file mode 100644
index 0000000000000000000000000000000000000000..6dab8f56dd4a5f399cfc2d8083086f7841ca0e67
--- /dev/null
+++ b/desk/tests/test_desk.py
@@ -0,0 +1,304 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""آزمونهای واحد میز معاملات — فقط کتابخانهٔ استاندارد."""
+from __future__ import annotations
+
+import json
+import sqlite3
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
+
+BASE_MARKET = Path(__file__).resolve().parents[1] / "market-demo.json"
+
+import desk as dk # noqa: E402
+
+
+def temp_cfg(tmp: str, **over) -> dict:
+ cfg = json.loads(json.dumps(dk.DEFAULT_CONFIG, ensure_ascii=False))
+ cfg["desk_db"] = str(Path(tmp) / "desk.sqlite3")
+ cfg["report_path"] = str(Path(tmp) / "dash.html")
+ cfg.update(over)
+ return cfg
+
+
+def make_kodal_db(tmp: str, rows: list[tuple]) -> Path:
+ p = Path(tmp) / "kodal.sqlite3"
+ conn = sqlite3.connect(str(p))
+ conn.execute("CREATE TABLE items (id TEXT PRIMARY KEY, title TEXT, source TEXT, symbol TEXT, company TEXT,"
+ " body TEXT, url TEXT, published_at TEXT, category TEXT, direction TEXT, score INTEGER,"
+ " reason TEXT, ai_note TEXT, provider TEXT, created_at TEXT)")
+ for i, (title, symbol, score) in enumerate(rows):
+ conn.execute("INSERT INTO items VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)",
+ (f"k{i}", title, "کدال", symbol, "", "", "https://codal.ir/x", "", "افزایش سرمایه",
+ "مثبت", score, "", "", "شاهد محلی", ""))
+ conn.commit()
+ conn.close()
+ return p
+
+
+class TestScoutBridge(unittest.TestCase):
+ def test_scout_loads(self):
+ scout = dk.load_scout()
+ self.assertTrue(hasattr(scout, "box_spread"))
+
+ def test_math_for_tabei_row(self):
+ res = dk.math_for_row({"symbol": "خ", "kind": "tabei", "stock_price": 2500, "put_price": 12,
+ "strike": 3125, "days": 90}, 0.39)
+ self.assertTrue(res["go"])
+ self.assertGreater(res["annualized_pct"], 39.0)
+
+ def test_math_for_bad_row_reports(self):
+ with self.assertRaises(ValueError):
+ dk.math_for_row({"symbol": "خ", "kind": "box", "call_low": 1}, 0.39)
+
+ def test_math_unknown_kind_reports(self):
+ with self.assertRaises(ValueError):
+ dk.math_for_row({"symbol": "خ", "kind": "nope"}, 0.39)
+
+
+class TestScan(unittest.TestCase):
+ def test_scan_demo_market(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ sigs = dk.scan_market(Path(dk.BASE) / "market-demo.json", cfg, desk)
+ self.assertGreaterEqual(len(sigs), 6)
+ scores = [s.score_pp for s in sigs]
+ self.assertEqual(scores, sorted(scores, reverse=True))
+ self.assertTrue(any(s.status == "pending" for s in sigs))
+ self.assertTrue(any(s.status == "rejected" for s in sigs))
+
+ def test_illiquid_row_is_rejected(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ sig = dk.Signal(sid="x1", symbol="شپنا", kind="box", name="n", annualized_pct=200.0,
+ score_pp=100.0, go=True,
+ detail={"liquidity_contracts_per_day": 3, "spread_pct": 0.01},
+ margin_per_contract=1000)
+ sig = dk.apply_risk_gates(sig, cfg, desk)
+ self.assertEqual(sig.status, "rejected")
+ self.assertIn("نقدشوندگی", sig.gate_note)
+
+ def test_wide_spread_is_rejected(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ sig = dk.Signal(sid="x2", symbol="الف", kind="box", name="n", annualized_pct=200.0,
+ score_pp=100.0, go=True,
+ detail={"liquidity_contracts_per_day": 200, "spread_pct": 0.09},
+ margin_per_contract=1000)
+ sig = dk.apply_risk_gates(sig, cfg, desk)
+ self.assertEqual(sig.status, "rejected")
+ self.assertIn("اسپرد", sig.gate_note)
+
+ def test_big_margin_blocks_position(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ sig = dk.Signal(sid="x3", symbol="ب", kind="basis", name="n", annualized_pct=120.0,
+ score_pp=60.0, go=True,
+ detail={"liquidity_contracts_per_day": 200, "spread_pct": 0.01},
+ margin_per_contract=cfg["capital"]) # بیشتر از سقف ۲۰ درصد
+ sig = dk.apply_risk_gates(sig, cfg, desk)
+ self.assertEqual(sig.contracts, 0)
+ self.assertEqual(sig.status, "rejected")
+
+ def test_margin_math_respects_cap(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ sig = dk.Signal(sid="x4", symbol="ج", kind="basis", name="n", annualized_pct=120.0,
+ score_pp=60.0, go=True,
+ detail={"liquidity_contracts_per_day": 200, "spread_pct": 0.01},
+ margin_per_contract=100_000_000)
+ sig = dk.apply_risk_gates(sig, cfg, desk)
+ self.assertEqual(sig.contracts, 10) # ۵ میلیارد × ۲۰٪ ÷ ۱۰۰ میلیون
+ self.assertLessEqual(sig.margin_locked, cfg["capital"] * cfg["max_margin_pct"])
+
+ def test_status_preserved_on_rescan(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ market = Path(dk.BASE) / "market-demo.json"
+ sigs = dk.scan_market(market, cfg, desk)
+ target = next(s for s in sigs if s.status == "pending")
+ desk.decide(target.sid, "approved", "تست")
+ dk.scan_market(market, cfg, desk)
+ self.assertEqual(desk.get(target.sid).status, "approved")
+
+
+class TestAlertsBridge(unittest.TestCase):
+ def test_read_and_match_alerts(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ p = make_kodal_db(tmp, [("افزایش سرمایه ۴۵۰ درصدی", "خساپا", 96),
+ ("توقف نماد", "وبملت", 86)])
+ alerts = dk.read_alerts(p, 60)
+ self.assertEqual(len(alerts), 2)
+ matched = dk.related_alerts("خساپا", alerts)
+ self.assertEqual(len(matched), 1)
+ self.assertIn("افزایش سرمایه", matched[0]["title"])
+
+ def test_missing_db_is_safe(self):
+ self.assertEqual(dk.read_alerts("/no/such.sqlite3", 60), [])
+
+ def test_recheck_tasks_for_uncovered_symbol(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ p = make_kodal_db(tmp, [("افزایش سرمایه", "شپدیس", 92)])
+ tasks = dk.recheck_tasks(cfg, desk, p, Path(dk.BASE) / "market-demo.json")
+ self.assertEqual(len(tasks), 1)
+ self.assertEqual(tasks[0]["symbol"], "شپدیس")
+
+ def test_covered_symbol_not_in_tasks(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ p = make_kodal_db(tmp, [("خبر مهم", "خساپا", 92)])
+ self.assertEqual(dk.recheck_tasks(cfg, desk, p, Path(dk.BASE) / "market-demo.json"), [])
+
+
+class TestWorkflow(unittest.TestCase):
+ def test_approve_records_decision_and_packet(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ sigs = dk.scan_market(Path(dk.BASE) / "market-demo.json", cfg, desk)
+ target = next(s for s in sigs if s.status == "pending")
+ self.assertTrue(desk.decide(target.sid, "approved", "ریسک پذیرفته شد"))
+ self.assertEqual(desk.get(target.sid).status, "approved")
+ self.assertEqual(len(desk.decisions(10)), 1)
+ packet = dk.order_packet(desk.get(target.sid))
+ self.assertIn(target.symbol, packet)
+ self.assertIn("انسان", packet)
+ self.assertIn("سود تضمینی وجود ندارد", packet)
+
+ def test_reject_unknown_id_returns_false(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ self.assertFalse(desk.decide("nope", "approved", ""))
+
+ def test_locked_margin_tracks_approvals(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ sigs = dk.scan_market(Path(dk.BASE) / "market-demo.json", cfg, desk)
+ target = next(s for s in sigs if s.status == "pending")
+ before = desk.locked_margin()
+ desk.decide(target.sid, "approved", "")
+ self.assertGreater(desk.locked_margin(), before)
+
+
+class TestDashboard(unittest.TestCase):
+ def test_dashboard_is_self_contained_and_rtl(self):
+ with tempfile.TemporaryDirectory() as tmp:
+ cfg = temp_cfg(tmp)
+ desk = dk.Desk(cfg["desk_db"])
+ sigs = dk.scan_market(Path(dk.BASE) / "market-demo.json", cfg, desk)
+ path = dk.build_dashboard(desk, cfg, cfg["report_path"], [{"symbol": "شپدیس", "reason": "بدون داده",
+ "alert": {"title": "خبر"}}])
+ body = path.read_text(encoding="utf-8")
+ self.assertIn('dir="rtl"', body)
+ self.assertIn(sigs[0].sid, body)
+ self.assertNotIn("