@salesforce/ui-bundle-template-feature-property-management-metadata 1.117.2

package/LICENSE.txt

@@ -0,0 +1,82 @@
+Terms of Use
+
+Copyright 2026 Salesforce, Inc. All rights reserved.
+
+These Terms of Use govern the download, installation, and/or use of this
+software provided by Salesforce, Inc. ("Salesforce") (the "Software"), were
+last updated on April 15, 2025, and constitute a legally binding
+agreement between you and Salesforce. If you do not agree to these Terms of
+Use, do not install or use the Software.
+
+Salesforce grants you a worldwide, non-exclusive, no-charge, royalty-free
+copyright license to reproduce, prepare derivative works of, publicly
+display, publicly perform, sublicense, and distribute the Software and
+derivative works subject to these Terms. These Terms shall be included in
+all copies or substantial portions of the Software.
+
+Subject to the limited rights expressly granted hereunder, Salesforce
+reserves all rights, title, and interest in and to all intellectual
+property subsisting in the Software. No rights are granted to you hereunder
+other than as expressly set forth herein. Users residing in countries on
+the United States Office of Foreign Assets Control sanction list, or which
+are otherwise subject to a US export embargo, may not use the Software.
+
+Implementation of the Software may require development work, for which you
+are responsible. The Software may contain bugs, errors and
+incompatibilities and is made available on an AS IS basis without support,
+updates, or service level commitments.
+
+Salesforce reserves the right at any time to modify, suspend, or
+discontinue, the Software (or any part thereof) with or without notice. You
+agree that Salesforce shall not be liable to you or to any third party for
+any modification, suspension, or discontinuance.
+
+You agree to defend Salesforce against any claim, demand, suit or
+proceeding made or brought against Salesforce by a third party arising out
+of or accruing from (a) your use of the Software, and (b) any application
+you develop with the Software that infringes any copyright, trademark,
+trade secret, trade dress, patent, or other intellectual property right of
+any person or defames any person or violates their rights of publicity or
+privacy (each a "Claim Against Salesforce"), and will indemnify Salesforce
+from any damages, attorney fees, and costs finally awarded against
+Salesforce as a result of, or for any amounts paid by Salesforce under a
+settlement approved by you in writing of, a Claim Against Salesforce,
+provided Salesforce (x) promptly gives you written notice of the Claim
+Against Salesforce, (y) gives you sole control of the defense and
+settlement of the Claim Against Salesforce (except that you may not settle
+any Claim Against Salesforce unless it unconditionally releases Salesforce
+of all liability), and (z) gives you all reasonable assistance, at your
+expense.
+
+WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE SOFTWARE IS NOT
+SUPPORTED AND IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. IN NO EVENT SHALL SALESFORCE HAVE ANY LIABILITY FOR ANY DAMAGES,
+INCLUDING, BUT NOT LIMITED TO, DIRECT, INDIRECT, SPECIAL, INCIDENTAL,
+PUNITIVE, OR CONSEQUENTIAL DAMAGES, OR DAMAGES BASED ON LOST PROFITS, DATA,
+OR USE, IN CONNECTION WITH THE SOFTWARE, HOWEVER CAUSED AND WHETHER IN
+CONTRACT, TORT, OR UNDER ANY OTHER THEORY OF LIABILITY, WHETHER OR NOT YOU
+HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+These Terms of Use shall be governed exclusively by the internal laws of
+the State of California, without regard to its conflicts of laws
+rules. Each party hereby consents to the exclusive jurisdiction of the
+state and federal courts located in San Francisco County, California to
+adjudicate any dispute arising out of or relating to these Terms of Use and
+the download, installation, and/or use of the Software. Except as expressly
+stated herein, these Terms of Use constitute the entire agreement between
+the parties, and supersede all prior and contemporaneous agreements,
+proposals, or representations, written or oral, concerning their subject
+matter. No modification, amendment, or waiver of any provision of these
+Terms of Use shall be effective unless it is by an update to these Terms of
+Use that Salesforce makes available, or is in writing and signed by the
+party against whom the modification, amendment, or waiver is to be
+asserted.
+
+Data Privacy: Salesforce may collect, process, and store device,
+system, and other information related to your use of the Software. This
+information includes, but is not limited to, IP address, user metrics, and
+other data ("Usage Data"). Salesforce may use Usage Data for analytics,
+product development, and marketing purposes. You acknowledge that files
+generated in conjunction with the Software may contain sensitive or
+confidential data, and you are solely responsible for anonymizing and
+protecting such data.

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@salesforce/ui-bundle-template-feature-property-management-metadata",
+  "version": "1.117.2",
+  "description": "Shared Property Management TDX object metadata and data for B2E/B2X sample apps",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "author": "",
+  "type": "module",
+  "main": "index.js",
+  "files": [
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rm -rf dist"
+  },
+  "nx": {
+    "targets": {
+      "watch": {
+        "executor": "@salesforce/ui-bundle-template-cli:watch-patches"
+      }
+    }
+  }
+}

