عن المشروع

dbt Charts، من dbt Labs (الحزمة `dbt-charts`، واجهة الأوامر `dct`)، تُصرّف تعريفات اللوحات المكتوبة بـ YAML إلى لوحات معلومات وتقارير تفاعلية بصيغ متعددة. يحدد SQL ما هي البيانات التي نراها؛ ويعلن YAML كيف نعرضها. وهي تعالج الفوضى الناتجة عن اللوحات المبنية بطريقة عشوائية عبر صيغة واضحة وقابلة للتدقيق. **البدء:** يتطلب Python 3.10-3.13. ثبّتها عبر `uv tool install dbt-charts` أو `pip install dbt-charts`. أضف محولات المستودعات كإضافات (BigQuery، Snowflake، PostgreSQL، وغيرها؛ DuckDB مدمج). الأوامر: `dct init`، `dct validate`، `dct serve` للمعاينة المباشرة. يتيح ملعب على play.dbtcharts.com التجربة دون تثبيت. **واجهة الأوامر (`dct`):** تتحقق، وتُصيّر إلى HTML/PDF/PNG/SVG/JSON، وتشغّل الاستعلامات، وتبحث في اللوحات، وتتتبع تأثير الأعمدة، وتتضمن مرجع YAML دون اتصال. الأفعال: `validate`، `serve`، `render`، `query`، `search`، `impact`، `docs`، `examples`. **مهارات الوكلاء وMCP:** تأتي مع مهارات مرفقة (`dct skills intro`) وخادم MCP محلي لـ VS Code وCursor وClaude Desktop وغيرها. يقوم `dct init mcp` بإعداده. **إضافة VS Code:** تضيف تمييز الصياغة، والإكمال التلقائي، والتشخيصات، والمعاينة المباشرة (تتطلب واجهة الأوامر). متاحة على Marketplace وOpen VSX. **الميزات:** تدعم المصادر المحلية (CSV، Parquet، JSON، DuckDB) والمستودعات عبر محولات dbt. 16 نوعاً أساسياً من الرسوم البيانية (أعمدة، خطوط، مساحات، مبعثر، خرائط حرارية، دائرية، حلقية، KPI، جداول، خرائط، وغيرها) بالإضافة إلى 13 نوعاً دلالياً (lollipop، bullet، slope، funnel، small multiples). خمس سمات مدمجة مع امتدادات YAML مخصصة. التحقق برموز أخطاء قابلة للتنفيذ؛ يضيف `dct init ci` سير عمل GitHub Actions. تتعامل الترحيلات مع الصياغة الأقدم تلقائياً. **تكامل dbt:** اختياري؛ يمكن للوحات أن تعمل مستقلة أو ضمن مشروع dbt لاستخدام `ref()`، ومشاركة بيانات الاعتماد، والحصول على تحقق CI. مبنية على Pydantic وJinja2 وVega-Lite وFastAPI. رخصة Apache 2.0. مرآة للقراءة فقط؛ المشكلات مرحّب بها، ولا تُقبل طلبات السحب.