refactor

backend/src/api/routes/dashboards.py

@@ -18,7 +18,7 @@ from ...dependencies import get_config_manager, get_task_manager, get_resource_s
 from ...core.logger import logger, belief_scope
 # [/SECTION]
 
-router = APIRouter()
+router = APIRouter(prefix="/api/dashboards", tags=["Dashboards"])
 
 # [DEF:GitStatus:DataClass]
 class GitStatus(BaseModel):
@@ -65,7 +65,7 @@ class DashboardsResponse(BaseModel):
 # @PARAM: page_size (Optional[int]) - Items per page (default: 10, max: 100)
 # @RETURN: DashboardsResponse - List of dashboards with status metadata
 # @RELATION: CALLS -> ResourceService.get_dashboards_with_status
-@router.get("/api/dashboards", response_model=DashboardsResponse)
+@router.get("", response_model=DashboardsResponse)
 async def get_dashboards(
     env_id: str,
     search: Optional[str] = None,
@@ -157,7 +157,7 @@ class TaskResponse(BaseModel):
 # @RETURN: TaskResponse - Task ID for tracking
 # @RELATION: DISPATCHES -> MigrationPlugin
 # @RELATION: CALLS -> task_manager.create_task
-@router.post("/api/dashboards/migrate", response_model=TaskResponse)
+@router.post("/migrate", response_model=TaskResponse)
 async def migrate_dashboards(
     request: MigrateRequest,
     config_manager=Depends(get_config_manager),
@@ -225,7 +225,7 @@ class BackupRequest(BaseModel):
 # @RETURN: TaskResponse - Task ID for tracking
 # @RELATION: DISPATCHES -> BackupPlugin
 # @RELATION: CALLS -> task_manager.create_task
-@router.post("/api/dashboards/backup", response_model=TaskResponse)
+@router.post("/backup", response_model=TaskResponse)
 async def backup_dashboards(
     request: BackupRequest,
     config_manager=Depends(get_config_manager),
@@ -289,7 +289,7 @@ class DatabaseMappingsResponse(BaseModel):
 # @PARAM: target_env_id (str) - Target environment ID
 # @RETURN: DatabaseMappingsResponse - List of suggested mappings
 # @RELATION: CALLS -> MappingService.get_suggestions
-@router.get("/api/dashboards/db-mappings", response_model=DatabaseMappingsResponse)
+@router.get("/db-mappings", response_model=DatabaseMappingsResponse)
 async def get_database_mappings(
     source_env_id: str,
     target_env_id: str,

backend/src/api/routes/datasets.py

@@ -19,7 +19,7 @@ from ...core.logger import logger, belief_scope
 from ...core.superset_client import SupersetClient
 # [/SECTION]
 
-router = APIRouter()
+router = APIRouter(prefix="/api/datasets", tags=["Datasets"])
 
 # [DEF:MappedFields:DataClass]
 class MappedFields(BaseModel):
@@ -63,8 +63,8 @@ class DatasetColumn(BaseModel):
 # [DEF:DatasetDetailResponse:DataClass]
 class DatasetDetailResponse(BaseModel):
     id: int
-    table_name: str
-    schema: str
+    table_name: Optional[str] = None
+    schema: Optional[str] = None
     database: str
     description: Optional[str] = None
     columns: List[DatasetColumn]
@@ -99,7 +99,7 @@ class TaskResponse(BaseModel):
 # @PARAM: search (Optional[str]) - Filter by table name
 # @RETURN: List[int] - List of dataset IDs
 # @RELATION: CALLS -> ResourceService.get_datasets_with_status
-@router.get("/api/datasets/ids")
+@router.get("/ids")
 async def get_dataset_ids(
     env_id: str,
     search: Optional[str] = None,
@@ -155,7 +155,7 @@ async def get_dataset_ids(
 # @PARAM: page_size (Optional[int]) - Items per page (default: 10, max: 100)
 # @RETURN: DatasetsResponse - List of datasets with status metadata
 # @RELATION: CALLS -> ResourceService.get_datasets_with_status
-@router.get("/api/datasets", response_model=DatasetsResponse)
+@router.get("", response_model=DatasetsResponse)
 async def get_datasets(
     env_id: str,
     search: Optional[str] = None,
@@ -241,7 +241,7 @@ class MapColumnsRequest(BaseModel):
 # @RETURN: TaskResponse - Task ID for tracking
 # @RELATION: DISPATCHES -> MapperPlugin
 # @RELATION: CALLS -> task_manager.create_task
-@router.post("/api/datasets/map-columns", response_model=TaskResponse)
+@router.post("/map-columns", response_model=TaskResponse)
 async def map_columns(
     request: MapColumnsRequest,
     config_manager=Depends(get_config_manager),
@@ -310,7 +310,7 @@ class GenerateDocsRequest(BaseModel):
 # @RETURN: TaskResponse - Task ID for tracking
 # @RELATION: DISPATCHES -> LLMAnalysisPlugin
 # @RELATION: CALLS -> task_manager.create_task
-@router.post("/api/datasets/generate-docs", response_model=TaskResponse)
+@router.post("/generate-docs", response_model=TaskResponse)
 async def generate_docs(
     request: GenerateDocsRequest,
     config_manager=Depends(get_config_manager),
@@ -363,7 +363,7 @@ async def generate_docs(
 # @PARAM: dataset_id (int) - The dataset ID
 # @RETURN: DatasetDetailResponse - Detailed dataset information
 # @RELATION: CALLS -> SupersetClient.get_dataset_detail
-@router.get("/api/datasets/{dataset_id}", response_model=DatasetDetailResponse)
+@router.get("/{dataset_id}", response_model=DatasetDetailResponse)
 async def get_dataset_detail(
     env_id: str,
     dataset_id: int,

backend/src/api/routes/environments.py

@@ -18,7 +18,7 @@ from pydantic import BaseModel, Field
 from ...core.logger import belief_scope
 # [/SECTION]
 
-router = APIRouter()
+router = APIRouter(prefix="/api/environments", tags=["Environments"])
 
 # [DEF:ScheduleSchema:DataClass]
 class ScheduleSchema(BaseModel):
@@ -43,6 +43,8 @@ class DatabaseResponse(BaseModel):
 
 # [DEF:get_environments:Function]
 # @PURPOSE: List all configured environments.
+# @LAYER: API
+# @SEMANTICS: list, environments, config
 # @PRE:     config_manager is injected via Depends.
 # @POST:    Returns a list of EnvironmentResponse objects.
 # @RETURN:  List[EnvironmentResponse]
@@ -71,6 +73,8 @@ async def get_environments(
 
 # [DEF:update_environment_schedule:Function]
 # @PURPOSE: Update backup schedule for an environment.
+# @LAYER: API
+# @SEMANTICS: update, schedule, backup, environment
 # @PRE:     Environment id exists, schedule is valid ScheduleSchema.
 # @POST:    Backup schedule updated and scheduler reloaded.
 # @PARAM:   id (str) - The environment ID.
@@ -103,6 +107,8 @@ async def update_environment_schedule(
 
 # [DEF:get_environment_databases:Function]
 # @PURPOSE: Fetch the list of databases from a specific environment.
+# @LAYER: API
+# @SEMANTICS: fetch, databases, superset, environment
 # @PRE:     Environment id exists.
 # @POST:    Returns a list of database summaries from the environment.
 # @PARAM:   id (str) - The environment ID.

backend/src/api/routes/git.py

@@ -26,7 +26,7 @@ from src.api.routes.git_schemas import (
 from src.services.git_service import GitService
 from src.core.logger import logger, belief_scope
 
-router = APIRouter(prefix="/api/git", tags=["git"])
+router = APIRouter(tags=["git"])
 git_service = GitService()
 
 # [DEF:get_git_configs:Function]

backend/src/api/routes/llm.py

@@ -16,7 +16,7 @@ from sqlalchemy.orm import Session
 
 # [DEF:router:Global]
 # @PURPOSE: APIRouter instance for LLM routes.
-router = APIRouter(prefix="/api/llm", tags=["LLM"])
+router = APIRouter(tags=["LLM"])
 # [/DEF:router:Global]
 
 # [DEF:get_providers:Function]

backend/src/api/routes/mappings.py

@@ -21,7 +21,7 @@ from ...models.mapping import DatabaseMapping
 from pydantic import BaseModel
 # [/SECTION]
 
-router = APIRouter(prefix="/api/mappings", tags=["mappings"])
+router = APIRouter(tags=["mappings"])
 
 # [DEF:MappingCreate:DataClass]
 class MappingCreate(BaseModel):

backend/src/api/routes/migration.py

@@ -44,7 +44,7 @@ async def get_dashboards(
 # @POST:    Starts the migration task and returns the task ID.
 # @PARAM:   selection (DashboardSelection) - The dashboards to migrate.
 # @RETURN:  Dict - {"task_id": str, "message": str}
-@router.post("/migration/execute")
+@router.post("/execute")
 async def execute_migration(
     selection: DashboardSelection,
     config_manager=Depends(get_config_manager),

backend/src/api/routes/settings.py

@@ -283,6 +283,7 @@ class ConsolidatedSettingsResponse(BaseModel):
     environments: List[dict]
     connections: List[dict]
     llm: dict
+    llm_providers: List[dict]
     logging: dict
     storage: dict
 # [/DEF:ConsolidatedSettingsResponse:Class]
@@ -302,13 +303,74 @@ async def get_consolidated_settings(
         
         config = config_manager.get_config()
         
+        from ...services.llm_provider import LLMProviderService
+        from ...core.database import SessionLocal
+        db = SessionLocal()
+        try:
+            llm_service = LLMProviderService(db)
+            providers = llm_service.get_all_providers()
+            llm_providers_list = [
+                {
+                    "id": p.id,
+                    "provider_type": p.provider_type,
+                    "name": p.name,
+                    "base_url": p.base_url,
+                    "api_key": "********",
+                    "default_model": p.default_model,
+                    "is_active": p.is_active
+                } for p in providers
+            ]
+        finally:
+            db.close()
+
         return ConsolidatedSettingsResponse(
             environments=[env.dict() for env in config.environments],
             connections=config.settings.connections,
             llm=config.settings.llm,
+            llm_providers=llm_providers_list,
             logging=config.settings.logging.dict(),
             storage=config.settings.storage.dict()
         )
 # [/DEF:get_consolidated_settings:Function]
 
+# [DEF:update_consolidated_settings:Function]
+# @PURPOSE: Bulk update application settings from the consolidated view.
+# @PRE:     User has admin permissions, config is valid.
+# @POST:    Settings are updated and saved via ConfigManager.
+@router.patch("/consolidated")
+async def update_consolidated_settings(
+    settings_patch: dict,
+    config_manager: ConfigManager = Depends(get_config_manager),
+    _ = Depends(has_permission("admin:settings", "WRITE"))
+):
+    with belief_scope("update_consolidated_settings"):
+        logger.info("[update_consolidated_settings][Entry] Applying consolidated settings patch")
+        
+        current_config = config_manager.get_config()
+        current_settings = current_config.settings
+        
+        # Update connections if provided
+        if "connections" in settings_patch:
+            current_settings.connections = settings_patch["connections"]
+            
+        # Update LLM if provided
+        if "llm" in settings_patch:
+            current_settings.llm = settings_patch["llm"]
+            
+        # Update Logging if provided
+        if "logging" in settings_patch:
+            current_settings.logging = LoggingConfig(**settings_patch["logging"])
+            
+        # Update Storage if provided
+        if "storage" in settings_patch:
+            new_storage = StorageConfig(**settings_patch["storage"])
+            is_valid, message = config_manager.validate_path(new_storage.root_path)
+            if not is_valid:
+                 raise HTTPException(status_code=400, detail=message)
+            current_settings.storage = new_storage
+
+        config_manager.update_global_settings(current_settings)
+        return {"status": "success", "message": "Settings updated"}
+# [/DEF:update_consolidated_settings:Function]
+
 # [/DEF:SettingsRouter:Module]