كيف تعمل الفوترة

يتتبع “Vibes to Bucks” تكاليف رمز “Cursor AI” ويحولها إلى ساعات قابلة للفوترة في برنامج تتبع الوقت الخاص بك (Moneybird أو Harvest). يعتمد التحويل على سعرك بالساعة — حيث يقوم الامتداد بحساب عدد الساعات التي تمثلها تكلفة الذكاء الاصطناعي، وينشئ إدخال وقت لتلك الكمية.

لكل عميل، يمكنك التحكم في ثلاثة أمور:

مضاعفة تكلفة الذكاء الاصطناعي (موصى به)

استخدم هذا عندما ترغب في فوترة العمل بمساعدة الذكاء الاصطناعي بهامش ربح. تحدد مضاعف التكلفة إلى الربح الذي يقوم بتوسيع تكلفة الذكاء الاصطناعي الخام قبل تحويلها إلى ساعات. هذا يعكس القيمة الحقيقية التي تقدمها — صياغة الأوامر، مراجعة وتكرار المخرجات، دمج النتيجة، وتحمل المسؤولية عن المنتج النهائي.

الحساب:

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

مثال: تكلفة الذكاء الاصطناعي €10، المضاعف 5، السعر بالساعة €120/ساعة:

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

مضاعف 5 يعني أن كل €1 من إنفاق الذكاء الاصطناعي يصبح €5 من الإيرادات القابلة للفوترة — هامش يعكس الخبرة والوقت الذي تستثمره حول مخرجات الذكاء الاصطناعي. ابدأ بـ 5 واضبطه ليتناسب مع اتفاقيات العملاء.

تمرير بالقيمة الاسمية

استخدم هذا للفوترة على أساس استرداد التكلفة — يتم تمرير تكلفة الذكاء الاصطناعي الخام إلى العميل بالقيمة الاسمية، محولة إلى ساعات بسعرك بالساعة. لا يتم إضافة أي هامش.

الحساب:

cost_eur = cost_usd × fx_rate
hours    = cost_eur / hourly_rate

مثال: تكلفة الذكاء الاصطناعي $12.00، سعر صرف EUR/USD 0.92، السعر بالساعة €120/ساعة:

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

غير قابل للفوترة

قم بإلغاء تحديد قابل للفوترة على التعيين لتتبع تكاليف الذكاء الاصطناعي لذلك العميل أو المشروع دون إنشاء أي إدخال وقت. تظهر التكاليف في لوحة التحكم الخاصة بك حتى تتمكن من رؤية الإنفاق، ولكن لا يتم مزامنة أي شيء مع Moneybird أو Harvest. مفيد للمشاريع الداخلية، البحث والتطوير، أو أي عمل تتحمل فيه تكلفة الذكاء الاصطناعي بنفسك.

أسعار الصرف

يستخدم التحويل من USD إلى EUR Frankfurter API، الذي يقدم أسعار مرجعية من البنك المركزي الأوروبي تُنشر يوميًا حوالي الساعة 16:00 بتوقيت وسط أوروبا. يتم تخزين الأسعار محليًا لتجنب استدعاءات API غير الضرورية. عندما لا يمكن الوصول إلى API، يعتمد الامتداد على fallback_rate من إعداداتك.

لملء الفراغات، يقوم الامتداد بجلب السعر التاريخي لكل يوم محدد، بحيث تحصل على تحويلات دقيقة حتى للتواريخ السابقة.

التقريب والحدود الدنيا

يتم تخزين إدخالات الوقت كطوابع زمنية للبداية والنهاية. يقوم الامتداد بتحويل الساعات إلى دقائق ويقرب إلى أقرب دقيقة كاملة، بحد أدنى دقيقة واحدة:

تبدأ جميع الإدخالات في الساعة 09:00 بالتوقيت العالمي. يتم حساب وقت النهاية من المدة المقربة. هذه الطوابع الزمنية هي متطلب API ولا تعكس ساعات العمل الفعلية.

إدخال واحد لكل عميل لكل مشروع في اليوم

ينتج محرك المزامنة إدخال وقت واحد على الأكثر لكل عميل لكل مشروع في اليوم. إذا وصلت أحداث أخرى في وقت لاحق من نفس اليوم، تقوم المزامنة التالية بتحديث الإدخال الحالي بدلاً من إنشاء جديد. هذا يحافظ على نظافة جدول وقتك ويتجنب الإدخالات المجزأة.

مزامنة متطابقة

قبل إنشاء إدخال، يتحقق الامتداد مما إذا كان هناك واحد موجود بالفعل لنفس (اليوم، الاتصال، المشروع) المجموعة:

تشغيل “المزامنة الآن” مرتين على التوالي لا ينتج عنه تكرارات.

الحد الأقصى للميزانية الأسبوعية

حدد حد تكلفة الذكاء الاصطناعي الأسبوعي لكل تعيين (Pro). يتتبع الامتداد الإنفاق لكل مستودع ويطلق إشعارات Cursor عند المعالم: 25%، 50%، 75%، 85%، 95% كتنبيهات معلومات، تتصاعد إلى تحذير عند 100% وكل 10% بعد ذلك. يتم إطلاق كل معلم مرة واحدة في الأسبوع لكل مستودع.

هذا حد ناعم — لا يمنع استخدام الذكاء الاصطناعي، بل يبقيك على اطلاع قبل أن تتجاوز الحد. حالة الميزانية مرئية أيضًا على لوحة التحكم في الاستخدام مع مقاييس تظهر الإنفاق مقابل الحد.