[ SaaS Product ]

Frameflow

محرر فيديو بالذكاء الاصطناعي داخل المتصفح

التحدي

أدوات التحرير الاحترافية معقدة وتبدأ بخط زمني فارغ. أردتُ محررًا داخل المتصفح تصف فيه الفيديو أولًا، فتحصل على خطة مشاهد، ثم تحرر منها.

الدور:Full-Stack Developer
السنة:2025
النوع:SaaS Product
الحالة:In Development

التقنيات المستخدمة

Next.jsTypeScriptPrismaPostgreSQLSupabaseNextAuth.jsGroqTailwind CSS
I

النهج الهندسي

مسار توليد يبدأ بالذكاء الاصطناعي

يصف المستخدمون الفيديو بلغة بسيطة، فيعيد نموذج ذكاء اصطناعي خطة مشاهد. ويملأ البحث عن لقطات جاهزة (Pexels) والملفات المرفوعة كل مشهد.

بنية يقودها المخطط

صممتُ نموذج البيانات حول المشاريع والمشاهد وطبقات الصوت. وحين احتاجت الموسيقى والتعليق الصوتي إلى طبقات متعددة، استبدلتُ الحقول المسطحة بجدول لطبقات الصوت ونقلتُ المشاريع الحالية إليه. يستخدم Prisma اتصالًا مجمّعًا للتطبيق واتصالًا مباشرًا للترحيلات.

خط زمني متعدد المسارات

بنيتُ خطًا زمنيًا بمسارات للفيديو والموسيقى والتعليق الصوتي، ومقياس زمني ثابت، ومؤشر تشغيل قابل للسحب يملك موضع التشغيل عبر المعاينة والخط الزمني والصفحة.

تعزيز الأمان

أضفتُ مخططات Zod لمدخلات الواجهة البرمجية، ومعاملات ذرية لحفظ المشاهد، ومصادقة آمنة ضد هجمات التوقيت، وتحديد معدل تسجيل الدخول بحسب البريد وعنوان IP، وفحوص ملكية المشروع عند الرفع.

II

القرارات التقنية الرئيسية

الخيارات التي شكّلت البنية وسهولة صيانتها.

مصدر واحد للحقيقة في التشغيل

موضع مؤشر التشغيل يتحكم في المعاينة والخط الزمني والتشغيل والإيقاف المؤقت. والتنقل بين المواضع يوقف التشغيل ولا يشغّله تلقائيًا.

لماذا

كان لدى عدة مكونات تصور خاص بها للوقت الحالي. ووجود مالك واحد لهذه الحالة يزيل الانحراف بينها.

تمديد المقطع يغيّر سرعته

يضبط التمديد سرعة التشغيل بين 0.25x و2x. أما القص (اختيار نقطتي الدخول والخروج) فميزة منفصلة.

لماذا

هاتان عمليتان مختلفتان. وفصلهما يتيح بناء كل منهما واختبارها على حدة، ويُخزَّن طول المصدر ليُشغَّل المقطع الممدّد بالسرعة الصحيحة.

حساب تجريبي بحمايات

حساب تجريبي ببيانات أولية له حمايات على كل مسارات الكتابة ويُعاد ضبطه كل يوم.

لماذا

يستطيع الزوار استكشاف المنتج دون أن يتمكنوا من تغيير بيانات يراها زوار آخرون.

حالات معلّقة صادقة

الميزات غير الموجودة بعد تقول ذلك. فزر التصدير يخبر بأن التصدير غير متاح، ولا يعرض نجاحًا زائفًا.

لماذا

رسالة النجاح الزائفة كذبة في المنتج. والحالات الصادقة تُبقي الواجهة جديرة بالثقة بينما تُبنى الميزات بالترتيب.

III

التحديات والحلول

[ التحدي ]

كان بإمكان أي مستخدم مسجّل الدخول الرفع إلى أي مشروع، لأن مسار الرفع لم يتحقق ممن يملك المشروع.

[ الحل ]

أضفتُ فحص ملكية قبل كل عملية رفع، والفحص نفسه على مسارات رفع الصوت.

[ التحدي ]

نسخ المشروع أنتج البيانات الوصفية الصحيحة لكن بلا مقاطع.

[ الحل ]

كان مسار الإنشاء ينسخ 5 فقط من 7 حقول للمشهد، ويُسقط بصمت رابط الفيديو ومعرّف المقطع الجاهز. أصلحتُ المطابقة ووحّدتُ قيم النمط ونسبة العرض إلى الارتفاع الفارغة التي كانت تفشل في التحقق.

[ التحدي ]

تغيّرت السمة في علامة تبويب لكنها عادت قديمة في أخرى.

[ الحل ]

اعتمد خطاف السمة على فئة DOM، التي كانت تتسابق بين علامات التبويب. أعدتُ كتابته باستخدام useSyncExternalStore ليكون localStorage المصدر الوحيد للحقيقة.

IV

النتائج

يشغّل Frameflow الحلقة الأساسية من البداية إلى النهاية: تسجيل الدخول، ووصف فيديو، والحصول على خطة مشاهد، وإضافة مقاطع جاهزة أو مرفوعة، وترتيبها على خط زمني متعدد المسارات بطبقات صوت، وإدارة المشاريع. ويشغّل التكامل المستمر فحص lint وفحص الأنواع والبناء على GitHub Actions، وتراكم lint البالغ 2316 مشكلة، الناتج عن فحص كود مُولَّد، صار الآن صفرًا.

2,316 → 0
Lint problems
3
Timeline tracks: video, music, voiceover
0.25–2x
Clip speed range

أبرز الدروس

البناء منفردًا يعني أن كل اختصار يظهر لاحقًا كخطأ. والعادة التي أثمرت أكثر هي التدقيق: أي الحقول ينسخها النسخ فعلًا، ومن يستطيع استدعاء كل مسار، وأي حالة تملك كل قيمة.