emloyee and user fixings

Backend/ERPCore/Controllers/AuthController.cs

@@ -27,13 +27,15 @@ public sealed class AuthController : ControllerBase
     private readonly IAuthRecoveryService _recovery;
     private readonly IAuthAltService _alt;
     private readonly IRoleService _roles;
+    private readonly IAuditService _audit;
 
-    public AuthController(IAuthUserService users, IAuthRecoveryService recovery, IAuthAltService alt, IRoleService roles)
+    public AuthController(IAuthUserService users, IAuthRecoveryService recovery, IAuthAltService alt, IRoleService roles, IAuditService audit)
     {
         _users = users;
         _recovery = recovery;
         _alt = alt;
         _roles = roles;
+        _audit = audit;
     }
 
     /// <summary>
@@ -68,6 +70,7 @@ public sealed class AuthController : ControllerBase
     {
         var result = await _users.LoginAsync(request, ct);
         AuthCookieWriter.WriteSession(Response, result.AccessToken, result.RefreshToken, result.Body.ExpiresIn);
+        if (result.Body.User?.UserId is Guid authUserId) await _audit.RecordLoginAsync(authUserId, ClientIp(), ClientUserAgent(), ct);
         return Ok(result.Body);
     }
 
@@ -78,9 +81,13 @@ public sealed class AuthController : ControllerBase
     {
         var result = await _users.VerifyOtpForLoginAsync(request, ct);
         AuthCookieWriter.WriteSession(Response, result.AccessToken, result.RefreshToken, result.Body.ExpiresIn);
+        if (result.Body.User?.UserId is Guid authUserId) await _audit.RecordLoginAsync(authUserId, ClientIp(), ClientUserAgent(), ct);
         return Ok(result.Body);
     }
 
+    private string? ClientIp() => HttpContext.Connection.RemoteIpAddress?.ToString();
+    private string? ClientUserAgent() => Request.Headers.UserAgent.ToString() is { Length: > 0 } ua ? ua : null;
+
     [HttpPost("refresh-token")]
     [AllowAnonymous]
     [ProducesResponseType(typeof(AuthSessionResponse), StatusCodes.Status200OK)]

Backend/ERPCore/Controllers/Hrm/BranchesController.cs

@@ -61,4 +61,14 @@ public sealed class BranchesController : ApiControllerBase
         await _branches.SetStatusAsync(branchId, request.Status, ct);
         return NoContent();
     }
+
+    [HttpDelete("{branchId:int}")]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    [ProducesResponseType(StatusCodes.Status409Conflict)]
+    public async Task<IActionResult> Delete(int branchId, CancellationToken ct)
+    {
+        await _branches.DeleteAsync(branchId, ct);
+        return NoContent();
+    }
 }

Backend/ERPCore/Controllers/Hrm/EmployeesController.cs

@@ -83,7 +83,6 @@ public sealed class EmployeesController : ApiControllerBase
         return Ok(result.Value);
     }
 
-    /// <summary>Never a hard delete — Employee is retained forever (docs/12-BACKEND-HRM.md C.2).</summary>
     [HttpPatch("{employeeId:int}/status")]
     [ProducesResponseType(StatusCodes.Status204NoContent)]
     [ProducesResponseType(StatusCodes.Status404NotFound)]
@@ -93,6 +92,17 @@ public sealed class EmployeesController : ApiControllerBase
         return NoContent();
     }
 
+    /// <summary>Permanently deletes the employee and all dependent HR records. Blocked (409) if payroll history exists.</summary>
+    [HttpDelete("{employeeId:int}")]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    [ProducesResponseType(StatusCodes.Status409Conflict)]
+    public async Task<IActionResult> Delete(int employeeId, CancellationToken ct)
+    {
+        await _employees.DeleteAsync(employeeId, ct);
+        return NoContent();
+    }
+
     [HttpPost("{employeeId:int}/link-user")]
     [ProducesResponseType(StatusCodes.Status204NoContent)]
     [ProducesResponseType(StatusCodes.Status404NotFound)]

Backend/ERPCore/Controllers/UsersController.cs

@@ -1,3 +1,5 @@
+using ERPCore.Domain.Enums;
+using ERPCore.Dtos.Audit;
 using ERPCore.Dtos.Common;
 using ERPCore.Dtos.Hrm;
 using ERPCore.Dtos.Users;
@@ -16,12 +18,14 @@ public sealed class UsersController : ApiControllerBase
 {
     private readonly IUserManagementService _users;
     private readonly IEmployeeUserLinkService _links;
+    private readonly IAuditService _audit;
     private readonly ICurrentUser _currentUser;
 
-    public UsersController(IUserManagementService users, IEmployeeUserLinkService links, ICurrentUser currentUser)
+    public UsersController(IUserManagementService users, IEmployeeUserLinkService links, IAuditService audit, ICurrentUser currentUser)
     {
         _users = users;
         _links = links;
+        _audit = audit;
         _currentUser = currentUser;
     }
 
@@ -33,8 +37,8 @@ public sealed class UsersController : ApiControllerBase
 
     [HttpGet]
     [ProducesResponseType(typeof(PagedResponse<ManagedUserDto>), StatusCodes.Status200OK)]
-    public async Task<ActionResult<PagedResponse<ManagedUserDto>>> List([FromQuery] PageQuery query, CancellationToken ct)
-        => Ok(await _users.ListAsync(query, ct));
+    public async Task<ActionResult<PagedResponse<ManagedUserDto>>> List([FromQuery] PageQuery query, [FromQuery] EntityStatus? status, [FromQuery] string? roleCode, CancellationToken ct)
+        => Ok(await _users.ListAsync(query, status, roleCode, ct));
 
     /// <summary>AuthHex UserType options for the create-user form's select.</summary>
     [HttpGet("user-types")]
@@ -65,4 +69,18 @@ public sealed class UsersController : ApiControllerBase
     [ProducesResponseType(StatusCodes.Status404NotFound)]
     public async Task<ActionResult<ManagedUserDto>> UpdateRole(int userId, [FromBody] UpdateUserRoleRequest request, CancellationToken ct)
         => Ok(await _users.UpdateRoleAsync(userId, request, ct));
+
+    /// <summary>Revokes/restores standing inside ERPCore only — see <see cref="IUserManagementService.SetStatusAsync"/>.</summary>
+    [HttpPatch("{userId:int}/status")]
+    [ProducesResponseType(typeof(ManagedUserDto), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<ManagedUserDto>> UpdateStatus(int userId, [FromBody] UpdateUserStatusRequest request, CancellationToken ct)
+        => Ok(await _users.SetStatusAsync(userId, request.Status, ct));
+
+    /// <summary>Device/login history ERPCore captures itself — not AuthHex's "currently active sessions"
+    /// (which only ever reports the caller's own). See <see cref="IAuditService.ListLoginDevicesAsync"/>.</summary>
+    [HttpGet("{userId:int}/login-devices")]
+    [ProducesResponseType(typeof(PagedResponse<LoginActivityDto>), StatusCodes.Status200OK)]
+    public async Task<ActionResult<PagedResponse<LoginActivityDto>>> ListLoginDevices(int userId, [FromQuery] PageQuery query, CancellationToken ct)
+        => Ok(await _audit.ListLoginDevicesAsync(userId, query, ct));
 }

Backend/ERPCore/Controllers/WarehousesController.cs

@@ -15,8 +15,9 @@ public sealed class WarehousesController : ApiControllerBase
 
     [HttpGet]
     [ProducesResponseType(typeof(PagedResponse<WarehouseDto>), StatusCodes.Status200OK)]
-    public async Task<ActionResult<PagedResponse<WarehouseDto>>> List([FromQuery] PageQuery query, CancellationToken ct)
-        => Ok(await _warehouses.ListAsync(query, ct));
+    public async Task<ActionResult<PagedResponse<WarehouseDto>>> List(
+        [FromQuery] PageQuery query, [FromQuery] int? branchId, CancellationToken ct)
+        => Ok(await _warehouses.ListAsync(query, branchId, ct));
 
     [HttpGet("{warehouseId:int}")]
     [ProducesResponseType(typeof(WarehouseDto), StatusCodes.Status200OK)]

Backend/ERPCore/Domain/Entities/Employee.cs

@@ -6,8 +6,10 @@ namespace ERPCore.Domain.Entities;
 /// Staff record (FR-HR-MD-02) — distinct from <see cref="User"/> (the system login
 /// account): not every employee has a login, and not every login belongs to an
 /// employee. <see cref="UserId"/> is the optional, explicit, human-confirmed link
-/// between the two (docs/12-BACKEND-HRM.md A.5/C.2, Part B.3.2). Never hard-deleted —
-/// separation is recorded via <see cref="Status"/> + <see cref="LastWorkingDate"/>.
+/// between the two (docs/12-BACKEND-HRM.md A.5/C.2, Part B.3.2). Normal separation is
+/// recorded via <see cref="Status"/> + <see cref="LastWorkingDate"/> rather than deletion;
+/// an explicit hard delete is also available (<see cref="Services.Interfaces.IEmployeeService.DeleteAsync"/>)
+/// and cascades to every dependent HR record, blocked only if payroll history exists.
 /// <see cref="EmployeeCode"/> is user-entered (not <see cref="NumberSequence"/>-issued):
 /// HR departments keep their own legacy numbering scheme, and NumberSequence's
 /// year-scoping is the wrong shape for an identifier that must never look "reset".

Backend/ERPCore/Domain/Entities/LoginActivity.cs

@@ -0,0 +1,22 @@
+namespace ERPCore.Domain.Entities;
+
+/// <summary>
+/// One row per successful sign-in, captured directly by ERPCore (not AuthHex) so an
+/// admin can see a user's device/login history — AuthHex's own session listing only
+/// ever reports the currently-authenticated caller's own sessions, with no admin-scoped
+/// call to inspect anyone else's. This is a history of past logins, not a live "currently
+/// active sessions" view (that would need AuthHex to expose one).
+/// </summary>
+public class LoginActivity
+{
+    public int LoginActivityId { get; set; }
+    public int UserId { get; set; }
+    public User? User { get; set; }
+
+    public string? IpAddress { get; set; }
+    public string? UserAgent { get; set; }
+    /// <summary>Best-effort "Browser on OS" label parsed from <see cref="UserAgent"/> for display.</summary>
+    public string? DeviceLabel { get; set; }
+
+    public DateTime LoginAt { get; set; }
+}

Backend/ERPCore/Domain/Enums/AuditAction.cs

@@ -5,5 +5,8 @@ public enum AuditAction
 {
     Create,
     Update,
-    Delete
+    Delete,
+    /// <summary>A successful sign-in — written explicitly (not via ErpDbContext's automatic
+    /// entity-change capture, since a login mutates nothing) by AuthController.</summary>
+    Login
 }

Backend/ERPCore/Dtos/Audit/AuditDtos.cs

@@ -10,3 +10,7 @@ public sealed record AuditLogDto(
 /// <summary>A GL-ready journal stub emitted per stock movement (FR-STK-13).</summary>
 public sealed record JournalEntryStubDto(
     int JournalId, string SourceDocType, int SourceDocId, string DebitAccount, string CreditAccount, decimal Amount);
+
+/// <summary>A captured past sign-in — device history, not a live "currently active sessions" view.</summary>
+public sealed record LoginActivityDto(
+    int LoginActivityId, string? IpAddress, string? DeviceLabel, DateTime LoginAt);

Backend/ERPCore/Dtos/Users/UserDtos.cs

@@ -53,5 +53,10 @@ public sealed class UpdateUserRoleRequest
     [Required] public int RoleId { get; set; }
 }
 
+public sealed class UpdateUserStatusRequest
+{
+    [Required, EnumDataType(typeof(EntityStatus))] public EntityStatus Status { get; set; }
+}
+
 /// <summary>AuthHex UserType lookup, for populating the create-user form's select (no local shadow — read-only passthrough).</summary>
 public sealed record UserTypeOptionDto(Guid UserTypeId, string? Code, string? Description);

Backend/ERPCore/Infra/Auth/UserAgentLabeler.cs

@@ -0,0 +1,39 @@
+namespace ERPCore.Infra.Auth;
+
+/// <summary>
+/// Best-effort "Browser on OS" label from a raw User-Agent string, for display in the
+/// login-device history — not a full parsing library, just enough to be readable
+/// (docs call this out: exact device model detection is out of scope).
+/// </summary>
+public static class UserAgentLabeler
+{
+    public static string Label(string? userAgent)
+    {
+        if (string.IsNullOrWhiteSpace(userAgent)) return "Unknown device";
+
+        var os = DetectOs(userAgent);
+        var browser = DetectBrowser(userAgent);
+        return $"{browser} on {os}";
+    }
+
+    private static string DetectOs(string ua)
+    {
+        if (ua.Contains("Windows", StringComparison.OrdinalIgnoreCase)) return "Windows";
+        if (ua.Contains("Mac OS X", StringComparison.OrdinalIgnoreCase) || ua.Contains("Macintosh", StringComparison.OrdinalIgnoreCase)) return "macOS";
+        if (ua.Contains("Android", StringComparison.OrdinalIgnoreCase)) return "Android";
+        if (ua.Contains("iPhone", StringComparison.OrdinalIgnoreCase) || ua.Contains("iPad", StringComparison.OrdinalIgnoreCase)) return "iOS";
+        if (ua.Contains("Linux", StringComparison.OrdinalIgnoreCase)) return "Linux";
+        return "an unknown OS";
+    }
+
+    private static string DetectBrowser(string ua)
+    {
+        // Order matters: Edge/OPR/Chrome all also contain "Safari"/"Chrome" tokens.
+        if (ua.Contains("Edg/", StringComparison.OrdinalIgnoreCase)) return "Edge";
+        if (ua.Contains("OPR/", StringComparison.OrdinalIgnoreCase) || ua.Contains("Opera", StringComparison.OrdinalIgnoreCase)) return "Opera";
+        if (ua.Contains("Firefox", StringComparison.OrdinalIgnoreCase)) return "Firefox";
+        if (ua.Contains("CriOS", StringComparison.OrdinalIgnoreCase) || ua.Contains("Chrome", StringComparison.OrdinalIgnoreCase)) return "Chrome";
+        if (ua.Contains("Safari", StringComparison.OrdinalIgnoreCase)) return "Safari";
+        return "an unknown browser";
+    }
+}

Backend/ERPCore/Infra/Persistence/Auditing/AuditScribe.cs

@@ -21,7 +21,7 @@ public static class AuditScribe
     private static readonly HashSet<Type> Excluded =
     [
         typeof(AuditLog), typeof(JournalEntryStub), typeof(NumberSequence),
-        typeof(StockLedger), typeof(StockLayer),
+        typeof(StockLedger), typeof(StockLayer), typeof(LoginActivity),
     ];
 
     private static readonly JsonSerializerOptions Json = new()

Backend/ERPCore/Infra/Persistence/Configurations/LoginActivityConfiguration.cs

@@ -0,0 +1,23 @@
+using ERPCore.Domain.Entities;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+
+namespace ERPCore.Infra.Persistence.Configurations;
+
+public sealed class LoginActivityConfiguration : IEntityTypeConfiguration<LoginActivity>
+{
+    public void Configure(EntityTypeBuilder<LoginActivity> builder)
+    {
+        builder.ToTable("login_activities");
+        builder.HasKey(l => l.LoginActivityId);
+
+        builder.Property(l => l.IpAddress).HasMaxLength(64);
+        builder.Property(l => l.UserAgent).HasMaxLength(500);
+        builder.Property(l => l.DeviceLabel).HasMaxLength(200);
+        builder.Property(l => l.LoginAt).IsRequired();
+
+        builder.HasOne(l => l.User).WithMany().HasForeignKey(l => l.UserId).OnDelete(DeleteBehavior.Cascade);
+
+        builder.HasIndex(l => new { l.UserId, l.LoginAt });
+    }
+}

Backend/ERPCore/Infra/Persistence/Configurations/NavItemConfiguration.cs

@@ -29,7 +29,8 @@ public sealed class NavItemConfiguration : IEntityTypeConfiguration<NavItem>
         builder.HasData(
             new NavItem { NavItemId = 1, Code = "dashboard", Label = "Dashboard", Href = "/dashboard", SortOrder = 1 },
             new NavItem { NavItemId = 2, Code = "products", Label = "Products", Href = "/dashboard/products", SortOrder = 2 },
-            new NavItem { NavItemId = 3, Code = "vendors", Label = "Vendors", Href = "/dashboard/vendors", SortOrder = 3 },
+            // NavItemId 3 ("vendors") retired 2026-09-09 — Vendors moved under Procurement as a
+            // sub-item (see SubNavItemConfiguration/PermissionConfiguration), matching the sidebar.
             new NavItem { NavItemId = 4, Code = "procurement", Label = "Procurement", Href = "/dashboard/procurement", SortOrder = 4 },
             new NavItem { NavItemId = 5, Code = "receiving", Label = "Receiving", Href = "/dashboard/receiving/grn", SortOrder = 5 },
             new NavItem { NavItemId = 6, Code = "stock", Label = "Stock", Href = "/dashboard/stock", SortOrder = 6 },

Backend/ERPCore/Infra/Persistence/Configurations/PermissionConfiguration.cs

@@ -26,7 +26,9 @@ public sealed class PermissionConfiguration : IEntityTypeConfiguration<Permissio
         builder.HasData(
             new Permission { PermissionId = 1, Code = "NAV:dashboard", NavItemId = 1 },
             new Permission { PermissionId = 2, Code = "NAV:products", NavItemId = 2 },
-            new Permission { PermissionId = 3, Code = "NAV:vendors", NavItemId = 3 },
+            // Moved under Procurement as a sub-item (2026-09-09) — same PermissionId (3), just
+            // repointed to the new SubNavItem, so any role already granted this permission keeps it.
+            new Permission { PermissionId = 3, Code = "NAV:procurement.vendors", SubNavItemId = 30 },
             new Permission { PermissionId = 4, Code = "NAV:procurement", NavItemId = 4 },
             new Permission { PermissionId = 5, Code = "NAV:receiving", NavItemId = 5 },
             new Permission { PermissionId = 6, Code = "NAV:stock", NavItemId = 6 },
@@ -67,7 +69,21 @@ public sealed class PermissionConfiguration : IEntityTypeConfiguration<Permissio
             new Permission { PermissionId = 37, Code = "NAV:production.runs", SubNavItemId = 25 },
             new Permission { PermissionId = 38, Code = "NAV:production.produced", SubNavItemId = 26 },
             new Permission { PermissionId = 39, Code = "NAV:procurement.purchase-invoices", SubNavItemId = 28 },
-            new Permission { PermissionId = 40, Code = "NAV:settings.branches", SubNavItemId = 29 }
+            new Permission { PermissionId = 40, Code = "NAV:settings.branches", SubNavItemId = 29 },
+            new Permission { PermissionId = 41, Code = "NAV:stock.ledger", SubNavItemId = 31 },
+            new Permission { PermissionId = 42, Code = "NAV:stock.enquiry", SubNavItemId = 32 },
+            new Permission { PermissionId = 43, Code = "NAV:stock.valuation", SubNavItemId = 33 },
+            new Permission { PermissionId = 44, Code = "NAV:stock.transfers", SubNavItemId = 34 },
+            new Permission { PermissionId = 45, Code = "NAV:stock.adjustments", SubNavItemId = 35 },
+            new Permission { PermissionId = 46, Code = "NAV:stock.counts", SubNavItemId = 36 },
+            new Permission { PermissionId = 47, Code = "NAV:stock.reorder-alerts", SubNavItemId = 37 },
+            new Permission { PermissionId = 48, Code = "NAV:stock.wastage", SubNavItemId = 38 },
+            // Sales (NavItemId 13) children — SubNavItemId 23 had no permission row before now
+            // (mirrors SubNavItemConfiguration's rename of that row to sales.bundle-templates).
+            new Permission { PermissionId = 49, Code = "NAV:sales.bundle-templates", SubNavItemId = 23 },
+            new Permission { PermissionId = 50, Code = "NAV:sales.invoices", SubNavItemId = 40 },
+            new Permission { PermissionId = 51, Code = "NAV:sales.free-issues", SubNavItemId = 41 },
+            new Permission { PermissionId = 52, Code = "NAV:sales.day-end", SubNavItemId = 42 }
         );
     }
 }

Backend/ERPCore/Infra/Persistence/Configurations/SubNavItemConfiguration.cs

@@ -35,10 +35,19 @@ public sealed class SubNavItemConfiguration : IEntityTypeConfiguration<SubNavIte
             new SubNavItem { SubNavItemId = 7, NavItemId = 9, Code = "settings.roles", Label = "Roles", Href = "/dashboard/settings/roles", SortOrder = 1 },
             new SubNavItem { SubNavItemId = 8, NavItemId = 9, Code = "settings.users", Label = "Users", Href = "/dashboard/settings/users", SortOrder = 2 },
             new SubNavItem { SubNavItemId = 24, NavItemId = 9, Code = "settings.notification-config", Label = "Notification Config", Href = "/dashboard/settings/notification-config", SortOrder = 3 },
-            new SubNavItem { SubNavItemId = 23, NavItemId = 13, Code = "sales.bundle-sales", Label = "Bundle Sales", Href = "/dashboard/sales/bundles", SortOrder = 1 },
+            // Sales (NavItemId 13) children — mirror the sidebar order (AppSidebar.tsx). SubNavItemId
+            // 23 is renamed in place (was "sales.bundle-sales" / Bundle Sales) rather than
+            // delete+recreate, so any role already granted this permission keeps it; the rest are new.
+            new SubNavItem { SubNavItemId = 40, NavItemId = 13, Code = "sales.invoices", Label = "Sales", Href = "/dashboard/sales/invoices", SortOrder = 1 },
+            new SubNavItem { SubNavItemId = 23, NavItemId = 13, Code = "sales.bundle-templates", Label = "Bundle Templates", Href = "/dashboard/sales/bundles/templates", SortOrder = 2 },
+            new SubNavItem { SubNavItemId = 41, NavItemId = 13, Code = "sales.free-issues", Label = "Free Issues", Href = "/dashboard/sales/free-issues", SortOrder = 3 },
+            new SubNavItem { SubNavItemId = 42, NavItemId = 13, Code = "sales.day-end", Label = "Day End", Href = "/dashboard/sales/day-end", SortOrder = 4 },
             // Procurement (NavItemId 4) children — mirror the hub page order.
             // IDs 17-20 (not 9-12): 9-12 were already claimed by the Ledgers sub-items below;
             // these procurement rows were never actually migrated into the database before now.
+            // Vendors (SubNavItemId 30) reuses PermissionId 3, which used to point at the retired
+            // top-level "vendors" NavItem — so any role already granted this permission keeps it.
+            new SubNavItem { SubNavItemId = 30, NavItemId = 4, Code = "procurement.vendors", Label = "Vendors", Href = "/dashboard/vendors", SortOrder = 0 },
             new SubNavItem { SubNavItemId = 17, NavItemId = 4, Code = "procurement.requisitions", Label = "Requisitions", Href = "/dashboard/procurement/requisitions", SortOrder = 1 },
             new SubNavItem { SubNavItemId = 18, NavItemId = 4, Code = "procurement.rfqs", Label = "RFQs", Href = "/dashboard/procurement/rfqs", SortOrder = 2 },
             new SubNavItem { SubNavItemId = 19, NavItemId = 4, Code = "procurement.purchase-orders", Label = "Purchase Orders", Href = "/dashboard/procurement/purchase-orders", SortOrder = 3 },
@@ -64,7 +73,18 @@ public sealed class SubNavItemConfiguration : IEntityTypeConfiguration<SubNavIte
             // FixProductionTemplatesSubNavItemIdConflict for the data repair.
             new SubNavItem { SubNavItemId = 27, NavItemId = 14, Code = "production.templates", Label = "Templates", Href = "/dashboard/production/templates", SortOrder = 1 },
             new SubNavItem { SubNavItemId = 25, NavItemId = 14, Code = "production.runs", Label = "Runs", Href = "/dashboard/production/runs", SortOrder = 2 },
-            new SubNavItem { SubNavItemId = 26, NavItemId = 14, Code = "production.produced", Label = "Produced", Href = "/dashboard/production/produced", SortOrder = 3 }
+            new SubNavItem { SubNavItemId = 26, NavItemId = 14, Code = "production.produced", Label = "Produced", Href = "/dashboard/production/produced", SortOrder = 3 },
+            // Stock (NavItemId 6) children — mirror the sidebar order (AppSidebar.tsx). These rows
+            // never existed in the database before now, so "stock" is still bypassed frontend-side
+            // in AppSidebar.tsx until roles are actually granted these permissions.
+            new SubNavItem { SubNavItemId = 31, NavItemId = 6, Code = "stock.ledger", Label = "Stock Ledger", Href = "/dashboard/stock/ledger", SortOrder = 1 },
+            new SubNavItem { SubNavItemId = 32, NavItemId = 6, Code = "stock.enquiry", Label = "Stock Enquiry", Href = "/dashboard/stock/enquiry", SortOrder = 2 },
+            new SubNavItem { SubNavItemId = 33, NavItemId = 6, Code = "stock.valuation", Label = "Valuation", Href = "/dashboard/stock/valuation", SortOrder = 3 },
+            new SubNavItem { SubNavItemId = 34, NavItemId = 6, Code = "stock.transfers", Label = "Transfers", Href = "/dashboard/stock/transfers", SortOrder = 4 },
+            new SubNavItem { SubNavItemId = 35, NavItemId = 6, Code = "stock.adjustments", Label = "Adjustments", Href = "/dashboard/stock/adjustments", SortOrder = 5 },
+            new SubNavItem { SubNavItemId = 36, NavItemId = 6, Code = "stock.counts", Label = "Counts", Href = "/dashboard/stock/counts", SortOrder = 6 },
+            new SubNavItem { SubNavItemId = 37, NavItemId = 6, Code = "stock.reorder-alerts", Label = "Reorder Alerts", Href = "/dashboard/stock/reorder-alerts", SortOrder = 7 },
+            new SubNavItem { SubNavItemId = 38, NavItemId = 6, Code = "stock.wastage", Label = "Wastage", Href = "/dashboard/stock/wastage", SortOrder = 8 }
         );
     }
 }

Backend/ERPCore/Infra/Persistence/ErpDbContext.cs

@@ -114,6 +114,7 @@ public class ErpDbContext : DbContext
     // --- Cross-cutting: audit trail + GL-ready journal (docs/10 Part C.7) ---
     public DbSet<AuditLog> AuditLogs => Set<AuditLog>();
     public DbSet<JournalEntryStub> JournalEntryStubs => Set<JournalEntryStub>();
+    public DbSet<LoginActivity> LoginActivities => Set<LoginActivity>();
 
     // --- HRM: org masters (docs/12-BACKEND-HRM.md Part C.1) ---
     public DbSet<Branch> Branches => Set<Branch>();

Backend/ERPCore/Migrations/20260909101932_MoveVendorsUnderProcurement.cs

@@ -0,0 +1,55 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace ERPCore.Migrations
+{
+    /// <inheritdoc />
+    public partial class MoveVendorsUnderProcurement : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            // Order matters: Permission.NavItemId cascades on delete, so the permission row must be
+            // repointed off NavItemId 3 (via the new sub_nav_item) before that nav_item is deleted —
+            // otherwise the delete cascades and removes the permission row first.
+            migrationBuilder.InsertData(
+                table: "sub_nav_items",
+                columns: new[] { "SubNavItemId", "Code", "Href", "Icon", "Label", "NavItemId", "SortOrder" },
+                values: new object[] { 30, "procurement.vendors", "/dashboard/vendors", null, "Vendors", 4, 0 });
+
+            migrationBuilder.UpdateData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 3,
+                columns: new[] { "Code", "NavItemId", "SubNavItemId" },
+                values: new object[] { "NAV:procurement.vendors", null, 30 });
+
+            migrationBuilder.DeleteData(
+                table: "nav_items",
+                keyColumn: "NavItemId",
+                keyValue: 3);
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 30);
+
+            migrationBuilder.InsertData(
+                table: "nav_items",
+                columns: new[] { "NavItemId", "Code", "Href", "Icon", "Label", "SortOrder", "Status" },
+                values: new object[] { 3, "vendors", "/dashboard/vendors", null, "Vendors", 3, "Active" });
+
+            migrationBuilder.UpdateData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 3,
+                columns: new[] { "Code", "NavItemId", "SubNavItemId" },
+                values: new object[] { "NAV:vendors", 3, null });
+        }
+    }
+}

Backend/ERPCore/Migrations/20260909102452_AddStockSubNavItems.cs

@@ -0,0 +1,130 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+#pragma warning disable CA1814 // Prefer jagged arrays over multidimensional
+
+namespace ERPCore.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddStockSubNavItems : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.InsertData(
+                table: "sub_nav_items",
+                columns: new[] { "SubNavItemId", "Code", "Href", "Icon", "Label", "NavItemId", "SortOrder" },
+                values: new object[,]
+                {
+                    { 31, "stock.ledger", "/dashboard/stock/ledger", null, "Stock Ledger", 6, 1 },
+                    { 32, "stock.enquiry", "/dashboard/stock/enquiry", null, "Stock Enquiry", 6, 2 },
+                    { 33, "stock.valuation", "/dashboard/stock/valuation", null, "Valuation", 6, 3 },
+                    { 34, "stock.transfers", "/dashboard/stock/transfers", null, "Transfers", 6, 4 },
+                    { 35, "stock.adjustments", "/dashboard/stock/adjustments", null, "Adjustments", 6, 5 },
+                    { 36, "stock.counts", "/dashboard/stock/counts", null, "Counts", 6, 6 },
+                    { 37, "stock.reorder-alerts", "/dashboard/stock/reorder-alerts", null, "Reorder Alerts", 6, 7 },
+                    { 38, "stock.wastage", "/dashboard/stock/wastage", null, "Wastage", 6, 8 }
+                });
+
+            migrationBuilder.InsertData(
+                table: "permissions",
+                columns: new[] { "PermissionId", "Code", "NavItemId", "SubNavItemId" },
+                values: new object[,]
+                {
+                    { 41, "NAV:stock.ledger", null, 31 },
+                    { 42, "NAV:stock.enquiry", null, 32 },
+                    { 43, "NAV:stock.valuation", null, 33 },
+                    { 44, "NAV:stock.transfers", null, 34 },
+                    { 45, "NAV:stock.adjustments", null, 35 },
+                    { 46, "NAV:stock.counts", null, 36 },
+                    { 47, "NAV:stock.reorder-alerts", null, 37 },
+                    { 48, "NAV:stock.wastage", null, 38 }
+                });
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 41);
+
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 42);
+
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 43);
+
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 44);
+
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 45);
+
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 46);
+
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 47);
+
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 48);
+
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 31);
+
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 32);
+
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 33);
+
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 34);
+
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 35);
+
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 36);
+
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 37);
+
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 38);
+        }
+    }
+}

Backend/ERPCore/Migrations/20260909103002_AddSalesSubNavItems.cs

