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;
     

frontend/src/routes/login/+page.svelte

@@ -1,8 +1,9 @@
 <!-- [DEF:LoginPage:Component] -->
 <!--
+@TIER:      STANDARD
 @SEMANTICS: login, auth, ui, form
 @PURPOSE:   Provides the user interface for local and ADFS authentication.
-@LAYER:     Feature
+@LAYER:     UI
 @RELATION:  USES -> authStore
 @RELATION:  CALLS -> api.auth.login
 

frontend/src/routes/migration/+page.svelte

@@ -303,7 +303,7 @@
       />
     </div>
 
-    <!-- [DEF:DashboardSelectionSection] -->
+    <!-- [DEF:DashboardSelectionSection:Component] -->
     <div class="mb-8">
       <h2 class="text-lg font-medium mb-4">Select Dashboards</h2>
       
@@ -316,7 +316,7 @@
         <p class="text-gray-500 italic">Select a source environment to view dashboards.</p>
       {/if}
     </div>
-    <!-- [/DEF:DashboardSelectionSection] -->
+    <!-- [/DEF:DashboardSelectionSection:Component] -->
 
 
     <div class="flex items-center mb-4">

frontend/src/routes/tools/storage/+page.svelte

@@ -1,8 +1,9 @@
 <!-- [DEF:StoragePage:Component] -->
 <!--
+@TIER:      STANDARD
 @SEMANTICS: storage, files, management
 @PURPOSE:   Main page for file storage management.
-@LAYER:     Feature
+@LAYER:     UI
 @RELATION:  DEPENDS_ON -> storageService
 @RELATION:  CONTAINS -> FileList
 @RELATION:  CONTAINS -> FileUpload