package/src/force-app/main/default/classes/MaintenanceRequestTriggerHandler.cls

@@ -0,0 +1,69 @@
+public without sharing class MaintenanceRequestTriggerHandler {
+
+    /**
+     * Handles before insert logic for Maintenance Request records
+     * Automatically assigns workers based on request type and updates status to Assigned
+     */
+    public static void handleBeforeInsert(List<Maintenance_Request__c> newRequests) {
+        // Map to store request type to worker type mappings
+        Map<String, String> requestTypeToWorkerType = new Map<String, String>{
+            'Plumbing'    => 'Plumbing',
+            'Electrical'  => 'Electrical',
+            'HVAC'        => 'HVAC (Heating & Cooling)',
+            'Appliance'   => 'Appliance Repair',
+            'Carpentry'   => 'General Carpentry',
+            'Landscaping' => 'Landscaping / Grounds',
+            'Cleaning'    => 'Janitorial / Cleaning',
+            'Pest'        => 'Pest Control'
+        };
+
+        // Collect unique worker types needed
+        Set<String> workerTypesNeeded = new Set<String>();
+        for (Maintenance_Request__c request : newRequests) {
+            if (request.Type__c != null && requestTypeToWorkerType.containsKey(request.Type__c)) {
+                workerTypesNeeded.add(requestTypeToWorkerType.get(request.Type__c));
+            }
+        }
+
+        // Query for available workers by type
+        Map<String, List<Maintenance_Worker__c>> workersByType = new Map<String, List<Maintenance_Worker__c>>();
+        if (!workerTypesNeeded.isEmpty()) {
+            for (Maintenance_Worker__c worker : [
+                SELECT Id, Name, Type__c, Rating__c
+                FROM Maintenance_Worker__c
+                WHERE Type__c IN :workerTypesNeeded
+                AND IsActive__c = true
+                ORDER BY Rating__c DESC NULLS LAST, Name ASC
+            ]) {
+                if (!workersByType.containsKey(worker.Type__c)) {
+                    workersByType.put(worker.Type__c, new List<Maintenance_Worker__c>());
+                }
+                workersByType.get(worker.Type__c).add(worker);
+            }
+        }
+
+        // Assign workers to requests
+        for (Maintenance_Request__c request : newRequests) {
+            // Only process requests with 'New' status (or null, since 'New' is the default)
+            if ((request.Status__c == 'New' || request.Status__c == null) &&
+                request.Type__c != null && requestTypeToWorkerType.containsKey(request.Type__c)) {
+                String workerType = requestTypeToWorkerType.get(request.Type__c);
+
+                // Check if we have available workers for this type
+                if (workersByType.containsKey(workerType) && !workersByType.get(workerType).isEmpty()) {
+                    // Assign the first available worker (highest rated)
+                    Maintenance_Worker__c assignedWorker = workersByType.get(workerType).get(0);
+                    request.Assigned_Worker__c = assignedWorker.Id;
+                    request.Status__c = 'Assigned';
+
+                    // Set scheduled date to 3 days from now
+                    request.Scheduled__c = DateTime.now().addDays(3);
+
+                    // Rotate worker to end of list for round-robin assignment
+                    workersByType.get(workerType).remove(0);
+                    workersByType.get(workerType).add(assignedWorker);
+                }
+            }
+        }
+    }
+}

