Files
zarinpal-analytics-backend/docs/GROWTH-COACH-SPEC.md

12 lines
1.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# مربی رشد و قدم‌های زرین
`/growth` قابلیت اصلی محصول است. هر پایانه یک پروفایل نسخه‌دار، سطح دشواری و برنامه‌های مستقل روزانه، هفتگی و ماهانه دارد. نمای همه پایانه‌ها فقط rollup است و هدف مشترک میان nicheهای متفاوت ایجاد نمی‌کند.
برنامه ماهانه والد قدم‌های هفتگی است. پیشنهاد AI تغییرناپذیر و در یکی از وضعیت‌های `OFFERED/ACCEPTED/REJECTED/EXPIRED` قرار دارد. پذیرش، یک «قدم زرین» مشترک برای کاربران مجاز merchant می‌سازد. actor هر mutation ثبت می‌شود.
قدم دستی توسط merchant شروع، تکمیل یا کنار گذاشته می‌شود. قدم metric فقط توسط backend و در برابر watermark واقعی تکمیل می‌شود؛ merchant تنها می‌تواند آن را کنار بگذارد. حداقل نمونه metric صد session است. target نرخ‌ها به‌ترتیب دو، پنج و ده واحد درصد و target count/amount/latency/fee به‌ترتیب پنج، ده و بیست درصد است. جهت latency و fee کاهشی است.
AvalAI فقط متن فارسی، اولویت و انتخاب metric/level از allowlist را تولید می‌کند. baseline، target، deadline، completion و difficulty قطعی‌اند. این چرخه تطبیقی و توضیح‌پذیر است و online RL نیست.
زمان‌بندی با `cmd/scheduler`، ساعت ۰۷:۰۰ تهران، شنبه و روز نخست ماه جلالی انجام می‌شود. render هیچ generationای اجرا نمی‌کند. outage آخرین plan معتبر و progress قطعی را حفظ می‌کند.