السافت تولز

۱. اگر به داستان‌های رازآلود و معمایی علاقه دارید:

• نام رمان: «دختری در قطار» (The Girl on the Train)
• نویسنده: پائولا هاوکینز
• موضوع: زنی به نام ریچل هر روز با قطار از کنار یک خانه رد می‌شود و به زوج جوانی که آنجا زندگی می‌کنند نگاه می‌کند. یک روز اتفاق عجیبی می‌افتد و آن زن گم می‌شود و ریچل ناخواسته وارد یک ماجرای پر از راز و دروغ می‌شود.

۲. اگر به فلسفه و داستان‌های عمیق و تأثیرگذار علاقه دارید:

• نام رمان: «ملت عشق» (The Forty Rules of Love)
• نویسنده: الیف شافاک
• موضوع: داستانی موازی درباره زنی خانه‌دار در دنیای امروز که با خواندن یک کتاب درباره رابطه شمس تبریزی و مولانا، تحول بزرگی در زندگی‌اش ایجاد می‌شود. این کتاب پر از قواعد عشق و زندگی است.

۳. اگر به علمی-تخیلی و ماجراجویی علاقه دارید (ادامه بحث فرانکشتاین!):

• نام رمان: «مریخی» (The Martian)
• نویسنده: اندی ویر
• موضوع: یک فضانورد به اشتباه فکر می‌کنند مرده و در سیاره مریخ تنها رها می‌شود. او باید با استفاده از دانش علمی و هوش خود زنده بماند تا کسی به کمکش بیاید.

۴. اگر به ادبیات کلاسیک فارسی علاقه دارید:

• نام رمان: «چشم‌هایش»
• نویسنده: بزرگ علوی
• موضوع: یکی از شاهکارهای ادبیات ایران که داستان عشق مرموز و پیچیده یک نقاش بزرگ (استاد ماکان) و زنی به نام «نگار» را در بستر حوادث سیاسی روایت می‌کند.

1. کتاب و شخصیت رمانی به همین نام:

1. خودِ هیولا:

1. نموذج البيانات (Model)

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
}

2. وحدة التحكم (Controller)

using Microsoft.AspNetCore.Mvc;

[Route("api/[controller]")]
[ApiController]
public class ProductsController : ControllerBase
{
    // قائمة وهمية لتخزين البيانات مؤقتاً (بدون قاعدة بيانات)
    private static List<Product> products = new List<Product>
    {
        new Product { Id = 1, Name = "لابتوب", Price = 1200.00m },
        new Product { Id = 2, Name = "ماوس", Price = 25.50m }
    };

    // 1. جلب كل المنتجات (GET: api/products)
    [HttpGet]
    public ActionResult<IEnumerable<Product>> GetProducts()
    {
        return Ok(products);
    }

    // 2. جلب منتج معين عن طريق الـ ID (GET: api/products/1)
    [HttpGet("{id}")]
    public ActionResult<Product> GetProduct(int id)
    {
        var product = products.FirstOrDefault(p => p.Id == id);
        
        if (product == null)
        {
            return NotFound(new { message = "المنتج غير موجود" });
        }

        return Ok(product);
    }

    // 3. إضافة منتج جديد (POST: api/products)
    [HttpPost]
    public ActionResult<Product> AddProduct([FromBody] Product newProduct)
    {
        // توليد ID جديد تلقائياً
        newProduct.Id = products.Max(p => p.Id) + 1;
        products.Add(newProduct);

        // إرجاع الرد مع الرابط الخاص بالمنتج الجديد
        return CreatedAtAction(nameof(GetProduct), new { id = newProduct.Id }, newProduct);
    }
}

كيف تختبر هذا الـ API؟

1. قم بإنشاء مشروع جديد نوعه ASP.NET Core Web API.
2. أضف الكودين السابقين.
3. شغل المشروع (F5)، وستفتح لك صفحة Swagger تلقائياً.
4. يمكنك تجربة:
• GET /api/products لعرض المنتجات.
• POST /api/products لإضافة منتج جديد بصيغة JSON مثل:

     {
       "name": "لوحة مفاتيح",
       "price": 45.00
     }

• هل هو برنامج بسيط للكونسول (Console Application)؟
• هل هو متعلق بقواعد البيانات، أو واجهة مستخدم (WPF / Windows Forms)، أو واجهة برمجية (API)؟
• أو هل لديك مشكلة أو خوارزمية معينة تريد حلها؟