التحدي
تشتّت المستندات وصعوبة العثور عليها، وضعف التنسيق بين المالك والمقاول والمكتب الهندسي، وتداخل الأعمال بما يؤدي إلى هدر الموارد.
ما الذي بنيناه؟
طوّرنا نظامًا لتنظيم العمل وتنسيق العمليات بين الأطراف الثلاثة، مع معالجة مشكلة تشتّت المستندات ضمن سير العمل.
نطاق التنفيذ
- تنسيق العمل بين المالك والمقاول والمكتب الهندسي.
- تنظيم المستندات ضمن سير العمل وتسهيل متابعة مواقعها.
- فصل منطق الأعمال وطبقة التطبيق والبنية التحتية.
المعمارية التقنية
بُني النظام باستخدام C# و.NET 10 للخدمات الخلفية وواجهات API، وTypeScript وNext.js وReact 19 لواجهة الويب وطبقة BFF، مع PostgreSQL لإدارة البيانات وEF Core للوصول إليها.
تتضمن البنية فصلًا بين منطق الأعمال وطبقة التطبيق والبنية التحتية، مع استخدام سياسات الوصول على مستوى الصفوف في قاعدة البيانات، وسكربتات للأتمتة والفحوصات الأمنية والتشغيلية باستخدام Python وBash.
- واجهة الويب وطبقة BFFNext.js · React 19 · TypeScript
- خدمات النظام وواجهات APIC# · .NET 10
- الوصول إلى البياناتEF Core
- قاعدة البيانات وسياسات الصفوفPostgreSQL
طبقات التنفيذ وتقنياتها
| الطبقة | التقنيات |
|---|---|
| الخدمات الخلفية وواجهات API | C# · .NET 10 · EF Core |
| واجهة الويب وBFF | TypeScript · Next.js · React 19 · TSX |
| البيانات | PostgreSQL · SQL |
| بنية وتصميم الواجهة | HTML · CSS · CSS Modules |
| سكربتات التشغيل والحماية | JavaScript / MJS · Python · Bash / Shell |
| إعدادات البناء والنشر | GitHub Actions · YAML · JSON |
قرار من التنفيذ
تفصل البنية منطق الأعمال عن طبقة التطبيق والبنية التحتية. يوضح هذا الفصل مسؤولية كل جزء عند تتبع تغيير من واجهة الاستخدام إلى البيانات، بينما تربط طبقة BFF احتياجات واجهة الويب بخدمات النظام.
النتيجة وتجربة الاستخدام
ساعد النظام على تحسين التنسيق وتسهيل متابعة المستندات، ومعالجة تداخل الأعمال الذي كان يسبب هدر الموارد.