# Copyright (c) 2025 Patrick Motsch # All rights reserved. """ Chatbot V2 Feature Container - Main Module. Handles feature initialization and RBAC catalog registration. Context-aware chat with file upload and extraction. """ import logging from typing import Dict, List, Any logger = logging.getLogger(__name__) # Feature metadata FEATURE_CODE = "chatbotv2" FEATURE_LABEL = {"en": "Chatbot V2", "de": "Chatbot V2", "fr": "Chatbot V2"} FEATURE_ICON = "mdi-robot-outline" # UI Objects for RBAC catalog - single "conversations" view (upload + chat in one page) UI_OBJECTS = [ { "objectKey": "ui.feature.chatbotv2.conversations", "label": {"en": "Conversations", "de": "Konversationen", "fr": "Conversations"}, "meta": {"area": "conversations"} }, ] # Resource Objects for RBAC catalog RESOURCE_OBJECTS = [ { "objectKey": "resource.feature.chatbotv2.upload", "label": {"en": "Upload Files", "de": "Dateien hochladen", "fr": "Télécharger fichiers"}, "meta": {"endpoint": "/api/chatbotv2/{instanceId}/upload", "method": "POST"} }, { "objectKey": "resource.feature.chatbotv2.startStream", "label": {"en": "Start Chat (Stream)", "de": "Chat starten (Stream)", "fr": "Démarrer chat (Stream)"}, "meta": {"endpoint": "/api/chatbotv2/{instanceId}/start/stream", "method": "POST"} }, { "objectKey": "resource.feature.chatbotv2.stop", "label": {"en": "Stop Chat", "de": "Chat stoppen", "fr": "Arrêter chat"}, "meta": {"endpoint": "/api/chatbotv2/{instanceId}/stop/{workflowId}", "method": "POST"} }, { "objectKey": "resource.feature.chatbotv2.threads", "label": {"en": "Get Threads", "de": "Threads abrufen", "fr": "Récupérer threads"}, "meta": {"endpoint": "/api/chatbotv2/{instanceId}/threads", "method": "GET"} }, { "objectKey": "resource.feature.chatbotv2.delete", "label": {"en": "Delete Chat", "de": "Chat löschen", "fr": "Supprimer chat"}, "meta": {"endpoint": "/api/chatbotv2/{instanceId}/conversations/{workflowId}", "method": "DELETE"} }, ] # Template roles for this feature TEMPLATE_ROLES = [ { "roleLabel": "chatbotv2-viewer", "description": { "en": "Chatbot V2 Viewer - View threads (read-only)", "de": "Chatbot V2 Betrachter - Threads ansehen (nur lesen)", "fr": "Visualiseur Chatbot V2 - Consulter les threads (lecture seule)" }, "accessRules": [ {"context": "UI", "item": "ui.feature.chatbotv2.conversations", "view": True}, {"context": "RESOURCE", "item": "resource.feature.chatbotv2.threads", "view": True}, {"context": "DATA", "item": None, "view": True, "read": "m", "create": "n", "update": "n", "delete": "n"}, ] }, { "roleLabel": "chatbotv2-user", "description": { "en": "Chatbot V2 User - Upload, extract, and chat with own threads", "de": "Chatbot V2 Benutzer - Hochladen, extrahieren und chatten mit eigenen Threads", "fr": "Utilisateur Chatbot V2 - Upload, extraction et chat avec ses threads" }, "accessRules": [ {"context": "UI", "item": "ui.feature.chatbotv2.conversations", "view": True}, {"context": "RESOURCE", "item": "resource.feature.chatbotv2.upload", "view": True}, {"context": "RESOURCE", "item": "resource.feature.chatbotv2.startStream", "view": True}, {"context": "RESOURCE", "item": "resource.feature.chatbotv2.stop", "view": True}, {"context": "RESOURCE", "item": "resource.feature.chatbotv2.threads", "view": True}, {"context": "RESOURCE", "item": "resource.feature.chatbotv2.delete", "view": True}, {"context": "DATA", "item": None, "view": True, "read": "m", "create": "m", "update": "m", "delete": "m"}, ] }, { "roleLabel": "chatbotv2-admin", "description": { "en": "Chatbot V2 Admin - Full access to all features", "de": "Chatbot V2 Admin - Vollzugriff auf alle Funktionen", "fr": "Administrateur Chatbot V2 - Accès complet" }, "accessRules": [ {"context": "UI", "item": None, "view": True}, {"context": "RESOURCE", "item": None, "view": True}, {"context": "DATA", "item": None, "view": True, "read": "a", "create": "a", "update": "a", "delete": "a"}, ] }, ] def getFeatureDefinition() -> Dict[str, Any]: """Return the feature definition for registration.""" return { "code": FEATURE_CODE, "label": FEATURE_LABEL, "icon": FEATURE_ICON, } def getUiObjects() -> List[Dict[str, Any]]: """Return UI objects for RBAC catalog registration.""" return UI_OBJECTS def getResourceObjects() -> List[Dict[str, Any]]: """Return resource objects for RBAC catalog registration.""" return RESOURCE_OBJECTS def getTemplateRoles() -> List[Dict[str, Any]]: """Return template roles for this feature.""" return TEMPLATE_ROLES def registerFeature(catalogService) -> bool: """ Register this feature's RBAC objects in the catalog. """ try: for uiObj in UI_OBJECTS: catalogService.registerUiObject( featureCode=FEATURE_CODE, objectKey=uiObj["objectKey"], label=uiObj["label"], meta=uiObj.get("meta") ) for resObj in RESOURCE_OBJECTS: catalogService.registerResourceObject( featureCode=FEATURE_CODE, objectKey=resObj["objectKey"], label=resObj["label"], meta=resObj.get("meta") ) _syncTemplateRolesToDb() logger.info(f"Feature '{FEATURE_CODE}' registered {len(UI_OBJECTS)} UI objects and {len(RESOURCE_OBJECTS)} resource objects") return True except Exception as e: logger.error(f"Failed to register feature '{FEATURE_CODE}': {e}") return False def _syncTemplateRolesToDb() -> int: """Sync template roles and their AccessRules to the database.""" try: from modules.interfaces.interfaceDbApp import getRootInterface from modules.datamodels.datamodelRbac import Role, AccessRule, AccessRuleContext rootInterface = getRootInterface() existingRoles = rootInterface.getRolesByFeatureCode(FEATURE_CODE) templateRoles = [r for r in existingRoles if r.mandateId is None] existingRoleLabels = {r.roleLabel: str(r.id) for r in templateRoles} createdCount = 0 for roleTemplate in TEMPLATE_ROLES: roleLabel = roleTemplate["roleLabel"] if roleLabel in existingRoleLabels: roleId = existingRoleLabels[roleLabel] _ensureAccessRulesForRole(rootInterface, roleId, roleTemplate.get("accessRules", [])) else: newRole = Role( roleLabel=roleLabel, description=roleTemplate.get("description", {}), featureCode=FEATURE_CODE, mandateId=None, featureInstanceId=None, isSystemRole=False ) createdRole = rootInterface.db.recordCreate(Role, newRole.model_dump()) roleId = createdRole.get("id") _ensureAccessRulesForRole(rootInterface, roleId, roleTemplate.get("accessRules", [])) logger.info(f"Created template role '{roleLabel}' with ID {roleId}") createdCount += 1 if createdCount > 0: logger.info(f"Feature '{FEATURE_CODE}': Created {createdCount} template roles") return createdCount except Exception as e: logger.error(f"Error syncing template roles for feature '{FEATURE_CODE}': {e}") return 0 def _ensureAccessRulesForRole(rootInterface, roleId: str, ruleTemplates: List[Dict[str, Any]]) -> int: """Ensure AccessRules exist for a role based on templates.""" from modules.datamodels.datamodelRbac import AccessRule, AccessRuleContext existingRules = rootInterface.getAccessRulesByRole(roleId) existingSignatures = set() for rule in existingRules: sig = (rule.context.value if rule.context else None, rule.item) existingSignatures.add(sig) createdCount = 0 for template in ruleTemplates: context = template.get("context", "UI") item = template.get("item") sig = (context, item) if sig in existingSignatures: continue if context == "UI": contextEnum = AccessRuleContext.UI elif context == "DATA": contextEnum = AccessRuleContext.DATA elif context == "RESOURCE": contextEnum = AccessRuleContext.RESOURCE else: contextEnum = context newRule = AccessRule( roleId=roleId, context=contextEnum, item=item, view=template.get("view", False), read=template.get("read"), create=template.get("create"), update=template.get("update"), delete=template.get("delete"), ) rootInterface.db.recordCreate(AccessRule, newRule.model_dump()) createdCount += 1 if createdCount > 0: logger.debug(f"Created {createdCount} AccessRules for role {roleId}") return createdCount