بلنگ کیسے کام کرتی ہے

‘Vibes to Bucks’ آپ کے Cursor AI ٹوکن کے اخراجات کو ٹریک کرتا ہے اور انہیں آپ کے وقت ٹریکنگ سافٹ ویئر (Moneybird یا Harvest) میں قابل بل گھنٹوں میں تبدیل کرتا ہے۔ یہ تبدیلی آپ کی گھنٹہ وار شرح پر مبنی ہوتی ہے — تو یہ ایکسٹینشن حساب لگاتا ہے کہ AI کے اخراجات آپ کے کتنے گھنٹوں کے برابر ہیں، اور اس مقدار کے لیے ایک وقت کا اندراج بناتا ہے۔

ہر کلائنٹ کی میپنگ کے لیے آپ تین چیزوں کو کنٹرول کرتے ہیں:

Multiply AI cost (تجویز کردہ)

اسے اس وقت استعمال کریں جب آپ AI کی مدد سے کام کو منافع کے مارجن پر بل کرنا چاہتے ہیں۔ آپ ایک Cost to Profit Multiplier سیٹ کرتے ہیں جو خام AI لاگت کو گھنٹوں میں تبدیل کرنے سے پہلے اسکیل کرتا ہے۔ یہ آپ کی فراہم کردہ حقیقی قدر کو پکڑتا ہے — پرامپٹ تیار کرنا، آؤٹ پٹ کا جائزہ لینا اور اس پر دوبارہ کام کرنا، نتیجہ کو ضم کرنا، اور حتمی پروڈکٹ کی ذمہ داری لینا۔

حساب کتاب:

cost_eur = cost_usd × multiplier × fx_rate
hours    = cost_eur / hourly_rate

مثال: €10 کی AI لاگت، ملٹی پلائر 5، گھنٹہ وار شرح €120/h:

cost_eur = €10 × 5 = €50
hours    = €50 / €120 = 0.42h (≈ 25 minutes billed)

ملٹی پلائر 5 کا مطلب ہے کہ AI پر خرچ ہونے والے ہر €1 کو €5 کی قابل بل آمدنی میں تبدیل کر دیا جاتا ہے — ایک مارجن جو AI آؤٹ پٹ کے ارد گرد آپ کی مہارت اور وقت کی عکاسی کرتا ہے۔ 5 سے شروع کریں اور اپنے کلائنٹ کے معاہدوں کے مطابق ایڈجسٹ کریں۔

Pass through at face value

اسے لاگت کی وصولی کے بلنگ کے لیے استعمال کریں — خام AI لاگت کو کلائنٹ کو اصل قیمت پر منتقل کیا جاتا ہے، جو آپ کی گھنٹہ وار شرح پر گھنٹوں میں تبدیل ہوتا ہے۔ کوئی مارجن شامل نہیں کیا جاتا۔

حساب کتاب:

cost_eur = cost_usd × fx_rate
hours    = cost_eur / hourly_rate

مثال: $12.00 AI لاگت، EUR/USD شرح 0.92، گھنٹہ وار شرح €120/h:

cost_eur = $12.00 × 0.92 = €11.04
hours    = €11.04 / €120  = 0.092h (≈ 6 minutes billed)

قابل بل نہیں

کسی میپنگ پر Billable کو انچیک کریں تاکہ اس کلائنٹ یا پروجیکٹ کے لیے AI اخراجات کو ٹریک کریں بغیر کسی وقت کے اندراج کو پیدا کیے۔ اخراجات آپ کے ڈیش بورڈ میں ظاہر ہوتے ہیں تاکہ آپ خرچ دیکھ سکیں، لیکن کچھ بھی Moneybird یا Harvest کے ساتھ ہم آہنگ نہیں ہوتا۔ اندرونی پروجیکٹس، R&D، یا کسی بھی کام کے لیے مفید ہے جہاں آپ AI لاگت کو خود برداشت کرتے ہیں۔

تبادلہ کی شرحیں

USD→EUR تبدیلی کے لیے Frankfurter API استعمال ہوتا ہے، جو یورپی مرکزی بینک کی حوالہ جاتی شرحیں روزانہ تقریباً 16:00 CET پر فراہم کرتا ہے۔ شرحیں مقامی طور پر کیش کی جاتی ہیں تاکہ غیر ضروری API کالز سے بچا جا سکے۔ جب API ناقابل رسائی ہوتا ہے، تو ایکسٹینشن آپ کی کنفیگریشن سے fallback_rate پر واپس آتا ہے۔

بیک فل کے لیے، ایکسٹینشن ہر مخصوص دن کے لیے تاریخی شرح کو حاصل کرتا ہے، تاکہ آپ کو ماضی کی تاریخوں کے لیے بھی درست تبدیلیاں مل سکیں۔

گولائی اور کم از کم

وقت کے اندراجات کو شروع/ختم ہونے والے ٹائم اسٹیمپس کے طور پر ذخیرہ کیا جاتا ہے۔ ایکسٹینشن گھنٹوں کو منٹوں میں تبدیل کرتا ہے اور قریب ترین پورے منٹ تک گول کرتا ہے، جس کی کم از کم 1 منٹ ہے:

تمام اندراجات 09:00 UTC پر شروع ہوتے ہیں۔ ختم ہونے کا وقت گولائی کی مدت سے حساب کیا جاتا ہے۔ یہ ٹائم اسٹیمپس API کی ضرورت ہیں اور اصل کام کے اوقات کی عکاسی نہیں کرتے۔

ہر کلائنٹ، ہر پروجیکٹ، ہر دن کے لیے ایک اندراج

سنک انجن ہر کلائنٹ، ہر پروجیکٹ، ہر دن کے لیے زیادہ سے زیادہ ایک وقت کا اندراج تیار کرتا ہے۔ اگر اسی دن بعد میں مزید ایونٹس آتے ہیں، تو اگلا سنک موجودہ اندراج کو اپ ڈیٹ کرتا ہے بجائے اس کے کہ نیا بنائے۔ اس سے آپ کی ٹائم شیٹ صاف رہتی ہے اور بکھرے ہوئے اندراجات سے بچا جاتا ہے۔

Idempotent sync

اندراج بنانے سے پہلے، ایکسٹینشن چیک کرتا ہے کہ آیا اسی (دن، رابطہ، پروجیکٹ) کے لیے پہلے سے کوئی اندراج موجود ہے:

“Sync Now” کو دو بار چلانے سے کوئی نقل نہیں بنتی۔

ہفتہ وار بجٹ کی حد

ہر میپنگ (Pro) کے لیے ہفتہ وار AI لاگت کی حد مقرر کریں۔ ایکسٹینشن ہر ریپو کے اخراجات کو ٹریک کرتا ہے اور Cursor نوٹیفیکیشنز کو سنگ میل پر فائر کرتا ہے: 25%, 50%, 75%, 85%, 95% بطور معلوماتی الرٹس، 100% پر انتباہ اور اس کے بعد ہر 10% پر بڑھتا ہوا۔ ہر سنگ میل ہر ہفتے فی ریپو ایک بار فائر ہوتا ہے۔

یہ ایک نرم حد ہے — یہ کبھی بھی AI کے استعمال کو بلاک نہیں کرتی، یہ صرف آپ کو آگاہ رکھتی ہے اس سے پہلے کہ آپ آگے بڑھ جائیں۔ بجٹ کی حیثیت بھی Usage Dashboard پر نظر آتی ہے جس میں خرچ بمقابلہ حد کو دکھانے والے گیجز ہوتے ہیں۔