۰. خلاصه اجرایی فنی
Next Prop فاز ۱ یک پلتفرم پراپ فارکس اروپاسازگار است که تریدر را از خرید چالش دوفازی روی MetaTrader به Funded و سپس Reward با صف انسانی میرساند. سرمایه نمایشی چارچوب ارزیابی است، نه حساب بانکی قابلبرداشت آزاد. AI فقط Support Assist است.
۱. قفلهای غیرقابلنقض و مفروضات
۱.۱ قفلها (Hard Locks)
| قفل | تعریف | نقض = |
|---|---|---|
| AI | فقط Support Assist: draft + Rulebook cite + Disclosure. ارسال فقط توسط انسان. | No-Go لانچ |
| مدل | مسیر بحرانی فقط مدل ۱–۴ دوفازی. مدل ۵ فقط طراحی مفهومی. | Out از فاز ۱ |
| رشد | ۱۰۰–۲۰۰ هزار پرداختکننده افق ۱۲ماه پس از لانچ است؛ KPI ماه ۶ نیست. | جابجایی اولویت |
| اعداد | تعرفه/سرمایه کارفرما ثابت؛ درصدها Provisional تا Locked با Guardrail. | تغییر بدون گیت |
| منبع حقیقت | قواعد = Rulebook Hub · تعهد = Guardrail/Pool · هویت = KYC Gate | باگ اعتماد |
۱.۲ مفروضات باز (باید قبل از M2 قفل شوند)
- ارائهدهنده MT Bridge / بروکر همکار تا پایان M1 مشخص است یا mock کامل پذیرفته میشود.
- Vendorهای KYC و PSP فیات تا M2 قرارداد مفهومی دارند؛ sandbox در M3.
- ساختار حقوقی و مسیر لایسنس عملیاتی مسیر جداست و بلوککننده کد نیست، ولی کپی Trust/Legal را تغذیه میکند.
- منطقه استقرار داده ترجیحاً EU (GDPR).
- واحد پول اصلی سیستم: USD (قابل پیکربندی بعداً).
۲. اسکوپ In / Out فاز ۱
IN داخل لانچ
- ۴ مدل دوفازی تا Funded + Rulebook یکپارچه
- ثبتنام، Locale (۶ زبان)، خرید، Progress، Pass/Fail+cite
- KYC Gate قبل از Paid
- Guardrail استخر + ولت فیات/کریپتو (انعکاس وضعیت)
- صف Reward با Finance انسانی
- مسیر signal → case → review انسانی (Fraud)
- پنل تریدر + Site Admin + Finance + Risk + Support
- Support Assist (draft فقط)
- طراحی مفهومی مدل ۵ (بدون اجرا)
- Soft Launch با سقف تعهد
OUT خارج از فاز ۱
- اجرای عملیاتی مدل ۵ Dynamic
- ترمینال معاملاتی اختصاصی
- سبد چنددارایی بهعنوان هسته
- جامعه / کپیترید / سیگنالمارکت
- AI بهعنوان approver یا تریاژ تصمیمساز
- اتوماسیون کامل Reward بدون انسان
- اتوماسیون کامل Risk مبهم
- کپی «سود تضمینی / بدون ریسک»
- مارکتینگ پولی و قیف رشد مقیاس
۳. استک پیشنهادی و معماری سیستم
۳.۱ استک
| لایه | انتخاب | دلیل نسبت به اسپک |
|---|---|---|
| Web / SEO / i18n | Next.js (App Router) + TypeScript | SSR/SSG لندینگ، hreflang، پنل تریدر و Ops در یک codebase |
| UI | Tailwind CSS + کامپوننت داخلی | مینیمال اسکاندیناویایی، موبایلوب اول |
| i18n | next-intl (EN/SV/NO/DA/FI/DE) | الزام روز اول اسپک |
| API دامنه | Laravel (API-only) + Sanctum/JWT | موتورها، صف، Policy، audit، Jobهای مالی |
| DB | PostgreSQL | تراکنش، محدودیت، گزارش Coverage |
| Cache / Queue | Redis + Laravel Queue | sync MT، Guardrail، webhook، payout |
| Object storage | S3-compatible (EU) | اسناد KYC، exportها |
| Observability | structured logs + error tracking + metrics | Queue health، webhook fail |
| MT | External Bridge Adapter | اتصال مستقیم داخل اپ وب توصیه نمیشود |
۳.۲ نمودار منطقی
۳.۳ محیطها
| محیط | هدف | داده Vendor |
|---|---|---|
| local | توسعه | Mock adapters |
| staging | UAT کارفرما / تیم | Sandbox واقعی |
| production | Soft → Controlled launch | Live + feature flags |
۳.۴ اصل معماری
- Modular Monolith در فاز ۱ (نه میکروسرویس زودرس).
- همه تصمیمهای سنگین از طریق موتورهای دامنه؛ UI فقط نمایش و اقدام مجاز نقش.
- Webhookها idempotent؛ هر تغییر وضعیت مالی/فاز audit میشود.
- اعداد محرمانه Pool به کاربر نهایی نشان داده نمیشود؛ فقط پیام سیاستی.
۴. دامنه محصول و ماژولهای Must
۴.۱ سفر Happy Path (فنی)
- Landing SEO → Register + consents + locale
- Storefront مدل ۱–۴ → Rulebook snapshot → Checkout
- Guardrail روی مدل ۴ → Payment intent → Paid → Provision MT account → Phase1
- MT events → Phase metrics (Progress, Daily DD, Max DD, Min days, Consistency)
- Pass1→Phase2 → Pass2 → Guardrail Allow/Defer Funded
- KYC Verified → Reward request → Fraud entitlement → Guardrail payout → Finance queue → Paid + Wallet ledger
۴.۲ خوشههای فیچر Must
| خوشه | ID | تحویل فنی |
|---|---|---|
| هویت | F-T01..T04 | Auth، پروفایل، locale، session امن |
| اعتماد | F-K01..K06 | KYC status machine، Rulebook versioned، Cite، Trust/Legal pages |
| خرید/ارزیابی | F-C01..C10 | Storefront، checkout، Progress، Fail/Pass، محدودیت مدل۴ |
| Funded/Reward | F-P01..P09 | Defer، entitlement lock، wallet، بنر Amber، payout states |
| پشتیبانی | F-S01..S05 | تیکت، AI draft، escalation · چت غنی = Could |
| Site Admin | F-A01..A03 | مدلها، Provisional/Locked، locale config |
| مالی | F-F01..F05 | صف payout، Coverage view، hold دستی، wallet ops |
| ریسک | F-R01..R04 | case desk، Limit/Freeze، signals داخلی |
۴.۳ منوی تریدر
Dashboard · Challenges · My Accounts · Progress · Rulebook · Wallet · Payouts · Support · Profile & Security · KYC
۵. موتورهای تصمیم (قلب سیستم)
سه موتور جدا؛ AI در هیچکدام approver نیست.
| موتور | سؤال | خروجی مجاز | AI |
|---|---|---|---|
| Phase Controller | فاز؟ Pass/Fail؟ | Phase1 · Phase2 · Funded · Failed · Deferred Funded | خیر |
| Commitment Guardrail | تعهد/payout مجاز؟ | Allow · Throttle · Defer · Pause | خیر |
| Fraud / Risk Triage | entitlement؟ | Clear · Limit · Freeze (+ case) | خیر |
۵.۱ ماشین حالت Phase
۵.۲ نقاط تصمیم (باید در کد و تست پوشش شوند)
| کد | رویداد | خروجی |
|---|---|---|
| D-PH1..6 | Progress / Fail+cite / Pass1→2 / Pass→Guardrail / Fail2 / نقض Funded | وضعیت فاز |
| D-G1..8 | Checkout مدل۱–۲ / مدل۴ / Funded Allow|Defer / Reward صف|Pause / Coverage view | سیاست تعهد |
| D-F1..5 | سیگنال داخلی / Limit|Freeze / Clear / Freeze روی Reward / Escalation | entitlement |
۵.۳ ترتیب گیت Reward
- KYC = Verified
- Fraud entitlement ≠ Freeze
- Guardrail payout Allow/Throttle
- Finance queue انسانی → Paid / Rejected(+cite Rulebook)
اولویت نمایش UI: Fraud lock (M10) > Guardrail pause/defer > KYC required > Fail Rulebook.
۵.۴ فرمولهای Guardrail (سطح محصول)
۶. یکپارچهسازی سرویسهای بیرونی
همه Vendorها پشت Adapter با قرارداد وضعیت داخلی یکسان مینشینند تا تعویض Vendor مسیر بحرانی را نشکند.
| سرویس | نیاز محصولی | قرارداد فنی حداقل | موعد آمادگی |
|---|---|---|---|
| MetaTrader Bridge | حساب ارزیابی/فاند، equity، معاملات، نقض DD | createAccount · syncMetrics · disableTrading · webhook/trade events · idempotent | Mock M2 · Sandbox M4 |
| KYC Provider | Verified/Rejected/Review | startSession · webhook status · document retention policy | Sandbox M3 |
| PSP فیات | خرید چالش + payout | payment intent · webhook · refund/chargeback events · payout API یا manual ops فاز۱ | Sandbox M3 |
| Crypto Wallet/Payout | انعکاس تراکنش ولت | address/invoice · confirmations · status map به ledger | Sandbox M4 |
| Email/SMS | OTP، وضعیت KYC/Payout | template + locale | M2 |
| AI Assist | draft + cite Rulebook | prompt با retrieval فقط از Rulebook · never auto-send · disclosure M12 | M5 |
۶.۱ نگاشت وضعیت پرداخت (نمونه)
۶.۲ نگاشت KYC
۷. پنلهای مدیریتی (Ops Multi-Panel)
یک اپ Next در مسیر /ops با چهار سطح نقش؛ نه یک ادمین ژنریک واحد.
۷.۱ ماتریس نقش × اقدام
| اقدام | Admin | Finance | Risk | Support |
|---|---|---|---|---|
| ویرایش مدل / Rulebook publish | ✓ | — | — | — |
| تغییر سطح Guardrail دستی (hold) | — | ✓ | محدود | — |
| Approve/Reject Paid | — | ✓ | — | — |
| Freeze entitlement | — | — | ✓ | — |
| ارسال پاسخ به کاربر | — | — | — | ✓ |
| AI auto-send | ممنوع برای همه | |||
۸. مدل داده مفهومی و ماشینهای وضعیت
۸.۱ موجودیتهای اصلی
| Entity | نکته کلیدی |
|---|---|
| User / Profile / Locale | رضایتها، زبان، نقشها |
| ChallengeProduct (Model 1–4) | تعرفه، سرمایه مجازی، پارامترها، flag Provisional/Locked |
| Order / Payment | وضعیت پرداخت، chargeback link |
| TradingAccount | phase، MT remote id، metrics snapshot |
| RulebookVersion + Clause | منبع حقیقت نسخهدار برای cite |
| PhaseDecision / FailEvent | پیوند اجباری به clause_id |
| GuardrailSnapshot | سطح Green/Amber/Red/Freeze + دلیل داخلی |
| KycCase | وضعیت و vendor ref |
| RewardRequest | Submitted…Paid/Rejected |
| WalletLedgerEntry | نوع، مبلغ، واحد، وضعیت، timestamp |
| FraudCase / Signal | داخلی؛ UI تریدر فقط M10 |
| SupportTicket / AiDraft | draft جدا از message نهایی |
| AuditLog | چه کسی، چه تغییری، قبل/بعد |
۸.۲ مدلهای تجاری (Provisional)
| مدل | تعرفه | سرمایه | P1/P2 | Max/Daily DD | Min days | Split |
|---|---|---|---|---|---|---|
| ۱ | ۲۵۰ | ۱۵k | ۱۰٪/۵٪ | ۱۰٪/۵٪ | ۴ | ۸۰/۲۰ |
| ۲ | ۳۵۰ | ۳۰k | ۱۰٪/۵٪ | ۱۰٪/۵٪ | ۴ | ۸۰/۲۰ |
| ۳ | ۵۰۰ | ۵۰k | ۱۰٪/۵٪ | ۱۰٪/۵٪ | ۵ | ۸۰/۲۰ |
| ۴ | ۹۰۰ | ۱۰۰k | ۱۰٪/۵٪ | ۱۰٪/۵٪ | ۵ | ۸۰/۲۰ |
۹. امنیت، حریم خصوصی و انطباق (حداقل فاز ۱)
- احراز هویت قوی برای Ops؛ MFA برای Finance/Risk اجباری پیشنهادی.
- تفکیک نقش (least privilege) طبق ماتریس بخش ۷.
- رمزنگاری در انتقال (TLS)؛ اسرار در secret manager / env نه در repo.
- GDPR: رضایتها، حداقل داده KYC، حق حذف/خروجی در صف حقوقی.
- Webhook signature verification برای همه Vendorها.
- Rate limit روی auth، checkout، reward request، support.
- AI: داده تیکت فقط برای draft؛ ممنوع آموزش روی داده مشتری بدون قرارداد.
- لاگ امنیتی برای Freeze/Paid/Rulebook publish.
۱۰. SEO، چندزبانه و سطح ایندکس
- SSR/SSG + metadata API Next · sitemap · robots · hreflang برای ۶ زبان
- بدون dark-pattern؛ کپی ممنوع «سود تضمینی»
- Core Web Vitals هدف: LCP/INP/CLS در آستانه Good روی لندینگ
- Schema سازمان/وبسایت در صورت تأیید حقوقی
۱۱. فازبندی و زمانبندی دقیق (۰ → ۱۰۰)
فرض: ۶ ماه تقویمی از T0. هر ماه یک Milestone قابلنمایش (MS-A…F). ماه ۶ فیچر جدید ندارد.
M0 — هفته ۰ تا ۱ · آمادهسازی (۰→۸٪)
Kickoff- Kickoff فنی، دسترسیها، repo، CI پایه، coding standards
- قفل استک، قرارداد Adapter، لیست Vendor shortlist
- تعریف Definition of Done و محیطها
خروجی: ADR امضاشده · اسکلت اجراشونده · برد بکلاگ MS-A
M1 — ماه ۱ · قفل محصول و قوانین (۸→۲۲٪) · MS-A
MS-A- Rulebook v1 نسخهدار در سیستم (نه فقط سند)
- ماتریس مدل ۱–۴ بهصورت داده Provisional
- In/Out و ممنوعیتهای مسیر بحرانی در چکلیست PR
- Auth پایه + مدل User/Role
دروازه خروج: هیچ ابهام In/Out در مسیر بحرانی نماند.
M2 — ماه ۲ · هسته سفر و درخت (۲۲→۴۰٪) · MS-B
MS-B- Landing SEO چندزبانه · Register/Login · Dashboard
- Storefront · جزئیات مدل · Checkout اسکلت
- MT Bridge Mock · TradingAccount · Progress UI
- روایت خرید→Progress کامل روی staging
دروازه: خرید→Progress قابل روایت برای نماینده فنی.
M3 — ماه ۳ · تعهد، مالی، KYC (۴۰→۵۸٪) · MS-C
MS-C- Guardrail levels + سیاست پیام بدون افشای عدد محرمانه
- Wallet ledger · Reward request states
- KYC Gate sandbox · بلاک Paid بدون Verified
- Finance queue UI اولیه
دروازه: مسیر پول بدون عدد محرمانه pool قابل توضیح است.
M4 — ماه ۴ · موتورها + Risk انسان (۵۸→۷۵٪) · MS-D
MS-D- Phase Controller کامل با Fail+cite
- Guardrail D-G* روی checkout مدل۴ و Funded Defer
- Fraud case desk · Limit/Freeze/Clear
- همخوانی جدول تصمیم با فیچر Must
- اتصال MT sandbox در صورت آمادگی Vendor
دروازه: D-* با کاتالوگ فیچر همخوان و دموپذیر.
M5 — ماه ۵ · Support Assist + لبهها (۷۵→۹۰٪) · MS-E
MS-E- F-S03/S04 + Disclosure M12
- retrieval فقط از Rulebook · UI برچسب AI · ممنوع auto-send
- تکمیل Fail/Defer/Freeze UX و اولویت نمایش
- Crypto adapter در صورت نیاز payout مسیر
- سختگیری feature flags برای Soft Launch
دروازه: مرز AI در UAT نقض نشده.
M6 — ماه ۶ · تست و Soft Launch (۹۰→۱۰۰٪) · MS-F
No new features- هفته ۱–۲: رگرسیون فلوها و Rulebook cite
- هفته ۳: Amber/Red/Freeze و Fraud Freeze روی Reward
- هفته ۴: Soft Launch با سقف تعهد
- ممنوع: فیچر جدید، مدل۵ اجرایی، Risk خودکار مبهم، چت غنی
دروازه: گزارش تست + امضای نماینده فنی و مالک محصول.
۱۱.۱ درصد پیشرفت تجمعی
| پایان | M0 | M1 | M2 | M3 | M4 | M5 | M6 |
|---|---|---|---|---|---|---|---|
| پیشرفت | ۸٪ | ۲۲٪ | ۴۰٪ | ۵۸٪ | ۷۵٪ | ۹۰٪ | ۱۰۰٪ Soft |
۱۳. استراتژی تست، KPI آمادگی و Go/No-Go
۱۳.۱ لایههای تست
| لایه | نمونه | Pass یعنی |
|---|---|---|
| Unit دامنه | محاسبه DD، Consistency، Coverage | فرمول و edge درست |
| Phase | Pass1→2→Funded / Fail+cite | وضعیت و پیام درست |
| Guardrail | Amber مدل۴ / Defer / صف | فقط پیام سیاستی |
| Fraud | Freeze روی Reward | M10 + عدم Paid |
| KYC | Unverified درخواست پاداش | بلاک + M03 |
| AI | draft بدون تأیید | ارسال نشود |
| رگرسیون | تغییر Rulebook → cite بهروز | منبع حقیقت واحد |
۱۳.۲ KPI آمادگی لانچ
- پوشش Must مسیر بحرانی = ۱۰۰٪
- هر D-* حداقل یک تست مفهومی/اتومات پاس
- نقض مرز AI در UAT = ۰
- امضای نماینده فنی + مالک محصول
۱۳.۳ نشانههای No-Go
- فیچر Out در مسیر بحرانی (مدل۵ اجرایی، AI approver، Risk خودکار مبهم)
- Fail بدون cite یا payout بدون وضعیت شفاف
- ناتوانی پیام Guardrail بدون افشای عدد محرمانه
- ارسال Assist بدون انسان در UAT
- ماه ۶ صرف فیچر جدید
۱۴. ریسکها، وابستگیها و کاهش اثر
| ریسک | اثر | کاهش |
|---|---|---|
| تأخیر MT Bridge Vendor | بالا | Mock کامل تا M4 · قرارداد SLA زود |
| تأخیر KYC/PSP sandbox | بالا | Adapter + fake provider از M2 |
| موج پاس مدل ۴ | مالی | Guardrail Amber/Red از روز اول منطق |
| خزش اسکوپ مدل۵/چت/AI | زمان | قفل Hard + چکلیست PR |
| ابهام حقوقی کپی | اعتماد | مسیر Legal موازی؛ کپی ممنوع در CI محتوا |
| Chargeback خوشهای | استخر | کندکردن payout غیرفوری در سناریو فشار |
۱۵. خروجیهای تحویلی و معیار پذیرش ماهانه
| ماه | آرتیفکت قابل مشاهده | پذیرش |
|---|---|---|
| M1 | Rulebook در سیستم · مدلهای seed · ADR | MS-A گیت In/Out |
| M2 | دمو خرید→Progress روی staging | MS-B |
| M3 | دمو KYC بلاک + Wallet + Coverage سطح | MS-C |
| M4 | دمو Pass/Fail/Defer/Freeze | MS-D |
| M5 | دمو Support Assist بدون auto-send | MS-E |
| M6 | گزارش تست · Soft Launch سقفدار · فرم Go/No-Go | MS-F |
۱۵.۱ چکلیست امضای ذهنی نماینده
- میدانم چه میسازیم و چه نمیسازیم
- جدول مدلها Provisional و مسیر قفل را دیدهام
- مسیر پول/تعهد بدون عدد محرمانه قابل روایت است
- مرز AI یک جمله و نقضناپذیر است
- ماه ۶ تست است؛ رشد مقیاس پس از لانچ است
۱۶. مرکز نظرات تیم فنی
همه نظرات ثبتشده در این مرورگر اینجا جمع میشوند. میتوانید JSON یا گزارش Markdown را دانلود و برای کارفرما بفرستید. امکان Import برای ادامه بررسی مشترک وجود دارد.