package/src/force-app/main/default/classes/MaintenanceRequestTriggerHandler.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>66.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

package/src/force-app/main/default/classes/MaintenanceRequestTriggerHandler_Test.cls

@@ -0,0 +1,308 @@
+/**
+ * Test class for MaintenanceRequestTriggerHandler
+ * Validates automatic worker assignment, status updates to Assigned, and scheduled date setting
+ */
+@isTest
+private class MaintenanceRequestTriggerHandler_Test {
+
+    /**
+     * Setup test data for all test methods
+     */
+    @testSetup
+    static void setupTestData() {
+        // Create test maintenance workers with different specialties
+        List<Maintenance_Worker__c> workers = new List<Maintenance_Worker__c>{
+            new Maintenance_Worker__c(
+                Name = 'John Plumber',
+                Type__c = 'Plumbing',
+                IsActive__c = true,
+                Rating__c = 4.5,
+                Phone__c = '555-0001'
+            ),
+            new Maintenance_Worker__c(
+                Name = 'Jane Electrician',
+                Type__c = 'Electrical',
+                IsActive__c = true,
+                Rating__c = 4.8,
+                Phone__c = '555-0002'
+            ),
+            new Maintenance_Worker__c(
+                Name = 'Bob HVAC',
+                Type__c = 'HVAC (Heating & Cooling)',
+                IsActive__c = true,
+                Rating__c = 4.2,
+                Phone__c = '555-0003'
+            ),
+            new Maintenance_Worker__c(
+                Name = 'Alice Appliance',
+                Type__c = 'Appliance Repair',
+                IsActive__c = true,
+                Rating__c = 4.7,
+                Phone__c = '555-0004'
+            ),
+            new Maintenance_Worker__c(
+                Name = 'Charlie Pest',
+                Type__c = 'Pest Control',
+                IsActive__c = true,
+                Rating__c = 4.3,
+                Phone__c = '555-0005'
+            ),
+            new Maintenance_Worker__c(
+                Name = 'Inactive Worker',
+                Type__c = 'Plumbing',
+                IsActive__c = false,
+                Rating__c = 5.0,
+                Phone__c = '555-0006'
+            )
+        };
+        insert workers;
+    }
+
+    /**
+     * Test that plumbing requests are assigned to plumbing workers
+     */
+    @isTest
+    static void testPlumbingRequestAssignment() {
+        // Query for plumbing worker
+        Maintenance_Worker__c plumber = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Plumbing' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Plumbing',
+            Description__c = 'Leaky faucet in bathroom',
+            Priority__c = 'Standard'
+        );
+        insert request;
+        Test.stopTest();
+
+        // Verify assignment
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c, Scheduled__c, Type__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(plumber.Id, insertedRequest.Assigned_Worker__c, 'Worker should be assigned');
+        System.assertEquals('Assigned', insertedRequest.Status__c, 'Status should be Assigned');
+        System.assertNotEquals(null, insertedRequest.Scheduled__c, 'Scheduled date should be set');
+
+        // Verify scheduled date is approximately 3 days from now (within 1 minute tolerance)
+        DateTime expectedDate = DateTime.now().addDays(3);
+        Long timeDiff = Math.abs(insertedRequest.Scheduled__c.getTime() - expectedDate.getTime());
+        System.assert(timeDiff < 60000, 'Scheduled date should be 3 days from now');
+    }
+
+    /**
+     * Test that electrical requests are assigned to electrical workers
+     */
+    @isTest
+    static void testElectricalRequestAssignment() {
+        Maintenance_Worker__c electrician = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Electrical' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Electrical',
+            Description__c = 'Outlet not working',
+            Priority__c = 'High (Same Day)'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(electrician.Id, insertedRequest.Assigned_Worker__c, 'Electrician should be assigned');
+        System.assertEquals('Assigned', insertedRequest.Status__c, 'Status should be Assigned');
+    }
+
+    /**
+     * Test that HVAC requests are assigned to HVAC workers
+     */
+    @isTest
+    static void testHVACRequestAssignment() {
+        Maintenance_Worker__c hvacWorker = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'HVAC (Heating & Cooling)' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'HVAC',
+            Description__c = 'AC not cooling',
+            Priority__c = 'High (Same Day)'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(hvacWorker.Id, insertedRequest.Assigned_Worker__c, 'HVAC worker should be assigned');
+        System.assertEquals('Assigned', insertedRequest.Status__c, 'Status should be Assigned');
+    }
+
+    /**
+     * Test that appliance requests are assigned to appliance repair workers
+     */
+    @isTest
+    static void testApplianceRequestAssignment() {
+        Maintenance_Worker__c applianceWorker = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Appliance Repair' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Appliance',
+            Description__c = 'Dishwasher not draining',
+            Priority__c = 'Standard'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(applianceWorker.Id, insertedRequest.Assigned_Worker__c, 'Appliance worker should be assigned');
+        System.assertEquals('Assigned', insertedRequest.Status__c, 'Status should be Assigned');
+    }
+
+    /**
+     * Test that pest requests are assigned to pest control workers
+     */
+    @isTest
+    static void testPestRequestAssignment() {
+        Maintenance_Worker__c pestWorker = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Pest Control' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Pest',
+            Description__c = 'Ants in kitchen',
+            Priority__c = 'Standard'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(pestWorker.Id, insertedRequest.Assigned_Worker__c, 'Pest control worker should be assigned');
+        System.assertEquals('Assigned', insertedRequest.Status__c, 'Status should be Assigned');
+    }
+
+    /**
+     * Test bulk insert with multiple request types
+     */
+    @isTest
+    static void testBulkRequestAssignment() {
+        Test.startTest();
+        List<Maintenance_Request__c> requests = new List<Maintenance_Request__c>{
+            new Maintenance_Request__c(Type__c = 'Plumbing', Description__c = 'Leak 1', Priority__c = 'High (Same Day)'),
+            new Maintenance_Request__c(Type__c = 'Electrical', Description__c = 'Issue 1', Priority__c = 'Standard'),
+            new Maintenance_Request__c(Type__c = 'Plumbing', Description__c = 'Leak 2', Priority__c = 'Standard'),
+            new Maintenance_Request__c(Type__c = 'HVAC', Description__c = 'AC Issue', Priority__c = 'High (Same Day)'),
+            new Maintenance_Request__c(Type__c = 'Appliance', Description__c = 'Fridge Issue', Priority__c = 'Standard')
+        };
+        insert requests;
+        Test.stopTest();
+
+        List<Maintenance_Request__c> insertedRequests = [
+            SELECT Id, Assigned_Worker__c, Status__c, Type__c
+            FROM Maintenance_Request__c
+            WHERE Id IN :requests
+        ];
+
+        // Verify all requests were assigned
+        for (Maintenance_Request__c req : insertedRequests) {
+            System.assertNotEquals(null, req.Assigned_Worker__c, 'All requests should have assigned workers');
+            System.assertEquals('Assigned', req.Status__c, 'All requests should be Assigned');
+        }
+
+        System.assertEquals(5, insertedRequests.size(), 'All 5 requests should be inserted');
+    }
+
+    /**
+     * Test that requests without type are not assigned
+     */
+    @isTest
+    static void testRequestWithoutType() {
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Description__c = 'General maintenance',
+            Priority__c = 'Standard'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(null, insertedRequest.Assigned_Worker__c, 'Worker should not be assigned without type');
+    }
+
+    /**
+     * Test that inactive workers are not assigned
+     */
+    @isTest
+    static void testInactiveWorkerNotAssigned() {
+        // Delete all active plumbing workers
+        delete [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Plumbing' AND IsActive__c = true];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Plumbing',
+            Description__c = 'Emergency leak',
+            Priority__c = 'High (Same Day)'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(null, insertedRequest.Assigned_Worker__c, 'Inactive worker should not be assigned');
+    }
+
+    /**
+     * Test that requests with non-New status are not automatically processed
+     */
+    @isTest
+    static void testNonNewStatusNotProcessed() {
+        // Query for plumbing worker
+        Maintenance_Worker__c plumber = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Plumbing' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        // Create a request with status explicitly set to 'In Progress'
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Plumbing',
+            Description__c = 'Manually assigned request',
+            Priority__c = 'Standard',
+            Status__c = 'In Progress'
+        );
+        insert request;
+        Test.stopTest();
+
+        // Verify the request was not processed by trigger (no worker assigned)
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c, Scheduled__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(null, insertedRequest.Assigned_Worker__c, 'Worker should not be auto-assigned for non-New status');
+        System.assertEquals('In Progress', insertedRequest.Status__c, 'Status should remain as originally set');
+        System.assertEquals(null, insertedRequest.Scheduled__c, 'Scheduled date should not be set by trigger');
+    }
+}

