From 889ca0795dfff2e933ef97c510f1e0575e5d8eb6 Mon Sep 17 00:00:00 2001
From: DeepnaPooja <poojathmideepna@gmail.com>
Date: Sun, 30 Aug 2026 22:44:12 +0530
Subject: [PATCH] Add data model for region targets, budgets, agency mapping,
 tax rules

Introduces RegionalTarget, RegionalBudget, RegionAgencyMap, and
RegionalTaxRule entities plus their DbSets and EF constraints, laying
the groundwork for the "beyond CRUD" region management features.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 Distribution/Data/AppDBContext.cs      | 26 ++++++++++++++++++++++++++
 Distribution/Models/RegionAgencyMap.cs | 16 ++++++++++++++++
 Distribution/Models/RegionalBudget.cs  | 14 ++++++++++++++
 Distribution/Models/RegionalTarget.cs  | 14 ++++++++++++++
 Distribution/Models/RegionalTaxRule.cs | 13 +++++++++++++
 5 files changed, 83 insertions(+)
 create mode 100644 Distribution/Models/RegionAgencyMap.cs
 create mode 100644 Distribution/Models/RegionalBudget.cs
 create mode 100644 Distribution/Models/RegionalTarget.cs
 create mode 100644 Distribution/Models/RegionalTaxRule.cs

diff --git a/Distribution/Data/AppDBContext.cs b/Distribution/Data/AppDBContext.cs
index 94dd9de..79a4e39 100644
--- a/Distribution/Data/AppDBContext.cs
+++ b/Distribution/Data/AppDBContext.cs
@@ -56,6 +56,10 @@ public class AppDBContext(DbContextOptions<AppDBContext> options) : DbContext(op
     public DbSet<Claim> Claims { get; set; }
     public DbSet<SupplierClaim> SupplierClaims { get; set; }
     public DbSet<SupplierClaimItem> SupplierClaimItems { get; set; }
+    public DbSet<RegionalTarget> RegionalTargets { get; set; }
+    public DbSet<RegionalBudget> RegionalBudgets { get; set; }
+    public DbSet<RegionAgencyMap> RegionAgencyMaps { get; set; }
+    public DbSet<RegionalTaxRule> RegionalTaxRules { get; set; }
 
     protected override void OnModelCreating(ModelBuilder modelBuilder)
     {
@@ -373,6 +377,28 @@ public class AppDBContext(DbContextOptions<AppDBContext> options) : DbContext(op
             .HasForeignKey(t => t.FK_OrderId)
             .OnDelete(DeleteBehavior.Restrict);
 
+        modelBuilder.Entity<RegionalTarget>()
+            .HasIndex(t => new { t.FK_RegionId, t.Period })
+            .IsUnique();
+
+        modelBuilder.Entity<RegionalBudget>()
+            .HasIndex(b => new { b.FK_RegionId, b.Period })
+            .IsUnique();
+
+        modelBuilder.Entity<RegionAgencyMap>()
+            .HasIndex(m => new { m.FK_RegionId, m.FK_AgencyUserId })
+            .IsUnique();
+
+        modelBuilder.Entity<RegionAgencyMap>()
+            .HasOne(m => m.AgencyUser)
+            .WithMany()
+            .HasForeignKey(m => m.FK_AgencyUserId)
+            .OnDelete(DeleteBehavior.Restrict);
+
+        modelBuilder.Entity<RegionalTaxRule>()
+            .HasIndex(r => r.FK_RegionId)
+            .IsUnique();
+
         Seed.RoleAndPermissionSeed.Apply(modelBuilder);
     }
 }
diff --git a/Distribution/Models/RegionAgencyMap.cs b/Distribution/Models/RegionAgencyMap.cs
new file mode 100644
index 0000000..a91df42
--- /dev/null
+++ b/Distribution/Models/RegionAgencyMap.cs
@@ -0,0 +1,16 @@
+using System.ComponentModel.DataAnnotations.Schema;
+
+namespace Distribution.Models
+{
+    public class RegionAgencyMap : Template
+    {
+        public Guid FK_RegionId { get; set; }
+        [ForeignKey("FK_RegionId")]
+        public Region Region { get; set; }
+
+        /// <summary>User holding the RegionalAgency role that is mapped to this region.</summary>
+        public Guid FK_AgencyUserId { get; set; }
+        [ForeignKey("FK_AgencyUserId")]
+        public User AgencyUser { get; set; }
+    }
+}
diff --git a/Distribution/Models/RegionalBudget.cs b/Distribution/Models/RegionalBudget.cs
new file mode 100644
index 0000000..3922b20
--- /dev/null
+++ b/Distribution/Models/RegionalBudget.cs
@@ -0,0 +1,14 @@
+using System.ComponentModel.DataAnnotations.Schema;
+
+namespace Distribution.Models
+{
+    public class RegionalBudget : Template
+    {
+        public Guid FK_RegionId { get; set; }
+        [ForeignKey("FK_RegionId")]
+        public Region Region { get; set; }
+
+        public string Period { get; set; }
+        public decimal BudgetAmount { get; set; }
+    }
+}
diff --git a/Distribution/Models/RegionalTarget.cs b/Distribution/Models/RegionalTarget.cs
new file mode 100644
index 0000000..e5e6f82
--- /dev/null
+++ b/Distribution/Models/RegionalTarget.cs
@@ -0,0 +1,14 @@
+using System.ComponentModel.DataAnnotations.Schema;
+
+namespace Distribution.Models
+{
+    public class RegionalTarget : Template
+    {
+        public Guid FK_RegionId { get; set; }
+        [ForeignKey("FK_RegionId")]
+        public Region Region { get; set; }
+
+        public string Period { get; set; }
+        public decimal TargetValue { get; set; }
+    }
+}
diff --git a/Distribution/Models/RegionalTaxRule.cs b/Distribution/Models/RegionalTaxRule.cs
new file mode 100644
index 0000000..84d2ab2
--- /dev/null
+++ b/Distribution/Models/RegionalTaxRule.cs
@@ -0,0 +1,13 @@
+using System.ComponentModel.DataAnnotations.Schema;
+
+namespace Distribution.Models
+{
+    public class RegionalTaxRule : Template
+    {
+        public Guid FK_RegionId { get; set; }
+        [ForeignKey("FK_RegionId")]
+        public Region Region { get; set; }
+
+        public string RuleConfig { get; set; }
+    }
+}