@@ -0,0 +1,94 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+#pragma warning disable CA1814 // Prefer jagged arrays over multidimensional
+
+namespace ERPCore.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddSalesSubNavItems : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.InsertData(
+                table: "permissions",
+                columns: new[] { "PermissionId", "Code", "NavItemId", "SubNavItemId" },
+                values: new object[] { 49, "NAV:sales.bundle-templates", null, 23 });
+
+            migrationBuilder.UpdateData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 23,
+                columns: new[] { "Code", "Href", "Label", "SortOrder" },
+                values: new object[] { "sales.bundle-templates", "/dashboard/sales/bundles/templates", "Bundle Templates", 2 });
+
+            migrationBuilder.InsertData(
+                table: "sub_nav_items",
+                columns: new[] { "SubNavItemId", "Code", "Href", "Icon", "Label", "NavItemId", "SortOrder" },
+                values: new object[,]
+                {
+                    { 40, "sales.invoices", "/dashboard/sales/invoices", null, "Sales", 13, 1 },
+                    { 41, "sales.free-issues", "/dashboard/sales/free-issues", null, "Free Issues", 13, 3 },
+                    { 42, "sales.day-end", "/dashboard/sales/day-end", null, "Day End", 13, 4 }
+                });
+
+            migrationBuilder.InsertData(
+                table: "permissions",
+                columns: new[] { "PermissionId", "Code", "NavItemId", "SubNavItemId" },
+                values: new object[,]
+                {
+                    { 50, "NAV:sales.invoices", null, 40 },
+                    { 51, "NAV:sales.free-issues", null, 41 },
+                    { 52, "NAV:sales.day-end", null, 42 }
+                });
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 49);
+
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 50);
+
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 51);
+
+            migrationBuilder.DeleteData(
+                table: "permissions",
+                keyColumn: "PermissionId",
+                keyValue: 52);
+
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 40);
+
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 41);
+
+            migrationBuilder.DeleteData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 42);
+
+            migrationBuilder.UpdateData(
+                table: "sub_nav_items",
+                keyColumn: "SubNavItemId",
+                keyValue: 23,
+                columns: new[] { "Code", "Href", "Label", "SortOrder" },
+                values: new object[] { "sales.bundle-sales", "/dashboard/sales/bundles", "Bundle Sales", 1 });
+        }
+    }
+}

Backend/ERPCore/Migrations/20260910092607_AddLoginActivity.cs

@@ -0,0 +1,51 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
+
+#nullable disable
+
+namespace ERPCore.Migrations
+{
+    /// <inheritdoc />
+    public partial class AddLoginActivity : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "login_activities",
+                columns: table => new
+                {
+                    LoginActivityId = table.Column<int>(type: "integer", nullable: false)
+                        .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
+                    UserId = table.Column<int>(type: "integer", nullable: false),
+                    IpAddress = table.Column<string>(type: "character varying(64)", maxLength: 64, nullable: true),
+                    UserAgent = table.Column<string>(type: "character varying(500)", maxLength: 500, nullable: true),
+                    DeviceLabel = table.Column<string>(type: "character varying(200)", maxLength: 200, nullable: true),
+                    LoginAt = table.Column<DateTime>(type: "timestamp with time zone", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_login_activities", x => x.LoginActivityId);
+                    table.ForeignKey(
+                        name: "FK_login_activities_users_UserId",
+                        column: x => x.UserId,
+                        principalTable: "users",
+                        principalColumn: "UserId",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_login_activities_UserId_LoginAt",
+                table: "login_activities",
+                columns: new[] { "UserId", "LoginAt" });
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "login_activities");
+        }
+    }
+}

Backend/ERPCore/Migrations/ErpDbContextModelSnapshot.cs

@@ -2171,6 +2171,39 @@ namespace ERPCore.Migrations
                     b.ToTable("hr_loan_installments", (string)null);
                 });
 
+            modelBuilder.Entity("ERPCore.Domain.Entities.LoginActivity", b =>
+                {
+                    b.Property<int>("LoginActivityId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("integer");
+
+                    NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<int>("LoginActivityId"));
+
+                    b.Property<string>("DeviceLabel")
+                        .HasMaxLength(200)
+                        .HasColumnType("character varying(200)");
+
+                    b.Property<string>("IpAddress")
+                        .HasMaxLength(64)
+                        .HasColumnType("character varying(64)");
+
+                    b.Property<DateTime>("LoginAt")
+                        .HasColumnType("timestamp with time zone");
+
+                    b.Property<string>("UserAgent")
+                        .HasMaxLength(500)
+                        .HasColumnType("character varying(500)");
+
+                    b.Property<int>("UserId")
+                        .HasColumnType("integer");
+
+                    b.HasKey("LoginActivityId");
+
+                    b.HasIndex("UserId", "LoginAt");
+
+                    b.ToTable("login_activities", (string)null);
+                });
+
             modelBuilder.Entity("ERPCore.Domain.Entities.NavItem", b =>
                 {
                     b.Property<int>("NavItemId")
@@ -2234,15 +2267,6 @@ namespace ERPCore.Migrations
                             Status = "Active"
                         },
                         new
-                        {
-                            NavItemId = 3,
-                            Code = "vendors",
-                            Href = "/dashboard/vendors",
-                            Label = "Vendors",
-                            SortOrder = 3,
-                            Status = "Active"
-                        },
-                        new
                         {
                             NavItemId = 4,
                             Code = "procurement",
@@ -2766,8 +2790,8 @@ namespace ERPCore.Migrations
                         new
                         {
                             PermissionId = 3,
-                            Code = "NAV:vendors",
-                            NavItemId = 3
+                            Code = "NAV:procurement.vendors",
+                            SubNavItemId = 30
                         },
                         new
                         {
@@ -2990,6 +3014,78 @@ namespace ERPCore.Migrations
                             PermissionId = 40,
                             Code = "NAV:settings.branches",
                             SubNavItemId = 29
+                        },
+                        new
+                        {
+                            PermissionId = 41,
+                            Code = "NAV:stock.ledger",
+                            SubNavItemId = 31
+                        },
+                        new
+                        {
+                            PermissionId = 42,
+                            Code = "NAV:stock.enquiry",
+                            SubNavItemId = 32
+                        },
+                        new
+                        {
+                            PermissionId = 43,
+                            Code = "NAV:stock.valuation",
+                            SubNavItemId = 33
+                        },
+                        new
+                        {
+                            PermissionId = 44,
+                            Code = "NAV:stock.transfers",
+                            SubNavItemId = 34
+                        },
+                        new
+                        {
+                            PermissionId = 45,
+                            Code = "NAV:stock.adjustments",
+                            SubNavItemId = 35
+                        },
+                        new
+                        {
+                            PermissionId = 46,
+                            Code = "NAV:stock.counts",
+                            SubNavItemId = 36
+                        },
+                        new
+                        {
+                            PermissionId = 47,
+                            Code = "NAV:stock.reorder-alerts",
+                            SubNavItemId = 37
+                        },
+                        new
+                        {
+                            PermissionId = 48,
+                            Code = "NAV:stock.wastage",
+                            SubNavItemId = 38
+                        },
+                        new
+                        {
+                            PermissionId = 49,
+                            Code = "NAV:sales.bundle-templates",
+                            SubNavItemId = 23
+                        },
+                        new
+                        {
+                            PermissionId = 50,
+                            Code = "NAV:sales.invoices",
+                            SubNavItemId = 40
+                        },
+                        new
+                        {
+                            PermissionId = 51,
+                            Code = "NAV:sales.free-issues",
+                            SubNavItemId = 41
+                        },
+                        new
+                        {
+                            PermissionId = 52,
+                            Code = "NAV:sales.day-end",
+                            SubNavItemId = 42
                         });
                 });
 
@@ -5502,15 +5598,55 @@ namespace ERPCore.Migrations
                         },
                         new
                         {
-                            SubNavItemId = 23,
-                            Code = "sales.bundle-sales",
-                            Href = "/dashboard/sales/bundles",
-                            Label = "Bundle Sales",
+                            SubNavItemId = 40,
+                            Code = "sales.invoices",
+                            Href = "/dashboard/sales/invoices",
+                            Label = "Sales",
                             NavItemId = 13,
                             SortOrder = 1,
                             Status = "Active"
                         },
                         new
+                        {
+                            SubNavItemId = 23,
+                            Code = "sales.bundle-templates",
+                            Href = "/dashboard/sales/bundles/templates",
+                            Label = "Bundle Templates",
+                            NavItemId = 13,
+                            SortOrder = 2,
+                            Status = "Active"
+                        },
+                        new
+                        {
+                            SubNavItemId = 41,
+                            Code = "sales.free-issues",
+                            Href = "/dashboard/sales/free-issues",
+                            Label = "Free Issues",
+                            NavItemId = 13,
+                            SortOrder = 3,
+                            Status = "Active"
+                        },
+                        new
+                        {
+                            SubNavItemId = 42,
+                            Code = "sales.day-end",
+                            Href = "/dashboard/sales/day-end",
+                            Label = "Day End",
+                            NavItemId = 13,
+                            SortOrder = 4,
+                            Status = "Active"
+                        },
+                        new
+                        {
+                            SubNavItemId = 30,
+                            Code = "procurement.vendors",
+                            Href = "/dashboard/vendors",
+                            Label = "Vendors",
+                            NavItemId = 4,
+                            SortOrder = 0,
+                            Status = "Active"
+                        },
+                        new
                         {
                             SubNavItemId = 17,
                             Code = "procurement.requisitions",
@@ -5689,6 +5825,86 @@ namespace ERPCore.Migrations
                             NavItemId = 14,
                             SortOrder = 3,
                             Status = "Active"
+                        },
+                        new
+                        {
+                            SubNavItemId = 31,
+                            Code = "stock.ledger",
+                            Href = "/dashboard/stock/ledger",
+                            Label = "Stock Ledger",
+                            NavItemId = 6,
+                            SortOrder = 1,
+                            Status = "Active"
+                        },
+                        new
+                        {
+                            SubNavItemId = 32,
+                            Code = "stock.enquiry",
+                            Href = "/dashboard/stock/enquiry",
+                            Label = "Stock Enquiry",
+                            NavItemId = 6,
+                            SortOrder = 2,
+                            Status = "Active"
+                        },
+                        new
+                        {
+                            SubNavItemId = 33,
+                            Code = "stock.valuation",
+                            Href = "/dashboard/stock/valuation",
+                            Label = "Valuation",
+                            NavItemId = 6,
+                            SortOrder = 3,
+                            Status = "Active"
+                        },
+                        new
+                        {
+                            SubNavItemId = 34,
+                            Code = "stock.transfers",
+                            Href = "/dashboard/stock/transfers",
+                            Label = "Transfers",
+                            NavItemId = 6,
+                            SortOrder = 4,
+                            Status = "Active"
+                        },
+                        new
+                        {
+                            SubNavItemId = 35,
+                            Code = "stock.adjustments",
+                            Href = "/dashboard/stock/adjustments",
+                            Label = "Adjustments",
+                            NavItemId = 6,
+                            SortOrder = 5,
+                            Status = "Active"
+                        },
+                        new
+                        {
+                            SubNavItemId = 36,
+                            Code = "stock.counts",
+                            Href = "/dashboard/stock/counts",
+                            Label = "Counts",
+                            NavItemId = 6,
+                            SortOrder = 6,
+                            Status = "Active"
+                        },
+                        new
+                        {
+                            SubNavItemId = 37,
+                            Code = "stock.reorder-alerts",
+                            Href = "/dashboard/stock/reorder-alerts",
+                            Label = "Reorder Alerts",
+                            NavItemId = 6,
+                            SortOrder = 7,
+                            Status = "Active"
+                        },
+                        new
+                        {
+                            SubNavItemId = 38,
+                            Code = "stock.wastage",
+                            Href = "/dashboard/stock/wastage",
+                            Label = "Wastage",
+                            NavItemId = 6,
+                            SortOrder = 8,
+                            Status = "Active"
                         });
                 });
 
@@ -6618,6 +6834,17 @@ namespace ERPCore.Migrations
                     b.Navigation("PayrollRun");
                 });
 
+            modelBuilder.Entity("ERPCore.Domain.Entities.LoginActivity", b =>
+                {
+                    b.HasOne("ERPCore.Domain.Entities.User", "User")
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("User");
+                });
+
             modelBuilder.Entity("ERPCore.Domain.Entities.NotificationConfig", b =>
                 {
                     b.HasOne("ERPCore.Domain.Entities.User", "UpdatedByUser")

Backend/ERPCore/Services/AuditService.cs

@@ -1,7 +1,10 @@
 using System.Text.Json;
 using ERPCore.Domain.Entities;
+using ERPCore.Domain.Enums;
 using ERPCore.Dtos.Audit;
 using ERPCore.Dtos.Common;
+using ERPCore.Infra.Auth;
+using ERPCore.Infra.UoW;
 using ERPCore.Repositories.Interfaces;
 using ERPCore.Services.Interfaces;
 using Microsoft.EntityFrameworkCore;
@@ -12,11 +15,19 @@ public sealed class AuditService : IAuditService
 {
     private readonly IRepository<AuditLog> _logs;
     private readonly IRepository<JournalEntryStub> _journal;
+    private readonly IRepository<User> _users;
+    private readonly IRepository<LoginActivity> _loginActivities;
+    private readonly IUnitOfWork _uow;
 
-    public AuditService(IRepository<AuditLog> logs, IRepository<JournalEntryStub> journal)
+    public AuditService(
+        IRepository<AuditLog> logs, IRepository<JournalEntryStub> journal, IRepository<User> users,
+        IRepository<LoginActivity> loginActivities, IUnitOfWork uow)
     {
         _logs = logs;
         _journal = journal;
+        _users = users;
+        _loginActivities = loginActivities;
+        _uow = uow;
     }
 
     public async Task<PagedResponse<AuditLogDto>> ListLogsAsync(
@@ -55,4 +66,48 @@ public sealed class AuditService : IAuditService
 
         return PagedResponse<JournalEntryStubDto>.Create(rows, query.Page, query.PageSize, total);
     }
+
+    public async Task RecordLoginAsync(Guid authUserId, string? ipAddress, string? userAgent, CancellationToken ct = default)
+    {
+        var userId = await _users.Query().AsNoTracking()
+            .Where(u => u.AuthUserId == authUserId)
+            .Select(u => (int?)u.UserId)
+            .FirstOrDefaultAsync(ct);
+        // JIT provisioning may not have created the local shadow row yet on a brand-new
+        // account's very first login — nothing to attach the log to in that case.
+        if (userId is null) return;
+
+        var now = DateTime.UtcNow;
+        await _logs.AddAsync(new AuditLog
+        {
+            UserId = userId.Value,
+            EntityType = "User",
+            EntityId = userId.Value,
+            Action = AuditAction.Login,
+            ChangeSet = "{}",
+            CreatedAt = now
+        }, ct);
+        await _loginActivities.AddAsync(new LoginActivity
+        {
+            UserId = userId.Value,
+            IpAddress = ipAddress,
+            UserAgent = userAgent,
+            DeviceLabel = UserAgentLabeler.Label(userAgent),
+            LoginAt = now
+        }, ct);
+        await _uow.SaveChangesAsync(ct);
+    }
+
+    public async Task<PagedResponse<LoginActivityDto>> ListLoginDevicesAsync(int userId, PageQuery query, CancellationToken ct = default)
+    {
+        var q = _loginActivities.Query().AsNoTracking().Where(l => l.UserId == userId);
+
+        var total = await q.CountAsync(ct);
+        var rows = await q.OrderByDescending(l => l.LoginActivityId)
+            .Skip(query.Skip).Take(query.PageSize)
+            .Select(l => new LoginActivityDto(l.LoginActivityId, l.IpAddress, l.DeviceLabel, l.LoginAt))
+            .ToListAsync(ct);
+
+        return PagedResponse<LoginActivityDto>.Create(rows, query.Page, query.PageSize, total);
+    }
 }

Backend/ERPCore/Services/Hrm/BranchService.cs

@@ -123,5 +123,21 @@ public sealed class BranchService : IBranchService
         await _uow.SaveChangesAsync(ct);
     }
 
+    public async Task DeleteAsync(int branchId, CancellationToken ct = default)
+    {
+        var branch = await _branches.GetByIdAsync(branchId, ct)
+            ?? throw new NotFoundException($"Branch {branchId} was not found.");
+
+        _branches.Remove(branch);
+        try
+        {
+            await _uow.SaveChangesAsync(ct);
+        }
+        catch (DbUpdateException)
+        {
+            throw new DomainException(ErrorCodes.MasterInUse, "This branch is referenced by other records and cannot be deleted.", 409);
+        }
+    }
+
     private static BranchDto Map(Branch b) => new(b.BranchId, b.Code, b.Name, b.Address, b.PhoneNumber, b.Status, b.CreatedAt, b.UpdatedAt);
 }

Backend/ERPCore/Services/Hrm/EmployeeService.cs

@@ -3,6 +3,7 @@ using ERPCore.Domain.Entities;
 using ERPCore.Domain.Enums;
 using ERPCore.Dtos.Common;
 using ERPCore.Dtos.Hrm;
+using ERPCore.Infra.Storage;
 using ERPCore.Infra.UoW;
 using ERPCore.Repositories.Interfaces;
 using ERPCore.Services.Interfaces;
@@ -21,17 +22,31 @@ public sealed class EmployeeService : IEmployeeService
     private readonly IRepository<Employee> _employees;
     private readonly IRepository<User> _users;
     private readonly IRepository<EmployeeBankDetail> _bankDetails;
+    private readonly IRepository<EmployeeDocument> _documents;
+    private readonly IRepository<EmployeeSalaryStructure> _salaryStructures;
+    private readonly IRepository<EmployeeLoan> _loans;
+    private readonly IRepository<LeaveBalance> _leaveBalances;
+    private readonly IRepository<PayrollLine> _payrollLines;
+    private readonly IFileStorageService _fileStorage;
     private readonly IBranchConfigService _branchConfig;
     private readonly IBranchAccessService _branchAccess;
     private readonly IUnitOfWork _uow;
 
     public EmployeeService(
         IRepository<Employee> employees, IRepository<User> users, IRepository<EmployeeBankDetail> bankDetails,
-        IBranchConfigService branchConfig, IBranchAccessService branchAccess, IUnitOfWork uow)
+        IRepository<EmployeeDocument> documents, IRepository<EmployeeSalaryStructure> salaryStructures,
+        IRepository<EmployeeLoan> loans, IRepository<LeaveBalance> leaveBalances, IRepository<PayrollLine> payrollLines,
+        IFileStorageService fileStorage, IBranchConfigService branchConfig, IBranchAccessService branchAccess, IUnitOfWork uow)
     {
         _employees = employees;
         _users = users;
         _bankDetails = bankDetails;
+        _documents = documents;
+        _salaryStructures = salaryStructures;
+        _loans = loans;
+        _leaveBalances = leaveBalances;
+        _payrollLines = payrollLines;
+        _fileStorage = fileStorage;
         _branchConfig = branchConfig;
         _branchAccess = branchAccess;
         _uow = uow;
@@ -197,6 +212,48 @@ public sealed class EmployeeService : IEmployeeService
         await _uow.SaveChangesAsync(ct);
     }
 
+    public async Task DeleteAsync(int employeeId, CancellationToken ct = default)
+    {
+        var employee = await _employees.GetByIdAsync(employeeId, ct)
+            ?? throw new NotFoundException($"Employee {employeeId} was not found.");
+
+        if (await _payrollLines.Query().AnyAsync(l => l.EmployeeId == employeeId, ct))
+            throw new DomainException(ErrorCodes.EmployeeHasPayrollHistory, "This employee has payroll history and cannot be deleted.", 409);
+
+        // A linked system-user account survives the employee row (Employee.UserId → User is
+        // Restrict, so cascading it away isn't even an option) — deactivate it (same as the
+        // Active/Deactivate toggle on Settings > Users) rather than leaving a login standing
+        // with no staff record behind it. The User row itself is never removed.
+        if (employee.UserId is not null)
+        {
+            var linkedUser = await _users.GetByIdAsync(employee.UserId.Value, ct);
+            if (linkedUser is not null) linkedUser.Status = EntityStatus.Inactive;
+        }
+
+        // Bank details and documents cascade at the DB level, but documents also have a
+        // physical file on disk that cascading the row would silently orphan — delete those
+        // explicitly first. Salary structures, loans, and leave balances are Restrict FKs, so
+        // they must be removed before the employee row itself will delete.
+        var documents = await _documents.Query().Where(d => d.EmployeeId == employeeId).ToListAsync(ct);
+        foreach (var doc in documents)
+        {
+            await _fileStorage.DeleteAsync(doc.RelativePath, ct);
+            _documents.Remove(doc);
+        }
+
+        var salaryStructures = await _salaryStructures.Query().Where(s => s.EmployeeId == employeeId).ToListAsync(ct);
+        foreach (var structure in salaryStructures) _salaryStructures.Remove(structure);
+
+        var loans = await _loans.Query().Where(l => l.EmployeeId == employeeId).ToListAsync(ct);
+        foreach (var loan in loans) _loans.Remove(loan);
+
+        var leaveBalances = await _leaveBalances.Query().Where(b => b.EmployeeId == employeeId).ToListAsync(ct);
+        foreach (var balance in leaveBalances) _leaveBalances.Remove(balance);
+
+        _employees.Remove(employee);
+        await _uow.SaveChangesAsync(ct);
+    }
+
     public async Task<List<EmployeeBankDetailDto>> ListBankDetailsAsync(int employeeId, CancellationToken ct = default)
     {
         return await _bankDetails.Query().AsNoTracking()

Backend/ERPCore/Services/Interfaces/IAuditService.cs

@@ -5,7 +5,10 @@ namespace ERPCore.Services.Interfaces;
 
 /// <summary>
 /// Read access to the audit trail and GL-ready journal stubs (auditor role,
-/// 02-SECURITY B.2.3). Both are append-only; no write API.
+/// 02-SECURITY B.2.3). Both are append-only — entity mutations are captured
+/// automatically by ErpDbContext.SaveChangesAsync and never written here directly.
+/// The one deliberate exception is <see cref="RecordLoginAsync"/>: a successful
+/// sign-in changes no entity, so nothing would otherwise appear in the trail for it.
 /// </summary>
 public interface IAuditService
 {
@@ -14,4 +17,12 @@ public interface IAuditService
 
     Task<PagedResponse<JournalEntryStubDto>> ListJournalAsync(
         string? sourceDocType, int? sourceDocId, PageQuery query, CancellationToken ct = default);
+
+    /// <summary>Writes a Login audit row and a login-device history entry for the local User backing this
+    /// AuthHex identity, if one exists yet.</summary>
+    Task RecordLoginAsync(Guid authUserId, string? ipAddress, string? userAgent, CancellationToken ct = default);
+
+    /// <summary>Past logins for a user — a history ERPCore captures itself, not a live "currently active
+    /// sessions" view (AuthHex has no admin-scoped call to inspect another user's sessions).</summary>
+    Task<PagedResponse<LoginActivityDto>> ListLoginDevicesAsync(int userId, PageQuery query, CancellationToken ct = default);
 }

Backend/ERPCore/Services/Interfaces/IBranchService.cs

@@ -13,4 +13,5 @@ public interface IBranchService
     Task<ETagged<BranchDto>> CreateAsync(CreateBranchRequest request, CancellationToken ct = default);
     Task<ETagged<BranchDto>> UpdateAsync(int branchId, UpdateBranchRequest request, uint expectedRowVersion, CancellationToken ct = default);
     Task SetStatusAsync(int branchId, EntityStatus status, CancellationToken ct = default);
+    Task DeleteAsync(int branchId, CancellationToken ct = default);
 }

Backend/ERPCore/Services/Interfaces/IEmployeeService.cs

@@ -15,6 +15,14 @@ public interface IEmployeeService
     Task<ETagged<EmployeeDetailDto>> UpdateAsync(int employeeId, UpdateEmployeeRequest request, uint expectedRowVersion, int actorUserId, CancellationToken ct = default);
     Task SetStatusAsync(int employeeId, EmployeeStatus status, CancellationToken ct = default);
 
+    /// <summary>
+    /// Permanently deletes the employee and every dependent record (bank details, documents
+    /// incl. their stored files, salary structure history, loans, leave balances). Blocked with
+    /// 409 if the employee has any payroll history, since that's financial/audit record that
+    /// must never be destroyed.
+    /// </summary>
+    Task DeleteAsync(int employeeId, CancellationToken ct = default);
+
     Task<List<EmployeeBankDetailDto>> ListBankDetailsAsync(int employeeId, CancellationToken ct = default);
     Task<List<EmployeeBankDetailDto>> ReplaceBankDetailsAsync(int employeeId, ReplaceEmployeeBankDetailsRequest request, CancellationToken ct = default);
 }

Backend/ERPCore/Services/Interfaces/IUserManagementService.cs

@@ -1,3 +1,4 @@
+using ERPCore.Domain.Enums;
 using ERPCore.Dtos.Common;
 using ERPCore.Dtos.Users;
 
@@ -10,11 +11,21 @@ namespace ERPCore.Services.Interfaces;
 /// </summary>
 public interface IUserManagementService
 {
-    Task<PagedResponse<ManagedUserDto>> ListAsync(PageQuery query, CancellationToken ct = default);
+    Task<PagedResponse<ManagedUserDto>> ListAsync(PageQuery query, EntityStatus? status, string? roleCode, CancellationToken ct = default);
     Task<ManagedUserDto?> GetAsync(int userId, CancellationToken ct = default);
     Task<ManagedUserDto> CreateAsync(CreateUserRequest request, int actorUserId, CancellationToken ct = default);
     Task<ManagedUserDto> UpdateRoleAsync(int userId, UpdateUserRoleRequest request, CancellationToken ct = default);
 
+    /// <summary>
+    /// Flips the local shadow row's status (Active/Inactive) — this is what
+    /// BranchAccessService and the rest of ERPCore gate on. AuthHex has no
+    /// admin-scoped "deactivate someone else's account" call (its ChangeUserStatus
+    /// is self-service, acting on whoever's bearer token is passed), so the
+    /// credential itself stays live upstream; this only revokes the account's
+    /// standing inside ERPCore.
+    /// </summary>
+    Task<ManagedUserDto> SetStatusAsync(int userId, EntityStatus status, CancellationToken ct = default);
+
     /// <summary>AuthHex UserType options for the create-user form's select.</summary>
     Task<List<UserTypeOptionDto>> ListUserTypesAsync(CancellationToken ct = default);
 }

Backend/ERPCore/Services/Interfaces/IWarehouseService.cs