package/src/force-app/main/default/classes/MaintenanceRequestTriggerHandler_Test.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>66.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

package/src/force-app/main/default/classes/TenantTriggerHandler.cls

@@ -0,0 +1,77 @@
+/**
+ * Assigns Tenant_Maintenance_Access permission set to users linked to Tenant__c records.
+ * When a Tenant is created or updated with User__c set, the linked user gets the permission set.
+ */
+public with sharing class TenantTriggerHandler {
+
+    private static final String PERMISSION_SET_NAME = 'Tenant_Maintenance_Access';
+
+    /**
+     * Assign Tenant_Maintenance_Access to each user linked via Tenant__c.User__c.
+     * Insert: all records with User__c set.
+     * Update: records where User__c was set or changed to a non-null value.
+     */
+    public static void assignTenantMaintenanceAccess(List<Tenant__c> newList, Map<Id, Tenant__c> oldMap) {
+        Set<Id> userIds = new Set<Id>();
+        for (Tenant__c t : newList) {
+            if (t.User__c == null) {
+                continue;
+            }
+            if (oldMap == null) {
+                userIds.add(t.User__c);
+            } else {
+                Tenant__c oldRec = oldMap.get(t.Id);
+                if (oldRec == null || oldRec.User__c != t.User__c) {
+                    userIds.add(t.User__c);
+                }
+            }
+        }
+        if (userIds.isEmpty()) {
+            return;
+        }
+        assignTenantMaintenanceAccessAsync(new List<Id>(userIds));
+    }
+
+    @future
+    private static void assignTenantMaintenanceAccessAsync(List<Id> userIdsList) {
+        Set<Id> userIds = new Set<Id>(userIdsList);
+        if (userIds.isEmpty()) {
+            return;
+        }
+        List<PermissionSet> permSets = [
+            SELECT Id
+            FROM PermissionSet
+            WHERE Name = :PERMISSION_SET_NAME
+            AND IsOwnedByProfile = false
+            LIMIT 1
+        ];
+        if (permSets.isEmpty()) {
+            return;
+        }
+        Id permSetId = permSets[0].Id;
+
+        Set<Id> alreadyAssigned = new Set<Id>();
+        for (PermissionSetAssignment psa : [
+            SELECT AssigneeId
+            FROM PermissionSetAssignment
+            WHERE PermissionSetId = :permSetId
+            AND AssigneeId IN :userIds
+        ]) {
+            alreadyAssigned.add(psa.AssigneeId);
+        }
+
+        List<PermissionSetAssignment> toInsert = new List<PermissionSetAssignment>();
+        for (Id uid : userIds) {
+            if (alreadyAssigned.contains(uid)) {
+                continue;
+            }
+            toInsert.add(new PermissionSetAssignment(
+                PermissionSetId = permSetId,
+                AssigneeId = uid
+            ));
+        }
+        if (!toInsert.isEmpty()) {
+            insert toInsert;
+        }
+    }
+}

