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

حجز قاعات الاجتماعات (تجربة)

اسأل عن هذا المشروع

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

اطلب تعديلًا

يُطبَّق على المسودة الحالية، النسخة ⁨6⁩، ويُنتج نسخة جديدة. تبقى النسخة الحالية في السجل.

مبني على النموذج الأولي المعتمد، النسخة ⁨1⁩. لتعديله ارجع خطوة واحدة.

النسخة ⁨6⁩مسودةأُنشئ قبل 21 ساعة
التقنيات: ⁨ASP.NET Core MVC⁩ على ⁨‎.NET 8⁩ · ⁨SQL Server⁩ · ⁨ASP.NET Core MVC / Razor⁩

تُبنى الشيفرة على قالب ASP.NET MVC المعتمد لدى الجهة: ‎.NET 8‎ وSQL Server وصفحاته وتصميمه، وتُضاف إليه وحدات النظام.

مكتوبة بـ ⁨ASP.NET Core MVC⁩ على ⁨‎.NET 8⁩ · ⁨SQL Server⁩ · ⁨ASP.NET Core MVC / Razor⁩

الشيفرة المصدرية

⁨44⁩ ملفًا في ⁨7⁩ وحدات

تنزيل الشيفرة (zip)
Domain/App.Domain/Entities/Room.cs · ⁨30⁩ سطرًا
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
using App.Domain.Common;
using App.Domain.Enums;
 
namespace App.Domain.Entities;
 
[Table("Rooms")]
public class Room : EntityBase
{
    [Required]
    [StringLength(100)]
    public string Name { get; set; }
 
    [Required]
    [Range(1, int.MaxValue)]
    public int Capacity { get; set; }
 
    [StringLength(500)]
    public string Equipment { get; set; }
 
    [Required]
    public RoomStatus Status { get; set; }
 
    public DateTime? MaintenanceStartedAt { get; set; }
 
    public DateTime? MaintenanceEndedAt { get; set; }
 
    public virtual ICollection<Booking> Bookings { get; set; }
}

البنية التقنية

يعتمد النظام على إطار عمل .NET 8 (LTS) مع ASP.NET Core MVC وEntity Framework Core، حيث يعمل الخادم على قاعدة بيانات Microsoft SQL Server في بيئة الإنتاج، بينما تُستخدم SQLite في بيئات التطوير والاختبار لضمان التوافق دون الحاجة لخادم قاعدة بيانات منفصل. يتكون المستودع من ملف الحل TemplateV4.sln الذي يضم عدة مشاريع: App.Domain لتعريف الكيانات والتعدادات، وApp.Helper للأنواع المساعدة وDTOs، وApp.Application لتعريفات الخدمات وملفات الخرائط، وApp.Infrastructure لتنفيذ الخدمات وإعدادات قاعدة البيانات، وApp.Web للتحكمات والعروض، وأخيراً App.Tests لاختبارات xUnit. تتبع الكيانات قاعدة تسمية موحدة حيث ترث من EntityBase التي توفر الحقول العامة مثل المعرف وتواريخ الإنشاء والتعديل، وتُعرّف الجداول باستخدام خاصية [Table] مع اسم الجمع، وتُضاف قيود التحقق مثل [Required] و[StringLength] على الحقول، مع جعل خصائص التنقل افتراضية (virtual). تُوضع التعدادات في مشروع App.Domain ضمن مساحة الاسم App.Domain.Enums، بينما تُخزن نماذج العرض (DTOs) في مشروع App.Helper ضمن مساحة الاسم App.Helper.Dto، مع استخدام خاصية [Display] لتعيين التسميات العربية ورسائل التحقق. تُعرّف واجهات الخدمات في مشروع App.Application ضمن مساحات أسماء فرعية لكل نطاق (مثل IRoomService)، بينما تُنفذ الخدمات في مشروع App.Infrastructure باستخدام نمط Unit of Work، حيث تُرجع الخدمات كائنات DTO أو قيم null/false عند عدم وجود السجل، وتستخدم PaginatedResult<T> لعرض القوائم مع التصفية والفرز. تُربط الكيانات بنماذج العرض عبر ملفات AutoMapper في مشروع App.Application، وتُضاف إعدادات الكيانات المتقدمة (مثل الفهارس والعلاقات) في مشروع App.Infrastructure ضمن مجلد Configurations. في مشروع App.Web، ترث التحكمات من BaseController وتستخدم خاصية [PermissionAuthorize] للتحقق من الصلاحيات، مع تمييز بين طلبات GET وPOST واستخدام [ValidateAntiForgeryToken] للعمليات التي تتضمن إرسال بيانات. تُبنى العروض (Views) باستخدام Razor Pages داخل مجلد Views/<ControllerName>، وتلتزم بتصميم RTL كامل مع استخدام مكتبة Bootstrap 4 ومكونات القالب الموحدة مثل card card-green وbtn btn-main، وتُعرض الرسائل عبر Swal.fire، وتُنفذ العمليات عبر jQuery مع إرسال رمز الحماية. تُكتب الاختبارات في مشروع App.Tests، حيث تختبر الخدمات ضد قاعدة بيانات SQLite في الذاكرة (TestDatabase) للتحقق من منطق الأعمال، وتختبر الصفحات عبر IClassFixture<TestApplication> باستخدام دور SuperAdmin لضمان وصول كامل، مع التركيز على التحقق من صحة البيانات وحالة الاستجابة (200) ومحتوى JSON بدلاً من اختبار الصلاحيات أو عناصر القالب العامة.

