این مخزن توسط عامل‌های هماهنگ تحت یک قرارداد مهندسی سخت‌گیرانه توسعه می‌یابد؛ مشارکت‌کنندگان انسانی از همان نظم بهره می‌برند.
راه‌اندازی
bash
git clone https://github.com/Opselon/NexusTradingForexBot.git
cd NexusTradingForexBot
python -m venv .venv && .\.venv\Scripts\Activate.ps1
pip install -e .[dev]
pytest tests/unit -qنظم تغییر
- اول حافظه مهندسی را بخوانید:
agents/skill.md(نقشه معماری)،agents/runtime_invariants.md،agents/bugs.md. - قبل از کدنویسی ادعا کنید — یک ردیف به
agents/taskboard.mdاضافه کنید. - استفاده مجدد > گسترش > بازآرایی > ایجاد؛ فایل‌های مسیر داغ قرارداد-قفل‌اند.
- کامیت‌ها:
<Name>: <summary>با بدنه ساختاریافته؛ هر کامیت یک گام منسجم. - گیت کیفیت:
./beforePush.sh -SkipPush(ruff · format · mypy · مجموعه بحرانی pytest · گیت استقرار فارنزیک).
گردش‌کار مستندات
مستندات متعلق به نقش Nexus-Docs است؛ تغییرات مستندات هرگز کد زمان‌اجر را لمس نمی‌کنند.
bash
python scripts/docs/check_docs.py # دکتر: لینک · لنگر · ترجمه · اسرار · انحراف · بیلد
python scripts/docs/check_translations.py # پوشش هر زبان از بازرسی واقعی
python scripts/docs/build_site.py # ساخت سایت Pages در site/publicانگلیسی زبان مبدأ است؛ ترجمه‌ها translation-status و source-revision دارند. نام محصولات/ماژول‌ها ترجمه نمی‌شوند؛ اصطلاحات رسمی در site/terminology/terms.csv است.
افزودن زبان جدید
- پوشه
site/content/<lang>/را بسازید (صفحات انگلیسی را کپی کنید). - زبان را در
scripts/docs/site_config.pyثبت کنید (dir: rtlبرای راست‌به‌چپ — چیدمان خودکار می‌چرخد و کد LTR می‌ماند). - صفحات را با
lang+translation-status+source-revisionعلامت بزنید. - اصطلاحات رسمی را به
site/terminology/terms.csvاضافه کنید. - دکتر و ممیزی ترجمه را اجرا کنید؛ یک PR فقط-مستندات باز کنید.