semantic update

frontend/src/routes/admin/roles/+page.svelte

@@ -1,8 +1,9 @@
 <!-- [DEF:AdminRolesPage:Component] -->
 <!--
+@TIER:      STANDARD
 @SEMANTICS: admin, role-management, rbac
 @PURPOSE:   UI for managing system roles and their permissions.
-@LAYER:     Feature
+@LAYER:     Domain
 @RELATION:  DEPENDS_ON -> frontend.src.services.adminService
 @RELATION:  DEPENDS_ON -> frontend.src.components.auth.ProtectedRoute
 
@@ -56,7 +57,13 @@
   // [/DEF:loadData:Function]
 
   // [DEF:openCreateModal:Function]
+  /**
+   * @purpose Initializes state for creating a new role.
+   * @pre     None.
+   * @post    showModal is true, roleForm is reset.
+   */
   function openCreateModal() {
+    console.log("[openCreateModal][Action] Opening create modal");
     isEditing = false;
     currentRoleId = null;
     roleForm = { name: '', description: '', permissions: [] };
@@ -65,7 +72,13 @@
   // [/DEF:openCreateModal:Function]
 
   // [DEF:openEditModal:Function]
+  /**
+   * @purpose Initializes state for editing an existing role.
+   * @pre     role object is provided.
+   * @post    showModal is true, roleForm is populated.
+   */
   function openEditModal(role) {
+    console.log(`[openEditModal][Action] Opening edit modal for role ${role.id}`);
     isEditing = true;
     currentRoleId = role.id;
     roleForm = {
@@ -80,6 +93,8 @@
   // [DEF:handleSaveRole:Function]
   /**
    * @purpose Submits role data (create or update).
+   * @pre     roleForm contains valid data.
+   * @post    Role is saved, modal closed, data reloaded.
    */
   async function handleSaveRole() {
     console.log('[AdminRolesPage][handleSaveRole][Entry]');
@@ -100,6 +115,11 @@
   // [/DEF:handleSaveRole:Function]
 
   // [DEF:handleDeleteRole:Function]
+  /**
+   * @purpose Deletes a role after confirmation.
+   * @pre     role object is provided.
+   * @post    Role is deleted if confirmed, data reloaded.
+   */
   async function handleDeleteRole(role) {
     if (!confirm($t.admin.roles.confirm_delete.replace('{name}', role.name))) return;