starcoach-hackathon/zarinpal-analytics-backend
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: deliver validated AI insight responses

Browse Source
This commit is contained in:
Amirhossein Khalili
2026-08-22 15:47:38 +08:00
parent ca55c2fb3d
commit 3fba4261ee
68 changed files with 6870 additions and 493 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
docs/GROWTH-COACH-SPEC.md Normal file
View File

@@ -0,0 +1,11 @@
# مربی رشد و قدم‌های زرین
`/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 قطعی را حفظ می‌کند.