الوحدات البرمجية

  1. MOD-01
    وحدة الأساس والتهيئة: تقع في مجلدات App.Domain وApp.Infrastructure وApp.Helper، وتضم تعريف الكيانات Room وBooking مع التعدادات RoomStatus وBookingStatus، وملفات إعدادات قاعدة البيانات (Configurations) التي تحدد الفهارس والعلاقات، بالإضافة إلى ملفات الخرائط (AutoMapper) وواجهات الخدمات الأساسية التي تعتمد عليها بقية الوحدات، مما يضمن اتساق البيانات وتطبيق قيود التحقق والتشفير المطلوب في NFR-05.
    أساسييحقق ⁨NFR-01⁩ و⁨NFR-05⁩
  2. MOD-02
    وحدة إدارة القاعات: تقع في مجلد WebApps/App.Web/Controllers/RoomController.cs مع العروض المرتبطة، وتنفذ منطق إضافة القاعات وتعديل بياناتها (السعة والتجهيزات) وتغيير حالتها بين المتاحة والموقوفة للصيانة، مع ضمان عدم تكرار الأسماء والتحقق من صحة المدخلات، وتتبع متطلبات BR-06 وBR-07 وBR-08.
    أساسييحقق ⁨FR-06⁩ و⁨FR-07⁩ و⁨FR-08⁩
  3. MOD-03
    وحدة عرض القاعات المتاحة: تقع في واجهة الموظف ضمن RoomController (إجراء Index مخصص للموظف) أو في وحدة عرض مخصصة، وتعرض قائمة بالقاعات المتاحة فقط مع تفاصيل السعة والتجهيزات، مع تطبيق التصفية حسب التاريخ والوقت وإخفاء القاعات الموقوفة تلقائياً، لضمان استجابة سريعة خلال ثانيتين كما في NFR-01.
    أساسييحقق ⁨FR-01⁩ و⁨NFR-01⁩
  4. MOD-04
    وحدة إنشاء الحجوزات: تقع في BookingController مع خدمة BookingService في App.Infrastructure، وتنفذ التحقق من عدم التداخل الزمني مع الحجوزات القائمة على نفس القاعة (FR-03)، وإنشاء الحجز الجديد، وإرسال إشعار التأكيد عبر البريد الإلكتروني المؤسسي (FR-05)، مع ضمان إتمام العملية خلال خمس ثوانٍ (NFR-02).
    أساسييحقق ⁨FR-02⁩ و⁨FR-03⁩ و⁨FR-05⁩ و⁨NFR-02⁩
  5. MOD-05
    وحدة إدارة حجوزات الموظف: تقع في BookingController (إجراء MyBookings) وتتيح للموظف الاطلاع على سجل حجوزاته وإلغاء أي حجز مؤكد، مع تحديث حالة الحجز فوراً وإرسال إشعار الإلغاء، وتطبيق مبدأ أقل صلاحيات بحيث لا يرى الموظف إلا بياناته الخاصة (NFR-04).
    أساسييحقق ⁨FR-04⁩ و⁨FR-05⁩ و⁨NFR-04⁩
  6. MOD-06
    وحدة التقارير الشهرية للإشغال: تقع في ReportController أو ضمن RoomController (إجراء MonthlyReport)، وتقوم بحساب نسبة الإشغال لكل قاعة بناءً على ساعات الحجز الفعلية مقارنة بالساعات المتاحة، مع استثناء فترات الصيانة من الحساب، وتعرض النتائج في جداول ورسوم بيانية تدعم اتخاذ القرارات الإدارية.
    مهميحقق ⁨FR-09⁩
  7. MOD-07
    وحدة التوثيق والصلاحيات: تعتمد على نظام التوثيق المركزي (SSO) الموجود مسبقاً في القالب، وتضيف تعريف الصلاحيات الجديدة للوحات (Room - Index, Booking - Create, etc.) في ModulePermissions.cs، مع تطبيق مبدأ أقل صلاحيات (Least Privilege) لضمان وصول مدير المرافق فقط إلى لوحات الإدارة، والموظف إلى لوحات الحجز فقط (NFR-04).
    أساسييحقق ⁨NFR-04⁩