@@ -6,7 +6,7 @@ namespace ERPCore.Services.Interfaces;
 /// <summary>Warehouse &amp; bin master business logic (docs/11-BACKEND-PHASE1.md §2.5).</summary>
 public interface IWarehouseService
 {
-    Task<PagedResponse<WarehouseDto>> ListAsync(PageQuery query, CancellationToken ct = default);
+    Task<PagedResponse<WarehouseDto>> ListAsync(PageQuery query, int? branchId, CancellationToken ct = default);
     Task<WarehouseDto?> GetAsync(int warehouseId, CancellationToken ct = default);
     Task<WarehouseDto> CreateAsync(CreateWarehouseRequest request, CancellationToken ct = default);
 

Backend/ERPCore/Services/UserManagementService.cs

@@ -18,27 +18,25 @@ public sealed class UserManagementService : IUserManagementService
     private readonly IRepository<User> _users;
     private readonly IRepository<Role> _roles;
     private readonly IRepository<Employee> _employees;
-    private readonly IAuthUserService _authUsers;
     private readonly IAuthHexClient _authHex;
     private readonly IEmployeeUserLinkService _links;
     private readonly IEmployeeService _employeeService;
     private readonly IUnitOfWork _uow;
 
     public UserManagementService(
-        IRepository<User> users, IRepository<Role> roles, IRepository<Employee> employees, IAuthUserService authUsers,
+        IRepository<User> users, IRepository<Role> roles, IRepository<Employee> employees,
         IAuthHexClient authHex, IEmployeeUserLinkService links, IEmployeeService employeeService, IUnitOfWork uow)
     {
         _users = users;
         _roles = roles;
         _employees = employees;
-        _authUsers = authUsers;
         _authHex = authHex;
         _links = links;
         _employeeService = employeeService;
         _uow = uow;
     }
 
-    public async Task<PagedResponse<ManagedUserDto>> ListAsync(PageQuery query, CancellationToken ct = default)
+    public async Task<PagedResponse<ManagedUserDto>> ListAsync(PageQuery query, EntityStatus? status, string? roleCode, CancellationToken ct = default)
     {
         IQueryable<User> q = _users.Query().AsNoTracking().Include(u => u.Role);
         if (!string.IsNullOrWhiteSpace(query.Q))
@@ -46,6 +44,8 @@ public sealed class UserManagementService : IUserManagementService
             var term = query.Q.Trim();
             q = q.Where(u => EF.Functions.ILike(u.Username, $"%{term}%") || EF.Functions.ILike(u.DisplayName, $"%{term}%"));
         }
+        if (status is not null) q = q.Where(u => u.Status == status);
+        if (!string.IsNullOrWhiteSpace(roleCode)) q = q.Where(u => u.Role != null && EF.Functions.ILike(u.Role.Code, roleCode));
 
         var total = await q.CountAsync(ct);
         var rows = await q.OrderBy(u => u.Username)
@@ -93,8 +93,13 @@ public sealed class UserManagementService : IUserManagementService
         var authUserId = Guid.NewGuid();
 
         // Source of truth: AuthHex creates the credential + emails it (registerUser,
-        // ERP_Auth_Service/Services/UserManager/UserManagerService.cs).
-        await _authUsers.RegisterAsync(new RegisterRequest
+        // ERP_Auth_Service/Services/UserManager/UserManagerService.cs). Calls the raw
+        // AuthHex client directly rather than IAuthUserService.RegisterAsync — that
+        // wrapper is shaped for self-registration (AuthController.Register) and demands
+        // a session (access/refresh tokens) in the response, which makes no sense here:
+        // an admin creating an account for someone else never logs in as them, so
+        // AuthHex's registerUser response for this case carries no tokens to demand.
+        await _authHex.RegisterAsync(new RegisterRequest
         {
             UserId = authUserId,
             RoleId = role.AuthRoleId,
@@ -167,6 +172,17 @@ public sealed class UserManagementService : IUserManagementService
         return Map(user);
     }
 
+    public async Task<ManagedUserDto> SetStatusAsync(int userId, EntityStatus status, CancellationToken ct = default)
+    {
+        var user = await _users.Query().Include(u => u.Role).FirstOrDefaultAsync(u => u.UserId == userId, ct)
+            ?? throw new NotFoundException($"User {userId} was not found.");
+
+        user.Status = status;
+        await _uow.SaveChangesAsync(ct);
+
+        return Map(user);
+    }
+
     public async Task<List<UserTypeOptionDto>> ListUserTypesAsync(CancellationToken ct = default)
     {
         var userTypes = await _authHex.ListUserTypesAsync(ct);

Backend/ERPCore/Services/WarehouseService.cs

@@ -28,7 +28,7 @@ public sealed class WarehouseService : IWarehouseService
         _uow = uow;
     }
 
-    public async Task<PagedResponse<WarehouseDto>> ListAsync(PageQuery query, CancellationToken ct = default)
+    public async Task<PagedResponse<WarehouseDto>> ListAsync(PageQuery query, int? branchId, CancellationToken ct = default)
     {
         IQueryable<Warehouse> q = _warehouses.Query().AsNoTracking().Include(w => w.Branch);
         if (!string.IsNullOrWhiteSpace(query.Q))
@@ -36,6 +36,7 @@ public sealed class WarehouseService : IWarehouseService
             var term = query.Q.Trim();
             q = q.Where(w => EF.Functions.ILike(w.Code, $"%{term}%") || EF.Functions.ILike(w.Name, $"%{term}%"));
         }
+        if (branchId is not null) q = q.Where(w => w.BranchId == branchId);
 
         var total = await q.CountAsync(ct);
         var rows = await q.OrderBy(w => w.Code)

Backend/ERPCore/System/Errors/ErrorCodes.cs

@@ -47,6 +47,7 @@ public static class ErrorCodes
     public const string SalaryStructureOverlap = "SALARY_STRUCTURE_OVERLAP";
     public const string TaxSlabGapInvalid = "TAX_SLAB_GAP_INVALID";
     public const string PayrollPeriodLocked = "PAYROLL_PERIOD_LOCKED";
+    public const string EmployeeHasPayrollHistory = "EMPLOYEE_HAS_PAYROLL_HISTORY";
 
     // Manufacturing / Production Lines (docs/30-BACKEND-PHASE2.md §D.4)
     public const string TemplateInUse = "TEMPLATE_IN_USE";

Frontend/erp-system/app/dashboard/hrm/employees/[id]/page.tsx

@@ -1,8 +1,8 @@
 "use client"
 
 import { useEffect, useState } from "react"
-import { useParams } from "next/navigation"
-import { Link2, Plus, Upload } from "lucide-react"
+import { useParams, useSearchParams } from "next/navigation"
+import { Briefcase, Link2, Plus, ShieldCheck, Upload, User, X } from "lucide-react"
 
 import { CreateEmployeeLoanRequest, CreateSalaryStructureRequest, employeesApi } from "@/lib/api/employees"
 import { branchesHrmApi, departmentsApi, designationsApi, employmentTypesApi, hrDocumentTypesApi, salaryComponentsApi, workShiftsApi } from "@/lib/api/hrm-masters"
@@ -44,6 +44,7 @@ function money(n: number): string {
 
 export default function EmployeeDetailPage() {
   const params = useParams<{ id: string }>()
+  const searchParams = useSearchParams()
   const employeeId = Number(params.id)
   const { isAdmin, branchId: myBranchId, branchingEnabled } = useAuth()
 
@@ -51,6 +52,7 @@ export default function EmployeeDetailPage() {
   const [employee, setEmployee] = useState<EmployeeDetail | null>(null)
   const [etag, setEtag] = useState<string | null>(null)
   const [error, setError] = useState<string | null>(null)
+  const [isEditing, setIsEditing] = useState(searchParams.get("edit") === "1")
 
   const [departments, setDepartments] = useState<Department[]>([])
   const [designations, setDesignations] = useState<Designation[]>([])
@@ -190,6 +192,7 @@ export default function EmployeeDetailPage() {
       }, etag)
       setEmployee(res.data)
       setEtag(res.etag)
+      setIsEditing(false)
       toast.success("Employee updated")
     } catch (err) {
       toast.error("Could not save", errorMessage(err))
@@ -198,6 +201,11 @@ export default function EmployeeDetailPage() {
     }
   }
 
+  function handleCancelEdit() {
+    setIsEditing(false)
+    load()
+  }
+
   async function handleUpload(file: File) {
     if (!uploadTypeId) { toast.error("Select a document type first"); return }
     try {
@@ -214,27 +222,30 @@ export default function EmployeeDetailPage() {
 
   return (
     <div className="flex flex-col gap-6">
-      <div className="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
+      <div className="flex flex-col gap-3 rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:flex-row sm:items-center sm:justify-between">
         <div>
+          <div className="flex items-center gap-2.5">
             <h1 className="text-2xl font-bold text-foreground">{employee.fullName}</h1>
-          <p className="text-base text-muted-foreground">
-            {employee.employeeCode}
+            <Badge variant="outline" className={cn("h-6 px-2.5 text-xs", employee.status === "Active" ? "bg-success/10 text-success" : "bg-muted text-muted-foreground")}>{employee.status}</Badge>
+          </div>
+          <p className="mt-1 flex flex-wrap items-center gap-x-2 text-sm text-muted-foreground">
+            <span className="font-mono">{employee.employeeCode}</span>
+            <span aria-hidden="true">·</span>
             {employee.userId ? (
-              <span className="ml-2 inline-flex items-center gap-1 text-primary"><Link2 className="size-3.5" />Linked to a system user</span>
+              <span className="inline-flex items-center gap-1 text-primary"><Link2 className="size-3.5" />Linked to a system user</span>
             ) : (
-              <span className="ml-2 text-muted-foreground">No system login</span>
+              <span>No system login</span>
             )}
           </p>
         </div>
-        <Badge variant="outline" className={cn("h-7 px-3 text-sm", employee.status === "Active" ? "bg-success/10 text-success" : "bg-muted text-muted-foreground")}>{employee.status}</Badge>
       </div>
 
-      <div className="flex gap-1 rounded-xl bg-muted p-1 w-fit">
+      <div className="flex w-full gap-1 overflow-x-auto rounded-xl bg-muted p-1">
         {TABS.map((t) => (
           <button
             key={t}
             onClick={() => setTab(t)}
-            className={cn("rounded-lg px-4 py-2 text-sm font-medium transition-colors", tab === t ? "bg-card shadow-sm text-foreground" : "text-muted-foreground hover:text-foreground")}
+            className={cn("flex-1 shrink-0 rounded-lg px-4 py-2 text-sm font-medium transition-colors", tab === t ? "bg-card shadow-sm text-foreground" : "text-muted-foreground hover:text-foreground")}
           >
             {t}
           </button>
@@ -242,37 +253,64 @@ export default function EmployeeDetailPage() {
       </div>
 
       {tab === "Overview" && (
-        <FieldGroup className="max-w-2xl">
-          <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">
-            <Field><FieldLabel>Full name</FieldLabel><Input value={employee.fullName} onChange={(e) => setEmployee({ ...employee, fullName: e.target.value })} /></Field>
-            <Field><FieldLabel>Email</FieldLabel><Input type="email" value={employee.email ?? ""} onChange={(e) => setEmployee({ ...employee, email: e.target.value })} /></Field>
-            <Field><FieldLabel>NIC</FieldLabel><Input value={employee.nic ?? ""} onChange={(e) => setEmployee({ ...employee, nic: e.target.value })} /></Field>
-            <Field><FieldLabel>Personal mobile</FieldLabel><Input value={employee.personalMobile ?? ""} onChange={(e) => setEmployee({ ...employee, personalMobile: e.target.value })} /></Field>
+        <div className="flex flex-col gap-4">
+          <section className="rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:p-6">
+            <div className="flex items-center gap-2.5 border-b border-border pb-4">
+              <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10">
+                <User className="size-4.5 text-primary" />
+              </div>
+              <div>
+                <h2 className="text-base font-semibold text-foreground">Personal details</h2>
+                <p className="text-sm text-muted-foreground">Contact and identity information.</p>
+              </div>
+            </div>
+            <FieldGroup>
+              <div className="mt-5 grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
+                <Field><FieldLabel>Full name</FieldLabel><Input disabled={!isEditing} value={employee.fullName} onChange={(e) => setEmployee({ ...employee, fullName: e.target.value })} /></Field>
+                <Field><FieldLabel>Email</FieldLabel><Input disabled={!isEditing} type="email" value={employee.email ?? ""} onChange={(e) => setEmployee({ ...employee, email: e.target.value })} /></Field>
+                <Field><FieldLabel>NIC</FieldLabel><Input disabled={!isEditing} value={employee.nic ?? ""} onChange={(e) => setEmployee({ ...employee, nic: e.target.value })} /></Field>
+                <Field><FieldLabel>Personal mobile</FieldLabel><Input disabled={!isEditing} value={employee.personalMobile ?? ""} onChange={(e) => setEmployee({ ...employee, personalMobile: e.target.value })} /></Field>
+              </div>
+            </FieldGroup>
+          </section>
+
+          <section className="rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:p-6">
+            <div className="flex items-center gap-2.5 border-b border-border pb-4">
+              <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10">
+                <Briefcase className="size-4.5 text-primary" />
+              </div>
+              <div>
+                <h2 className="text-base font-semibold text-foreground">Employment details</h2>
+                <p className="text-sm text-muted-foreground">Where and how this employee works.</p>
+              </div>
+            </div>
+            <FieldGroup>
+              <div className="mt-5 grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
                 <Field>
                   <FieldLabel>Department</FieldLabel>
                   <Select value={String(employee.departmentId)} onValueChange={(v) => setEmployee({ ...employee, departmentId: Number(v) })}>
-                <SelectTrigger><SelectValue /></SelectTrigger>
+                    <SelectTrigger disabled={!isEditing}><SelectValue /></SelectTrigger>
                     <SelectContent>{departments.map((d) => <SelectItem key={d.departmentId} value={String(d.departmentId)}>{d.name}</SelectItem>)}</SelectContent>
                   </Select>
                 </Field>
                 <Field>
                   <FieldLabel>Designation</FieldLabel>
                   <Select value={String(employee.designationId)} onValueChange={(v) => setEmployee({ ...employee, designationId: Number(v) })}>
-                <SelectTrigger><SelectValue /></SelectTrigger>
+                    <SelectTrigger disabled={!isEditing}><SelectValue /></SelectTrigger>
                     <SelectContent>{designations.map((d) => <SelectItem key={d.designationId} value={String(d.designationId)}>{d.name}</SelectItem>)}</SelectContent>
                   </Select>
                 </Field>
                 <Field>
                   <FieldLabel>Employment type</FieldLabel>
                   <Select value={String(employee.employmentTypeId)} onValueChange={(v) => setEmployee({ ...employee, employmentTypeId: Number(v) })}>
-                <SelectTrigger><SelectValue /></SelectTrigger>
+                    <SelectTrigger disabled={!isEditing}><SelectValue /></SelectTrigger>
                     <SelectContent>{employmentTypes.map((t) => <SelectItem key={t.employmentTypeId} value={String(t.employmentTypeId)}>{t.name}</SelectItem>)}</SelectContent>
                   </Select>
                 </Field>
                 <Field>
                   <FieldLabel>Work shift</FieldLabel>
                   <Select value={String(employee.workShiftId)} onValueChange={(v) => setEmployee({ ...employee, workShiftId: Number(v) })}>
-                <SelectTrigger><SelectValue /></SelectTrigger>
+                    <SelectTrigger disabled={!isEditing}><SelectValue /></SelectTrigger>
                     <SelectContent>{workShifts.map((w) => <SelectItem key={w.workShiftId} value={String(w.workShiftId)}>{w.name}</SelectItem>)}</SelectContent>
                   </Select>
                 </Field>
@@ -280,94 +318,125 @@ export default function EmployeeDetailPage() {
                   <Field>
                     <FieldLabel>Branch</FieldLabel>
                     <Select value={String(employee.branchId)} onValueChange={(v) => setEmployee({ ...employee, branchId: Number(v) })}>
-                  <SelectTrigger disabled={!isAdmin}><SelectValue placeholder="Select" /></SelectTrigger>
+                      <SelectTrigger disabled={!isEditing || !isAdmin}><SelectValue placeholder="Select" /></SelectTrigger>
                       <SelectContent>{(isAdmin ? branches : branches.filter((b) => b.branchId === myBranchId || b.branchId === employee.branchId)).map((b) => <SelectItem key={b.branchId} value={String(b.branchId)}>{b.name}</SelectItem>)}</SelectContent>
                     </Select>
                   </Field>
                 )}
-            <Field><FieldLabel>EPF number</FieldLabel><Input value={employee.epfNumber ?? ""} onChange={(e) => setEmployee({ ...employee, epfNumber: e.target.value })} /></Field>
-            <Field><FieldLabel>ETF number</FieldLabel><Input value={employee.etfNumber ?? ""} onChange={(e) => setEmployee({ ...employee, etfNumber: e.target.value })} /></Field>
-          </div>
-          <div className="flex justify-end pt-2">
-            <Button onClick={handleSave} disabled={saving}>{saving ? "Saving…" : "Save changes"}</Button>
               </div>
             </FieldGroup>
+          </section>
+
+          <section className="rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:p-6">
+            <div className="flex items-center gap-2.5 border-b border-border pb-4">
+              <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10">
+                <ShieldCheck className="size-4.5 text-primary" />
+              </div>
+              <div>
+                <h2 className="text-base font-semibold text-foreground">Statutory details</h2>
+                <p className="text-sm text-muted-foreground">Government registration numbers.</p>
+              </div>
+            </div>
+            <FieldGroup>
+              <div className="mt-5 grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
+                <Field><FieldLabel>EPF number</FieldLabel><Input disabled={!isEditing} value={employee.epfNumber ?? ""} onChange={(e) => setEmployee({ ...employee, epfNumber: e.target.value })} /></Field>
+                <Field><FieldLabel>ETF number</FieldLabel><Input disabled={!isEditing} value={employee.etfNumber ?? ""} onChange={(e) => setEmployee({ ...employee, etfNumber: e.target.value })} /></Field>
+              </div>
+            </FieldGroup>
+          </section>
+
+          {isEditing && (
+            <div className="flex justify-end gap-2">
+              <Button variant="outline" onClick={handleCancelEdit} disabled={saving}>
+                <X className="size-4" />
+                Cancel
+              </Button>
+              <Button onClick={handleSave} disabled={saving}>{saving ? "Saving…" : "Save changes"}</Button>
+            </div>
+          )}
+        </div>
       )}
 
       {tab === "Bank Details" && (
-        <div className="flex flex-col gap-4">
+        <div className="overflow-hidden rounded-2xl bg-card shadow-sm ring-1 ring-foreground/10">
+          <div className="overflow-x-auto">
           <Table className="text-base">
             <TableHeader>
-              <TableRow>
-                <TableHead className="h-12 px-3 text-sm">Bank</TableHead>
-                <TableHead className="h-12 px-3 text-sm">Branch</TableHead>
-                <TableHead className="h-12 px-3 text-sm">Account</TableHead>
-                <TableHead className="h-12 px-3 text-sm">Primary</TableHead>
+              <TableRow className="hover:bg-transparent">
+                <TableHead className="h-11 px-4 text-sm">Bank</TableHead>
+                <TableHead className="h-11 px-4 text-sm">Branch</TableHead>
+                <TableHead className="h-11 px-4 text-sm">Account</TableHead>
+                <TableHead className="h-11 px-4 text-sm">Primary</TableHead>
               </TableRow>
             </TableHeader>
             <TableBody>
               {bankDetails.map((b, i) => (
-                <TableRow key={b.employeeBankDetailId ?? i}>
-                  <TableCell className="px-3 py-3.5">{b.bankName}</TableCell>
-                  <TableCell className="px-3 py-3.5">{b.branchName}</TableCell>
-                  <TableCell className="px-3 py-3.5">{b.accountNumber}</TableCell>
-                  <TableCell className="px-3 py-3.5">{b.isPrimary ? "Yes" : "—"}</TableCell>
+                <TableRow key={b.employeeBankDetailId ?? i} className="hover:bg-muted/20">
+                  <TableCell className="px-4 py-3.5">{b.bankName}</TableCell>
+                  <TableCell className="px-4 py-3.5">{b.branchName}</TableCell>
+                  <TableCell className="px-4 py-3.5">{b.accountNumber}</TableCell>
+                  <TableCell className="px-4 py-3.5">{b.isPrimary ? "Yes" : "—"}</TableCell>
                 </TableRow>
               ))}
               {bankDetails.length === 0 && (
-                <TableRow><TableCell colSpan={4} className="px-3 py-8 text-center text-muted-foreground">No bank details on file.</TableCell></TableRow>
+                <TableRow><TableCell colSpan={4} className="px-4 py-10 text-center text-muted-foreground">No bank details on file.</TableCell></TableRow>
               )}
             </TableBody>
           </Table>
           </div>
+        </div>
       )}
 
       {tab === "Documents" && (
         <div className="flex flex-col gap-4">
-          <div className="flex items-center gap-3">
+          <div className="flex flex-col gap-3 rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:flex-row sm:items-center">
             <Select value={uploadTypeId} onValueChange={(v) => setUploadTypeId(v ?? "")}>
-              <SelectTrigger className="w-56"><SelectValue placeholder="Document type" /></SelectTrigger>
+              <SelectTrigger className="w-full sm:w-56"><SelectValue placeholder="Document type" /></SelectTrigger>
               <SelectContent>{documentTypes.map((t) => <SelectItem key={t.hrDocumentTypeId} value={String(t.hrDocumentTypeId)}>{t.name}</SelectItem>)}</SelectContent>
             </Select>
-            <label className={cn("inline-flex cursor-pointer items-center gap-2 rounded-lg border px-4 py-2 text-sm font-medium hover:bg-muted")}>
+            <label className={cn("inline-flex w-fit cursor-pointer items-center gap-2 rounded-lg border border-black px-4 py-2 text-sm font-medium hover:bg-muted")}>
               <Upload className="size-4" />
               Upload
               <input type="file" className="hidden" accept=".pdf,.jpg,.jpeg,.png,.docx" onChange={(e) => { const f = e.target.files?.[0]; if (f) handleUpload(f); e.target.value = "" }} />
             </label>
           </div>
+          <div className="overflow-hidden rounded-2xl bg-card shadow-sm ring-1 ring-foreground/10">
+            <div className="overflow-x-auto">
             <Table className="text-base">
               <TableHeader>
-              <TableRow>
-                <TableHead className="h-12 px-3 text-sm">File</TableHead>
-                <TableHead className="h-12 px-3 text-sm">Type</TableHead>
-                <TableHead className="h-12 px-3 text-sm">Uploaded</TableHead>
-                <TableHead className="h-12 px-3 text-sm">Status</TableHead>
-                <TableHead className="h-12 px-3 text-sm">Download</TableHead>
+                <TableRow className="hover:bg-transparent">
+                  <TableHead className="h-11 px-4 text-sm">File</TableHead>
+                  <TableHead className="h-11 px-4 text-sm">Type</TableHead>
+                  <TableHead className="h-11 px-4 text-sm">Uploaded</TableHead>
+                  <TableHead className="h-11 px-4 text-sm">Status</TableHead>
+                  <TableHead className="h-11 px-4 text-sm">Download</TableHead>
                 </TableRow>
               </TableHeader>
               <TableBody>
                 {documents.map((d) => (
-                <TableRow key={d.employeeDocumentId}>
-                  <TableCell className="px-3 py-3.5">{d.originalFileName}</TableCell>
-                  <TableCell className="px-3 py-3.5">{d.hrDocumentTypeName ?? "—"}</TableCell>
-                  <TableCell className="px-3 py-3.5">{new Date(d.uploadedAt).toLocaleDateString()}</TableCell>
-                  <TableCell className="px-3 py-3.5">{d.status}</TableCell>
-                  <TableCell className="px-3 py-3.5">
+                  <TableRow key={d.employeeDocumentId} className="hover:bg-muted/20">
+                    <TableCell className="px-4 py-3.5">{d.originalFileName}</TableCell>
+                    <TableCell className="px-4 py-3.5">{d.hrDocumentTypeName ?? "—"}</TableCell>
+                    <TableCell className="px-4 py-3.5">{new Date(d.uploadedAt).toLocaleDateString()}</TableCell>
+                    <TableCell className="px-4 py-3.5">{d.status}</TableCell>
+                    <TableCell className="px-4 py-3.5">
                       <a href={employeesApi.documentDownloadUrl(employeeId, d.employeeDocumentId)} className="text-primary underline underline-offset-2" target="_blank" rel="noreferrer">Download</a>
                     </TableCell>
                   </TableRow>
                 ))}
                 {documents.length === 0 && (
-                <TableRow><TableCell colSpan={5} className="px-3 py-8 text-center text-muted-foreground">No documents uploaded yet.</TableCell></TableRow>
+                  <TableRow><TableCell colSpan={5} className="px-4 py-10 text-center text-muted-foreground">No documents uploaded yet.</TableCell></TableRow>
                 )}
               </TableBody>
             </Table>
             </div>
+          </div>
+        </div>
       )}
 
       {tab === "Salary & Loans" && (
-        <div className="flex flex-col gap-8">
-          <section className="flex flex-col gap-4">
+        <div className="flex flex-col gap-6">
+          <section className="flex flex-col gap-4 rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10">
             <div className="flex items-center justify-between">
               <h2 className="text-lg font-semibold text-foreground">Salary Structure</h2>
               <Dialog open={structureOpen} onOpenChange={(v) => { setStructureOpen(v); if (v && structureLines.length === 0) addStructureLine() }}>
@@ -405,32 +474,36 @@ export default function EmployeeDetailPage() {
                 </DialogContent>
               </Dialog>
             </div>
+            <div className="overflow-hidden rounded-xl border">
+              <div className="overflow-x-auto">
               <Table className="text-base">
                 <TableHeader>
-                <TableRow>
-                  <TableHead className="h-12 px-3 text-sm">Effective from</TableHead>
-                  <TableHead className="h-12 px-3 text-sm">Effective to</TableHead>
-                  <TableHead className="h-12 px-3 text-sm">Basic</TableHead>
-                  <TableHead className="h-12 px-3 text-sm">Status</TableHead>
+                  <TableRow className="hover:bg-transparent">
+                    <TableHead className="h-11 px-4 text-sm">Effective from</TableHead>
+                    <TableHead className="h-11 px-4 text-sm">Effective to</TableHead>
+                    <TableHead className="h-11 px-4 text-sm">Basic</TableHead>
+                    <TableHead className="h-11 px-4 text-sm">Status</TableHead>
                   </TableRow>
                 </TableHeader>
                 <TableBody>
                   {salaryStructures.map((s) => (
-                  <TableRow key={s.employeeSalaryStructureId}>
-                    <TableCell className="px-3 py-3.5">{new Date(s.effectiveFrom).toLocaleDateString()}</TableCell>
-                    <TableCell className="px-3 py-3.5">{s.effectiveTo ? new Date(s.effectiveTo).toLocaleDateString() : "Current"}</TableCell>
-                    <TableCell className="px-3 py-3.5">{money(s.basicSalary)}</TableCell>
-                    <TableCell className="px-3 py-3.5">{s.status}</TableCell>
+                    <TableRow key={s.employeeSalaryStructureId} className="hover:bg-muted/20">
+                      <TableCell className="px-4 py-3.5">{new Date(s.effectiveFrom).toLocaleDateString()}</TableCell>
+                      <TableCell className="px-4 py-3.5">{s.effectiveTo ? new Date(s.effectiveTo).toLocaleDateString() : "Current"}</TableCell>
+                      <TableCell className="px-4 py-3.5">{money(s.basicSalary)}</TableCell>
+                      <TableCell className="px-4 py-3.5">{s.status}</TableCell>
                     </TableRow>
                   ))}
                   {salaryStructures.length === 0 && (
-                  <TableRow><TableCell colSpan={4} className="px-3 py-8 text-center text-muted-foreground">No salary structure set yet.</TableCell></TableRow>
+                    <TableRow><TableCell colSpan={4} className="px-4 py-10 text-center text-muted-foreground">No salary structure set yet.</TableCell></TableRow>
                   )}
                 </TableBody>
               </Table>
+              </div>
+            </div>
           </section>
 
-          <section className="flex flex-col gap-4">
+          <section className="flex flex-col gap-4 rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10">
             <div className="flex items-center justify-between">
               <h2 className="text-lg font-semibold text-foreground">Loans &amp; Advances</h2>
               <Dialog open={loanOpen} onOpenChange={setLoanOpen}>
@@ -467,31 +540,35 @@ export default function EmployeeDetailPage() {
                 </DialogContent>
               </Dialog>
             </div>
+            <div className="overflow-hidden rounded-xl border">
+              <div className="overflow-x-auto">
               <Table className="text-base">
                 <TableHeader>
-                <TableRow>
-                  <TableHead className="h-12 px-3 text-sm">Doc No</TableHead>
-                  <TableHead className="h-12 px-3 text-sm">Type</TableHead>
-                  <TableHead className="h-12 px-3 text-sm">Principal</TableHead>
-                  <TableHead className="h-12 px-3 text-sm">Outstanding</TableHead>
-                  <TableHead className="h-12 px-3 text-sm">Status</TableHead>
+                  <TableRow className="hover:bg-transparent">
+                    <TableHead className="h-11 px-4 text-sm">Doc No</TableHead>
+                    <TableHead className="h-11 px-4 text-sm">Type</TableHead>
+                    <TableHead className="h-11 px-4 text-sm">Principal</TableHead>
+                    <TableHead className="h-11 px-4 text-sm">Outstanding</TableHead>
+                    <TableHead className="h-11 px-4 text-sm">Status</TableHead>
                   </TableRow>
                 </TableHeader>
                 <TableBody>
                   {loans.map((l) => (
-                  <TableRow key={l.employeeLoanId}>
-                    <TableCell className="px-3 py-3.5 font-medium">{l.docNo}</TableCell>
-                    <TableCell className="px-3 py-3.5">{l.loanKind}</TableCell>
-                    <TableCell className="px-3 py-3.5">{money(l.principalAmount)}</TableCell>
-                    <TableCell className="px-3 py-3.5">{money(l.outstandingBalance)}</TableCell>
-                    <TableCell className="px-3 py-3.5">{l.status}</TableCell>
+                    <TableRow key={l.employeeLoanId} className="hover:bg-muted/20">
+                      <TableCell className="px-4 py-3.5 font-medium">{l.docNo}</TableCell>
+                      <TableCell className="px-4 py-3.5">{l.loanKind}</TableCell>
+                      <TableCell className="px-4 py-3.5">{money(l.principalAmount)}</TableCell>
+                      <TableCell className="px-4 py-3.5">{money(l.outstandingBalance)}</TableCell>
+                      <TableCell className="px-4 py-3.5">{l.status}</TableCell>
                     </TableRow>
                   ))}
                   {loans.length === 0 && (
-                  <TableRow><TableCell colSpan={5} className="px-3 py-8 text-center text-muted-foreground">No loans or advances on file.</TableCell></TableRow>
+                    <TableRow><TableCell colSpan={5} className="px-4 py-10 text-center text-muted-foreground">No loans or advances on file.</TableCell></TableRow>
                   )}
                 </TableBody>
               </Table>
+              </div>
+            </div>
           </section>
         </div>
       )}

Frontend/erp-system/app/dashboard/hrm/employees/new/page.tsx

@@ -0,0 +1,353 @@
+"use client"
+
+import { useEffect, useState } from "react"
+import { useRouter } from "next/navigation"
+import Link from "next/link"
+import { Briefcase, KeyRound, Link2, Save, User } from "lucide-react"
+
+import { employeesApi } from "@/lib/api/employees"
+import { branchesHrmApi, departmentsApi, designationsApi, employmentTypesApi, workShiftsApi } from "@/lib/api/hrm-masters"
+import { rolesApi } from "@/lib/api/roles"
+import { usersApi } from "@/lib/api/users"
+import { errorMessage } from "@/lib/error-map"
+import { cn } from "@/lib/utils"
+import { Branch, CreateEmployeeRequest, Department, Designation, EmploymentType, UserMatch, WorkShift } from "@/types/hrm"
+import { Role } from "@/types/rbac"
+import { UserTypeOption } from "@/types/users"
+
+import { useAuth } from "@/components/auth/AuthProvider"
+import { Button, buttonVariants } from "@/components/ui/button"
+import { Switch } from "@/components/ui/switch"
+import { Input } from "@/components/ui/input"
+import { Field, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field"
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
+import { toast } from "@/components/ui/toast"
+
+const emptyForm: CreateEmployeeRequest = {
+  employeeCode: "",
+  fullName: "",
+  email: "",
+  hireDate: new Date().toISOString().slice(0, 10),
+  departmentId: 0,
+  designationId: 0,
+  employmentTypeId: 0,
+  branchId: 0,
+  workShiftId: 0,
+}
+
+export default function NewEmployeePage() {
+  const router = useRouter()
+  const { isAdmin, branchId: myBranchId, branchName: myBranchName, activeBranchId, activeBranchName, branchingEnabled } = useAuth()
+  const lockedBranchId = isAdmin ? activeBranchId : myBranchId
+  const lockedBranchName = isAdmin ? activeBranchName : myBranchName
+  const showBranchPicker = branchingEnabled && isAdmin && !lockedBranchId
+
+  const [departments, setDepartments] = useState<Department[]>([])
+  const [designations, setDesignations] = useState<Designation[]>([])
+  const [employmentTypes, setEmploymentTypes] = useState<EmploymentType[]>([])
+  const [workShifts, setWorkShifts] = useState<WorkShift[]>([])
+  const [branches, setBranches] = useState<Branch[]>([])
+
+  const [form, setForm] = useState<CreateEmployeeRequest>(emptyForm)
+  const [errors, setErrors] = useState<Record<string, string>>({})
+  const [submitting, setSubmitting] = useState(false)
+
+  // Advisory cross-link suggestion: does a System User already exist with this email?
+  const [userMatch, setUserMatch] = useState<UserMatch | null>(null)
+  const [checkingEmail, setCheckingEmail] = useState(false)
+
+  // Optional: create a login account for this employee in the same step.
+  const [grantLogin, setGrantLogin] = useState(false)
+  const [loginUsername, setLoginUsername] = useState("")
+  const [loginRoleId, setLoginRoleId] = useState("")
+  const [loginUserTypeId, setLoginUserTypeId] = useState("")
+  const [roles, setRoles] = useState<Role[]>([])
+  const [userTypes, setUserTypes] = useState<UserTypeOption[]>([])
+
+  // Admins have access to every branch regardless of which one their staff record names —
+  // don't make the creator pick one, just quietly default it (the Employee row still needs
+  // a home branch on file; it just never gates what an Admin login can see or do).
+  const selectedLoginRole = roles.find((r) => String(r.roleId) === loginRoleId)
+  const loginIsAdmin = grantLogin && !userMatch && selectedLoginRole?.code?.toUpperCase() === "ADMIN"
+
+  useEffect(() => {
+    if (lockedBranchId) setForm((f) => ({ ...f, branchId: lockedBranchId }))
+  }, [lockedBranchId])
+
+  useEffect(() => {
+    if (loginIsAdmin && !form.branchId) {
+      const fallbackBranchId = lockedBranchId ?? branches[0]?.branchId
+      if (fallbackBranchId) setForm((f) => ({ ...f, branchId: fallbackBranchId }))
+    }
+  }, [loginIsAdmin, lockedBranchId, branches, form.branchId])
+
+  useEffect(() => {
+    departmentsApi.list({ pageSize: 200, status: "Active" }).then((r) => setDepartments(r.items)).catch(() => setDepartments([]))
+    designationsApi.list({ pageSize: 200, status: "Active" }).then((r) => setDesignations(r.items)).catch(() => setDesignations([]))
+    employmentTypesApi.list({ pageSize: 200, status: "Active" }).then((r) => setEmploymentTypes(r.items)).catch(() => setEmploymentTypes([]))
+    workShiftsApi.list({ pageSize: 200, status: "Active" }).then((r) => setWorkShifts(r.items)).catch(() => setWorkShifts([]))
+    if (branchingEnabled) branchesHrmApi.list({ pageSize: 200, status: "Active" }).then((r) => setBranches(r.items)).catch(() => setBranches([]))
+    rolesApi.list({ pageSize: 200, status: "Active" }).then((r) => setRoles(r.items)).catch(() => setRoles([]))
+    usersApi.userTypes().then(setUserTypes).catch(() => setUserTypes([]))
+  }, [branchingEnabled])
+
+  async function checkEmail(email: string) {
+    if (!email.trim()) { setUserMatch(null); return }
+    setCheckingEmail(true)
+    try {
+      const { match } = await employeesApi.emailLookup(email.trim())
+      setUserMatch(match)
+    } catch {
+      setUserMatch(null)
+    } finally {
+      setCheckingEmail(false)
+    }
+  }
+
+  async function handleCreate() {
+    const nextErrors: Record<string, string> = {}
+    if (!form.employeeCode.trim()) nextErrors.employeeCode = "Employee code is required"
+    if (!form.fullName.trim()) nextErrors.fullName = "Full name is required"
+    if (!form.hireDate) nextErrors.hireDate = "Hire date is required"
+    if (!form.departmentId) nextErrors.departmentId = "Department is required"
+    if (!form.designationId) nextErrors.designationId = "Designation is required"
+    if (!form.employmentTypeId) nextErrors.employmentTypeId = "Employment type is required"
+    if (!form.workShiftId) nextErrors.workShiftId = "Work shift is required"
+    if (branchingEnabled && !loginIsAdmin && !form.branchId) nextErrors.branchId = "Branch is required"
+    if (grantLogin && !userMatch) {
+      if (!form.email?.trim()) nextErrors.email = "Email is required to grant login access"
+      if (!loginUsername.trim()) nextErrors.loginUsername = "Username is required"
+      if (!loginRoleId) nextErrors.loginRoleId = "Role is required"
+      if (!loginUserTypeId) nextErrors.loginUserTypeId = "User type is required"
+    }
+    setErrors(nextErrors)
+    if (Object.keys(nextErrors).length > 0) return
+
+    setSubmitting(true)
+    try {
+      const created = await employeesApi.create({
+        ...form,
+        email: form.email || null,
+        linkUserId: userMatch ? userMatch.userId : null,
+      })
+
+      // Grant login access in the same step — no separate "Add User" flow needed.
+      if (grantLogin && !userMatch) {
+        try {
+          await usersApi.create({
+            username: loginUsername.trim(),
+            fullName: form.fullName.trim(),
+            email: form.email!.trim(),
+            roleId: Number(loginRoleId),
+            userTypeId: loginUserTypeId,
+            mobileNumber: form.personalMobile || undefined,
+            nic: form.nic || undefined,
+            linkEmployeeId: created.data.employeeId,
+          })
+          toast.success("Employee created", "Login credentials have been emailed to the employee.")
+        } catch (err) {
+          toast.error("Employee created, but login account failed", errorMessage(err))
+        }
+      } else {
+        toast.success("Employee created")
+      }
+
+      router.push(`/dashboard/hrm/employees/${created.data.employeeId}`)
+    } catch (err) {
+      toast.error("Could not create employee", errorMessage(err))
+    } finally {
+      setSubmitting(false)
+    }
+  }
+
+  return (
+    <div className="flex w-full flex-col gap-6 pb-24">
+      <div>
+        <h1 className="text-2xl font-bold text-foreground">New employee</h1>
+        <p className="text-base text-muted-foreground">Add a staff record — grant login access at the end if this employee needs one.</p>
+      </div>
+
+      <section className="flex flex-col gap-5 rounded-2xl border bg-card p-6 shadow-sm">
+        <div className="flex items-center gap-3">
+          <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10 text-primary">
+            <User className="size-4.5" />
+          </div>
+          <div>
+            <h2 className="text-base font-semibold text-foreground">Personal details</h2>
+            <p className="text-sm text-muted-foreground">Basic identity and contact information.</p>
+          </div>
+        </div>
+        <FieldGroup>
+          <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">
+            <Field data-invalid={!!errors.employeeCode}>
+              <FieldLabel htmlFor="e-code">Employee code</FieldLabel>
+              <Input id="e-code" value={form.employeeCode} onChange={(e) => setForm((f) => ({ ...f, employeeCode: e.target.value }))} aria-invalid={!!errors.employeeCode} />
+              <FieldError errors={[errors.employeeCode ? { message: errors.employeeCode } : undefined]} />
+            </Field>
+            <Field data-invalid={!!errors.hireDate}>
+              <FieldLabel htmlFor="e-hire">Hire date</FieldLabel>
+              <Input id="e-hire" type="date" value={form.hireDate} onChange={(e) => setForm((f) => ({ ...f, hireDate: e.target.value }))} aria-invalid={!!errors.hireDate} />
+              <FieldError errors={[errors.hireDate ? { message: errors.hireDate } : undefined]} />
+            </Field>
+          </div>
+          <Field data-invalid={!!errors.fullName}>
+            <FieldLabel htmlFor="e-name">Full name</FieldLabel>
+            <Input id="e-name" value={form.fullName} onChange={(e) => setForm((f) => ({ ...f, fullName: e.target.value }))} aria-invalid={!!errors.fullName} />
+            <FieldError errors={[errors.fullName ? { message: errors.fullName } : undefined]} />
+          </Field>
+          <Field data-invalid={!!errors.email}>
+            <FieldLabel htmlFor="e-email">Email {grantLogin ? "" : "(optional)"}</FieldLabel>
+            <Input
+              id="e-email"
+              type="email"
+              value={form.email ?? ""}
+              onChange={(e) => setForm((f) => ({ ...f, email: e.target.value }))}
+              onBlur={(e) => checkEmail(e.target.value)}
+              aria-invalid={!!errors.email}
+            />
+            {checkingEmail && <p className="text-sm text-muted-foreground">Checking for an existing system user…</p>}
+            {userMatch && (
+              <div className="flex items-center gap-2 rounded-lg border border-primary/30 bg-primary/5 px-3 py-2 text-sm">
+                <Link2 className="size-4 shrink-0 text-primary" />
+                <span>
+                  System user <strong>{userMatch.username}</strong> ({userMatch.displayName}) matches this email — it will be linked to this employee.
+                </span>
+              </div>
+            )}
+            <FieldError errors={[errors.email ? { message: errors.email } : undefined]} />
+          </Field>
+        </FieldGroup>
+      </section>
+
+      <section className="flex flex-col gap-5 rounded-2xl border bg-card p-6 shadow-sm">
+        <div className="flex items-center gap-3">
+          <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10 text-primary">
+            <Briefcase className="size-4.5" />
+          </div>
+          <div>
+            <h2 className="text-base font-semibold text-foreground">Employment</h2>
+            <p className="text-sm text-muted-foreground">Where this employee sits in the org.</p>
+          </div>
+        </div>
+        <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">
+          <Field data-invalid={!!errors.departmentId}>
+            <FieldLabel htmlFor="e-dept">Department</FieldLabel>
+            <Select value={form.departmentId ? String(form.departmentId) : undefined} onValueChange={(v) => setForm((f) => ({ ...f, departmentId: v ? Number(v) : 0 }))}>
+              <SelectTrigger id="e-dept" className="h-10 w-full"><SelectValue placeholder="Select" /></SelectTrigger>
+              <SelectContent>{departments.map((d) => <SelectItem key={d.departmentId} value={String(d.departmentId)}>{d.name}</SelectItem>)}</SelectContent>
+            </Select>
+            <FieldError errors={[errors.departmentId ? { message: errors.departmentId } : undefined]} />
+          </Field>
+          <Field data-invalid={!!errors.designationId}>
+            <FieldLabel htmlFor="e-desig">Designation</FieldLabel>
+            <Select value={form.designationId ? String(form.designationId) : undefined} onValueChange={(v) => setForm((f) => ({ ...f, designationId: v ? Number(v) : 0 }))}>
+              <SelectTrigger id="e-desig" className="h-10 w-full"><SelectValue placeholder="Select" /></SelectTrigger>
+              <SelectContent>{designations.map((d) => <SelectItem key={d.designationId} value={String(d.designationId)}>{d.name}</SelectItem>)}</SelectContent>
+            </Select>
+            <FieldError errors={[errors.designationId ? { message: errors.designationId } : undefined]} />
+          </Field>
+          <Field data-invalid={!!errors.employmentTypeId}>
+            <FieldLabel htmlFor="e-etype">Employment type</FieldLabel>
+            <Select value={form.employmentTypeId ? String(form.employmentTypeId) : undefined} onValueChange={(v) => setForm((f) => ({ ...f, employmentTypeId: v ? Number(v) : 0 }))}>
+              <SelectTrigger id="e-etype" className="h-10 w-full"><SelectValue placeholder="Select" /></SelectTrigger>
+              <SelectContent>{employmentTypes.map((t) => <SelectItem key={t.employmentTypeId} value={String(t.employmentTypeId)}>{t.name}</SelectItem>)}</SelectContent>
+            </Select>
+            <FieldError errors={[errors.employmentTypeId ? { message: errors.employmentTypeId } : undefined]} />
+          </Field>
+          <Field data-invalid={!!errors.workShiftId}>
+            <FieldLabel htmlFor="e-shift">Work shift</FieldLabel>
+            <Select value={form.workShiftId ? String(form.workShiftId) : undefined} onValueChange={(v) => setForm((f) => ({ ...f, workShiftId: v ? Number(v) : 0 }))}>
+              <SelectTrigger id="e-shift" className="h-10 w-full"><SelectValue placeholder="Select" /></SelectTrigger>
+              <SelectContent>{workShifts.map((w) => <SelectItem key={w.workShiftId} value={String(w.workShiftId)}>{w.name}</SelectItem>)}</SelectContent>
+            </Select>
+            <FieldError errors={[errors.workShiftId ? { message: errors.workShiftId } : undefined]} />
+          </Field>
+          {branchingEnabled && loginIsAdmin && (
+            <Field className="sm:col-span-2">
+              <FieldLabel>Branch</FieldLabel>
+              <div className="flex h-9 items-center rounded-lg border border-primary/30 bg-primary/5 px-3 text-sm text-muted-foreground">
+                Not needed — the Admin role grants access to every branch.
+              </div>
+            </Field>
+          )}
+          {branchingEnabled && !loginIsAdmin && (
+            <Field data-invalid={!!errors.branchId}>
+              <FieldLabel htmlFor="e-branch">Branch</FieldLabel>
+              {showBranchPicker ? (
+                <Select value={form.branchId ? String(form.branchId) : undefined} onValueChange={(v) => setForm((f) => ({ ...f, branchId: v ? Number(v) : 0 }))}>
+                  <SelectTrigger id="e-branch" className="h-10 w-full" aria-invalid={!!errors.branchId}><SelectValue placeholder="Select" /></SelectTrigger>
+                  <SelectContent>{branches.map((b) => <SelectItem key={b.branchId} value={String(b.branchId)}>{b.name}</SelectItem>)}</SelectContent>
+                </Select>
+              ) : (
+                <div id="e-branch" className="flex h-9 items-center rounded-lg border border-input bg-muted px-3 text-sm text-muted-foreground">
+                  {lockedBranchName ?? "No branch assigned — contact an admin"}
+                </div>
+              )}
+              <FieldError errors={[errors.branchId ? { message: errors.branchId } : undefined]} />
+            </Field>
+          )}
+        </div>
+      </section>
+
+      {!userMatch && (
+        <section className="flex flex-col gap-5 rounded-2xl border bg-card p-6 shadow-sm">
+          <label className="flex cursor-pointer items-center justify-between gap-4">
+            <div className="flex items-center gap-3">
+              <div className={cn("flex size-9 shrink-0 items-center justify-center rounded-lg transition-colors", grantLogin ? "bg-primary/10 text-primary" : "bg-muted text-muted-foreground")}>
+                <KeyRound className="size-4.5" />
+              </div>
+              <div>
+                <h2 className="text-base font-semibold text-foreground">Grant login access</h2>
+                <p className="text-sm text-muted-foreground">Optional — creates a system user account for this employee automatically.</p>
+              </div>
+            </div>
+            <Switch checked={grantLogin} onCheckedChange={(v) => setGrantLogin(v === true)} aria-label="Grant login access" />
+          </label>
+          {grantLogin && (
+            <FieldGroup className="border-t pt-5">
+              <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">
+                <Field data-invalid={!!errors.loginUsername}>
+                  <FieldLabel htmlFor="e-login-username">Username</FieldLabel>
+                  <Input
+                    id="e-login-username"
+                    value={loginUsername}
+                    onChange={(e) => setLoginUsername(e.target.value)}
+                    aria-invalid={!!errors.loginUsername}
+                  />
+                  <FieldError errors={[errors.loginUsername ? { message: errors.loginUsername } : undefined]} />
+                </Field>
+                <Field data-invalid={!!errors.loginRoleId}>
+                  <FieldLabel htmlFor="e-login-role">Role</FieldLabel>
+                  <Select value={loginRoleId || undefined} onValueChange={(v) => setLoginRoleId(v ?? "")}>
+                    <SelectTrigger id="e-login-role" className="h-10 w-full" aria-invalid={!!errors.loginRoleId}><SelectValue placeholder="Select" /></SelectTrigger>
+                    <SelectContent>{roles.map((r) => <SelectItem key={r.roleId} value={String(r.roleId)}>{r.name}</SelectItem>)}</SelectContent>
+                  </Select>
+                  <FieldError errors={[errors.loginRoleId ? { message: errors.loginRoleId } : undefined]} />
+                </Field>
+                <Field data-invalid={!!errors.loginUserTypeId} className="sm:col-span-2">
+                  <FieldLabel htmlFor="e-login-usertype">User type</FieldLabel>
+                  <Select value={loginUserTypeId || undefined} onValueChange={(v) => setLoginUserTypeId(v ?? "")}>
+                    <SelectTrigger id="e-login-usertype" className="h-10 w-full" aria-invalid={!!errors.loginUserTypeId}><SelectValue placeholder="Select" /></SelectTrigger>
+                    <SelectContent>{userTypes.map((t) => <SelectItem key={t.userTypeId} value={t.userTypeId}>{t.code ?? t.description ?? t.userTypeId}</SelectItem>)}</SelectContent>
+                  </Select>
+                  <FieldError errors={[errors.loginUserTypeId ? { message: errors.loginUserTypeId } : undefined]} />
+                </Field>
+              </div>
+              <p className="text-xs text-muted-foreground">A password will be auto-generated and emailed to the employee.</p>
+            </FieldGroup>
+          )}
+        </section>
+      )}
+
+      <div className="sticky bottom-0 -mx-4 flex justify-end gap-3 border-t bg-background/95 px-4 py-4 backdrop-blur supports-backdrop-filter:bg-background/80 sm:-mx-6 sm:px-6">
+        <Link href="/dashboard/hrm/employees" className={cn(buttonVariants({ variant: "outline" }))}>
+          Cancel
+        </Link>
+        <Button onClick={handleCreate} disabled={submitting} className="min-w-40">
+          <Save className="size-4" />
+          {submitting ? "Creating…" : "Create employee"}
+        </Button>
+      </div>
+    </div>
+  )
+}

Frontend/erp-system/app/dashboard/hrm/employees/page.tsx

@@ -2,136 +2,85 @@
 
 import { useEffect, useState } from "react"
 import Link from "next/link"
-import { Link2, Pencil, Plus, Users as UsersIcon } from "lucide-react"
+import { ChevronLeft, ChevronRight, Eye, Link2, Pencil, Plus, Search, Trash2, UserCheck, UserMinus, UserX, Users as UsersIcon, X } from "lucide-react"
 
 import { employeesApi } from "@/lib/api/employees"
-import { branchesHrmApi, departmentsApi, designationsApi, employmentTypesApi, workShiftsApi } from "@/lib/api/hrm-masters"
 import { errorMessage } from "@/lib/error-map"
 import { cn } from "@/lib/utils"
 import { PaginationMeta } from "@/types/common"
-import { Branch, CreateEmployeeRequest, Department, Designation, EmployeeListItem, EmploymentType, UserMatch, WorkShift } from "@/types/hrm"
+import { EmployeeListItem } from "@/types/hrm"
 
 import { useAuth } from "@/components/auth/AuthProvider"
+import { AlertDialog, AlertDialogContent, AlertDialogTrigger } from "@/components/ui/alert-dialog"
 import { Button, buttonVariants } from "@/components/ui/button"
 import { Input } from "@/components/ui/input"
 import { Badge } from "@/components/ui/badge"
-import { Field, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field"
-import { Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle, DialogTrigger } from "@/components/ui/dialog"
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
 import { Skeleton } from "@/components/ui/skeleton"
+import { StatCard } from "@/components/ui/stat-card"
 import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"
 import { toast } from "@/components/ui/toast"
 
-const PAGE_SIZE = 10
-
-const emptyForm: CreateEmployeeRequest = {
-  employeeCode: "",
-  fullName: "",
-  email: "",
-  hireDate: new Date().toISOString().slice(0, 10),
-  departmentId: 0,
-  designationId: 0,
-  employmentTypeId: 0,
-  branchId: 0,
-  workShiftId: 0,
-}
+const PAGE_SIZE_OPTIONS = [5, 10, 25, 50]
 
 export default function EmployeesPage() {
-  const { isAdmin, branchId: myBranchId, branchName: myBranchName, activeBranchId, activeBranchName, branchingEnabled } = useAuth()
-  // The branch to pin the new hire to without asking: an Admin's currently-selected
-  // header branch, or a non-admin's own branch. Only when an Admin is on "All Branches"
-  // (no single branch implied) do they need the dropdown to pick one explicitly.
-  const lockedBranchId = isAdmin ? activeBranchId : myBranchId
-  const lockedBranchName = isAdmin ? activeBranchName : myBranchName
-  const showBranchPicker = branchingEnabled && isAdmin && !lockedBranchId
+  const { activeBranchId, branchingEnabled } = useAuth()
 
   const [employees, setEmployees] = useState<EmployeeListItem[] | null>(null)
   const [pagination, setPagination] = useState<PaginationMeta | null>(null)
   const [error, setError] = useState<string | null>(null)
   const [page, setPage] = useState(1)
-  const [q, setQ] = useState("")
+  const [pageSize, setPageSize] = useState(5)
+  const [search, setSearch] = useState("")
+  const [debouncedSearch, setDebouncedSearch] = useState("")
+  const [actionPendingId, setActionPendingId] = useState<number | null>(null)
 
-  const [departments, setDepartments] = useState<Department[]>([])
-  const [designations, setDesignations] = useState<Designation[]>([])
-  const [employmentTypes, setEmploymentTypes] = useState<EmploymentType[]>([])
-  const [workShifts, setWorkShifts] = useState<WorkShift[]>([])
-  const [branches, setBranches] = useState<Branch[]>([])
-
-  const [open, setOpen] = useState(false)
-  const [form, setForm] = useState<CreateEmployeeRequest>(emptyForm)
-  const [errors, setErrors] = useState<Record<string, string>>({})
-  const [submitting, setSubmitting] = useState(false)
-
-  // Advisory cross-link suggestion: does a System User already exist with this email?
-  const [userMatch, setUserMatch] = useState<UserMatch | null>(null)
-  const [checkingEmail, setCheckingEmail] = useState(false)
+  const [stats, setStats] = useState<{ total: number; active: number; terminated: number } | null>(null)
 
   function load() {
     employeesApi
-      .list({ page, pageSize: PAGE_SIZE, q: q || undefined, branchId: branchingEnabled ? (activeBranchId ?? undefined) : undefined })
+      .list({ page, pageSize, q: debouncedSearch || undefined, branchId: branchingEnabled ? (activeBranchId ?? undefined) : undefined })
       .then((res) => { setEmployees(res.items); setPagination(res.pagination) })
       .catch((err) => setError(errorMessage(err)))
   }
-  useEffect(load, [page, q, activeBranchId, branchingEnabled])
+  useEffect(load, [page, pageSize, debouncedSearch, activeBranchId, branchingEnabled])
   // Switching branch changes what "page 1" even means — stay on a page past the
   // new filtered result set otherwise.
   useEffect(() => setPage(1), [activeBranchId])
 
   useEffect(() => {
-    departmentsApi.list({ pageSize: 200, status: "Active" }).then((r) => setDepartments(r.items)).catch(() => setDepartments([]))
-    designationsApi.list({ pageSize: 200, status: "Active" }).then((r) => setDesignations(r.items)).catch(() => setDesignations([]))
-    employmentTypesApi.list({ pageSize: 200, status: "Active" }).then((r) => setEmploymentTypes(r.items)).catch(() => setEmploymentTypes([]))
-    workShiftsApi.list({ pageSize: 200, status: "Active" }).then((r) => setWorkShifts(r.items)).catch(() => setWorkShifts([]))
-    if (branchingEnabled) branchesHrmApi.list({ pageSize: 200, status: "Active" }).then((r) => setBranches(r.items)).catch(() => setBranches([]))
-  }, [branchingEnabled])
+    const t = setTimeout(() => {
+      setPage(1)
+      setDebouncedSearch(search.trim())
+    }, 300)
+    return () => clearTimeout(t)
+  }, [search])
 
-  async function checkEmail(email: string) {
-    if (!email.trim()) { setUserMatch(null); return }
-    setCheckingEmail(true)
+  function loadStats() {
+    const branchId = branchingEnabled ? (activeBranchId ?? undefined) : undefined
+    Promise.all([
+      employeesApi.list({ page: 1, pageSize: 1, branchId }),
+      employeesApi.list({ page: 1, pageSize: 1, status: "Active", branchId }),
+      employeesApi.list({ page: 1, pageSize: 1, status: "Terminated", branchId }),
+    ])
+      .then(([totalRes, activeRes, terminatedRes]) =>
+        setStats({ total: totalRes.pagination.totalItems, active: activeRes.pagination.totalItems, terminated: terminatedRes.pagination.totalItems })
+      )
+      .catch(() => setStats(null))
+  }
+  useEffect(loadStats, [activeBranchId, branchingEnabled])
+
+  // Permanent delete — blocked by the backend (409) if the employee has payroll history.
+  async function handleDelete(e: EmployeeListItem) {
+    setActionPendingId(e.employeeId)
     try {
-      const { match } = await employeesApi.emailLookup(email.trim())
-      setUserMatch(match)
-    } catch {
-      setUserMatch(null)
-    } finally {
-      setCheckingEmail(false)
-    }
-  }
-
-  function resetForm() {
-    setForm(emptyForm)
-    setUserMatch(null)
-    setErrors({})
-  }
-
-  async function handleCreate() {
-    const nextErrors: Record<string, string> = {}
-    if (!form.employeeCode.trim()) nextErrors.employeeCode = "Employee code is required"
-    if (!form.fullName.trim()) nextErrors.fullName = "Full name is required"
-    if (!form.hireDate) nextErrors.hireDate = "Hire date is required"
-    if (!form.departmentId) nextErrors.departmentId = "Department is required"
-    if (!form.designationId) nextErrors.designationId = "Designation is required"
-    if (!form.employmentTypeId) nextErrors.employmentTypeId = "Employment type is required"
-    if (!form.workShiftId) nextErrors.workShiftId = "Work shift is required"
-    if (branchingEnabled && !form.branchId) nextErrors.branchId = "Branch is required"
-    setErrors(nextErrors)
-    if (Object.keys(nextErrors).length > 0) return
-
-    setSubmitting(true)
-    try {
-      await employeesApi.create({
-        ...form,
-        email: form.email || null,
-        linkUserId: userMatch ? userMatch.userId : null,
-      })
-      toast.success("Employee created")
-      setOpen(false)
-      resetForm()
+      await employeesApi.remove(e.employeeId)
+      toast.success("Employee deleted", `${e.fullName} has been permanently removed.`)
       load()
+      loadStats()
     } catch (err) {
-      toast.error("Could not create employee", errorMessage(err))
+      toast.error("Could not delete employee", errorMessage(err))
     } finally {
-      setSubmitting(false)
+      setActionPendingId(null)
     }
   }
 
@@ -139,182 +88,261 @@ export default function EmployeesPage() {
     <div className="flex flex-col gap-6">
       <div className="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
         <div>
+          <div className="flex items-center gap-2.5">
             <h1 className="text-2xl font-bold text-foreground">Employees</h1>
+            {pagination && (
+              <span className="rounded-full border bg-white px-2 py-0.5 text-xs font-medium text-muted-foreground">
+                {pagination.totalItems}
+              </span>
+            )}
+          </div>
           <p className="text-base text-muted-foreground">Staff records — separate from system login accounts (see the link chip below).</p>
         </div>
-        <Dialog
-          open={open}
-          onOpenChange={(v) => {
-            setOpen(v)
-            if (!v) resetForm()
-            else if (lockedBranchId) setForm((f) => ({ ...f, branchId: lockedBranchId }))
-          }}
-        >
-          <DialogTrigger render={<Button size="lg"><Plus className="size-5" />New Employee</Button>} />
-          <DialogContent className="sm:max-w-lg">
-            <DialogHeader className="items-center text-center">
-              <DialogTitle>New Employee</DialogTitle>
-              <DialogDescription>Not every employee needs a login — a system user account is optional and separate.</DialogDescription>
-            </DialogHeader>
-            <FieldGroup>
-              <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">
-                <Field data-invalid={!!errors.employeeCode}>
-                  <FieldLabel htmlFor="e-code">Employee code</FieldLabel>
-                  <Input id="e-code" value={form.employeeCode} onChange={(e) => setForm((f) => ({ ...f, employeeCode: e.target.value }))} aria-invalid={!!errors.employeeCode} />
-                  <FieldError errors={[errors.employeeCode ? { message: errors.employeeCode } : undefined]} />
-                </Field>
-                <Field data-invalid={!!errors.hireDate}>
-                  <FieldLabel htmlFor="e-hire">Hire date</FieldLabel>
-                  <Input id="e-hire" type="date" value={form.hireDate} onChange={(e) => setForm((f) => ({ ...f, hireDate: e.target.value }))} aria-invalid={!!errors.hireDate} />
-                  <FieldError errors={[errors.hireDate ? { message: errors.hireDate } : undefined]} />
-                </Field>
+
+        <Link href="/dashboard/hrm/employees/new" className={cn(buttonVariants({ size: "lg" }))}>
+          <Plus className="size-5" />
+          New Employee
+        </Link>
       </div>
-              <Field data-invalid={!!errors.fullName}>
-                <FieldLabel htmlFor="e-name">Full name</FieldLabel>
-                <Input id="e-name" value={form.fullName} onChange={(e) => setForm((f) => ({ ...f, fullName: e.target.value }))} aria-invalid={!!errors.fullName} />
-                <FieldError errors={[errors.fullName ? { message: errors.fullName } : undefined]} />
-              </Field>
-              <Field>
-                <FieldLabel htmlFor="e-email">Email (optional)</FieldLabel>
-                <Input
-                  id="e-email"
-                  type="email"
-                  value={form.email ?? ""}
-                  onChange={(e) => setForm((f) => ({ ...f, email: e.target.value }))}
-                  onBlur={(e) => checkEmail(e.target.value)}
-                />
-                {checkingEmail && <p className="text-sm text-muted-foreground">Checking for an existing system user…</p>}
-                {userMatch && (
-                  <div className="flex items-center gap-2 rounded-lg border border-primary/30 bg-primary/5 px-3 py-2 text-sm">
-                    <Link2 className="size-4 shrink-0 text-primary" />
-                    <span>
-                      System user <strong>{userMatch.username}</strong> ({userMatch.displayName}) matches this email — it will be linked to this employee.
-                    </span>
-                  </div>
-                )}
-              </Field>
-              <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">
-                <Field data-invalid={!!errors.departmentId}>
-                  <FieldLabel htmlFor="e-dept">Department</FieldLabel>
-                  <Select value={String(form.departmentId)} onValueChange={(v) => setForm((f) => ({ ...f, departmentId: Number(v) }))}>
-                    <SelectTrigger id="e-dept"><SelectValue placeholder="Select" /></SelectTrigger>
-                    <SelectContent>{departments.map((d) => <SelectItem key={d.departmentId} value={String(d.departmentId)}>{d.name}</SelectItem>)}</SelectContent>
-                  </Select>
-                  <FieldError errors={[errors.departmentId ? { message: errors.departmentId } : undefined]} />
-                </Field>
-                <Field data-invalid={!!errors.designationId}>
-                  <FieldLabel htmlFor="e-desig">Designation</FieldLabel>
-                  <Select value={String(form.designationId)} onValueChange={(v) => setForm((f) => ({ ...f, designationId: Number(v) }))}>
-                    <SelectTrigger id="e-desig"><SelectValue placeholder="Select" /></SelectTrigger>
-                    <SelectContent>{designations.map((d) => <SelectItem key={d.designationId} value={String(d.designationId)}>{d.name}</SelectItem>)}</SelectContent>
-                  </Select>
-                  <FieldError errors={[errors.designationId ? { message: errors.designationId } : undefined]} />
-                </Field>
-                <Field data-invalid={!!errors.employmentTypeId}>
-                  <FieldLabel htmlFor="e-etype">Employment type</FieldLabel>
-                  <Select value={String(form.employmentTypeId)} onValueChange={(v) => setForm((f) => ({ ...f, employmentTypeId: Number(v) }))}>
-                    <SelectTrigger id="e-etype"><SelectValue placeholder="Select" /></SelectTrigger>
-                    <SelectContent>{employmentTypes.map((t) => <SelectItem key={t.employmentTypeId} value={String(t.employmentTypeId)}>{t.name}</SelectItem>)}</SelectContent>
-                  </Select>
-                  <FieldError errors={[errors.employmentTypeId ? { message: errors.employmentTypeId } : undefined]} />
-                </Field>
-                <Field data-invalid={!!errors.workShiftId}>
-                  <FieldLabel htmlFor="e-shift">Work shift</FieldLabel>
-                  <Select value={String(form.workShiftId)} onValueChange={(v) => setForm((f) => ({ ...f, workShiftId: Number(v) }))}>
-                    <SelectTrigger id="e-shift"><SelectValue placeholder="Select" /></SelectTrigger>
-                    <SelectContent>{workShifts.map((w) => <SelectItem key={w.workShiftId} value={String(w.workShiftId)}>{w.name}</SelectItem>)}</SelectContent>
-                  </Select>
-                  <FieldError errors={[errors.workShiftId ? { message: errors.workShiftId } : undefined]} />
-                </Field>
-                {branchingEnabled && (
-                  <Field data-invalid={!!errors.branchId}>
-                    <FieldLabel htmlFor="e-branch">Branch</FieldLabel>
-                    {showBranchPicker ? (
-                      <Select value={String(form.branchId)} onValueChange={(v) => setForm((f) => ({ ...f, branchId: v ? Number(v) : 0 }))}>
-                        <SelectTrigger id="e-branch" aria-invalid={!!errors.branchId}><SelectValue placeholder="Select" /></SelectTrigger>
-                        <SelectContent>{branches.map((b) => <SelectItem key={b.branchId} value={String(b.branchId)}>{b.name}</SelectItem>)}</SelectContent>
-                      </Select>
+
+      <div className="grid grid-cols-2 gap-4 sm:grid-cols-4">
+        {stats ? (
+          <>
+            <StatCard label="Total employees" value={stats.total} icon={UsersIcon} />
+            <StatCard label="Active" value={stats.active} icon={UserCheck} />
+            <StatCard label="Inactive" value={stats.total - stats.active} icon={UserX} />
+            <StatCard label="Terminated" value={stats.terminated} icon={UserMinus} />
+          </>
         ) : (
-                      <div id="e-branch" className="flex h-9 items-center rounded-lg border border-input bg-muted px-3 text-sm text-muted-foreground">
-                        {lockedBranchName ?? "No branch assigned — contact an admin"}
-                      </div>
-                    )}
-                    <FieldError errors={[errors.branchId ? { message: errors.branchId } : undefined]} />
-                  </Field>
+          Array.from({ length: 4 }).map((_, i) => <Skeleton key={i} className="h-20 w-full rounded-xl" />)
         )}
       </div>
-            </FieldGroup>
-            <div className="flex flex-col-reverse gap-3 pt-2 sm:flex-row sm:justify-center">
-              <Button variant="outline" className="w-full sm:w-auto sm:min-w-32" onClick={() => setOpen(false)} disabled={submitting}>Cancel</Button>
-              <Button className="w-full sm:w-auto sm:min-w-32" onClick={handleCreate} disabled={submitting}>{submitting ? "Creating…" : "Create"}</Button>
-            </div>
-          </DialogContent>
-        </Dialog>
+
+      <div className="relative w-full sm:max-w-xs">
+        <Search className="pointer-events-none absolute left-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" />
+        <Input
+          value={search}
+          onChange={(e) => setSearch(e.target.value)}
+          placeholder="Search by name or employee code…"
+          className="h-10 pl-9 pr-9"
+          aria-label="Search employees"
+        />
+        {search && (
+          <button
+            type="button"
+            onClick={() => setSearch("")}
+            aria-label="Clear search"
+            className="absolute right-2.5 top-1/2 -translate-y-1/2 text-muted-foreground hover:text-foreground"
+          >
+            <X className="size-4" />
+          </button>
+        )}
       </div>
 
-      <Input placeholder="Search by name or employee code…" value={q} onChange={(e) => { setPage(1); setQ(e.target.value) }} className="max-w-sm" />
-
-      {error && <div className="rounded-lg border border-destructive/30 bg-destructive/5 p-5 text-base text-destructive">{error}</div>}
+      {error && (
+        <div className="rounded-lg border border-destructive/30 bg-destructive/5 p-5 text-base text-destructive">{error}</div>
+      )}
 
       {!error && employees === null && (
-        <div className="flex flex-col gap-3">{Array.from({ length: 4 }).map((_, i) => <Skeleton key={i} className="h-14 w-full" />)}</div>
+        <div className="overflow-hidden rounded-xl border">
+          <div className="flex h-11 items-center gap-4 border-b bg-muted/20 px-4">
+            <Skeleton className="h-3.5 w-16" />
+            <Skeleton className="ml-auto h-3.5 w-16" />
+          </div>
+          {Array.from({ length: 5 }).map((_, i) => (
+            <div key={i} className="flex items-center gap-3 border-b px-4 py-4 last:border-b-0">
+              <Skeleton className="size-9 shrink-0 rounded-lg" />
+              <div className="flex flex-1 flex-col gap-2">
+                <Skeleton className="h-4 w-40" />
+                <Skeleton className="h-3 w-24" />
+              </div>
+              <Skeleton className="h-5 w-16 rounded-full" />
+              <Skeleton className="ml-4 h-7 w-16" />
+            </div>
+          ))}
+        </div>
       )}
 
-      {!error && employees !== null && employees.length === 0 && (
+      {!error && employees !== null && employees.length === 0 && debouncedSearch && (
+        <div className="flex flex-col items-center gap-3 rounded-xl border border-dashed py-16 text-center">
+          <Search className="size-10 text-muted-foreground" />
+          <div>
+            <p className="text-base font-medium text-foreground">No employees match &quot;{debouncedSearch}&quot;</p>
+            <p className="text-sm text-muted-foreground">Try a different name or code.</p>
+          </div>
+          <Button variant="outline" size="sm" onClick={() => setSearch("")}>
+            Clear search
+          </Button>
+        </div>
+      )}
+
+      {!error && employees !== null && employees.length === 0 && !debouncedSearch && (
         <div className="flex flex-col items-center gap-4 rounded-xl border border-dashed py-20 text-center">
           <UsersIcon className="size-12 text-muted-foreground" />
-          <p className="text-base text-muted-foreground">No employees yet.</p>
+          <div>
+            <p className="text-base font-medium text-foreground">No employees yet</p>
+            <p className="text-sm text-muted-foreground">Add your first employee record to get started.</p>
+          </div>
+          <Link href="/dashboard/hrm/employees/new" className={cn(buttonVariants())}>
+            <Plus className="size-4" />
+            New Employee
+          </Link>
         </div>
       )}
 
       {!error && employees !== null && employees.length > 0 && (
+        <div className="overflow-hidden rounded-xl border">
+          <div className="overflow-x-auto">
             <Table className="text-base">
               <TableHeader>
-            <TableRow>
-              <TableHead className="h-12 px-3 text-sm">Code</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Name</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Department</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Designation</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Login</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Status</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Actions</TableHead>
+                <TableRow className="hover:bg-transparent">
+                  <TableHead className="h-11 w-48 px-3 text-sm">Employee</TableHead>
+                  <TableHead className="h-11 w-32 px-3 text-sm">Code</TableHead>
+                  <TableHead className="h-11 w-40 px-3 text-sm">Department</TableHead>
+                  <TableHead className="h-11 w-40 px-3 text-sm">Designation</TableHead>
+                  <TableHead className="h-11 w-32 px-3 text-sm">Hire Date</TableHead>
+                  <TableHead className="h-11 w-32 px-3 text-sm">Login</TableHead>
+                  <TableHead className="h-11 w-28 px-3 text-sm">Status</TableHead>
+                  <TableHead className="h-11 w-24 px-3 text-center text-sm">Actions</TableHead>
                 </TableRow>
               </TableHeader>
               <TableBody>
                 {employees.map((e) => (
-              <TableRow key={e.employeeId}>
-                <TableCell className="px-3 py-3.5 font-medium">{e.employeeCode}</TableCell>
-                <TableCell className="px-3 py-3.5">{e.fullName}</TableCell>
-                <TableCell className="px-3 py-3.5">{e.departmentName ?? "—"}</TableCell>
-                <TableCell className="px-3 py-3.5">{e.designationName ?? "—"}</TableCell>
-                <TableCell className="px-3 py-3.5">
+                  <TableRow key={e.employeeId} className="group align-top hover:bg-muted/20">
+                    <TableCell className="px-3 py-4">
+                      <Link
+                        href={`/dashboard/hrm/employees/${e.employeeId}`}
+                        className="rounded-md -m-1 inline-block p-1 font-semibold leading-tight text-foreground outline-none hover:underline focus-visible:ring-2 focus-visible:ring-ring/50"
+                      >
+                        {e.fullName}
+                      </Link>
+                    </TableCell>
+
+                    <TableCell className="px-3 py-4">
+                      <span className="font-mono text-xs text-muted-foreground">{e.employeeCode}</span>
+                    </TableCell>
+
+                    <TableCell className="px-3 py-4 text-sm text-muted-foreground">{e.departmentName ?? "—"}</TableCell>
+
+                    <TableCell className="px-3 py-4 text-sm text-muted-foreground">{e.designationName ?? "—"}</TableCell>
+
+                    <TableCell className="px-3 py-4 text-sm text-muted-foreground">
+                      {new Date(e.hireDate).toLocaleDateString(undefined, {
+                        year: "numeric",
+                        month: "short",
+                        day: "numeric",
+                      })}
+                    </TableCell>
+
+                    <TableCell className="px-3 py-4">
                       {e.hasUserLink ? (
-                    <Badge variant="outline" className="h-6 w-fit justify-center gap-1 border-transparent bg-primary/10 px-2.5 text-sm text-primary"><Link2 className="size-3.5" />Linked</Badge>
+                        <Badge variant="outline" className="h-5 w-fit justify-center gap-1 border-transparent bg-primary/10 px-2 text-xs text-primary"><Link2 className="size-3.5" />Linked</Badge>
                       ) : (
-                    <span className="text-sm text-muted-foreground">No login</span>
+                        <span className="text-xs text-muted-foreground">No login</span>
                       )}
                     </TableCell>
-                <TableCell className="px-3 py-3.5">
-                  <Badge variant="outline" className={cn("h-6 w-fit justify-center border-transparent px-2.5 text-sm", e.status === "Active" ? "bg-success/10 text-success" : "bg-muted text-muted-foreground")}>{e.status}</Badge>
+
+                    <TableCell className="px-3 py-4">
+                      <Badge
+                        variant="outline"
+                        className={cn(
+                          "h-5 w-fit justify-center bg-white px-2 text-xs",
+                          e.status === "Active" ? "border-success/40 text-success" : "border-input text-muted-foreground"
+                        )}
+                      >
+                        {e.status}
+                      </Badge>
                     </TableCell>
-                <TableCell className="px-3 py-3.5">
-                  <Link href={`/dashboard/hrm/employees/${e.employeeId}`} className={cn(buttonVariants({ variant: "ghost", size: "icon-sm" }))} aria-label={`Edit ${e.fullName}`}>
+
+                    <TableCell className="px-3 py-4">
+                      <div className="flex items-center justify-center gap-1">
+                        <Link href={`/dashboard/hrm/employees/${e.employeeId}`} className={cn(buttonVariants({ variant: "ghost", size: "icon-sm" }))} aria-label={`View ${e.fullName}`} title={`View ${e.fullName}`}>
+                          <Eye className="size-4" />
+                        </Link>
+                        <Link href={`/dashboard/hrm/employees/${e.employeeId}?edit=1`} className={cn(buttonVariants({ variant: "ghost", size: "icon-sm" }))} aria-label={`Edit ${e.fullName}`} title={`Edit ${e.fullName}`}>
                           <Pencil className="size-4" />
                         </Link>
+                        <AlertDialog>
+                          <AlertDialogTrigger
+                            render={
+                              <Button
+                                variant="ghost"
+                                size="icon-sm"
+                                className="text-destructive hover:bg-destructive/10 disabled:pointer-events-auto disabled:cursor-not-allowed"
+                                aria-label={`Delete ${e.fullName}`}
+                                title={`Delete ${e.fullName}`}
+                                disabled={actionPendingId === e.employeeId}
+                              />
+                            }
+                          >
+                            <Trash2 className="size-4" />
+                          </AlertDialogTrigger>
+                          <AlertDialogContent
+                            variant="destructive"
+                            title={`Delete ${e.fullName}?`}
+                            description="This permanently removes the employee and all their HR records (bank details, documents, salary history, loans). This cannot be undone. Blocked if the employee has payroll history."
+                            confirmLabel="Delete"
+                            onConfirm={() => handleDelete(e)}
+                          />
+                        </AlertDialog>
+                      </div>
                     </TableCell>
                   </TableRow>
                 ))}
               </TableBody>
             </Table>
+          </div>
+        </div>
       )}
 
-      {pagination && pagination.totalPages > 1 && (
-        <div className="flex items-center justify-between">
-          <p className="text-sm text-muted-foreground">Showing {(pagination.page - 1) * pagination.pageSize + 1}–{Math.min(pagination.page * pagination.pageSize, pagination.totalItems)} of {pagination.totalItems}</p>
+      {pagination && pagination.totalItems > 0 && (
+        <div className="flex flex-col-reverse items-center gap-3 sm:flex-row sm:justify-between">
+          <div className="flex items-center gap-3">
+            <p className="text-sm text-muted-foreground">
+              Showing <span className="font-medium text-foreground">{(pagination.page - 1) * pagination.pageSize + 1}</span>–
+              <span className="font-medium text-foreground">
+                {Math.min(pagination.page * pagination.pageSize, pagination.totalItems)}
+              </span>{" "}
+              of <span className="font-medium text-foreground">{pagination.totalItems}</span> employees
+            </p>
+            <label className="flex items-center gap-1.5 text-sm text-muted-foreground">
+              Rows per page
+              <select
+                value={pageSize}
+                onChange={(e) => { setPage(1); setPageSize(Number(e.target.value)) }}
+                className="h-8 rounded-md border border-black bg-white px-2 text-sm text-foreground outline-none focus-visible:ring-2 focus-visible:ring-ring/50"
+                aria-label="Rows per page"
+              >
+                {PAGE_SIZE_OPTIONS.map((size) => (
+                  <option key={size} value={size}>{size}</option>
+                ))}
+              </select>
+            </label>
+          </div>
           <div className="flex items-center gap-2">
-            <Button type="button" variant="outline" size="sm" disabled={pagination.page <= 1} onClick={() => setPage((p) => Math.max(1, p - 1))}>Previous</Button>
-            <span className="text-sm text-muted-foreground">Page {pagination.page} of {pagination.totalPages}</span>
-            <Button type="button" variant="outline" size="sm" disabled={pagination.page >= pagination.totalPages} onClick={() => setPage((p) => Math.min(pagination.totalPages, p + 1))}>Next</Button>
+            <Button
+              type="button"
+              variant="outline"
+              size="sm"
+              disabled={pagination.page <= 1}
+              onClick={() => setPage((p) => Math.max(1, p - 1))}
+            >
+              <ChevronLeft className="size-4" />
+              Previous
+            </Button>
+            <span className="min-w-20 text-center text-sm text-muted-foreground">
+              Page {pagination.page} of {pagination.totalPages}
+            </span>
+            <Button
+              type="button"
+              variant="outline"
+              size="sm"
+              disabled={pagination.page >= pagination.totalPages}
+              onClick={() => setPage((p) => Math.min(pagination.totalPages, p + 1))}
+            >
+              Next
+              <ChevronRight className="size-4" />
+            </Button>
           </div>
         </div>
       )}

Frontend/erp-system/app/dashboard/hrm/settings/branches/[id]/page.tsx

@@ -0,0 +1,7 @@
+"use client"
+
+import { BranchDetailPage } from "@/components/settings/BranchDetailPage"
+
+export default function BranchDetail() {
+  return <BranchDetailPage />
+}

Frontend/erp-system/app/dashboard/receiving/grn/[id]/page.tsx

@@ -297,18 +297,18 @@ export default function GrnDetailPage() {
       </Table>
       </div>
 
-      <div className="flex flex-wrap justify-end gap-8 border-t border-border pt-4 text-base">
-        <div className="flex gap-3">
-          <span className="text-muted-foreground">Stock value (excl. VAT)</span>
-          <span className="tabular-nums">{grn.lines.reduce((s, l) => s + l.receivedValue, 0).toFixed(2)}</span>
+      <div className="grid grid-cols-1 gap-4 sm:grid-cols-3">
+        <div className="flex flex-col gap-1 rounded-xl border border-border bg-white p-5 shadow-sm">
+          <span className="text-sm text-muted-foreground">Stock value (excl. VAT)</span>
+          <span className="text-xl font-semibold tabular-nums">{grn.lines.reduce((s, l) => s + l.receivedValue, 0).toFixed(2)}</span>
         </div>
-        <div className="flex gap-3">
-          <span className="text-muted-foreground">VAT</span>
-          <span className="tabular-nums">{grn.lines.reduce((s, l) => s + l.vatAmount, 0).toFixed(2)}</span>
+        <div className="flex flex-col gap-1 rounded-xl border border-border bg-white p-5 shadow-sm">
+          <span className="text-sm text-muted-foreground">VAT</span>
+          <span className="text-xl font-semibold tabular-nums">{grn.lines.reduce((s, l) => s + l.vatAmount, 0).toFixed(2)}</span>
         </div>
-        <div className="flex gap-3">
-          <span className="text-muted-foreground">Document total</span>
-          <span className="font-semibold tabular-nums">{grn.lines.reduce((s, l) => s + l.lineTotal, 0).toFixed(2)}</span>
+        <div className="flex flex-col gap-1 rounded-xl border border-border bg-white p-5 shadow-sm">
+          <span className="text-sm text-muted-foreground">Document total</span>
+          <span className="text-xl font-semibold tabular-nums">{grn.lines.reduce((s, l) => s + l.lineTotal, 0).toFixed(2)}</span>
         </div>
       </div>
 

Frontend/erp-system/app/dashboard/settings/branches/[id]/page.tsx

@@ -0,0 +1,7 @@
+"use client"
+
+import { BranchDetailPage } from "@/components/settings/BranchDetailPage"
+
+export default function BranchDetail() {
+  return <BranchDetailPage />
+}

Frontend/erp-system/app/dashboard/settings/configuration/page.tsx

@@ -3,10 +3,10 @@ import { Building2, LayoutTemplate, MapPin, SlidersHorizontal } from "lucide-rea
 
 const cards = [
   {
-    title: "Product Configuration",
-    href: "/dashboard/products/settings",
-    icon: SlidersHorizontal,
-    description: "Configure product and master-data options",
+    title: "Company Profile",
+    href: "/dashboard/settings/company-profile",
+    icon: Building2,
+    description: "Invoice header, tax, and bank details",
   },
   {
     title: "Branch Configuration",
@@ -14,18 +14,18 @@ const cards = [
     icon: MapPin,
     description: "Turn multi-branch mode on or off for this deployment",
   },
+  {
+    title: "Product Configuration",
+    href: "/dashboard/products/settings",
+    icon: SlidersHorizontal,
+    description: "Configure product and master-data options",
+  },
   {
     title: "Invoice Template",
     href: "/dashboard/settings/invoice-template",
     icon: LayoutTemplate,
     description: "Logo, footer, terms, and template style for printed invoices",
   },
-  {
-    title: "Company Profile",
-    href: "/dashboard/settings/company-profile",
-    icon: Building2,
-    description: "Invoice header, tax, and bank details",
-  },
 ]
 
 export default function ConfigurationPage() {
@@ -38,7 +38,7 @@ export default function ConfigurationPage() {
         </p>
       </div>
 
-      <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3">
+      <div className="grid grid-cols-1 gap-4 sm:grid-cols-2">
         {cards.map((card) => (
           <Link
             key={card.href}

Frontend/erp-system/app/dashboard/settings/roles/[id]/page.tsx

@@ -3,7 +3,7 @@
 import { useEffect, useState } from "react"
 import { useParams, useRouter } from "next/navigation"
 import Link from "next/link"
-import { AlertTriangle, Save } from "lucide-react"
+import { AlertTriangle, Power, Save } from "lucide-react"
 
 import { navApi } from "@/lib/api/nav"
 import { rolesApi } from "@/lib/api/roles"
@@ -40,6 +40,7 @@ export default function RoleDetailPage() {
   const [saveError, setSaveError] = useState<string | null>(null)
   const [saving, setSaving] = useState(false)
   const [savingPermissions, setSavingPermissions] = useState(false)
+  const [togglingStatus, setTogglingStatus] = useState(false)
 
   function load() {
     setLoadError(null)
@@ -93,6 +94,21 @@ export default function RoleDetailPage() {
     }
   }
 
+  async function handleToggleStatus() {
+    if (!role) return
+    const nextStatus = role.status === "Active" ? "Inactive" : "Active"
+    setTogglingStatus(true)
+    try {
+      await rolesApi.updateStatus(roleId, nextStatus)
+      setRole((prev) => (prev ? { ...prev, status: nextStatus } : prev))
+      toast.success(nextStatus === "Active" ? "Role activated" : "Role deactivated", `${role.code} is now ${nextStatus.toLowerCase()}.`)
+    } catch (err) {
+      toast.error("Could not update status", errorMessage(err))
+    } finally {
+      setTogglingStatus(false)
+    }
+  }
+
   async function handleSavePermissions() {
     setSavingPermissions(true)
     try {
@@ -148,6 +164,17 @@ export default function RoleDetailPage() {
             <p className="text-base text-muted-foreground">{role.name}</p>
           </div>
         </div>
+
+        <Button
+          variant="outline"
+          className={role.status === "Active" ? "text-destructive hover:bg-destructive/10" : "text-success hover:bg-success/10"}
+          onClick={handleToggleStatus}
+          disabled={togglingStatus || role.isSystemRole}
+          title={role.isSystemRole ? "System roles can't be deactivated" : undefined}
+        >
+          <Power className="size-4" />
+          {togglingStatus ? "Updating…" : role.status === "Active" ? "Deactivate" : "Activate"}
+        </Button>
       </div>
 
       {conflict && (
@@ -166,7 +193,7 @@ export default function RoleDetailPage() {
         <div className="rounded-lg border border-destructive/30 bg-destructive/5 p-5 text-base text-destructive">{saveError}</div>
       )}
 
-      <section className="flex flex-col gap-4">
+      <section className="flex flex-col gap-4 rounded-xl border p-5">
         <h2 className="text-lg font-semibold text-foreground">Details</h2>
         <div className="grid grid-cols-1 gap-4 sm:grid-cols-2">
           <div className="flex flex-col gap-2">
@@ -187,7 +214,7 @@ export default function RoleDetailPage() {
         </div>
       </section>
 
-      <section className="flex flex-col gap-4">
+      <section className="flex flex-col gap-4 rounded-xl border p-5">
         <div>
           <h2 className="text-lg font-semibold text-foreground">Sidebar permissions</h2>
           <p className="text-sm text-muted-foreground">Choose which sections a user with this role can see.</p>

Frontend/erp-system/app/dashboard/settings/roles/new/page.tsx

@@ -0,0 +1,145 @@
+"use client"
+
+import { useEffect, useState } from "react"
+import { useRouter } from "next/navigation"
+import Link from "next/link"
+import { Save } from "lucide-react"
+
+import { navApi } from "@/lib/api/nav"
+import { rolesApi } from "@/lib/api/roles"
+import { errorMessage, fieldErrors } from "@/lib/error-map"
+import { cn } from "@/lib/utils"
+import { NavItem } from "@/types/rbac"
+
+import { RolePermissionTree } from "@/components/auth/RolePermissionTree"
+import { Button, buttonVariants } from "@/components/ui/button"
+import { Input } from "@/components/ui/input"
+import { Label } from "@/components/ui/label"
+import { FieldError } from "@/components/ui/field"
+import { Skeleton } from "@/components/ui/skeleton"
+import { toast } from "@/components/ui/toast"
+
+/** Code is derived from Name, never typed directly (e.g. "Store Manager" -> "STORE_MANAGER"). */
+function deriveCode(name: string): string {
+  return name
+    .trim()
+    .toUpperCase()
+    .replace(/[^A-Z0-9]+/g, "_")
+    .replace(/^_+|_+$/g, "")
+}
+
+export default function NewRolePage() {
+  const router = useRouter()
+
+  const [tree, setTree] = useState<NavItem[] | null>(null)
+  const [name, setName] = useState("")
+  const [navItemIds, setNavItemIds] = useState<Set<number>>(new Set())
+  const [subNavItemIds, setSubNavItemIds] = useState<Set<number>>(new Set())
+  const [errors, setErrors] = useState<Record<string, string>>({})
+  const [submitting, setSubmitting] = useState(false)
+
+  useEffect(() => {
+    navApi.tree().then(setTree).catch(() => setTree([]))
+  }, [])
+
+  const code = deriveCode(name)
+
+  async function handleCreate() {
+    const nextErrors: Record<string, string> = {}
+    if (!name.trim()) nextErrors.name = "Role name is required"
+    else if (!code) nextErrors.name = "Role name must contain at least one letter or number"
+    setErrors(nextErrors)
+    if (Object.keys(nextErrors).length > 0) return
+
+    setSubmitting(true)
+    try {
+      const result = await rolesApi.create({ code, name: name.trim() })
+      if (navItemIds.size > 0 || subNavItemIds.size > 0) {
+        await rolesApi.assignPermissions(result.data.roleId, {
+          navItemIds: Array.from(navItemIds),
+          subNavItemIds: Array.from(subNavItemIds),
+        })
+      }
+      toast.success("Role created", `${result.data.code} — ${result.data.name}`)
+      router.push(`/dashboard/settings/roles/${result.data.roleId}`)
+    } catch (err) {
+      const fe = fieldErrors(err)
+      if (fe?.code) setErrors((prev) => ({ ...prev, code: fe.code }))
+      toast.error("Could not create role", errorMessage(err))
+    } finally {
+      setSubmitting(false)
+    }
+  }
+
+  return (
+    <div className="flex flex-col gap-8">
+      <div>
+        <h1 className="text-2xl font-bold text-foreground">New role</h1>
+        <p className="text-base text-muted-foreground">Created in both the auth service and here.</p>
+      </div>
+
+      <section className="flex flex-col gap-4 rounded-xl border p-5">
+        <h2 className="text-lg font-semibold text-foreground">Details</h2>
+        <div className="grid grid-cols-1 gap-4 sm:grid-cols-2">
+          <div className="flex flex-col gap-2">
+            <Label className="text-base" htmlFor="r-name">
+              Name
+            </Label>
+            <Input
+              id="r-name"
+              value={name}
+              onChange={(e) => setName(e.target.value)}
+              placeholder="Manager"
+              aria-invalid={!!errors.name}
+              className="h-12 text-base"
+            />
+            <FieldError errors={[errors.name ? { message: errors.name } : undefined]} />
+          </div>
+          <div className="flex flex-col gap-2">
+            <Label className="text-base" htmlFor="r-code">
+              Code (auto-generated)
+            </Label>
+            <Input
+              id="r-code"
+              value={code}
+              disabled
+              readOnly
+              placeholder="—"
+              className="h-12 text-base text-muted-foreground"
+            />
+          </div>
+        </div>
+      </section>
+
+      <section className="flex flex-col gap-4 rounded-xl border p-5">
+        <div>
+          <h2 className="text-lg font-semibold text-foreground">Sidebar permissions</h2>
+          <p className="text-sm text-muted-foreground">Choose which sections a user with this role can see.</p>
+        </div>
+        {tree === null ? (
+          <Skeleton className="h-48 w-full" />
+        ) : (
+          <RolePermissionTree
+            tree={tree}
+            selectedNavItemIds={navItemIds}
+            selectedSubNavItemIds={subNavItemIds}
+            onChange={(nav, sub) => {
+              setNavItemIds(nav)
+              setSubNavItemIds(sub)
+            }}
+          />
+        )}
+      </section>
+
+      <div className="flex justify-end gap-3">
+        <Link href="/dashboard/settings/roles" className={cn(buttonVariants({ variant: "outline" }))}>
+          Cancel
+        </Link>
+        <Button onClick={handleCreate} disabled={submitting}>
+          <Save className="size-4" />
+          {submitting ? "Creating…" : "Create role"}
+        </Button>
+      </div>
+    </div>
+  )
+}

Frontend/erp-system/app/dashboard/settings/roles/page.tsx

@@ -2,63 +2,36 @@
 
 import { useEffect, useState } from "react"
 import Link from "next/link"
-import { Pencil, Plus, ShieldCheck, Trash2 } from "lucide-react"
+import { ChevronLeft, ChevronRight, Eye, Pencil, Plus, Search, ShieldCheck, Trash2, X } from "lucide-react"
 
-import { navApi } from "@/lib/api/nav"
 import { rolesApi } from "@/lib/api/roles"
 import { errorMessage } from "@/lib/error-map"
 import { cn } from "@/lib/utils"
 import { PaginationMeta } from "@/types/common"
-import { NavItem, Role } from "@/types/rbac"
+import { Role } from "@/types/rbac"
 
-import { RolePermissionTree } from "@/components/auth/RolePermissionTree"
 import { AlertDialog, AlertDialogContent, AlertDialogTrigger } from "@/components/ui/alert-dialog"
 import { Button, buttonVariants } from "@/components/ui/button"
 import { Input } from "@/components/ui/input"
 import { Badge } from "@/components/ui/badge"
-import { Field, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field"
-import {
-  Dialog,
-  DialogContent,
-  DialogDescription,
-  DialogHeader,
-  DialogTitle,
-  DialogTrigger,
-} from "@/components/ui/dialog"
 import { Skeleton } from "@/components/ui/skeleton"
 import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"
 import { toast } from "@/components/ui/toast"
 
 const PAGE_SIZE = 10
 
-/** Code is derived from Name, never typed directly (e.g. "Store Manager" -> "STORE_MANAGER"). */
-function deriveCode(name: string): string {
-  return name
-    .trim()
-    .toUpperCase()
-    .replace(/[^A-Z0-9]+/g, "_")
-    .replace(/^_+|_+$/g, "")
-}
-
 export default function RolesPage() {
   const [roles, setRoles] = useState<Role[] | null>(null)
   const [pagination, setPagination] = useState<PaginationMeta | null>(null)
   const [error, setError] = useState<string | null>(null)
   const [page, setPage] = useState(1)
-
-  const [tree, setTree] = useState<NavItem[] | null>(null)
-
-  const [open, setOpen] = useState(false)
-  const [name, setName] = useState("")
-  const [navItemIds, setNavItemIds] = useState<Set<number>>(new Set())
-  const [subNavItemIds, setSubNavItemIds] = useState<Set<number>>(new Set())
-  const [errors, setErrors] = useState<Record<string, string>>({})
-  const [submitting, setSubmitting] = useState(false)
+  const [search, setSearch] = useState("")
+  const [debouncedSearch, setDebouncedSearch] = useState("")
   const [actionPendingId, setActionPendingId] = useState<number | null>(null)
 
   function load() {
     rolesApi
-      .list({ page, pageSize: PAGE_SIZE })
+      .list({ page, pageSize: PAGE_SIZE, q: debouncedSearch || undefined })
       .then((res) => {
         setRoles(res.items)
         setPagination(res.pagination)
@@ -66,47 +39,15 @@ export default function RolesPage() {
       .catch((err) => setError(errorMessage(err)))
   }
 
-  useEffect(load, [page])
+  useEffect(load, [page, debouncedSearch])
 
   useEffect(() => {
-    navApi.tree().then(setTree).catch(() => setTree([]))
-  }, [])
-
-  function resetForm() {
-    setName("")
-    setNavItemIds(new Set())
-    setSubNavItemIds(new Set())
-    setErrors({})
-  }
-
-  const code = deriveCode(name)
-
-  async function handleCreate() {
-    const nextErrors: Record<string, string> = {}
-    if (!name.trim()) nextErrors.name = "Role name is required"
-    else if (!code) nextErrors.name = "Role name must contain at least one letter or number"
-    setErrors(nextErrors)
-    if (Object.keys(nextErrors).length > 0) return
-
-    setSubmitting(true)
-    try {
-      const result = await rolesApi.create({ code, name: name.trim() })
-      if (navItemIds.size > 0 || subNavItemIds.size > 0) {
-        await rolesApi.assignPermissions(result.data.roleId, {
-          navItemIds: Array.from(navItemIds),
-          subNavItemIds: Array.from(subNavItemIds),
-        })
-      }
-      toast.success("Role created", `${result.data.code} — ${result.data.name}`)
-      setOpen(false)
-      resetForm()
-      load()
-    } catch (err) {
-      toast.error("Could not create role", errorMessage(err))
-    } finally {
-      setSubmitting(false)
-    }
-  }
+    const t = setTimeout(() => {
+      setPage(1)
+      setDebouncedSearch(search.trim())
+    }, 300)
+    return () => clearTimeout(t)
+  }, [search])
 
   async function handleDelete(role: Role) {
     setActionPendingId(role.roleId)
@@ -125,122 +66,167 @@ export default function RolesPage() {
     <div className="flex flex-col gap-6">
       <div className="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
         <div>
+          <div className="flex items-center gap-2.5">
             <h1 className="text-2xl font-bold text-foreground">Roles</h1>
+            {pagination && (
+              <span className="rounded-full border bg-white px-2 py-0.5 text-xs font-medium text-muted-foreground">
+                {pagination.totalItems}
+              </span>
+            )}
+          </div>
           <p className="text-base text-muted-foreground">
             Manage roles and which sidebar sections each one can see.
           </p>
         </div>
 
-        <Dialog
-          open={open}
-          onOpenChange={(v) => {
-            setOpen(v)
-            if (!v) resetForm()
-          }}
-        >
-          <DialogTrigger
-            render={
-              <Button size="lg">
+        <Link href="/dashboard/settings/roles/new" className={cn(buttonVariants({ size: "lg" }))}>
           <Plus className="size-5" />
           New Role
-              </Button>
-            }
-          />
-          <DialogContent className="sm:max-w-lg">
-            <DialogHeader className="items-center text-center">
-              <DialogTitle>New role</DialogTitle>
-              <DialogDescription>Created in both the auth service and here.</DialogDescription>
-            </DialogHeader>
-            <FieldGroup>
-              <Field data-invalid={!!errors.name}>
-                <FieldLabel htmlFor="r-name">Name</FieldLabel>
-                <Input id="r-name" value={name} onChange={(e) => setName(e.target.value)} placeholder="Manager" aria-invalid={!!errors.name} />
-                <FieldError errors={[errors.name ? { message: errors.name } : undefined]} />
-              </Field>
-              <Field>
-                <FieldLabel htmlFor="r-code">Code (auto-generated)</FieldLabel>
-                <Input id="r-code" value={code} disabled readOnly placeholder="—" className="text-muted-foreground" />
-              </Field>
-            </FieldGroup>
-
-            <div className="flex flex-col gap-2">
-              <FieldLabel>Sidebar permissions</FieldLabel>
-              {tree === null ? (
-                <Skeleton className="h-32 w-full" />
-              ) : (
-                <div className="max-h-80 overflow-auto">
-                  <RolePermissionTree
-                    tree={tree}
-                    selectedNavItemIds={navItemIds}
-                    selectedSubNavItemIds={subNavItemIds}
-                    onChange={(nav, sub) => {
-                      setNavItemIds(nav)
-                      setSubNavItemIds(sub)
-                    }}
-                  />
+        </Link>
       </div>
+
+      <div className="relative w-full sm:max-w-xs">
+        <Search className="pointer-events-none absolute left-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" />
+        <Input
+          value={search}
+          onChange={(e) => setSearch(e.target.value)}
+          placeholder="Search roles by name or code…"
+          className="h-10 pl-9 pr-9"
+          aria-label="Search roles"
+        />
+        {search && (
+          <button
+            type="button"
+            onClick={() => setSearch("")}
+            aria-label="Clear search"
+            className="absolute right-2.5 top-1/2 -translate-y-1/2 text-muted-foreground hover:text-foreground"
+          >
+            <X className="size-4" />
+          </button>
         )}
       </div>
 
-            <div className="flex flex-col-reverse gap-3 pt-2 sm:flex-row sm:justify-center">
-              <Button variant="outline" className="w-full sm:w-auto sm:min-w-36" onClick={() => setOpen(false)} disabled={submitting}>
-                Cancel
-              </Button>
-              <Button className="w-full sm:w-auto sm:min-w-36" onClick={handleCreate} disabled={submitting}>
-                {submitting ? "Creating…" : "Create"}
-              </Button>
-            </div>
-          </DialogContent>
-        </Dialog>
-      </div>
-
       {error && (
         <div className="rounded-lg border border-destructive/30 bg-destructive/5 p-5 text-base text-destructive">{error}</div>
       )}
 
       {!error && roles === null && (
-        <div className="flex flex-col gap-3">
-          {Array.from({ length: 4 }).map((_, i) => (
-            <Skeleton key={i} className="h-14 w-full" />
+        <div className="overflow-hidden rounded-xl border">
+          <div className="flex h-11 items-center gap-4 border-b bg-muted/20 px-4">
+            <Skeleton className="h-3.5 w-16" />
+            <Skeleton className="ml-auto h-3.5 w-16" />
+          </div>
+          {Array.from({ length: 5 }).map((_, i) => (
+            <div key={i} className="flex items-center gap-3 border-b px-4 py-4 last:border-b-0">
+              <Skeleton className="size-9 shrink-0 rounded-lg" />
+              <div className="flex flex-1 flex-col gap-2">
+                <Skeleton className="h-4 w-40" />
+                <Skeleton className="h-3 w-24" />
+              </div>
+              <Skeleton className="h-5 w-16 rounded-full" />
+              <Skeleton className="ml-4 h-7 w-16" />
+            </div>
           ))}
         </div>
       )}
 
-      {!error && roles !== null && roles.length === 0 && (
+      {!error && roles !== null && roles.length === 0 && debouncedSearch && (
+        <div className="flex flex-col items-center gap-3 rounded-xl border border-dashed py-16 text-center">
+          <Search className="size-10 text-muted-foreground" />
+          <div>
+            <p className="text-base font-medium text-foreground">No roles match &quot;{debouncedSearch}&quot;</p>
+            <p className="text-sm text-muted-foreground">Try a different name or code.</p>
+          </div>
+          <Button variant="outline" size="sm" onClick={() => setSearch("")}>
+            Clear search
+          </Button>
+        </div>
+      )}
+
+      {!error && roles !== null && roles.length === 0 && !debouncedSearch && (
         <div className="flex flex-col items-center gap-4 rounded-xl border border-dashed py-20 text-center">
           <ShieldCheck className="size-12 text-muted-foreground" />
-          <p className="text-base text-muted-foreground">No roles yet.</p>
+          <div>
+            <p className="text-base font-medium text-foreground">No roles yet</p>
+            <p className="text-sm text-muted-foreground">Create your first role to start assigning permissions.</p>
+          </div>
+          <Link href="/dashboard/settings/roles/new" className={cn(buttonVariants())}>
+            <Plus className="size-4" />
+            New Role
+          </Link>
         </div>
       )}
 
       {!error && roles !== null && roles.length > 0 && (
+        <div className="overflow-hidden rounded-xl border">
+          <div className="overflow-x-auto">
             <Table className="text-base">
               <TableHeader>
-            <TableRow>
-              <TableHead className="h-12 px-3 text-sm">Code</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Name</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Status</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Actions</TableHead>
+                <TableRow className="hover:bg-transparent">
+                  <TableHead className="h-11 w-56 px-3 text-sm">Role</TableHead>
+                  <TableHead className="h-11 w-40 px-3 text-sm">Code</TableHead>
+                  <TableHead className="h-11 w-28 px-3 text-sm">Status</TableHead>
+                  <TableHead className="h-11 w-32 px-3 text-sm">Created Date</TableHead>
+                  <TableHead className="h-11 w-24 px-3 text-center text-sm">Actions</TableHead>
                 </TableRow>
               </TableHeader>
               <TableBody>
                 {roles.map((r) => (
-              <TableRow key={r.roleId}>
-                <TableCell className="px-3 py-3.5 font-medium">{r.code}</TableCell>
-                <TableCell className="px-3 py-3.5">{r.name}</TableCell>
-                <TableCell className="px-3 py-3.5">
+                  <TableRow key={r.roleId} className="group align-top hover:bg-muted/20">
+                    <TableCell className="px-3 py-4">
+                      <Link
+                        href={`/dashboard/settings/roles/${r.roleId}`}
+                        className="flex items-start gap-3 rounded-md -m-1 p-1 outline-none focus-visible:ring-2 focus-visible:ring-ring/50"
+                      >
+                        <div className="flex size-9 shrink-0 items-center justify-center rounded-lg border bg-white text-foreground">
+                          <ShieldCheck className="size-4.5" />
+                        </div>
+                        <div className="flex flex-col gap-1 pt-0.5">
+                          <span className="font-semibold leading-tight text-foreground group-hover:underline">{r.name}</span>
+                          {r.isSystemRole && (
+                            <Badge variant="outline" className="h-5 w-fit justify-center border-input bg-white px-2 text-xs text-muted-foreground">
+                              System
+                            </Badge>
+                          )}
+                        </div>
+                      </Link>
+                    </TableCell>
+
+                    <TableCell className="px-3 py-4">
+                      <span className="font-mono text-xs text-muted-foreground">{r.code}</span>
+                    </TableCell>
+
+                    <TableCell className="px-3 py-4">
                       <Badge
                         variant="outline"
                         className={cn(
-                      "h-6 w-fit justify-center border-transparent px-2.5 text-sm",
-                      r.status === "Active" ? "bg-success/10 text-success" : "bg-muted text-muted-foreground"
+                          "h-5 w-fit justify-center bg-white px-2 text-xs",
+                          r.status === "Active" ? "border-success/40 text-success" : "border-input text-muted-foreground"
                         )}
                       >
                         {r.status}
                       </Badge>
                     </TableCell>
-                <TableCell className="px-3 py-3.5">
-                  <div className="flex items-center gap-1">
+
+                    <TableCell className="px-3 py-4 text-sm text-muted-foreground">
+                      {new Date(r.createdAt).toLocaleDateString(undefined, {
+                        year: "numeric",
+                        month: "short",
+                        day: "numeric",
+                      })}
+                    </TableCell>
+
+                    <TableCell className="px-3 py-4">
+                      <div className="flex items-center justify-center gap-1">
+                        <Link
+                          href={`/dashboard/settings/roles/${r.roleId}`}
+                          className={cn(buttonVariants({ variant: "ghost", size: "icon-sm" }))}
+                          aria-label={`View ${r.code}`}
+                          title={`View ${r.code}`}
+                        >
+                          <Eye className="size-4" />
+                        </Link>
+
                         <Link
                           href={`/dashboard/settings/roles/${r.roleId}`}
                           className={cn(buttonVariants({ variant: "ghost", size: "icon-sm" }))}
@@ -255,8 +241,9 @@ export default function RolesPage() {
                               <Button
                                 variant="ghost"
                                 size="icon-sm"
-                            className="text-destructive hover:bg-destructive/10"
+                                className="text-destructive hover:bg-destructive/10 disabled:pointer-events-auto disabled:cursor-not-allowed"
                                 aria-label={`Delete ${r.code}`}
+                                title={r.isSystemRole ? "System roles can't be deleted" : `Delete ${r.code}`}
                                 disabled={r.isSystemRole || actionPendingId === r.roleId}
                               />
                             }
@@ -277,19 +264,31 @@ export default function RolesPage() {
                 ))}
               </TableBody>
             </Table>
+          </div>
+        </div>
       )}
 
       {pagination && pagination.totalPages > 1 && (
-        <div className="flex items-center justify-between">
+        <div className="flex flex-col-reverse items-center gap-3 sm:flex-row sm:justify-between">
           <p className="text-sm text-muted-foreground">
-            Showing {(pagination.page - 1) * pagination.pageSize + 1}–
-            {Math.min(pagination.page * pagination.pageSize, pagination.totalItems)} of {pagination.totalItems}
+            Showing <span className="font-medium text-foreground">{(pagination.page - 1) * pagination.pageSize + 1}</span>–
+            <span className="font-medium text-foreground">
+              {Math.min(pagination.page * pagination.pageSize, pagination.totalItems)}
+            </span>{" "}
+            of <span className="font-medium text-foreground">{pagination.totalItems}</span> roles
           </p>
           <div className="flex items-center gap-2">
-            <Button type="button" variant="outline" size="sm" disabled={pagination.page <= 1} onClick={() => setPage((p) => Math.max(1, p - 1))}>
+            <Button
+              type="button"
+              variant="outline"
+              size="sm"
+              disabled={pagination.page <= 1}
+              onClick={() => setPage((p) => Math.max(1, p - 1))}
+            >
+              <ChevronLeft className="size-4" />
               Previous
             </Button>
-            <span className="text-sm text-muted-foreground">
+            <span className="min-w-20 text-center text-sm text-muted-foreground">
               Page {pagination.page} of {pagination.totalPages}
             </span>
             <Button
@@ -300,6 +299,7 @@ export default function RolesPage() {
               onClick={() => setPage((p) => Math.min(pagination.totalPages, p + 1))}
             >
               Next
+              <ChevronRight className="size-4" />
             </Button>
           </div>
         </div>

Frontend/erp-system/app/dashboard/settings/users/[id]/page.tsx

@@ -1,64 +1,58 @@
 "use client"
 
 import { useEffect, useState } from "react"
-import { useParams, useRouter } from "next/navigation"
+import { useParams } from "next/navigation"
 import Link from "next/link"
-import { Save } from "lucide-react"
+import { Clock, IdCard, Laptop, ShieldCheck } from "lucide-react"
 
-import { rolesApi } from "@/lib/api/roles"
+import { auditLogsApi } from "@/lib/api/audit-logs"
 import { usersApi } from "@/lib/api/users"
 import { errorMessage } from "@/lib/error-map"
 import { cn } from "@/lib/utils"
-import { Role } from "@/types/rbac"
+import { AuditLog, LoginActivity } from "@/types/audit"
 import { ManagedUser } from "@/types/users"
 
 import { Badge } from "@/components/ui/badge"
-import { Button, buttonVariants } from "@/components/ui/button"
-import { Label } from "@/components/ui/label"
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
+import { buttonVariants } from "@/components/ui/button"
 import { Skeleton } from "@/components/ui/skeleton"
-import { toast } from "@/components/ui/toast"
+
+const ACTIVITY_PAGE_SIZE = 8
+const DEVICES_PAGE_SIZE = 8
 
 export default function UserDetailPage() {
   const params = useParams<{ id: string }>()
-  const router = useRouter()
   const userId = Number(params.id)
 
   const [user, setUser] = useState<ManagedUser | null>(null)
-  const [roles, setRoles] = useState<Role[]>([])
   const [loadError, setLoadError] = useState<string | null>(null)
-  const [roleId, setRoleId] = useState<string>("")
-  const [saving, setSaving] = useState(false)
 
-  function load() {
-    setLoadError(null)
-    Promise.all([usersApi.get(userId), rolesApi.list({ pageSize: 200, status: "Active" })])
-      .then(([u, roleList]) => {
-        setUser(u)
-        setRoles(roleList.items)
-        setRoleId(u.roleId ? String(u.roleId) : "")
-      })
-      .catch((err) => setLoadError(errorMessage(err)))
-  }
+  const [activity, setActivity] = useState<AuditLog[] | null>(null)
+  const [activityError, setActivityError] = useState<string | null>(null)
+
+  const [devices, setDevices] = useState<LoginActivity[] | null>(null)
+  const [devicesError, setDevicesError] = useState<string | null>(null)
 
   useEffect(() => {
-    if (Number.isFinite(userId)) load()
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    if (!Number.isFinite(userId)) return
+    setLoadError(null)
+    usersApi.get(userId).then(setUser).catch((err) => setLoadError(errorMessage(err)))
   }, [userId])
 
-  async function handleSave() {
-    if (!roleId) return
-    setSaving(true)
-    try {
-      const result = await usersApi.updateRole(userId, { roleId: Number(roleId) })
-      setUser(result)
-      toast.success("Role updated", `${result.username} is now assigned to ${result.roleName}.`)
-    } catch (err) {
-      toast.error("Could not update role", errorMessage(err))
-    } finally {
-      setSaving(false)
-    }
-  }
+  useEffect(() => {
+    if (!Number.isFinite(userId)) return
+    auditLogsApi
+      .list({ userId, page: 1, pageSize: ACTIVITY_PAGE_SIZE })
+      .then((res) => setActivity(res.items))
+      .catch((err) => setActivityError(errorMessage(err)))
+  }, [userId])
+
+  useEffect(() => {
+    if (!Number.isFinite(userId)) return
+    usersApi
+      .loginDevices(userId, { page: 1, pageSize: DEVICES_PAGE_SIZE })
+      .then((res) => setDevices(res.items))
+      .catch((err) => setDevicesError(errorMessage(err)))
+  }, [userId])
 
   if (loadError && !user) {
     return (
@@ -100,31 +94,145 @@ export default function UserDetailPage() {
         </div>
       </div>
 
-      <div className="flex flex-col gap-2 sm:max-w-sm">
-        <Label className="text-base">Role</Label>
-        <Select value={roleId || undefined} onValueChange={(v) => setRoleId(v ?? "")}>
-          <SelectTrigger>
-            <SelectValue placeholder="Select a role" />
-          </SelectTrigger>
-          <SelectContent>
-            {roles.map((r) => (
-              <SelectItem key={r.roleId} value={String(r.roleId)}>
-                {r.name}
-              </SelectItem>
-            ))}
-          </SelectContent>
-        </Select>
+      <section className="rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:p-6">
+        <div className="flex items-center gap-2.5 border-b border-border pb-4">
+          <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10">
+            <IdCard className="size-4.5 text-primary" />
           </div>
+          <div>
+            <h2 className="text-base font-semibold text-foreground">User details</h2>
+            <p className="text-sm text-muted-foreground">Account identity as recorded in this app.</p>
+          </div>
+        </div>
+        <div className="mt-5 grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
+          <div className="flex flex-col gap-1">
+            <span className="text-sm text-muted-foreground">Username</span>
+            <span className="font-mono text-sm text-foreground">{user.username}</span>
+          </div>
+          <div className="flex flex-col gap-1">
+            <span className="text-sm text-muted-foreground">Display name</span>
+            <span className="text-sm text-foreground">{user.displayName}</span>
+          </div>
+          <div className="flex flex-col gap-1">
+            <span className="text-sm text-muted-foreground">Email</span>
+            <span className="text-sm text-foreground">{user.email ?? "—"}</span>
+          </div>
+          <div className="flex flex-col gap-1">
+            <span className="text-sm text-muted-foreground">User ID</span>
+            <span className="font-mono text-sm text-foreground">{user.userId}</span>
+          </div>
+        </div>
+      </section>
 
-      <div className="flex justify-end gap-3">
-        <Button variant="outline" size="lg" onClick={() => router.push("/dashboard/settings/users")}>
-          Cancel
-        </Button>
-        <Button size="lg" onClick={handleSave} disabled={saving || !roleId}>
-          <Save className="size-5" />
-          {saving ? "Saving…" : "Save role"}
-        </Button>
+      <section className="rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:p-6">
+        <div className="flex items-center gap-2.5 border-b border-border pb-4">
+          <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10">
+            <ShieldCheck className="size-4.5 text-primary" />
           </div>
+          <div>
+            <h2 className="text-base font-semibold text-foreground">Role &amp; access</h2>
+            <p className="text-sm text-muted-foreground">Controls what this user can see and do.</p>
+          </div>
+        </div>
+        <div className="mt-5 flex flex-col gap-1 sm:max-w-sm">
+          <span className="text-sm text-muted-foreground">Role</span>
+          <span className="text-sm text-foreground">{user.roleName ?? "—"}</span>
+          {user.roleCode && <p className="text-xs text-muted-foreground">Role code: {user.roleCode}</p>}
+        </div>
+      </section>
+
+      <section className="rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:p-6">
+        <div className="flex items-center gap-2.5 border-b border-border pb-4">
+          <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10">
+            <Clock className="size-4.5 text-primary" />
+          </div>
+          <div>
+            <h2 className="text-base font-semibold text-foreground">Recent activity</h2>
+            <p className="text-sm text-muted-foreground">The last changes this user made, from the audit trail.</p>
+          </div>
+        </div>
+        <div className="mt-5">
+          {activityError && (
+            <p className="text-sm text-destructive">{activityError}</p>
+          )}
+          {!activityError && activity === null && (
+            <div className="flex flex-col gap-2">
+              {Array.from({ length: 3 }).map((_, i) => <Skeleton key={i} className="h-10 w-full" />)}
+            </div>
+          )}
+          {!activityError && activity !== null && activity.length === 0 && (
+            <p className="text-sm text-muted-foreground">No recorded activity yet.</p>
+          )}
+          {!activityError && activity !== null && activity.length > 0 && (
+            <ul className="flex flex-col divide-y divide-border">
+              {activity.map((a) => (
+                <li key={a.auditId} className="flex items-center justify-between gap-3 py-3">
+                  <div className="flex items-center gap-2 text-sm">
+                    <Badge
+                      variant="outline"
+                      className={cn(
+                        "h-5 w-fit justify-center border-transparent px-2 text-xs",
+                        a.action === "Create" && "bg-success/10 text-success",
+                        a.action === "Update" && "bg-primary/10 text-primary",
+                        a.action === "Delete" && "bg-destructive/10 text-destructive",
+                        a.action === "Login" && "bg-muted text-muted-foreground"
+                      )}
+                    >
+                      {a.action}
+                    </Badge>
+                    {a.action === "Login" ? (
+                      <span className="text-foreground">Signed in</span>
+                    ) : (
+                      <>
+                        <span className="text-foreground">{a.entityType}</span>
+                        <span className="text-muted-foreground">#{a.entityId}</span>
+                      </>
+                    )}
+                  </div>
+                  <span className="text-xs text-muted-foreground">{new Date(a.createdAt).toLocaleString()}</span>
+                </li>
+              ))}
+            </ul>
+          )}
+        </div>
+      </section>
+
+      <section className="rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:p-6">
+        <div className="flex items-center gap-2.5 border-b border-border pb-4">
+          <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10">
+            <Laptop className="size-4.5 text-primary" />
+          </div>
+          <div>
+            <h2 className="text-base font-semibold text-foreground">Login devices</h2>
+            <p className="text-sm text-muted-foreground">Devices and locations this account has signed in from.</p>
+          </div>
+        </div>
+        <div className="mt-5">
+          {devicesError && <p className="text-sm text-destructive">{devicesError}</p>}
+          {!devicesError && devices === null && (
+            <div className="flex flex-col gap-2">
+              {Array.from({ length: 3 }).map((_, i) => <Skeleton key={i} className="h-10 w-full" />)}
+            </div>
+          )}
+          {!devicesError && devices !== null && devices.length === 0 && (
+            <p className="text-sm text-muted-foreground">No logins recorded yet.</p>
+          )}
+          {!devicesError && devices !== null && devices.length > 0 && (
+            <ul className="flex flex-col divide-y divide-border">
+              {devices.map((d) => (
+                <li key={d.loginActivityId} className="flex items-center justify-between gap-3 py-3">
+                  <div className="flex items-center gap-2 text-sm">
+                    <Laptop className="size-4 shrink-0 text-muted-foreground" />
+                    <span className="text-foreground">{d.deviceLabel ?? "Unknown device"}</span>
+                    {d.ipAddress && <span className="font-mono text-xs text-muted-foreground">{d.ipAddress}</span>}
+                  </div>
+                  <span className="text-xs text-muted-foreground">{new Date(d.loginAt).toLocaleString()}</span>
+                </li>
+              ))}
+            </ul>
+          )}
+        </div>
+      </section>
     </div>
   )
 }

Frontend/erp-system/app/dashboard/settings/users/page.tsx

@@ -2,104 +2,38 @@
 
 import { useEffect, useState } from "react"
 import Link from "next/link"
-import { Link2, Pencil, Plus, Users as UsersIcon } from "lucide-react"
+import { ChevronLeft, ChevronRight, Eye, Pencil, Search, ShieldCheck, UserCheck, UserX, Users as UsersIcon, X } from "lucide-react"
 
-import { rolesApi } from "@/lib/api/roles"
 import { usersApi } from "@/lib/api/users"
-import { employeeCrossLinkApi } from "@/lib/api/employees"
-import { branchesHrmApi, departmentsApi, designationsApi, employmentTypesApi, workShiftsApi } from "@/lib/api/hrm-masters"
-import { errorMessage, fieldErrors } from "@/lib/error-map"
+import { errorMessage } from "@/lib/error-map"
 import { cn } from "@/lib/utils"
 import { PaginationMeta } from "@/types/common"
-import { Role } from "@/types/rbac"
-import { Branch, Department, Designation, EmployeeMatch, EmploymentType, WorkShift } from "@/types/hrm"
-import { ManagedUser, UserTypeOption } from "@/types/users"
+import { ManagedUser } from "@/types/users"
 
-import { useAuth } from "@/components/auth/AuthProvider"
 import { Button, buttonVariants } from "@/components/ui/button"
 import { Input } from "@/components/ui/input"
 import { Badge } from "@/components/ui/badge"
-import { Field, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field"
-import {
-  Dialog,
-  DialogContent,
-  DialogDescription,
-  DialogHeader,
-  DialogTitle,
-  DialogTrigger,
-} from "@/components/ui/dialog"
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
 import { Skeleton } from "@/components/ui/skeleton"
+import { StatCard } from "@/components/ui/stat-card"
 import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"
 import { toast } from "@/components/ui/toast"
 
-const PAGE_SIZE = 10
+const PAGE_SIZE_OPTIONS = [5, 10, 20, 25]
 
 export default function UsersPage() {
-  const { isAdmin, branchId: myBranchId, branchName: myBranchName, activeBranchId, activeBranchName, branchingEnabled } = useAuth()
-  // Same "don't ask if it's already implied" heuristic as the Employees form: an Admin's
-  // currently-selected header branch, or a non-admin's own branch.
-  const lockedBranchId = isAdmin ? activeBranchId : myBranchId
-  const lockedBranchName = isAdmin ? activeBranchName : myBranchName
-  const showBranchPicker = branchingEnabled && isAdmin && !lockedBranchId
-
   const [users, setUsers] = useState<ManagedUser[] | null>(null)
   const [pagination, setPagination] = useState<PaginationMeta | null>(null)
-  const [roles, setRoles] = useState<Role[]>([])
-  const [userTypes, setUserTypes] = useState<UserTypeOption[]>([])
   const [error, setError] = useState<string | null>(null)
   const [page, setPage] = useState(1)
-
-  const [open, setOpen] = useState(false)
-  const [username, setUsername] = useState("")
-  const [fullName, setFullName] = useState("")
-  const [email, setEmail] = useState("")
-  const [mobileNumber, setMobileNumber] = useState("")
-  const [nic, setNic] = useState("")
-  const [roleId, setRoleId] = useState<string>("")
-  const [userTypeId, setUserTypeId] = useState("")
-  const [errors, setErrors] = useState<Record<string, string>>({})
-  const [submitting, setSubmitting] = useState(false)
-
-  // Non-admin roles must be scoped to one branch (see UserManagementService.CreateAsync) —
-  // these fields build the Employee record that carries it.
-  const selectedRole = roles.find((r) => String(r.roleId) === roleId)
-  const requiresBranchScope = !!roleId && selectedRole?.code?.toUpperCase() !== "ADMIN"
-
-  const [employeeCode, setEmployeeCode] = useState("")
-  const [hireDate, setHireDate] = useState(() => new Date().toISOString().slice(0, 10))
-  const [departmentId, setDepartmentId] = useState(0)
-  const [designationId, setDesignationId] = useState(0)
-  const [employmentTypeId, setEmploymentTypeId] = useState(0)
-  const [workShiftId, setWorkShiftId] = useState(0)
-  const [branchId, setBranchId] = useState(0)
-
-  const [departments, setDepartments] = useState<Department[]>([])
-  const [designations, setDesignations] = useState<Designation[]>([])
-  const [employmentTypes, setEmploymentTypes] = useState<EmploymentType[]>([])
-  const [workShifts, setWorkShifts] = useState<WorkShift[]>([])
-  const [branches, setBranches] = useState<Branch[]>([])
-
-  // Advisory cross-link suggestion: does a Staff record already exist with this email?
-  const [staffMatch, setStaffMatch] = useState<EmployeeMatch | null>(null)
-  const [checkingEmail, setCheckingEmail] = useState(false)
-
-  async function checkEmail(value: string) {
-    if (!value.trim()) { setStaffMatch(null); return }
-    setCheckingEmail(true)
-    try {
-      const { match } = await employeeCrossLinkApi.findStaffByEmail(value.trim())
-      setStaffMatch(match)
-    } catch {
-      setStaffMatch(null)
-    } finally {
-      setCheckingEmail(false)
-    }
-  }
+  const [pageSize, setPageSize] = useState(5)
+  const [search, setSearch] = useState("")
+  const [debouncedSearch, setDebouncedSearch] = useState("")
+  const [actionPendingId, setActionPendingId] = useState<number | null>(null)
+  const [stats, setStats] = useState<{ total: number; active: number; admins: number } | null>(null)
 
   function load() {
     usersApi
-      .list({ page, pageSize: PAGE_SIZE })
+      .list({ page, pageSize, q: debouncedSearch || undefined })
       .then((res) => {
         setUsers(res.items)
         setPagination(res.pagination)
@@ -107,113 +41,44 @@ export default function UsersPage() {
       .catch((err) => setError(errorMessage(err)))
   }
 
-  useEffect(load, [page])
+  useEffect(load, [page, pageSize, debouncedSearch])
 
-  useEffect(() => {
-    rolesApi.list({ pageSize: 200, status: "Active" }).then((res) => setRoles(res.items)).catch(() => setRoles([]))
-  }, [])
-
-  useEffect(() => {
-    usersApi
-      .userTypes()
-      .then((types) => {
-        setUserTypes(types)
-        // Only one user type exists today (AuthHex's "Admin"/"dev" seed) — default to it
-        // so the admin never has to pick a raw GUID; the select still lets them switch
-        // if more types are added later.
-        if (types.length > 0) setUserTypeId((current) => current || types[0].userTypeId)
-      })
-      .catch(() => setUserTypes([]))
-  }, [])
-
-  useEffect(() => {
-    departmentsApi.list({ pageSize: 200, status: "Active" }).then((r) => setDepartments(r.items)).catch(() => setDepartments([]))
-    designationsApi.list({ pageSize: 200, status: "Active" }).then((r) => setDesignations(r.items)).catch(() => setDesignations([]))
-    employmentTypesApi.list({ pageSize: 200, status: "Active" }).then((r) => setEmploymentTypes(r.items)).catch(() => setEmploymentTypes([]))
-    workShiftsApi.list({ pageSize: 200, status: "Active" }).then((r) => setWorkShifts(r.items)).catch(() => setWorkShifts([]))
-    if (branchingEnabled) branchesHrmApi.list({ pageSize: 200, status: "Active" }).then((r) => setBranches(r.items)).catch(() => setBranches([]))
-  }, [branchingEnabled])
-
-  // Once a non-admin role is picked, default the branch to whatever's already implied
-  // (an Admin's selected header branch, or a non-admin creator's own branch) instead of
-  // making them pick it again.
-  useEffect(() => {
-    if (requiresBranchScope && lockedBranchId && !branchId) setBranchId(lockedBranchId)
-  }, [requiresBranchScope, lockedBranchId, branchId])
-
-  function resetForm() {
-    setUsername("")
-    setFullName("")
-    setEmail("")
-    setMobileNumber("")
-    setNic("")
-    setRoleId("")
-    setUserTypeId("")
-    setEmployeeCode("")
-    setHireDate(new Date().toISOString().slice(0, 10))
-    setDepartmentId(0)
-    setDesignationId(0)
-    setEmploymentTypeId(0)
-    setWorkShiftId(0)
-    setBranchId(0)
-    setErrors({})
-    setStaffMatch(null)
+  function loadStats() {
+    Promise.all([
+      usersApi.list({ page: 1, pageSize: 1 }),
+      usersApi.list({ page: 1, pageSize: 1, status: "Active" }),
+      usersApi.list({ page: 1, pageSize: 1, roleCode: "Admin" }),
+    ])
+      .then(([totalRes, activeRes, adminsRes]) =>
+        setStats({ total: totalRes.pagination.totalItems, active: activeRes.pagination.totalItems, admins: adminsRes.pagination.totalItems })
+      )
+      .catch(() => setStats(null))
   }
+  useEffect(loadStats, [])
 
-  async function handleCreate() {
-    const nextErrors: Record<string, string> = {}
-    if (!username.trim()) nextErrors.username = "Username is required"
-    if (!fullName.trim()) nextErrors.fullName = "Full name is required"
-    if (!email.trim()) nextErrors.email = "Email is required"
-    if (!roleId) nextErrors.roleId = "Role is required"
-    if (!userTypeId.trim()) nextErrors.userTypeId = "User type is required"
-    // A matched existing Staff record already carries a branch — only ask for a fresh
-    // one to be created when there's no such link.
-    if (requiresBranchScope && !staffMatch) {
-      if (!employeeCode.trim()) nextErrors.employeeCode = "Employee code is required"
-      if (!hireDate) nextErrors.hireDate = "Hire date is required"
-      if (!departmentId) nextErrors.departmentId = "Department is required"
-      if (!designationId) nextErrors.designationId = "Designation is required"
-      if (!employmentTypeId) nextErrors.employmentTypeId = "Employment type is required"
-      if (!workShiftId) nextErrors.workShiftId = "Work shift is required"
-      if (branchingEnabled && !branchId) nextErrors.branchId = "Branch is required"
-    }
-    setErrors(nextErrors)
-    if (Object.keys(nextErrors).length > 0) return
+  useEffect(() => {
+    const t = setTimeout(() => {
+      setPage(1)
+      setDebouncedSearch(search.trim())
+    }, 300)
+    return () => clearTimeout(t)
+  }, [search])
 
-    setSubmitting(true)
+  // Toggles the account's standing inside ERPCore (BranchAccessService and the rest of the
+  // app gate on this) — the auth-service credential is untouched either way, and the row is
+  // never removed from the table, just flagged so the user can't log in while Inactive.
+  async function handleToggleStatus(u: ManagedUser) {
+    const nextStatus = u.status === "Active" ? "Inactive" : "Active"
+    setActionPendingId(u.userId)
     try {
-      const result = await usersApi.create({
-        username: username.trim(),
-        fullName: fullName.trim(),
-        email: email.trim(),
-        mobileNumber: mobileNumber || null,
-        nic: nic || null,
-        roleId: Number(roleId),
-        userTypeId: userTypeId.trim(),
-        linkEmployeeId: staffMatch ? staffMatch.employeeId : null,
-        ...(requiresBranchScope && !staffMatch
-          ? {
-              employeeCode: employeeCode.trim(),
-              hireDate,
-              departmentId,
-              designationId,
-              employmentTypeId,
-              workShiftId,
-              branchId: branchId || null,
-            }
-          : {}),
-      })
-      toast.success("User created", `Credentials have been emailed to ${result.username}.`)
-      setOpen(false)
-      resetForm()
+      await usersApi.updateStatus(u.userId, { status: nextStatus })
+      toast.success(nextStatus === "Active" ? "User activated" : "User deactivated", `${u.username} is now ${nextStatus}.`)
       load()
+      loadStats()
     } catch (err) {
-      const fe = fieldErrors(err)
-      if (fe) setErrors(fe)
-      toast.error("Could not create user", errorMessage(err))
+      toast.error("Could not update user status", errorMessage(err))
     } finally {
-      setSubmitting(false)
+      setActionPendingId(null)
     }
   }
 
@@ -221,176 +86,50 @@ export default function UsersPage() {
     <div className="flex flex-col gap-6">
       <div className="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
         <div>
+          <div className="flex items-center gap-2.5">
             <h1 className="text-2xl font-bold text-foreground">Users</h1>
-          <p className="text-base text-muted-foreground">
-            Create accounts and assign roles. New users receive their credentials by email.
-          </p>
+            {pagination && (
+              <span className="rounded-full border bg-white px-2 py-0.5 text-xs font-medium text-muted-foreground">
+                {pagination.totalItems}
+              </span>
+            )}
+          </div>
+          <p className="text-base text-muted-foreground">Manage user accounts and their roles.</p>
+        </div>
       </div>
 
-        <Dialog open={open} onOpenChange={setOpen}>
-          <DialogTrigger
-            render={
-              <Button size="lg">
-                <Plus className="size-5" />
-                New User
-              </Button>
-            }
-          />
-          <DialogContent className="max-h-[85vh] overflow-y-auto sm:max-w-lg">
-            <DialogHeader className="items-center text-center">
-              <DialogTitle>New user</DialogTitle>
-              <DialogDescription>Created in both the auth service and here; password is emailed.</DialogDescription>
-            </DialogHeader>
-            <FieldGroup>
-              <Field data-invalid={!!errors.username}>
-                <FieldLabel htmlFor="u-username">Username</FieldLabel>
-                <Input id="u-username" value={username} onChange={(e) => setUsername(e.target.value)} aria-invalid={!!errors.username} />
-                <FieldError errors={[errors.username ? { message: errors.username } : undefined]} />
-              </Field>
-              <Field data-invalid={!!errors.fullName}>
-                <FieldLabel htmlFor="u-fullname">Full name</FieldLabel>
-                <Input id="u-fullname" value={fullName} onChange={(e) => setFullName(e.target.value)} aria-invalid={!!errors.fullName} />
-                <FieldError errors={[errors.fullName ? { message: errors.fullName } : undefined]} />
-              </Field>
-              <Field data-invalid={!!errors.email}>
-                <FieldLabel htmlFor="u-email">Email</FieldLabel>
-                <Input
-                  id="u-email"
-                  type="email"
-                  value={email}
-                  onChange={(e) => setEmail(e.target.value)}
-                  onBlur={(e) => checkEmail(e.target.value)}
-                  aria-invalid={!!errors.email}
-                />
-                <FieldError errors={[errors.email ? { message: errors.email } : undefined]} />
-                {checkingEmail && <p className="text-sm text-muted-foreground">Checking for an existing staff record…</p>}
-                {staffMatch && (
-                  <div className="flex items-center gap-2 rounded-lg border border-primary/30 bg-primary/5 px-3 py-2 text-sm">
-                    <Link2 className="size-4 shrink-0 text-primary" />
-                    <span>
-                      Staff record <strong>{staffMatch.employeeCode}</strong> ({staffMatch.fullName}) matches this email — it will be linked to this user.
-                    </span>
-                  </div>
-                )}
-              </Field>
-              <Field>
-                <FieldLabel htmlFor="u-mobile">Mobile number (optional)</FieldLabel>
-                <Input id="u-mobile" value={mobileNumber} onChange={(e) => setMobileNumber(e.target.value)} />
-              </Field>
-              <Field>
-                <FieldLabel htmlFor="u-nic">NIC (optional)</FieldLabel>
-                <Input id="u-nic" value={nic} onChange={(e) => setNic(e.target.value)} />
-              </Field>
-              <Field data-invalid={!!errors.roleId}>
-                <FieldLabel htmlFor="u-role">Role</FieldLabel>
-                <Select value={roleId || undefined} onValueChange={(v) => setRoleId(v ?? "")}>
-                  <SelectTrigger id="u-role">
-                    <SelectValue placeholder="Select a role" />
-                  </SelectTrigger>
-                  <SelectContent>
-                    {roles.map((r) => (
-                      <SelectItem key={r.roleId} value={String(r.roleId)}>
-                        {r.name}
-                      </SelectItem>
-                    ))}
-                  </SelectContent>
-                </Select>
-                <FieldError errors={[errors.roleId ? { message: errors.roleId } : undefined]} />
-              </Field>
-              {requiresBranchScope && !staffMatch && (
+      <div className="grid grid-cols-2 gap-4 sm:grid-cols-4">
+        {stats ? (
           <>
-                  <div className="rounded-lg border border-primary/30 bg-primary/5 px-3 py-2 text-sm text-muted-foreground">
-                    This role isn&apos;t Admin — it must be scoped to one branch. These details create the linked staff record.
-                  </div>
-                  <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">
-                    <Field data-invalid={!!errors.employeeCode}>
-                      <FieldLabel htmlFor="u-empcode">Employee code</FieldLabel>
-                      <Input id="u-empcode" value={employeeCode} onChange={(e) => setEmployeeCode(e.target.value)} aria-invalid={!!errors.employeeCode} />
-                      <FieldError errors={[errors.employeeCode ? { message: errors.employeeCode } : undefined]} />
-                    </Field>
-                    <Field data-invalid={!!errors.hireDate}>
-                      <FieldLabel htmlFor="u-hire">Hire date</FieldLabel>
-                      <Input id="u-hire" type="date" value={hireDate} onChange={(e) => setHireDate(e.target.value)} aria-invalid={!!errors.hireDate} />
-                      <FieldError errors={[errors.hireDate ? { message: errors.hireDate } : undefined]} />
-                    </Field>
-                    <Field data-invalid={!!errors.departmentId}>
-                      <FieldLabel htmlFor="u-dept">Department</FieldLabel>
-                      <Select value={departmentId ? String(departmentId) : undefined} onValueChange={(v) => setDepartmentId(v ? Number(v) : 0)}>
-                        <SelectTrigger id="u-dept" aria-invalid={!!errors.departmentId}><SelectValue placeholder="Select" /></SelectTrigger>
-                        <SelectContent>{departments.map((d) => <SelectItem key={d.departmentId} value={String(d.departmentId)}>{d.name}</SelectItem>)}</SelectContent>
-                      </Select>
-                      <FieldError errors={[errors.departmentId ? { message: errors.departmentId } : undefined]} />
-                    </Field>
-                    <Field data-invalid={!!errors.designationId}>
-                      <FieldLabel htmlFor="u-desig">Designation</FieldLabel>
-                      <Select value={designationId ? String(designationId) : undefined} onValueChange={(v) => setDesignationId(v ? Number(v) : 0)}>
-                        <SelectTrigger id="u-desig" aria-invalid={!!errors.designationId}><SelectValue placeholder="Select" /></SelectTrigger>
-                        <SelectContent>{designations.map((d) => <SelectItem key={d.designationId} value={String(d.designationId)}>{d.name}</SelectItem>)}</SelectContent>
-                      </Select>
-                      <FieldError errors={[errors.designationId ? { message: errors.designationId } : undefined]} />
-                    </Field>
-                    <Field data-invalid={!!errors.employmentTypeId}>
-                      <FieldLabel htmlFor="u-etype">Employment type</FieldLabel>
-                      <Select value={employmentTypeId ? String(employmentTypeId) : undefined} onValueChange={(v) => setEmploymentTypeId(v ? Number(v) : 0)}>
-                        <SelectTrigger id="u-etype" aria-invalid={!!errors.employmentTypeId}><SelectValue placeholder="Select" /></SelectTrigger>
-                        <SelectContent>{employmentTypes.map((t) => <SelectItem key={t.employmentTypeId} value={String(t.employmentTypeId)}>{t.name}</SelectItem>)}</SelectContent>
-                      </Select>
-                      <FieldError errors={[errors.employmentTypeId ? { message: errors.employmentTypeId } : undefined]} />
-                    </Field>
-                    <Field data-invalid={!!errors.workShiftId}>
-                      <FieldLabel htmlFor="u-shift">Work shift</FieldLabel>
-                      <Select value={workShiftId ? String(workShiftId) : undefined} onValueChange={(v) => setWorkShiftId(v ? Number(v) : 0)}>
-                        <SelectTrigger id="u-shift" aria-invalid={!!errors.workShiftId}><SelectValue placeholder="Select" /></SelectTrigger>
-                        <SelectContent>{workShifts.map((w) => <SelectItem key={w.workShiftId} value={String(w.workShiftId)}>{w.name}</SelectItem>)}</SelectContent>
-                      </Select>
-                      <FieldError errors={[errors.workShiftId ? { message: errors.workShiftId } : undefined]} />
-                    </Field>
-                    {branchingEnabled && (
-                      <Field data-invalid={!!errors.branchId}>
-                        <FieldLabel htmlFor="u-branch">Branch</FieldLabel>
-                        {showBranchPicker ? (
-                          <Select value={branchId ? String(branchId) : undefined} onValueChange={(v) => setBranchId(v ? Number(v) : 0)}>
-                            <SelectTrigger id="u-branch" aria-invalid={!!errors.branchId}><SelectValue placeholder="Select" /></SelectTrigger>
-                            <SelectContent>{branches.map((b) => <SelectItem key={b.branchId} value={String(b.branchId)}>{b.name}</SelectItem>)}</SelectContent>
-                          </Select>
-                        ) : (
-                          <div id="u-branch" className="flex h-9 items-center rounded-lg border border-input bg-muted px-3 text-sm text-muted-foreground">
-                            {lockedBranchName ?? "No branch assigned — contact an admin"}
-                          </div>
-                        )}
-                        <FieldError errors={[errors.branchId ? { message: errors.branchId } : undefined]} />
-                      </Field>
-                    )}
-                  </div>
+            <StatCard label="Total users" value={stats.total} icon={UsersIcon} />
+            <StatCard label="Active" value={stats.active} icon={UserCheck} />
+            <StatCard label="Inactive" value={stats.total - stats.active} icon={UserX} />
+            <StatCard label="Admins" value={stats.admins} icon={ShieldCheck} />
           </>
+        ) : (
+          Array.from({ length: 4 }).map((_, i) => <Skeleton key={i} className="h-20 w-full rounded-xl" />)
         )}
-              <Field data-invalid={!!errors.userTypeId}>
-                <FieldLabel htmlFor="u-usertype">User type</FieldLabel>
-                <Select value={userTypeId || undefined} onValueChange={(v) => setUserTypeId(v ?? "")}>
-                  <SelectTrigger id="u-usertype">
-                    <SelectValue placeholder="Select a user type" />
-                  </SelectTrigger>
-                  <SelectContent>
-                    {userTypes.map((t) => (
-                      <SelectItem key={t.userTypeId} value={t.userTypeId}>
-                        {t.code ?? t.userTypeId}
-                      </SelectItem>
-                    ))}
-                  </SelectContent>
-                </Select>
-                <FieldError errors={[errors.userTypeId ? { message: errors.userTypeId } : undefined]} />
-              </Field>
-            </FieldGroup>
-            <div className="flex flex-col-reverse gap-3 pt-2 sm:flex-row sm:justify-center">
-              <Button variant="outline" className="w-full sm:w-auto sm:min-w-36" onClick={() => setOpen(false)} disabled={submitting}>
-                Cancel
-              </Button>
-              <Button className="w-full sm:w-auto sm:min-w-36" onClick={handleCreate} disabled={submitting}>
-                {submitting ? "Creating…" : "Create"}
-              </Button>
       </div>
-          </DialogContent>
-        </Dialog>
+
+      <div className="relative w-full sm:max-w-xs">
+        <Search className="pointer-events-none absolute left-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" />
+        <Input
+          value={search}
+          onChange={(e) => setSearch(e.target.value)}
+          placeholder="Search users by username or name…"
+          className="h-10 pl-9 pr-9"
+          aria-label="Search users"
+        />
+        {search && (
+          <button
+            type="button"
+            onClick={() => setSearch("")}
+            aria-label="Clear search"
+            className="absolute right-2.5 top-1/2 -translate-y-1/2 text-muted-foreground hover:text-foreground"
+          >
+            <X className="size-4" />
+          </button>
+        )}
       </div>
 
       {error && (
@@ -398,14 +137,39 @@ export default function UsersPage() {
       )}
 
       {!error && users === null && (
-        <div className="flex flex-col gap-3">
-          {Array.from({ length: 4 }).map((_, i) => (
-            <Skeleton key={i} className="h-14 w-full" />
+        <div className="overflow-hidden rounded-xl border">
+          <div className="flex h-11 items-center gap-4 border-b bg-muted/20 px-4">
+            <Skeleton className="h-3.5 w-16" />
+            <Skeleton className="ml-auto h-3.5 w-16" />
+          </div>
+          {Array.from({ length: 5 }).map((_, i) => (
+            <div key={i} className="flex items-center gap-3 border-b px-4 py-4 last:border-b-0">
+              <Skeleton className="size-9 shrink-0 rounded-lg" />
+              <div className="flex flex-1 flex-col gap-2">
+                <Skeleton className="h-4 w-40" />
+                <Skeleton className="h-3 w-24" />
+              </div>
+              <Skeleton className="h-5 w-16 rounded-full" />
+              <Skeleton className="ml-4 h-7 w-16" />
+            </div>
           ))}
         </div>
       )}
 
-      {!error && users !== null && users.length === 0 && (
+      {!error && users !== null && users.length === 0 && debouncedSearch && (
+        <div className="flex flex-col items-center gap-3 rounded-xl border border-dashed py-16 text-center">
+          <Search className="size-10 text-muted-foreground" />
+          <div>
+            <p className="text-base font-medium text-foreground">No users match &quot;{debouncedSearch}&quot;</p>
+            <p className="text-sm text-muted-foreground">Try a different username or name.</p>
+          </div>
+          <Button variant="outline" size="sm" onClick={() => setSearch("")}>
+            Clear search
+          </Button>
+        </div>
+      )}
+
+      {!error && users !== null && users.length === 0 && !debouncedSearch && (
         <div className="flex flex-col items-center gap-4 rounded-xl border border-dashed py-20 text-center">
           <UsersIcon className="size-12 text-muted-foreground" />
           <p className="text-base text-muted-foreground">No users yet.</p>
@@ -413,59 +177,122 @@ export default function UsersPage() {
       )}
 
       {!error && users !== null && users.length > 0 && (
+        <div className="overflow-hidden rounded-xl border">
+          <div className="overflow-x-auto">
             <Table className="text-base">
               <TableHeader>
-            <TableRow>
-              <TableHead className="h-12 px-3 text-sm">Username</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Display name</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Role</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Status</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Actions</TableHead>
+                <TableRow className="hover:bg-transparent">
+                  <TableHead className="h-11 w-48 px-3 text-sm">Username</TableHead>
+                  <TableHead className="h-11 w-48 px-3 text-sm">Display name</TableHead>
+                  <TableHead className="h-11 w-40 px-3 text-sm">Role</TableHead>
+                  <TableHead className="h-11 w-28 px-3 text-sm">Status</TableHead>
+                  <TableHead className="h-11 w-32 px-3 text-center text-sm">Actions</TableHead>
                 </TableRow>
               </TableHeader>
               <TableBody>
                 {users.map((u) => (
-              <TableRow key={u.userId}>
-                <TableCell className="px-3 py-3.5 font-medium">{u.username}</TableCell>
-                <TableCell className="px-3 py-3.5">{u.displayName}</TableCell>
-                <TableCell className="px-3 py-3.5">{u.roleName ?? "—"}</TableCell>
-                <TableCell className="px-3 py-3.5">
+                  <TableRow key={u.userId} className="group align-top hover:bg-muted/20">
+                    <TableCell className="px-3 py-4">
+                      <Link
+                        href={`/dashboard/settings/users/${u.userId}`}
+                        className="font-semibold leading-tight text-foreground group-hover:underline"
+                      >
+                        {u.username}
+                      </Link>
+                    </TableCell>
+                    <TableCell className="px-3 py-4 text-sm text-muted-foreground">{u.displayName}</TableCell>
+                    <TableCell className="px-3 py-4 text-sm text-muted-foreground">{u.roleName ?? "—"}</TableCell>
+                    <TableCell className="px-3 py-4">
                       <Badge
                         variant="outline"
                         className={cn(
-                      "h-6 w-fit justify-center border-transparent px-2.5 text-sm",
-                      u.status === "Active" ? "bg-success/10 text-success" : "bg-muted text-muted-foreground"
+                          "h-5 w-fit justify-center bg-white px-2 text-xs",
+                          u.status === "Active" ? "border-success/40 text-success" : "border-input text-muted-foreground"
                         )}
                       >
                         {u.status}
                       </Badge>
                     </TableCell>
-                <TableCell className="px-3 py-3.5">
+                    <TableCell className="px-3 py-4">
+                      <div className="flex items-center justify-center gap-1">
+                        <Link
+                          href={`/dashboard/settings/users/${u.userId}`}
+                          className={cn(buttonVariants({ variant: "ghost", size: "icon-sm" }))}
+                          aria-label={`View ${u.username}`}
+                          title={`View ${u.username}`}
+                        >
+                          <Eye className="size-4" />
+                        </Link>
                         <Link
                           href={`/dashboard/settings/users/${u.userId}`}
                           className={cn(buttonVariants({ variant: "ghost", size: "icon-sm" }))}
                           aria-label={`Edit ${u.username}`}
+                          title={`Edit ${u.username}`}
                         >
                           <Pencil className="size-4" />
                         </Link>
+                        <Button
+                          type="button"
+                          variant="ghost"
+                          size="icon-sm"
+                          className={cn(
+                            u.status === "Active"
+                              ? "text-destructive hover:bg-destructive/10"
+                              : "text-success hover:bg-success/10"
+                          )}
+                          aria-label={u.status === "Active" ? `Deactivate ${u.username}` : `Activate ${u.username}`}
+                          title={u.status === "Active" ? `Deactivate ${u.username}` : `Activate ${u.username}`}
+                          disabled={actionPendingId === u.userId}
+                          onClick={() => handleToggleStatus(u)}
+                        >
+                          {u.status === "Active" ? <UserX className="size-4" /> : <UserCheck className="size-4" />}
+                        </Button>
+                      </div>
                     </TableCell>
                   </TableRow>
                 ))}
               </TableBody>
             </Table>
+          </div>
+        </div>
       )}
 
-      {pagination && pagination.totalPages > 1 && (
-        <div className="flex items-center justify-between">
+      {pagination && pagination.totalItems > 0 && (
+        <div className="flex flex-col-reverse items-center gap-3 sm:flex-row sm:justify-between">
+          <div className="flex items-center gap-3">
             <p className="text-sm text-muted-foreground">
-            Showing {(pagination.page - 1) * pagination.pageSize + 1}–
-            {Math.min(pagination.page * pagination.pageSize, pagination.totalItems)} of {pagination.totalItems}
+              Showing <span className="font-medium text-foreground">{(pagination.page - 1) * pagination.pageSize + 1}</span>–
+              <span className="font-medium text-foreground">
+                {Math.min(pagination.page * pagination.pageSize, pagination.totalItems)}
+              </span>{" "}
+              of <span className="font-medium text-foreground">{pagination.totalItems}</span> users
             </p>
+            <label className="flex items-center gap-1.5 text-sm text-muted-foreground">
+              Rows per page
+              <select
+                value={pageSize}
+                onChange={(e) => { setPage(1); setPageSize(Number(e.target.value)) }}
+                className="h-8 rounded-md border border-black bg-white px-2 text-sm text-foreground outline-none focus-visible:ring-2 focus-visible:ring-ring/50"
+                aria-label="Rows per page"
+              >
+                {PAGE_SIZE_OPTIONS.map((size) => (
+                  <option key={size} value={size}>{size}</option>
+                ))}
+              </select>
+            </label>
+          </div>
           <div className="flex items-center gap-2">
-            <Button type="button" variant="outline" size="sm" disabled={pagination.page <= 1} onClick={() => setPage((p) => Math.max(1, p - 1))}>
+            <Button
+              type="button"
+              variant="outline"
+              size="sm"
+              disabled={pagination.page <= 1}
+              onClick={() => setPage((p) => Math.max(1, p - 1))}
+            >
+              <ChevronLeft className="size-4" />
               Previous
             </Button>
-            <span className="text-sm text-muted-foreground">
+            <span className="min-w-20 text-center text-sm text-muted-foreground">
               Page {pagination.page} of {pagination.totalPages}
             </span>
             <Button
@@ -476,6 +303,7 @@ export default function UsersPage() {
               onClick={() => setPage((p) => Math.min(pagination.totalPages, p + 1))}
             >
               Next
+              <ChevronRight className="size-4" />
             </Button>
           </div>
         </div>

Frontend/erp-system/components/auth/RolePermissionTree.tsx

@@ -5,8 +5,11 @@
 // "select all children" convenience toggle — the parent's own visibility is
 // derived from its children on the frontend (see AppSidebar.tsx's filter), so
 // only the children need to carry the actual grant for those groups.
+import { Check } from "lucide-react"
+
 import { Checkbox } from "@/components/ui/checkbox"
 import { Label } from "@/components/ui/label"
+import { cn } from "@/lib/utils"
 import { NavItem } from "@/types/rbac"
 
 interface Props {
@@ -41,42 +44,60 @@ export function RolePermissionTree({ tree, selectedNavItemIds, selectedSubNavIte
   }
 
   return (
-    <div className="flex flex-col gap-1 rounded-lg border p-4">
-      {tree.map((item) => {
-        if (item.children.length === 0) {
-          return (
-            <label key={item.navItemId} className="flex items-center gap-3 rounded-md px-2 py-2 hover:bg-muted/50">
-              <Checkbox
-                checked={selectedNavItemIds.has(item.navItemId)}
-                onCheckedChange={() => toggleLeaf(item.navItemId)}
-              />
-              <Label className="cursor-pointer text-base font-medium">{item.label}</Label>
-            </label>
-          )
-        }
-
+    <div className="overflow-hidden rounded-lg border">
+      {tree.map((item, i) => {
+        const hasChildren = item.children.length > 0
         const checkedCount = item.children.filter((c) => selectedSubNavItemIds.has(c.subNavItemId)).length
-        const allChecked = checkedCount === item.children.length
+        const allChecked = hasChildren && checkedCount === item.children.length
+        const someChecked = hasChildren && checkedCount > 0 && !allChecked
 
         return (
-          <div key={item.navItemId} className="flex flex-col gap-1 border-t pt-2 first:border-t-0 first:pt-0">
-            <label className="flex items-center gap-3 rounded-md px-2 py-2 hover:bg-muted/50">
-              <Checkbox checked={allChecked} onCheckedChange={(checked) => toggleAllChildren(item, !!checked)} />
-              <Label className="cursor-pointer text-base font-semibold">
-                {item.label} {checkedCount > 0 && !allChecked && <span className="text-sm font-normal text-muted-foreground">({checkedCount} of {item.children.length})</span>}
+          <div
+            key={item.navItemId}
+            className="grid grid-cols-[minmax(11rem,14rem)_1fr] items-start gap-x-4 gap-y-2 border-b bg-white px-4 py-3 last:border-b-0"
+          >
+            <label className="flex items-center gap-2.5 pt-0.5">
+              <Checkbox
+                checked={hasChildren ? allChecked : selectedNavItemIds.has(item.navItemId)}
+                indeterminate={someChecked}
+                onCheckedChange={
+                  hasChildren
+                    ? (checked) => toggleAllChildren(item, !!checked)
+                    : () => toggleLeaf(item.navItemId)
+                }
+                className="size-5 border-2 border-muted-foreground/50 data-checked:border-blue-600! data-checked:bg-blue-600! data-checked:text-white! [&_svg]:size-4"
+              />
+              <Label className={cn("cursor-pointer text-base", hasChildren ? "font-semibold" : "font-medium")}>
+                {item.label}
               </Label>
             </label>
-            <div className="flex flex-col gap-1 pl-9">
-              {item.children.map((child) => (
-                <label key={child.subNavItemId} className="flex items-center gap-3 rounded-md px-2 py-1.5 hover:bg-muted/50">
-                  <Checkbox
-                    checked={selectedSubNavItemIds.has(child.subNavItemId)}
-                    onCheckedChange={() => toggleChild(child.subNavItemId)}
-                  />
-                  <Label className="cursor-pointer text-sm">{child.label}</Label>
-                </label>
-              ))}
+
+            {hasChildren ? (
+              <div className="flex flex-wrap items-center gap-1.5">
+                {item.children.map((child) => {
+                  const checked = selectedSubNavItemIds.has(child.subNavItemId)
+                  return (
+                    <button
+                      key={child.subNavItemId}
+                      type="button"
+                      aria-pressed={checked}
+                      onClick={() => toggleChild(child.subNavItemId)}
+                      className={cn(
+                        "inline-flex items-center gap-1 rounded-full border px-3 py-1 text-sm font-medium transition-colors",
+                        checked
+                          ? "border-transparent bg-blue-100 text-blue-700 hover:bg-blue-200 dark:bg-blue-500/20 dark:text-blue-300 dark:hover:bg-blue-500/30"
+                          : "border-input bg-white text-muted-foreground hover:border-muted-foreground/40 hover:text-foreground"
+                      )}
+                    >
+                      {checked && <Check className="size-3.5" />}
+                      {child.label}
+                    </button>
+                  )
+                })}
               </div>
+            ) : (
+              <span className="pt-1 text-sm text-muted-foreground">No sub-items — grants the whole section.</span>
+            )}
           </div>
         )
       })}

Frontend/erp-system/components/settings/BranchDetailPage.tsx

@@ -0,0 +1,236 @@
+"use client"
+
+// Read-only Branch detail screen, linked from the "View" action on BranchMasterPage.
+// Shared by both entry points (/dashboard/settings/branches/[id] and
+// /dashboard/hrm/settings/branches/[id]) the same way BranchMasterPage is.
+import { useEffect, useState } from "react"
+import { useParams, usePathname } from "next/navigation"
+import Link from "next/link"
+import { BarChart3, Building2, MapPin, Phone, ReceiptText } from "lucide-react"
+
+import { employeesApi } from "@/lib/api/employees"
+import { branchesHrmApi } from "@/lib/api/hrm-masters"
+import { salesApi } from "@/lib/api/sales"
+import { errorMessage } from "@/lib/error-map"
+import { cn } from "@/lib/utils"
+import { Branch } from "@/types/hrm"
+
+import { Badge } from "@/components/ui/badge"
+import { buttonVariants } from "@/components/ui/button"
+import PieChart from "@/components/ui/pie-chart"
+import { Skeleton } from "@/components/ui/skeleton"
+
+// Status colors, not a categorical series — same green/gray the Active/Inactive
+// badges already use elsewhere on this page, so the chart reads as an extension
+// of that badge rather than an unrelated palette.
+const STATUS_COLORS = { active: "#22c55e", inactive: "#9ca3af" }
+
+// Sales invoice status — same three colors as the invoice status Badge elsewhere in the app.
+const SALES_STATUS_COLORS = { posted: "#22c55e", draft: "#9ca3af", cancelled: "#ef4444" }
+
+const CURRENCY_FORMAT = new Intl.NumberFormat("en-LK", { style: "currency", currency: "LKR" })
+
+export function BranchDetailPage() {
+  const params = useParams<{ id: string }>()
+  const branchId = Number(params.id)
+  const pathname = usePathname()
+  const listHref = pathname.replace(/\/\d+$/, "")
+
+  const [branch, setBranch] = useState<Branch | null>(null)
+  const [loadError, setLoadError] = useState<string | null>(null)
+  const [insights, setInsights] = useState<{ employees: number; activeEmployees: number } | null>(null)
+  const [salesInsights, setSalesInsights] = useState<{ posted: number; draft: number; cancelled: number; revenue: number } | null>(null)
+
+  useEffect(() => {
+    if (!Number.isFinite(branchId)) return
+    setLoadError(null)
+    branchesHrmApi
+      .get(branchId)
+      .then((res) => setBranch(res.data))
+      .catch((err) => setLoadError(errorMessage(err)))
+  }, [branchId])
+
+  useEffect(() => {
+    if (!Number.isFinite(branchId)) return
+    setInsights(null)
+    Promise.all([
+      employeesApi.list({ branchId, page: 1, pageSize: 1 }),
+      employeesApi.list({ branchId, status: "Active", page: 1, pageSize: 1 }),
+    ])
+      .then(([all, active]) =>
+        setInsights({
+          employees: all.pagination.totalItems,
+          activeEmployees: active.pagination.totalItems,
+        })
+      )
+      .catch(() => setInsights(null))
+  }, [branchId])
+
+  useEffect(() => {
+    if (!Number.isFinite(branchId)) return
+    setSalesInsights(null)
+    Promise.all([
+      // Posted revenue is summed from the invoices actually returned, so it's exact up to the
+      // most recent 200 — fine for an at-a-glance figure, not a statutory total.
+      salesApi.listInvoices({ branchId, status: "Posted", page: 1, pageSize: 200 }),
+      salesApi.listInvoices({ branchId, status: "Draft", page: 1, pageSize: 1 }),
+      salesApi.listInvoices({ branchId, status: "Cancelled", page: 1, pageSize: 1 }),
+    ])
+      .then(([posted, draft, cancelled]) =>
+        setSalesInsights({
+          posted: posted.pagination.totalItems,
+          draft: draft.pagination.totalItems,
+          cancelled: cancelled.pagination.totalItems,
+          revenue: posted.items.reduce((sum, inv) => sum + inv.totals.grandTotal, 0),
+        })
+      )
+      .catch(() => setSalesInsights(null))
+  }, [branchId])
+
+  if (loadError && !branch) {
+    return (
+      <div className="flex flex-col gap-4">
+        <div className="rounded-lg border border-destructive/30 bg-destructive/5 p-5 text-base text-destructive">{loadError}</div>
+        <Link href={listHref} className={cn(buttonVariants({ variant: "outline" }))}>
+          Back to branches
+        </Link>
+      </div>
+    )
+  }
+
+  if (!branch) {
+    return (
+      <div className="flex flex-col gap-3">
+        <Skeleton className="h-10 w-72" />
+        <Skeleton className="h-48 w-full" />
+      </div>
+    )
+  }
+
+  return (
+    <div className="flex flex-col gap-6">
+      <div className="flex items-center gap-3">
+        <div>
+          <div className="flex items-center gap-3">
+            <h1 className="text-2xl font-bold text-foreground">{branch.name}</h1>
+            <Badge
+              variant="outline"
+              className={cn(
+                "h-6 w-fit justify-center border-transparent px-2.5 text-sm",
+                branch.status === "Active" ? "bg-success/10 text-success" : "bg-muted text-muted-foreground"
+              )}
+            >
+              {branch.status}
+            </Badge>
+          </div>
+          <p className="font-mono text-sm text-muted-foreground">{branch.code}</p>
+        </div>
+      </div>
+
+      <section className="rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:p-6">
+        <div className="flex items-center gap-2.5 border-b border-border pb-4">
+          <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10">
+            <Building2 className="size-4.5 text-primary" />
+          </div>
+          <div>
+            <h2 className="text-base font-semibold text-foreground">Branch details</h2>
+            <p className="text-sm text-muted-foreground">Company branch/location used for multi-branch scoping.</p>
+          </div>
+        </div>
+        <div className="mt-5 grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
+          <div className="flex flex-col gap-1">
+            <span className="text-sm text-muted-foreground">Code</span>
+            <span className="font-mono text-sm text-foreground">{branch.code}</span>
+          </div>
+          <div className="flex flex-col gap-1">
+            <span className="text-sm text-muted-foreground">Name</span>
+            <span className="text-sm text-foreground">{branch.name}</span>
+          </div>
+          <div className="flex flex-col gap-1">
+            <span className="flex items-center gap-1.5 text-sm text-muted-foreground">
+              <MapPin className="size-3.5" /> Address
+            </span>
+            <span className="text-sm text-foreground">{branch.address ?? "—"}</span>
+          </div>
+          <div className="flex flex-col gap-1">
+            <span className="flex items-center gap-1.5 text-sm text-muted-foreground">
+              <Phone className="size-3.5" /> Phone Number
+            </span>
+            <span className="text-sm text-foreground">{branch.phoneNumber ?? "—"}</span>
+          </div>
+          <div className="flex flex-col gap-1">
+            <span className="text-sm text-muted-foreground">Created</span>
+            <span className="text-sm text-foreground">{new Date(branch.createdAt).toLocaleString()}</span>
+          </div>
+          {branch.updatedAt && (
+            <div className="flex flex-col gap-1">
+              <span className="text-sm text-muted-foreground">Last updated</span>
+              <span className="text-sm text-foreground">{new Date(branch.updatedAt).toLocaleString()}</span>
+            </div>
+          )}
+        </div>
+      </section>
+
+      <div className="grid grid-cols-1 gap-6 lg:grid-cols-2">
+        <section className="rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:p-6">
+          <div className="flex items-center gap-2.5 border-b border-border pb-4">
+            <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10">
+              <BarChart3 className="size-4.5 text-primary" />
+            </div>
+            <div>
+              <h2 className="text-base font-semibold text-foreground">Workforce status</h2>
+              <p className="text-sm text-muted-foreground">Active vs. inactive employees at this branch.</p>
+            </div>
+          </div>
+          <div className="mt-5">
+            {!insights ? (
+              <Skeleton className="h-64 w-full rounded-xl" />
+            ) : insights.employees === 0 ? (
+              <p className="text-sm text-muted-foreground">No employees assigned to this branch yet.</p>
+            ) : (
+              <PieChart
+                labels={["Active", "Inactive"]}
+                data={[insights.activeEmployees, insights.employees - insights.activeEmployees]}
+                backgroundColor={[STATUS_COLORS.active, STATUS_COLORS.inactive]}
+              />
+            )}
+          </div>
+        </section>
+
+        <section className="rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 sm:p-6">
+          <div className="flex items-center gap-2.5 border-b border-border pb-4">
+            <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10">
+              <ReceiptText className="size-4.5 text-primary" />
+            </div>
+            <div>
+              <h2 className="text-base font-semibold text-foreground">Sales</h2>
+              <p className="text-sm text-muted-foreground">Invoices raised at this branch, by status.</p>
+            </div>
+          </div>
+          <div className="mt-5">
+            {!salesInsights ? (
+              <Skeleton className="h-64 w-full rounded-xl" />
+            ) : salesInsights.posted + salesInsights.draft + salesInsights.cancelled === 0 ? (
+              <p className="text-sm text-muted-foreground">No sales invoices for this branch yet.</p>
+            ) : (
+              <>
+                <p className="mb-4 text-sm text-muted-foreground">
+                  Posted revenue <span className="font-semibold text-foreground">{CURRENCY_FORMAT.format(salesInsights.revenue)}</span>
+                </p>
+                <PieChart
+                  labels={["Posted", "Draft", "Cancelled"]}
+                  data={[salesInsights.posted, salesInsights.draft, salesInsights.cancelled]}
+                  backgroundColor={[SALES_STATUS_COLORS.posted, SALES_STATUS_COLORS.draft, SALES_STATUS_COLORS.cancelled]}
+                />
+              </>
+            )}
+          </div>
+        </section>
+      </div>
+
+      <Link href={listHref} className={cn(buttonVariants({ variant: "outline" }), "ml-auto w-fit")}>
+        Back to branches
+      </Link>
+    </div>
+  )
+}

Frontend/erp-system/components/settings/BranchMasterPage.tsx

@@ -6,7 +6,9 @@
 // entry points (Settings → Branches and HRM → Settings → Branches) since Branch
 // is a cross-cutting concept now, not HRM-specific.
 import { useEffect, useState } from "react"
-import { Plus } from "lucide-react"
+import Link from "next/link"
+import { usePathname } from "next/navigation"
+import { Building2, ChevronLeft, ChevronRight, CheckCircle2, Eye, Pencil, Plus, Search, Trash2, X, XCircle } from "lucide-react"
 
 import { branchesHrmApi } from "@/lib/api/hrm-masters"
 import { errorMessage } from "@/lib/error-map"
@@ -14,7 +16,8 @@ import { cn } from "@/lib/utils"
 import { Branch } from "@/types/hrm"
 import { EntityStatus, PaginationMeta } from "@/types/common"
 
-import { Button } from "@/components/ui/button"
+import { AlertDialog, AlertDialogContent, AlertDialogTrigger } from "@/components/ui/alert-dialog"
+import { Button, buttonVariants } from "@/components/ui/button"
 import { Input } from "@/components/ui/input"
 import { Badge } from "@/components/ui/badge"
 import { Field, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field"
@@ -23,23 +26,31 @@ import { Skeleton } from "@/components/ui/skeleton"
 import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"
 import { toast } from "@/components/ui/toast"
 
+const PAGE_SIZE_OPTIONS = [5, 10, 20, 25]
+
 export function BranchMasterPage() {
-  const PAGE_SIZE = 10
+  const pathname = usePathname()
   const [items, setItems] = useState<Branch[] | null>(null)
   const [pagination, setPagination] = useState<PaginationMeta | null>(null)
   const [error, setError] = useState<string | null>(null)
   const [page, setPage] = useState(1)
+  const [pageSize, setPageSize] = useState(5)
+  const [search, setSearch] = useState("")
+  const [debouncedSearch, setDebouncedSearch] = useState("")
+  const [actionPendingId, setActionPendingId] = useState<number | null>(null)
 
   const [open, setOpen] = useState(false)
+  const [editing, setEditing] = useState<Branch | null>(null)
   const [name, setName] = useState("")
   const [address, setAddress] = useState("")
   const [phoneNumber, setPhoneNumber] = useState("")
   const [errors, setErrors] = useState<Record<string, string>>({})
   const [submitting, setSubmitting] = useState(false)
+  const [deletingId, setDeletingId] = useState<number | null>(null)
 
   function load() {
     branchesHrmApi
-      .list({ page, pageSize: PAGE_SIZE })
+      .list({ page, pageSize, q: debouncedSearch || undefined })
       .then((res) => {
         setItems(res.items)
         setPagination(res.pagination)
@@ -47,16 +58,39 @@ export function BranchMasterPage() {
       .catch((err) => setError(errorMessage(err)))
   }
 
-  useEffect(load, [page])
+  useEffect(load, [page, pageSize, debouncedSearch])
+
+  useEffect(() => {
+    const t = setTimeout(() => {
+      setPage(1)
+      setDebouncedSearch(search.trim())
+    }, 300)
+    return () => clearTimeout(t)
+  }, [search])
 
   function resetForm() {
+    setEditing(null)
     setName("")
     setAddress("")
     setPhoneNumber("")
     setErrors({})
   }
 
-  async function handleCreate() {
+  function openCreateDialog() {
+    resetForm()
+    setOpen(true)
+  }
+
+  function openEditDialog(item: Branch) {
+    setEditing(item)
+    setName(item.name)
+    setAddress(item.address ?? "")
+    setPhoneNumber(item.phoneNumber ?? "")
+    setErrors({})
+    setOpen(true)
+  }
+
+  async function handleSubmit() {
     const nextErrors: Record<string, string> = {}
     if (!name.trim()) nextErrors.name = "Name is required"
     setErrors(nextErrors)
@@ -64,45 +98,72 @@ export function BranchMasterPage() {
 
     setSubmitting(true)
     try {
-      await branchesHrmApi.create({
-        name: name.trim(),
-        address: address.trim() || null,
-        phoneNumber: phoneNumber.trim() || null,
-      })
+      const payload = { name: name.trim(), address: address.trim() || null, phoneNumber: phoneNumber.trim() || null }
+      if (editing) {
+        // The list response carries no ETag, so re-read to get a fresh If-Match token.
+        const current = await branchesHrmApi.get(editing.branchId)
+        await branchesHrmApi.update(editing.branchId, payload, current.etag ?? "")
+        toast.success("Branch updated")
+      } else {
+        await branchesHrmApi.create(payload)
         toast.success("Branch created")
+      }
       setOpen(false)
       resetForm()
       load()
     } catch (err) {
-      toast.error("Could not create branch", errorMessage(err))
+      toast.error(editing ? "Could not update branch" : "Could not create branch", errorMessage(err))
     } finally {
       setSubmitting(false)
     }
   }
 
+  async function handleDelete(item: Branch) {
+    setDeletingId(item.branchId)
+    try {
+      await branchesHrmApi.remove(item.branchId)
+      toast.success("Branch deleted", item.name)
+      load()
+    } catch (err) {
+      toast.error("Could not delete branch", errorMessage(err))
+    } finally {
+      setDeletingId(null)
+    }
+  }
+
   async function toggleStatus(item: Branch) {
     const next: EntityStatus = item.status === "Active" ? "Inactive" : "Active"
+    setActionPendingId(item.branchId)
     try {
       await branchesHrmApi.updateStatus(item.branchId, next)
       load()
     } catch (err) {
       toast.error("Could not update status", errorMessage(err))
+    } finally {
+      setActionPendingId(null)
     }
   }
 
   return (
     <div className="flex flex-col gap-6">
-      <div className="flex items-center justify-between">
+      <div className="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
         <div>
+          <div className="flex items-center gap-2.5">
             <h1 className="text-2xl font-bold text-foreground">Branches</h1>
+            {pagination && (
+              <span className="rounded-full border bg-white px-2 py-0.5 text-xs font-medium text-muted-foreground">
+                {pagination.totalItems}
+              </span>
+            )}
+          </div>
           <p className="text-base text-muted-foreground">Company branches/locations — used for multi-branch scoping.</p>
         </div>
         <Dialog open={open} onOpenChange={(next) => { setOpen(next); if (!next) resetForm() }}>
-          <DialogTrigger render={<Button size="lg"><Plus className="size-5" />New</Button>} />
+          <DialogTrigger render={<Button size="lg" onClick={openCreateDialog}><Plus className="size-5" />New Branch</Button>} />
           <DialogContent className="sm:max-w-sm">
             <DialogHeader className="items-center text-center">
-              <DialogTitle>New Branch</DialogTitle>
-              <DialogDescription>Code is generated automatically. Deactivate later — branches are never deleted.</DialogDescription>
+              <DialogTitle>{editing ? "Edit Branch" : "New Branch"}</DialogTitle>
+              <DialogDescription>{editing ? "Code cannot be changed." : "Code is generated automatically."}</DialogDescription>
             </DialogHeader>
             <FieldGroup>
               <Field data-invalid={!!errors.name}>
@@ -121,68 +182,235 @@ export function BranchMasterPage() {
             </FieldGroup>
             <div className="flex justify-center gap-3 pt-2">
               <Button variant="outline" className="min-w-32" onClick={() => setOpen(false)} disabled={submitting}>Cancel</Button>
-              <Button className="min-w-32" onClick={handleCreate} disabled={submitting}>{submitting ? "Creating…" : "Create"}</Button>
+              <Button className="min-w-32" onClick={handleSubmit} disabled={submitting}>
+                {submitting ? (editing ? "Saving…" : "Creating…") : editing ? "Save" : "Create"}
+              </Button>
             </div>
           </DialogContent>
         </Dialog>
       </div>
 
+      <div className="relative w-full sm:max-w-xs">
+        <Search className="pointer-events-none absolute left-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" />
+        <Input
+          value={search}
+          onChange={(e) => setSearch(e.target.value)}
+          placeholder="Search branches by name…"
+          className="h-10 pl-9 pr-9"
+          aria-label="Search branches"
+        />
+        {search && (
+          <button
+            type="button"
+            onClick={() => setSearch("")}
+            aria-label="Clear search"
+            className="absolute right-2.5 top-1/2 -translate-y-1/2 text-muted-foreground hover:text-foreground"
+          >
+            <X className="size-4" />
+          </button>
+        )}
+      </div>
+
       {error && <div className="rounded-lg border border-destructive/30 bg-destructive/5 p-5 text-base text-destructive">{error}</div>}
 
       {!error && items === null && (
-        <div className="flex flex-col gap-3">{Array.from({ length: 4 }).map((_, i) => <Skeleton key={i} className="h-14 w-full" />)}</div>
+        <div className="overflow-hidden rounded-xl border">
+          <div className="flex h-11 items-center gap-4 border-b bg-muted/20 px-4">
+            <Skeleton className="h-3.5 w-16" />
+            <Skeleton className="ml-auto h-3.5 w-16" />
+          </div>
+          {Array.from({ length: 5 }).map((_, i) => (
+            <div key={i} className="flex items-center gap-3 border-b px-4 py-4 last:border-b-0">
+              <Skeleton className="size-9 shrink-0 rounded-lg" />
+              <div className="flex flex-1 flex-col gap-2">
+                <Skeleton className="h-4 w-40" />
+                <Skeleton className="h-3 w-24" />
+              </div>
+              <Skeleton className="h-5 w-16 rounded-full" />
+              <Skeleton className="ml-4 h-7 w-16" />
+            </div>
+          ))}
+        </div>
       )}
 
-      {!error && items !== null && items.length === 0 && (
+      {!error && items !== null && items.length === 0 && debouncedSearch && (
+        <div className="flex flex-col items-center gap-3 rounded-xl border border-dashed py-16 text-center">
+          <Search className="size-10 text-muted-foreground" />
+          <div>
+            <p className="text-base font-medium text-foreground">No branches match &quot;{debouncedSearch}&quot;</p>
+            <p className="text-sm text-muted-foreground">Try a different name.</p>
+          </div>
+          <Button variant="outline" size="sm" onClick={() => setSearch("")}>
+            Clear search
+          </Button>
+        </div>
+      )}
+
+      {!error && items !== null && items.length === 0 && !debouncedSearch && (
         <div className="flex flex-col items-center gap-4 rounded-xl border border-dashed py-20 text-center">
-          <p className="text-base text-muted-foreground">No branches yet.</p>
+          <Building2 className="size-12 text-muted-foreground" />
+          <div>
+            <p className="text-base font-medium text-foreground">No branches yet</p>
+            <p className="text-sm text-muted-foreground">Add your first branch to get started.</p>
+          </div>
+          <Button onClick={openCreateDialog}>
+            <Plus className="size-4" />
+            New Branch
+          </Button>
         </div>
       )}
 
       {!error && items !== null && items.length > 0 && (
+        <div className="overflow-hidden rounded-xl border">
+          <div className="overflow-x-auto">
             <Table className="text-base">
               <TableHeader>
-            <TableRow>
-              <TableHead className="h-12 px-3 text-sm">Code</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Name</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Address</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Phone Number</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Status</TableHead>
-              <TableHead className="h-12 px-3 text-sm">Actions</TableHead>
+                <TableRow className="hover:bg-transparent">
+                  <TableHead className="h-11 w-48 px-4 text-sm">Branch</TableHead>
+                  <TableHead className="h-11 w-32 px-4 text-sm">Code</TableHead>
+                  <TableHead className="h-11 px-4 text-sm">Address</TableHead>
+                  <TableHead className="h-11 w-40 px-4 text-sm">Phone Number</TableHead>
+                  <TableHead className="h-11 w-28 px-4 text-sm">Status</TableHead>
+                  <TableHead className="h-11 w-40 px-4 text-center text-sm">Actions</TableHead>
                 </TableRow>
               </TableHeader>
               <TableBody>
                 {items.map((item) => (
-              <TableRow key={item.branchId}>
-                <TableCell className="px-3 py-3.5 font-medium">{item.code}</TableCell>
-                <TableCell className="px-3 py-3.5">{item.name}</TableCell>
-                <TableCell className="px-3 py-3.5 text-muted-foreground">{item.address ?? "—"}</TableCell>
-                <TableCell className="px-3 py-3.5 text-muted-foreground">{item.phoneNumber ?? "—"}</TableCell>
-                <TableCell className="px-3 py-3.5">
-                  <Badge variant="outline" className={cn("h-6 w-fit justify-center border-transparent px-2.5 text-sm", item.status === "Active" ? "bg-success/10 text-success" : "bg-muted text-muted-foreground")}>
+                  <TableRow key={item.branchId} className="align-top hover:bg-muted/20">
+                    <TableCell className="px-4 py-4 font-semibold text-foreground">{item.name}</TableCell>
+                    <TableCell className="px-4 py-4">
+                      <span className="font-mono text-xs text-muted-foreground">{item.code}</span>
+                    </TableCell>
+                    <TableCell className="px-4 py-4 text-sm text-muted-foreground">{item.address ?? "—"}</TableCell>
+                    <TableCell className="px-4 py-4 text-sm text-muted-foreground">{item.phoneNumber ?? "—"}</TableCell>
+                    <TableCell className="px-4 py-4">
+                      <Badge
+                        variant="outline"
+                        className={cn(
+                          "h-5 w-fit justify-center bg-white px-2 text-xs",
+                          item.status === "Active" ? "border-success/40 text-success" : "border-input text-muted-foreground"
+                        )}
+                      >
                         {item.status}
                       </Badge>
                     </TableCell>
-                <TableCell className="px-3 py-3.5">
-                  <Button variant="ghost" size="sm" onClick={() => toggleStatus(item)}>
-                    {item.status === "Active" ? "Deactivate" : "Activate"}
+                    <TableCell className="px-4 py-4">
+                      <div className="flex items-center justify-center gap-1">
+                        <Link
+                          href={`${pathname}/${item.branchId}`}
+                          className={cn(buttonVariants({ variant: "ghost", size: "icon-sm" }))}
+                          aria-label={`View ${item.name}`}
+                          title={`View ${item.name}`}
+                        >
+                          <Eye className="size-4" />
+                        </Link>
+                        <Button
+                          type="button"
+                          variant="ghost"
+                          size="icon-sm"
+                          aria-label={`Edit ${item.name}`}
+                          title={`Edit ${item.name}`}
+                          onClick={() => openEditDialog(item)}
+                        >
+                          <Pencil className="size-4" />
                         </Button>
+                        <Button
+                          type="button"
+                          variant="ghost"
+                          size="icon-sm"
+                          className={cn(
+                            item.status === "Active"
+                              ? "text-destructive hover:bg-destructive/10"
+                              : "text-success hover:bg-success/10"
+                          )}
+                          aria-label={item.status === "Active" ? `Deactivate ${item.name}` : `Activate ${item.name}`}
+                          title={item.status === "Active" ? `Deactivate ${item.name}` : `Activate ${item.name}`}
+                          disabled={actionPendingId === item.branchId}
+                          onClick={() => toggleStatus(item)}
+                        >
+                          {item.status === "Active" ? <XCircle className="size-4" /> : <CheckCircle2 className="size-4" />}
+                        </Button>
+                        <AlertDialog>
+                          <AlertDialogTrigger
+                            render={
+                              <Button
+                                variant="ghost"
+                                size="icon-sm"
+                                className="text-destructive hover:bg-destructive/10"
+                                aria-label={`Delete ${item.name}`}
+                                title={`Delete ${item.name}`}
+                                disabled={deletingId === item.branchId}
+                              />
+                            }
+                          >
+                            <Trash2 className="size-4" />
+                          </AlertDialogTrigger>
+                          <AlertDialogContent
+                            variant="destructive"
+                            title={`Delete ${item.name}?`}
+                            description="This permanently removes the branch. Branches referenced by employees, warehouses, or other records cannot be deleted."
+                            confirmLabel="Delete"
+                            onConfirm={() => handleDelete(item)}
+                          />
+                        </AlertDialog>
+                      </div>
                     </TableCell>
                   </TableRow>
                 ))}
               </TableBody>
             </Table>
+          </div>
+        </div>
       )}
 
-      {pagination && pagination.totalPages > 1 && (
-        <div className="flex items-center justify-between">
+      {pagination && pagination.totalItems > 0 && (
+        <div className="flex flex-col-reverse items-center gap-3 sm:flex-row sm:justify-between">
+          <div className="flex items-center gap-3">
             <p className="text-sm text-muted-foreground">
-            Showing {(pagination.page - 1) * pagination.pageSize + 1}–{Math.min(pagination.page * pagination.pageSize, pagination.totalItems)} of {pagination.totalItems}
+              Showing <span className="font-medium text-foreground">{(pagination.page - 1) * pagination.pageSize + 1}</span>–
+              <span className="font-medium text-foreground">
+                {Math.min(pagination.page * pagination.pageSize, pagination.totalItems)}
+              </span>{" "}
+              of <span className="font-medium text-foreground">{pagination.totalItems}</span> branches
             </p>
+            <label className="flex items-center gap-1.5 text-sm text-muted-foreground">
+              Rows per page
+              <select
+                value={pageSize}
+                onChange={(e) => { setPage(1); setPageSize(Number(e.target.value)) }}
+                className="h-8 rounded-md border border-black bg-white px-2 text-sm text-foreground outline-none focus-visible:ring-2 focus-visible:ring-ring/50"
+                aria-label="Rows per page"
+              >
+                {PAGE_SIZE_OPTIONS.map((size) => (
+                  <option key={size} value={size}>{size}</option>
+                ))}
+              </select>
+            </label>
+          </div>
           <div className="flex items-center gap-2">
-            <Button type="button" variant="outline" size="sm" disabled={pagination.page <= 1} onClick={() => setPage((p) => Math.max(1, p - 1))}>Previous</Button>
-            <span className="text-sm text-muted-foreground">Page {pagination.page} of {pagination.totalPages}</span>
-            <Button type="button" variant="outline" size="sm" disabled={pagination.page >= pagination.totalPages} onClick={() => setPage((p) => Math.min(pagination.totalPages, p + 1))}>Next</Button>
+            <Button
+              type="button"
+              variant="outline"
+              size="sm"
+              disabled={pagination.page <= 1}
+              onClick={() => setPage((p) => Math.max(1, p - 1))}
+            >
+              <ChevronLeft className="size-4" />
+              Previous
+            </Button>
+            <span className="min-w-20 text-center text-sm text-muted-foreground">
+              Page {pagination.page} of {pagination.totalPages}
+            </span>
+            <Button
+              type="button"
+              variant="outline"
+              size="sm"
+              disabled={pagination.page >= pagination.totalPages}
+              onClick={() => setPage((p) => Math.min(pagination.totalPages, p + 1))}
+            >
+              Next
+              <ChevronRight className="size-4" />
+            </Button>
           </div>
         </div>
       )}

Frontend/erp-system/components/ui/stat-card.tsx

@@ -71,21 +71,21 @@ export function StatCard({
   return (
     <div
       className={cn(
-        "flex flex-col gap-3 rounded-2xl bg-card p-5 shadow-sm ring-1 ring-foreground/10 transition-all duration-200 hover:-translate-y-0.5 hover:shadow-lg hover:ring-primary/30",
+        "flex flex-col gap-1.5 rounded-xl bg-card p-3.5 shadow-sm ring-1 ring-foreground/10 transition-all duration-200 hover:-translate-y-0.5 hover:shadow-lg hover:ring-primary/30",
         className
       )}
     >
       <div className="flex items-start justify-between gap-2">
-        <p className="text-base font-medium text-muted-foreground">{label}</p>
+        <p className="text-sm font-medium text-muted-foreground">{label}</p>
         {Icon && (
-          <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary/10">
-            <Icon className="size-5 text-primary" />
+          <div className="flex size-7 shrink-0 items-center justify-center rounded-lg bg-primary/10">
+            <Icon className="size-4 text-primary" />
           </div>
         )}
       </div>
 
       <div className="flex items-end justify-between gap-2">
-        <p className="text-xl font-bold tracking-tight text-foreground">{formatValue(value)}</p>
+        <p className="text-lg font-bold tracking-tight text-foreground">{formatValue(value)}</p>
         {trend && trend.length > 1 && <Sparkline points={trend} />}
       </div>
 

Frontend/erp-system/lib/api/audit-logs.ts

@@ -0,0 +1,20 @@
+// Read-only audit trail (ERPCore Controllers/AuditLogsController.cs).
+import { apiRequest, buildQuery } from "@/lib/api-client"
+import { PagedResponse } from "@/types/common"
+import { AuditLog } from "@/types/audit"
+
+export interface ListAuditLogsParams {
+  page?: number
+  pageSize?: number
+  entityType?: string
+  entityId?: number
+  userId?: number
+  from?: string
+  to?: string
+}
+
+export const auditLogsApi = {
+  list(params: ListAuditLogsParams = {}): Promise<PagedResponse<AuditLog>> {
+    return apiRequest<PagedResponse<AuditLog>>(`/audit-logs${buildQuery(params)}`)
+  },
+}

Frontend/erp-system/lib/api/employees.ts

@@ -59,6 +59,10 @@ export const employeesApi = {
   updateStatus(employeeId: number, status: EmployeeStatus): Promise<void> {
     return apiRequest<void>(`/employees/${employeeId}/status`, { method: "PATCH", body: { status } })
   },
+  /** Permanently deletes the employee and every dependent HR record. Blocked (409) if payroll history exists. */
+  remove(employeeId: number): Promise<void> {
+    return apiRequest<void>(`/employees/${employeeId}`, { method: "DELETE" })
+  },
 
   /** Advisory: does a System User already exist with this email? */
   emailLookup(email: string): Promise<{ match: UserMatch | null }> {

Frontend/erp-system/lib/api/hrm-master-factory.ts

@@ -28,5 +28,8 @@ export function createMasterApi<T, TCreate, TUpdate>(resource: string) {
     updateStatus(id: number, status: EntityStatus): Promise<void> {
       return apiRequest<void>(`/${resource}/${id}/status`, { method: "PATCH", body: { status } })
     },
+    remove(id: number): Promise<void> {
+      return apiRequest<void>(`/${resource}/${id}`, { method: "DELETE" })
+    },
   }
 }

Frontend/erp-system/lib/api/users.ts

@@ -1,13 +1,16 @@
 // User management (ERPCore Controllers/UsersController.cs). Create orchestrates
 // account creation in both AuthHex and ERPCore's local shadow table server-side.
 import { apiRequest, buildQuery } from "@/lib/api-client"
-import { PagedResponse } from "@/types/common"
-import { CreateUserRequest, ManagedUser, UpdateUserRoleRequest, UserTypeOption } from "@/types/users"
+import { EntityStatus, PagedResponse } from "@/types/common"
+import { LoginActivity } from "@/types/audit"
+import { CreateUserRequest, ManagedUser, UpdateUserRoleRequest, UpdateUserStatusRequest, UserTypeOption } from "@/types/users"
 
 export interface ListUsersParams {
   page?: number
   pageSize?: number
   q?: string
+  status?: EntityStatus
+  roleCode?: string
 }
 
 export const usersApi = {
@@ -27,7 +30,17 @@ export const usersApi = {
     return apiRequest<ManagedUser>(`/users/${userId}/role`, { method: "PUT", body: request })
   },
 
+  /** Revokes/restores standing inside ERPCore only — the auth-service credential itself is untouched. */
+  updateStatus(userId: number, request: UpdateUserStatusRequest): Promise<ManagedUser> {
+    return apiRequest<ManagedUser>(`/users/${userId}/status`, { method: "PATCH", body: request })
+  },
+
   userTypes(): Promise<UserTypeOption[]> {
     return apiRequest<UserTypeOption[]>("/users/user-types")
   },
+
+  /** Device/login history ERPCore captures itself — not a live "currently active sessions" view. */
+  loginDevices(userId: number, params: { page?: number; pageSize?: number } = {}): Promise<PagedResponse<LoginActivity>> {
+    return apiRequest<PagedResponse<LoginActivity>>(`/users/${userId}/login-devices${buildQuery(params)}`)
+  },
 }

Frontend/erp-system/lib/api/warehouses.ts

@@ -13,6 +13,7 @@ export interface ListWarehousesParams {
   pageSize?: number
   q?: string
   sort?: string
+  branchId?: number
 }
 
 export const warehousesApi = {

Frontend/erp-system/types/audit.ts

@@ -0,0 +1,20 @@
+// Audit trail DTOs (mirrors ERPCore's Dtos/Audit/AuditDtos.cs).
+export type AuditAction = "Create" | "Update" | "Delete" | "Login"
+
+export interface AuditLog {
+  auditId: number
+  userId: number
+  entityType: string
+  entityId: number
+  action: AuditAction
+  changeSet: unknown
+  createdAt: string
+}
+
+/** A captured past sign-in — device history, not a live "currently active sessions" view. */
+export interface LoginActivity {
+  loginActivityId: number
+  ipAddress: string | null
+  deviceLabel: string | null
+  loginAt: string
+}

Frontend/erp-system/types/users.ts

@@ -44,6 +44,10 @@ export interface UpdateUserRoleRequest {
   roleId: number
 }
 
+export interface UpdateUserStatusRequest {
+  status: EntityStatus
+}
+
 /** AuthHex UserType lookup, for the create-user form's select (no local shadow — read-only). */
 export interface UserTypeOption {
   userTypeId: string