package/src/force-app/main/default/classes/TenantTriggerHandler.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>66.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

package/src/force-app/main/default/classes/TenantTriggerHandler_Test.cls

@@ -0,0 +1,100 @@
+/**
+ * Test class for TenantTriggerHandler.
+ * Verifies that Tenant_Maintenance_Access permission set is assigned to the user
+ * when a Tenant__c record is created or updated with User__c set.
+ */
+@isTest
+private class TenantTriggerHandler_Test {
+
+    @isTest
+    static void testAssignOnInsert() {
+        Id runAsUserId = UserInfo.getUserId();
+        Tenant__c tenant = new Tenant__c(User__c = runAsUserId);
+
+        Test.startTest();
+        insert tenant;
+        Test.stopTest();
+
+        List<PermissionSet> permSets = [
+            SELECT Id FROM PermissionSet
+            WHERE Name = 'Tenant_Maintenance_Access'
+            AND IsOwnedByProfile = false
+            LIMIT 1
+        ];
+        if (!permSets.isEmpty()) {
+            List<PermissionSetAssignment> assignments = [
+                SELECT Id, AssigneeId, PermissionSetId
+                FROM PermissionSetAssignment
+                WHERE PermissionSetId = :permSets[0].Id
+                AND AssigneeId = :runAsUserId
+            ];
+            System.assert(assignments.size() == 1, 'Permission set should be assigned to user when Tenant is created with User__c');
+        }
+    }
+
+    @isTest
+    static void testAssignOnUpdateWhenUserSet() {
+        Tenant__c tenant = new Tenant__c();
+        insert tenant;
+
+        Id runAsUserId = UserInfo.getUserId();
+
+        Test.startTest();
+        tenant.User__c = runAsUserId;
+        update tenant;
+        Test.stopTest();
+
+        List<PermissionSet> permSets = [
+            SELECT Id FROM PermissionSet
+            WHERE Name = 'Tenant_Maintenance_Access'
+            AND IsOwnedByProfile = false
+            LIMIT 1
+        ];
+        if (!permSets.isEmpty()) {
+            List<PermissionSetAssignment> assignments = [
+                SELECT Id FROM PermissionSetAssignment
+                WHERE PermissionSetId = :permSets[0].Id
+                AND AssigneeId = :runAsUserId
+            ];
+            System.assert(assignments.size() == 1, 'Permission set should be assigned when User__c is set on update');
+        }
+    }
+
+    @isTest
+    static void testNoAssignWhenUserNull() {
+        Tenant__c tenant = new Tenant__c();
+        Test.startTest();
+        insert tenant;
+        Test.stopTest();
+        // Handler does not assign when User__c is null; trigger runs without error
+    }
+
+    @isTest
+    static void testNoDuplicateAssign() {
+        Id runAsUserId = UserInfo.getUserId();
+        Tenant__c tenant = new Tenant__c(User__c = runAsUserId);
+        Test.startTest();
+        insert tenant;
+        Test.stopTest();
+
+        Integer countBefore = [
+            SELECT COUNT()
+            FROM PermissionSetAssignment
+            WHERE AssigneeId = :runAsUserId
+            AND PermissionSet.Name = 'Tenant_Maintenance_Access'
+        ];
+
+        Test.startTest();
+        tenant.Status__c = 'Active';
+        update tenant;
+        Test.stopTest();
+
+        Integer countAfter = [
+            SELECT COUNT()
+            FROM PermissionSetAssignment
+            WHERE AssigneeId = :runAsUserId
+            AND PermissionSet.Name = 'Tenant_Maintenance_Access'
+        ];
+        System.assertEquals(countBefore, countAfter, 'Update without User__c change should not create duplicate assignment');
+    }
+}