CleanArch.Generator 1.0.118

🧱 Clean Architecture Template for .NET

هذا القالب يُنشئ مشروعًا مبنيًا على معمارية نظيفة (Clean Architecture) باستخدام .NET، مع فصل واضح بين الطبقات، مما يسهل تطوير المشاريع، صيانتها، واختبارها على المدى الطويل.

🚀 المميزات

• ✅ معمارية واضحة ومنظمة (API, Application, Domain, Infrastructure).
• 📦 هيكل مجلدات احترافي يدعم الفصل المنطقي للمسؤوليات.
• 🧪 جاهزية عالية للاختبار وإضافة الوحدات (Unit Testing).
• ⚙️ مبني باستخدام أحدث إصدار من .NET (net8.0).
• 🧰 يدعم التوسعة والتخصيص لأي نوع من التطبيقات (Web API، Microservices، إلخ).

🗂️ الهيكل العام للمشروع

MyNewProject/
└── src/
    ├── MyNewProject.API/               # طبقة العرض (Controllers + Middleware)
    │   ├── Controllers/
    │   │   └── BaseController.cs
    │   ├── Middleware/
    │   │   └── ExceptionMiddleware.cs
    │   └── MyNewProject.API.csproj
    │
    ├── MyNewProject.Domain/            # الكيانات وواجهات التجريد
    │   ├── Entites/
    │   │   └── BaseEntity.cs
    │   ├── Interface/
    │   │   ├── IRepository.cs
    │   │   └── IUnitOfWork.cs
    │   └── MyNewProject.Domain.csproj
    │
    ├── MyNewProject.Application/       # منطق الأعمال، الخدمات، DTOs
    │   ├── Base/
    │   │   └── BaseService.cs
    │   ├── Interface/
    │   │   └── IService.cs
    │   ├── Implement/
    │   │   └── Service.cs
    │   ├── DTOs/
    │   │   ├── RequestDTO.cs
    │   │   └── ResponseDTO.cs
    │   └── MyNewProject.Application.csproj
    │
    ├── MyNewProject.Infrastructure/    # تنفيذ المستودعات، DbContext
    │   ├── Data/
    │   │   └── AppDbContext.cs
    │   ├── Repository/
    │   │   ├── Repository.cs
    │   │   └── UnitOfWork.cs
    │   └── MyNewProject.Infrastructure.csproj
    │
    └── MyNewProject.sln                # ملف الحل الأساسي


🧩 شرح الطبقات
| الطبقة             | الوصف                                                                   |
| ------------------ | ----------------------------------------------------------------------- |
| **API**            | الطبقة المسؤولة عن العرض وتلقي الطلبات HTTP (Controllers + Middleware). |
| **Domain**         | تعريف الكيانات الأساسية والعقود (Interfaces) للمستودعات ووحدة العمل.    |
| **Application**    | المنطق الوظيفي للتطبيق (الخدمات، الـ DTOs، تطبيق الواجهات).             |
| **Infrastructure** | تنفيذ الواجهات، إعداد قاعدة البيانات، المستودعات، و`DbContext`.         |

⚙️ التثبيت والاستخدام:
1. تثبيت القالب
لتثبيت القالب على جهازك، نفّذ الأمر التالي باستخدام .NET CLI:
    dotnet new --install CleanArch.Template::1.0.0

2. إنشاء مشروع جديد
بعد تثبيت القالب، يمكنك إنشاء مشروع جديد بتنفيذ الأمر:
    dotnet new cleanarch-gen --name MyNewProject --framework net8.0
        💡 يمكنك تغيير الاسم والإطار كما يناسب مشروعك.

💡 ملاحظة:

إذا لم تحدد إطار العمل (--framework)، سيتم استخدام أحدث إصدار افتراضيًا.

يمكنك تحديد اسم المشروع والإطار المستهدف كما في المثال أعلاه.

3. ماذا يحدث بعد التنفيذ؟
سيتم إنشاء مجلد جديد يحتوي على هيكل المشروع التالي:

    Core

    Application

    Infrastructure

    WebApi

كما يتم تجهيز ملفات التشغيل مثل Program.cs وتهيئة ASP.NET Core.

4. تشغيل المشروع
لتشغيل المشروع:
    cd MyNewProject
    dotnet run
ثم افتح المتصفح على:
    http://localhost:5000

🧪 التوسعة والاختبارات
أضف مشروعًا جديدًا للاختبارات (مثل: MyNewProject.Tests) لتغطية Application وInfrastructure.

استخدم أدوات مثل xUnit أو NUnit مع Moq لإجراء الاختبارات الوحدوية.

📌 ملاحظات إضافية
القالب مناسب للفرق التي ترغب في فصل الاهتمامات (Separation of Concerns) وتطبيق أفضل الممارسات في تطوير البرمجيات.

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

📬 المساهمة
مرحبًا بجميع أنواع المساهمات، سواء كانت تحسينات على القالب أو اقتراحات أو إصلاحات.

📄 الرخصة
هذا المشروع مرخّص تحت MIT License. يمكنك استخدامه وتعديله وتوزيعه بحرية مع الإبقاء على إشعار الحقوق.