feat(project): merge to develop for release QA

.cursor/rules/generate-new-api-clients.mdc

@@ -0,0 +1,140 @@
+---
+description: 
+globs: 
+alwaysApply: false
+---
+
+
+## Directory Structure
+```
+api-clients/
+├── _common/
+│   ├── composables/
+│   │   └── use-api-query-key.ts
+│   └── schema/
+│       ├── api-verbs/
+│       └── model.ts
+└── {service-name}/
+    ├── {resource}/
+    │   ├── composables/
+    │   │   └── use-{resource}-api.ts
+    │   └── schema/
+    │       ├── api-verbs/
+    │       │   ├── {verb}.ts
+    │       └── model.ts
+    └── index.ts
+```
+
+## API Client Composable Template
+```typescript
+// use-{resource}-api.ts template
+import { SpaceConnector } from '@cloudforet/core-lib/space-connector';
+
+import { useAPIQueryKey } from '@/api-clients/_common/composables/use-api-query-key';
+import type { ListResponse } from '@/api-clients/_common/schema/api-verbs/list';
+import type { {Resource}CreateParameters } from '@/api-clients/{service}/{resource}/schema/api-verbs/create';
+import type { {Resource}Model } from '@/api-clients/{service}/{resource}/schema/model';
+
+export const use{Resource}Api = () => {
+    // Define API actions
+    const actions = {
+        create: SpaceConnector.clientV2.{service}.{resource}.create<{Resource}CreateParameters, {Resource}Model>,
+        list: SpaceConnector.clientV2.{service}.{resource}.list<{Resource}ListParameters, ListResponse<{Resource}Model>>,
+        // ... other actions
+    };
+
+    return {
+        {resource}QueryKey,
+        {resource}ListQueryKey,
+        {resource}API: actions,
+    };
+};
+```
+
+## Schema Templates
+
+### Model Definition
+```typescript
+// model.ts template
+export interface {Resource}Model {
+    // Define resource properties
+    resource_id: string;
+    name: string;
+    // ... other properties
+}
+```
+
+### API Verb Parameters
+```typescript
+// create.ts template
+export interface {Resource}CreateParameters {
+    // Define create operation parameters
+    name: string;
+    // ... other parameters
+}
+
+// list.ts template
+export interface {Resource}ListParameters {
+    query?: {
+        filter?: Array<{
+            k: string;
+            v: any;
+            o: string;
+        }>;
+        // ... other query parameters
+    };
+}
+```
+
+## Usage Rules
+
+1. **Naming Conventions**
+   - Use PascalCase for interface names: `{Resource}Model`, `{Resource}{Verb}Parameters`
+   - Use camelCase for variables and functions: `use{Resource}Api`
+   - Follow existing naming patterns in the codebase
+
+2. **Type Safety**
+   - Always define proper TypeScript interfaces for all parameters and responses
+   - Use generics with SpaceConnector client methods
+   - Define all possible API parameters in schema files
+
+3. **Query Key Management**
+   - Use `useAPIQueryKey` for generating consistent query keys
+   - Create separate query keys for different operations
+   - Include contextual information in query keys when needed
+
+4. **Code Organization**
+   - Keep schema definitions separate from API logic
+   - Group related files in appropriate directories
+   - Follow the established directory structure
+
+5. **Documentation**
+   - Add JSDoc comments for public interfaces and functions
+   - Document any special behaviors or requirements
+   - Include examples for complex parameter structures
+
+## Example Usage in Components
+```typescript
+const { {resource}API } = use{Resource}Api();
+
+const { key, params } = useServiceKey(service, resource, verb, {
+  params: ...
+})
+
+// In composables
+const query = useScopedQuery({
+    queryKey: {resource}QueryKey.value,
+    queryFn: () => {resource}API.{verb}(params.value),
+    // ... other options
+}, ['WORKSPACE', 'ADMIN']);
+```
+
+## Notes
+- Always check existing API clients for consistent patterns
+- Consider reusability and maintainability
+- Follow the service's API documentation for accurate parameter definitions
+- Use appropriate error handling and loading states
+- Consider implementing proper caching strategies 
+- Add comments only when it is really complex. (English only)
+
+

