S-Contract — سير عمل العقود

أداة تحوّل قالب عقد في Word إلى نموذج قابل للمشاركة، تجمع الطلبات المعبّأة من أطراف خارجية، تمرّرها عبر مسار اعتماد، ثم تنتج ملف DOCX و PDF النهائي الجاهز — تلقائياً.

التحدي

تعيد المؤسسات استخدام العقود نفسها مراراً، لكن العملية يدوية: انسخ القالب، املأ الفراغات، أرسله بالبريد، طارد الاعتمادات، ثم صدّره إلى PDF في كل مرة.

الحل

• متغيّرات القوالب: ارفع ملف DOCX فيه {{ متغيّرات }} فيستخرجها التطبيق في نموذج منظّم — حتى عندما يُجزّئ Word المتغيّر داخلياً.
• نماذج قابلة للمشاركة: ولّد روابط عامة مع تحقّق اختياري برمز OTP، وتقييد بالنطاقات المسموحة، وصلاحية، وحدّ للطلبات.
• مسار اعتماد: اعتماد تلقائي عند اجتياز التحقق، أو تحويل للمراجعة اليدوية مع قبول/رفض (وإعادة إرسال) — مع إشعار بريدي في كل خطوة.
• توليد المستندات: عند الاعتماد، يُنتَج ملف DOCX المعبّأ عبر PHPWord ويُحوَّل إلى PDF بواسطة LibreOffice دون واجهة، وكل ذلك على طوابير في الخلفية.

التنفيذ التقني

Laravel 13 مع لوحتي Filament 5 (لوحة الإدارة ولوحة النماذج العامة)، و PHPWord للقوالب، و LibreOffice لتحويل PDF. منشور عبر Nixpacks و RoadRunner (Octane) مع عامل طوابير يديره supervisor. مُختبَر بـ Pest وخطّ تكامل مستمر على GitHub Actions.