أتمتة إعداد تقديرات HVAC عبر Workyard Smart Forms (HVAC Estimate Automation)
تفاصيل العمل
دوري في المشروع: مطوّر أتمتة وذكاء اصطناعي (n8n) + متخصص تكامل API
------------------------------------------------------------
وصف المشروع:
ساعدت شركة HVAC في إكمال وتثبيت نظام متكامل لإعداد التقديرات (Estimates) من البداية للنهاية. النظام يجمع بيانات المهمة (بيانات العميل، نطاق العمل، الصور، وقائمة المواد)، ثم يقوم بإثراء أسعار المواد عبر سحب الأسعار والروابط من SupplyHouse، وبعدها يستخدم GPT-4o لتوليد تقدير منظم ومهيكل.
في النهاية يتم تسجيل النتائج داخل Airtable، وإنشاء ملف PDF يحتوي على الصور الأصلية وروابط المواد وأسعارها، ثم يتم إنشاء التقدير تلقائيًا داخل QuickBooks كـ Estimate. كذلك تم دمج Workyard لجلب Submissions من Smart Forms وإرسال التحديثات والمرفقات إلى المهمة/الوظيفة المناسبة مع تحديث حالة Airtable.
------------------------------------------------------------
سير العمل (Workflow Overview):
1) العميل/الفني يرسل Workyard Smart Form (يتضمن صور + قائمة مواد)
2) يتم تخزين/تحديث البيانات داخل Airtable
3) سحب أسعار المواد وروابطها من SupplyHouse باستخدام Firecrawl (مع Apify كخيار احتياطي)
4) GPT-4o يحسب التقدير ويُنسّق المخرجات بشكل منظم
5) إرسال التقدير إلى QuickBooks (Estimate) + إنشاء PDF وحفظه في Google Drive
6) تحديث Workyard بالملاحظات/المرفقات + تحديث حالة Airtable
------------------------------------------------------------
ما الذي قمت بحلّه وتحسينه (What I Solved / Improved):
- إصلاح مشاكل التواصل مع APIs والمتغيرات الناقصة داخل تدفقات n8n الموجودة مسبقًا
- تنفيذ معالجة صور موثوقة (روابط الصور + تجهيزها للذكاء الاصطناعي + تضمينها داخل PDF)
- بناء منطق Scraping لإرجاع قائمة مواد نظيفة مع الروابط والأسعار
- إضافة تكامل QuickBooks لإنشاء Estimates برمجيًا
- زيادة اعتمادية النظام (Error handling، retries، triggers أنظف، logging واضح)
------------------------------------------------------------
المهارات والتسليمات (Skills & Deliverables):
- Airtable
- Data Scraping
- QuickBooks Online API
- Form Development
- Google Docs API
------------------------------------------------------------
الأدوات والتقنيات المستخدمة (Tools Used):
- n8n (Self-hosted)
- Workyard API (Smart Forms + Tasks/Notes + Attachments)
- Airtable (Storage + Triggers + Statuses)
- Firecrawl API (SupplyHouse Scraping) + Apify (Fallback)
- GPT-4o (Estimate Generation + Formatting)
- QuickBooks Online (QBO API / n8n Integration) (Create Estimates)
- Google Drive (PDF Storage + Sharing)