.gitignore

@@ -13,6 +13,10 @@ node_modules.nosync/
 *.swp
 *.bak
 
+## Cursor rules : Ignore all files in .cursor directory except specific file (rules)
+.cursor/*
+!.cursor/generate-new-api-clients.mdc
+
 # Turborepo
 .turbo
 out/

apps/web/src/api-clients/_common/constants/api-doc-constant.ts

@@ -376,6 +376,11 @@ export const API_DOC = {
             'list',
         ],
     },
+    inventory: {
+        'metric-data': [
+            'analyze',
+        ],
+    },
     opsflow: {
         comment: [
             'create',

apps/web/src/api-clients/cost-analysis/cost-report-config/composables/use-cost-report-config-api.ts

@@ -0,0 +1,29 @@
+import { SpaceConnector } from '@cloudforet/core-lib/space-connector';
+
+import type { ListResponse } from '@/api-clients/_common/schema/api-verbs/list';
+import type { CostReportConfigListParameters } from '@/api-clients/cost-analysis/cost-report-config/schema/api-verbs/list';
+import type { CostReportConfigUpdateParameters } from '@/api-clients/cost-analysis/cost-report-config/schema/api-verbs/update';
+import type { CostReportConfigModel } from '@/api-clients/cost-analysis/cost-report-config/schema/model';
+
+
+interface UseCostReportConfigApiReturn {
+    costReportConfigAPI: {
+        update: (params: CostReportConfigUpdateParameters) => Promise<CostReportConfigModel>;
+        list: (params: CostReportConfigListParameters) => Promise<ListResponse<CostReportConfigModel>>;
+    }
+}
+
+export const useCostReportConfigApi = (): UseCostReportConfigApiReturn => {
+    const actions = {
+        async update(params: CostReportConfigUpdateParameters) {
+            return SpaceConnector.clientV2.costAnalysis.costReportConfig.update<CostReportConfigUpdateParameters, CostReportConfigModel>(params);
+        },
+        async list(params: CostReportConfigListParameters) {
+            return SpaceConnector.clientV2.costAnalysis.costReportConfig.list<CostReportConfigListParameters, ListResponse<CostReportConfigModel>>(params);
+        },
+    };
+
+    return {
+        costReportConfigAPI: actions,
+    };
+};

apps/web/src/api-clients/cost-analysis/data-source/composables/use-data-source-api.ts

@@ -0,0 +1,38 @@
+import { SpaceConnector } from '@cloudforet/core-lib/space-connector';
+
+import type { ListResponse } from '@/api-clients/_common/schema/api-verbs/list';
+import type { CostDataSourceGetParameters } from '@/api-clients/cost-analysis/data-source/schema/api-verbs/get';
+import type { CostDataSourceListParameters } from '@/api-clients/cost-analysis/data-source/schema/api-verbs/list';
+import type { CostDataSourceSyncParameters } from '@/api-clients/cost-analysis/data-source/schema/api-verbs/sync';
+import type { CostDataSourceUpdatePermissionsParameters } from '@/api-clients/cost-analysis/data-source/schema/api-verbs/update-permissions';
+import type { CostDataSourceModel } from '@/api-clients/cost-analysis/data-source/schema/model';
+
+interface UseDataSourceApiReturn {
+    dataSourceAPI: {
+        get: (params: CostDataSourceGetParameters) => Promise<CostDataSourceModel>;
+        list: (params: CostDataSourceListParameters) => Promise<ListResponse<CostDataSourceModel>>;
+        sync: (params: CostDataSourceSyncParameters) => Promise<void>;
+        updatePermissions: (params: CostDataSourceUpdatePermissionsParameters) => Promise<CostDataSourceModel>;
+    }
+}
+
+export const useDataSourceApi = (): UseDataSourceApiReturn => {
+    const actions = {
+        async get(params: CostDataSourceGetParameters) {
+            return SpaceConnector.clientV2.costAnalysis.dataSource.get<CostDataSourceGetParameters, CostDataSourceModel>(params);
+        },
+        async list(params: CostDataSourceListParameters) {
+            return SpaceConnector.clientV2.costAnalysis.dataSource.list<CostDataSourceListParameters, ListResponse<CostDataSourceModel>>(params);
+        },
+        async sync(params: CostDataSourceSyncParameters) {
+            return SpaceConnector.clientV2.costAnalysis.dataSource.sync<CostDataSourceSyncParameters>(params);
+        },
+        async updatePermissions(params: CostDataSourceUpdatePermissionsParameters) {
+            return SpaceConnector.clientV2.costAnalysis.dataSource.updatePermissions<CostDataSourceUpdatePermissionsParameters, CostDataSourceModel>(params);
+        },
+    };
+
+    return {
+        dataSourceAPI: actions,
+    };
+};

apps/web/src/api-clients/cost-analysis/unified-cost/composables/use-unified-cost-api.ts

@@ -0,0 +1,20 @@
+import { SpaceConnector } from '@cloudforet/core-lib/space-connector';
+
+import type { AnalyzeResponse } from '@/api-clients/_common/schema/api-verbs/analyze';
+import type { ListResponse } from '@/api-clients/_common/schema/api-verbs/list';
+import type { UnifiedCostAnalyzeParameters } from '@/api-clients/cost-analysis/unified-cost/schema/api-verbs/analyze';
+import type { UnifiedCostListParameters } from '@/api-clients/cost-analysis/unified-cost/schema/api-verbs/list';
+import type { UnifiedCostStatParameters } from '@/api-clients/cost-analysis/unified-cost/schema/api-verbs/stat';
+import type { UnifiedCostModel } from '@/api-clients/cost-analysis/unified-cost/schema/model';
+
+export const useUnifiedCostApi = () => {
+    const actions = {
+        analyze: SpaceConnector.clientV2.costAnalysis.unifiedCost.analyze<UnifiedCostAnalyzeParameters, AnalyzeResponse<any>>,
+        list: SpaceConnector.clientV2.costAnalysis.unifiedCost.list<UnifiedCostListParameters, ListResponse<UnifiedCostModel>>,
+        stat: SpaceConnector.clientV2.costAnalysis.unifiedCost.stat<UnifiedCostStatParameters, any>,
+    };
+
+    return {
+        unifiedCostAPI: actions,
+    };
+};

apps/web/src/api-clients/dashboard/_types/dashboard-global-variable-type.ts

@@ -1,6 +1,4 @@
 // Base Model
-import type { GLOBAL_VARIABLE_FILTER_TYPE_MAP } from '@/services/dashboards/constants/dashboard-global-variable';
-
 interface DashboardGlobalVariableBase {
     key: string; // new_variable
     name: string; // New Variable
@@ -79,4 +77,3 @@ export type DashboardGlobalVariable =
 
 
 
-export type GlobalVariableFilterType = keyof typeof GLOBAL_VARIABLE_FILTER_TYPE_MAP;

apps/web/src/api-clients/dashboard/_types/dashboard-type.ts

@@ -13,23 +13,27 @@ import type { PrivateDashboardGetParameters } from '@/api-clients/dashboard/priv
 import type { PrivateDashboardListParameters } from '@/api-clients/dashboard/private-dashboard/schema/api-verbs/list';
 import type { PrivateDashboardUpdateParameters } from '@/api-clients/dashboard/private-dashboard/schema/api-verbs/update';
 import type { PrivateDashboardModel } from '@/api-clients/dashboard/private-dashboard/schema/model';
+import type { PrivateFolderModel } from '@/api-clients/dashboard/private-folder/schema/model';
 import type { PublicDashboardChangeFolderParameters } from '@/api-clients/dashboard/public-dashboard/schema/api-verbs/change-folder';
 import type { PublicDashboardCreateParameters } from '@/api-clients/dashboard/public-dashboard/schema/api-verbs/create';
 import type { PublicDashboardDeleteParameters } from '@/api-clients/dashboard/public-dashboard/schema/api-verbs/delete';
 import type { PublicDashboardGetParameters } from '@/api-clients/dashboard/public-dashboard/schema/api-verbs/get';
 import type { PublicDashboardListParameters } from '@/api-clients/dashboard/public-dashboard/schema/api-verbs/list';
 import type { PublicDashboardUpdateParameters } from '@/api-clients/dashboard/public-dashboard/schema/api-verbs/update';
 import type { PublicDashboardModel } from '@/api-clients/dashboard/public-dashboard/schema/model';
+import type { PublicFolderModel } from '@/api-clients/dashboard/public-folder/schema/model';
 
 import type { VariableModelType } from '@/lib/variable-models';
 import type { Value } from '@/lib/variable-models/_base/types';
 
+
 export type DashboardType = typeof DASHBOARD_TYPE[keyof typeof DASHBOARD_TYPE];
 export type DashboardFolderType = 'PUBLIC'|'PRIVATE';
 
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
 // @ts-ignore
 export type DashboardModel = PublicDashboardModel | PrivateDashboardModel;
+export type DashboardFolderModel = PublicFolderModel | PrivateFolderModel;
 export type DashboardCreateParams = PublicDashboardCreateParameters | PrivateDashboardCreateParameters;
 export type DashboardChangeFolderParams = PublicDashboardChangeFolderParameters | PrivateDashboardChangeFolderParameters;
 export type DashboardListParams = PublicDashboardListParameters | PrivateDashboardListParameters;

apps/web/src/api-clients/dashboard/private-dashboard/composables/use-private-dashboard-api.ts

@@ -9,37 +9,15 @@ import type { PrivateDashboardListParameters } from '@/api-clients/dashboard/pri
 import type { PrivateDashboardUpdateParameters } from '@/api-clients/dashboard/private-dashboard/schema/api-verbs/update';
 import type { PrivateDashboardModel } from '@/api-clients/dashboard/private-dashboard/schema/model';
 
-interface UsePrivateDashboardApiReturn {
-    privateDashboardAPI: {
-        create: (params: PrivateDashboardCreateParameters) => Promise<PrivateDashboardModel>;
-        update: (params: PrivateDashboardUpdateParameters) => Promise<PrivateDashboardModel>;
-        changeFolder: (params: PrivateDashboardChangeFolderParameters) => Promise<PrivateDashboardModel>;
-        delete: (params: PrivateDashboardDeleteParameters) => Promise<void>;
-        get: (params: PrivateDashboardGetParameters) => Promise<PrivateDashboardModel>;
-        list: (params: PrivateDashboardListParameters) => Promise<ListResponse<PrivateDashboardModel>>;
-    }
-}
 
-export const usePrivateDashboardApi = (): UsePrivateDashboardApiReturn => {
+export const usePrivateDashboardApi = () => {
     const actions = {
-        async create(params: PrivateDashboardCreateParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDashboard.create<PrivateDashboardCreateParameters, PrivateDashboardModel>(params);
-        },
-        async update(params: PrivateDashboardUpdateParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDashboard.update<PrivateDashboardUpdateParameters, PrivateDashboardModel>(params);
-        },
-        async changeFolder(params: PrivateDashboardChangeFolderParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDashboard.changeFolder<PrivateDashboardChangeFolderParameters, PrivateDashboardModel>(params);
-        },
-        async delete(params: PrivateDashboardDeleteParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDashboard.delete<PrivateDashboardDeleteParameters>(params);
-        },
-        async get(params: PrivateDashboardGetParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDashboard.get<PrivateDashboardGetParameters, PrivateDashboardModel>(params);
-        },
-        async list(params: PrivateDashboardListParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDashboard.list<PrivateDashboardListParameters, ListResponse<PrivateDashboardModel>>(params);
-        },
+        create: SpaceConnector.clientV2.dashboard.privateDashboard.create<PrivateDashboardCreateParameters, PrivateDashboardModel>,
+        update: SpaceConnector.clientV2.dashboard.privateDashboard.update<PrivateDashboardUpdateParameters, PrivateDashboardModel>,
+        changeFolder: SpaceConnector.clientV2.dashboard.privateDashboard.changeFolder<PrivateDashboardChangeFolderParameters, PrivateDashboardModel>,
+        delete: SpaceConnector.clientV2.dashboard.privateDashboard.delete<PrivateDashboardDeleteParameters>,
+        get: SpaceConnector.clientV2.dashboard.privateDashboard.get<PrivateDashboardGetParameters, PrivateDashboardModel>,
+        list: SpaceConnector.clientV2.dashboard.privateDashboard.list<PrivateDashboardListParameters, ListResponse<PrivateDashboardModel>>,
     };
 
     return {

apps/web/src/api-clients/dashboard/private-dashboard/schema/api-verbs/list.ts

@@ -5,4 +5,5 @@ export interface PrivateDashboardListParameters {
     query?: Query;
     dashboard_id?: string;
     name?: string;
+    folder_id?: string;
 }

apps/web/src/api-clients/dashboard/private-data-table/composables/use-private-data-table-api.ts

@@ -11,41 +11,15 @@ import type { DataTableLoadParameters } from '@/api-clients/dashboard/public-dat
 import type { DataTableTransformParameters } from '@/api-clients/dashboard/public-data-table/schema/api-verbs/transform';
 import type { DataTableUpdateParameters } from '@/api-clients/dashboard/public-data-table/schema/api-verbs/update';
 
-interface UsePrivateDataTableApiReturn {
-    privateDataTableAPI: {
-        add: (params: DataTableAddParameters) => Promise<PrivateDataTableModel>;
-        transform: (params: DataTableTransformParameters) => Promise<PrivateDataTableModel>;
-        update: (params: DataTableUpdateParameters) => Promise<PrivateDataTableModel>;
-        delete: (params: DataTableDeleteParameters) => Promise<void>;
-        load: (params: DataTableLoadParameters) => Promise<DataTableLoadResponse>;
-        get: (params: DataTableGetParameters) => Promise<PrivateDataTableModel>;
-        list: (params: DataTableListParameters) => Promise<ListResponse<PrivateDataTableModel>>;
-    }
-}
-
-export const usePrivateDataTableApi = (): UsePrivateDataTableApiReturn => {
+export const usePrivateDataTableApi = () => {
     const action = {
-        async add(params: DataTableAddParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDataTable.add<DataTableAddParameters, PrivateDataTableModel>(params);
-        },
-        async transform(params: DataTableTransformParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDataTable.transform<DataTableTransformParameters, PrivateDataTableModel>(params);
-        },
-        async update(params: DataTableUpdateParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDataTable.update<DataTableUpdateParameters, PrivateDataTableModel>(params);
-        },
-        async delete(params: DataTableDeleteParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDataTable.delete<DataTableDeleteParameters>(params);
-        },
-        async load(params: DataTableLoadParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDataTable.load<DataTableLoadParameters, DataTableLoadResponse>(params);
-        },
-        async get(params: DataTableGetParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDataTable.get<DataTableGetParameters, PrivateDataTableModel>(params);
-        },
-        async list(params: DataTableListParameters) {
-            return SpaceConnector.clientV2.dashboard.privateDataTable.list<DataTableListParameters, ListResponse<PrivateDataTableModel>>(params);
-        },
+        add: SpaceConnector.clientV2.dashboard.privateDataTable.add<DataTableAddParameters, PrivateDataTableModel>,
+        transform: SpaceConnector.clientV2.dashboard.privateDataTable.transform<DataTableTransformParameters, PrivateDataTableModel>,
+        update: SpaceConnector.clientV2.dashboard.privateDataTable.update<DataTableUpdateParameters, PrivateDataTableModel>,
+        delete: SpaceConnector.clientV2.dashboard.privateDataTable.delete<DataTableDeleteParameters>,
+        load: SpaceConnector.clientV2.dashboard.privateDataTable.load<DataTableLoadParameters, DataTableLoadResponse>,
+        get: SpaceConnector.clientV2.dashboard.privateDataTable.get<DataTableGetParameters, PrivateDataTableModel>,
+        list: SpaceConnector.clientV2.dashboard.privateDataTable.list<DataTableListParameters, ListResponse<PrivateDataTableModel>>,
     };
 
     return {