feat(giving): giving-category service with CRUD + soft-disable

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

API/ROLAC.API/DTOs/Giving/CreateGivingCategoryRequest.cs

@@ -0,0 +1,11 @@
+using System.ComponentModel.DataAnnotations;
+namespace ROLAC.API.DTOs.Giving;
+
+public class CreateGivingCategoryRequest
+{
+    [Required, MaxLength(200)] public string Name_en { get; set; } = "";
+    [MaxLength(200)] public string? Name_zh { get; set; }
+    [MaxLength(500)] public string? Description_en { get; set; }
+    [MaxLength(500)] public string? Description_zh { get; set; }
+    public int SortOrder { get; set; }
+}

API/ROLAC.API/DTOs/Giving/GivingCategoryDto.cs

@@ -0,0 +1,12 @@
+namespace ROLAC.API.DTOs.Giving;
+
+public class GivingCategoryDto
+{
+    public int     Id             { get; set; }
+    public string  Name_en        { get; set; } = "";
+    public string? Name_zh        { get; set; }
+    public string? Description_en { get; set; }
+    public string? Description_zh { get; set; }
+    public bool    IsActive       { get; set; }
+    public int     SortOrder      { get; set; }
+}

API/ROLAC.API/DTOs/Giving/UpdateGivingCategoryRequest.cs

@@ -0,0 +1,12 @@
+using System.ComponentModel.DataAnnotations;
+namespace ROLAC.API.DTOs.Giving;
+
+public class UpdateGivingCategoryRequest
+{
+    [Required, MaxLength(200)] public string Name_en { get; set; } = "";
+    [MaxLength(200)] public string? Name_zh { get; set; }
+    [MaxLength(500)] public string? Description_en { get; set; }
+    [MaxLength(500)] public string? Description_zh { get; set; }
+    public bool IsActive { get; set; } = true;
+    public int  SortOrder { get; set; }
+}

API/ROLAC.API/Program.cs

@@ -118,6 +118,7 @@ builder.Services.AddScoped<ITokenService,          TokenService>();
 builder.Services.AddScoped<IAuthService,           AuthService>();
 builder.Services.AddScoped<IMemberService,         MemberService>();
 builder.Services.AddScoped<IUserManagementService, UserManagementService>();
+builder.Services.AddScoped<IGivingCategoryService, GivingCategoryService>();
 
 // ---------------------------------------------------------------------------
 // Swagger / MVC

API/ROLAC.API/Services/GivingCategoryService.cs

@@ -0,0 +1,60 @@
+using Microsoft.AspNetCore.Http;
+using Microsoft.EntityFrameworkCore;
+using ROLAC.API.Data;
+using ROLAC.API.DTOs.Giving;
+using ROLAC.API.Entities;
+
+namespace ROLAC.API.Services;
+
+public class GivingCategoryService : IGivingCategoryService
+{
+    private readonly AppDbContext _db;
+    public GivingCategoryService(AppDbContext db, IHttpContextAccessor http) => _db = db;
+
+    public async Task<List<GivingCategoryDto>> GetAllAsync(bool includeInactive)
+    {
+        var query = _db.GivingCategories.AsNoTracking().AsQueryable();
+        if (!includeInactive) query = query.Where(c => c.IsActive);
+
+        return await query
+            .OrderBy(c => c.SortOrder).ThenBy(c => c.Name_en)
+            .Select(c => new GivingCategoryDto
+            {
+                Id = c.Id, Name_en = c.Name_en, Name_zh = c.Name_zh,
+                Description_en = c.Description_en, Description_zh = c.Description_zh,
+                IsActive = c.IsActive, SortOrder = c.SortOrder,
+            })
+            .ToListAsync();
+    }
+
+    public async Task<int> CreateAsync(CreateGivingCategoryRequest r)
+    {
+        var entity = new GivingCategory
+        {
+            Name_en = r.Name_en, Name_zh = r.Name_zh,
+            Description_en = r.Description_en, Description_zh = r.Description_zh,
+            SortOrder = r.SortOrder, IsActive = true,
+        };
+        _db.GivingCategories.Add(entity);
+        await _db.SaveChangesAsync();
+        return entity.Id;
+    }
+
+    public async Task UpdateAsync(int id, UpdateGivingCategoryRequest r)
+    {
+        var c = await _db.GivingCategories.FindAsync(id)
+            ?? throw new KeyNotFoundException($"GivingCategory {id} not found.");
+        c.Name_en = r.Name_en; c.Name_zh = r.Name_zh;
+        c.Description_en = r.Description_en; c.Description_zh = r.Description_zh;
+        c.IsActive = r.IsActive; c.SortOrder = r.SortOrder;
+        await _db.SaveChangesAsync();
+    }
+
+    public async Task DeactivateAsync(int id)
+    {
+        var c = await _db.GivingCategories.FindAsync(id)
+            ?? throw new KeyNotFoundException($"GivingCategory {id} not found.");
+        c.IsActive = false;
+        await _db.SaveChangesAsync();
+    }
+}

API/ROLAC.API/Services/IGivingCategoryService.cs

@@ -0,0 +1,11 @@
+using ROLAC.API.DTOs.Giving;
+
+namespace ROLAC.API.Services;
+
+public interface IGivingCategoryService
+{
+    Task<List<GivingCategoryDto>> GetAllAsync(bool includeInactive);
+    Task<int>  CreateAsync(CreateGivingCategoryRequest request);
+    Task       UpdateAsync(int id, UpdateGivingCategoryRequest request);
+    Task       DeactivateAsync(int id);   // soft-disable: IsActive = false
+}