feat(release-20250423): merge to master

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

@@ -0,0 +1,138 @@
+---
+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 type { ListResponse } from '@/api-clients/_common/schema/api-verbs/list';
+import type { {Resource}{Verb}Parameters } from '@/api-clients/{service}/{resource}/schema/api-verbs/{verb}';
+import type { {Resource}{Verb = list}Parameters } from '@/api-clients/{service}/{resource}/schema/api-verbs/list';
+import type { {Resource}Model } from '@/api-clients/{service}/{resource}/schema/model';
+
+export const use{Resource}Api = () => {
+    // Define API actions
+    const actions = {
+        {verb}: SpaceConnector.clientV2.{service}.{resource}.{verb}<{Resource}{Verb}Parameters, {Resource}Model>,
+        {verb = list}: SpaceConnector.clientV2.{service}.{resource}.list<{Resource}ListParameters, ListResponse<{Resource}Model>>,
+        // ... other actions
+    };
+
+    return {
+        {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 example
+export interface {Resource}CreateParameters {
+    // Define create operation parameters
+    name: string;
+    // ... other parameters
+}
+
+// list.ts template example
+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 } = useServiceQueryKey(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/mirinae-storybook/mock/vue-router-composables.ts

@@ -0,0 +1,22 @@
+export const useRoute = () => ({
+    path: '',
+    hash: '',
+    query: {},
+    params: {},
+    fullPath: '',
+    matched: [],
+});
+
+export const useRouter = () => ({
+    resolve() {
+        return {
+            resolved: {
+                path: '/',
+                hash: '#',
+                matched: [],
+                name: '',
+                params: {},
+            },
+        };
+    },
+});

apps/mirinae-storybook/vite.config.js

@@ -12,6 +12,7 @@ export default defineConfig({
         alias: {
             '@': path.resolve(__dirname, '../../packages/mirinae/src'),
             'vue/dist/vue.esm': path.resolve(__dirname, '../../node_modules/vue/dist/vue.esm.js'),
+            'vue-router/composables': path.resolve(__dirname, './mock/vue-router-composables.ts'),
         },
     },
     optimizeDeps: {

apps/web/package.json

@@ -112,7 +112,7 @@
     "postcss-config-custom": "*",
     "rollup-plugin-visualizer": "^5.9.0",
     "tsconfig": "*",
-    "vite": "^4.5.11",
+    "vite": "^4.5.13",
     "vite-plugin-stylelint": "^3.3.3",
     "vite-plugin-vue-type-imports": "^0.2.4",
     "vitest": "^3.0.8",

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',
@@ -413,5 +418,11 @@ export const API_DOC = {
             'update',
         ],
     },
+    repository: {
+        'dashboard-template': [
+            'list',
+            'register',
+        ],
+    },
 } as const;
 export type APIDoc = typeof API_DOC;

apps/web/src/api-clients/cost-analysis/budget-usage/schema/api-verbs/analyze.ts

@@ -18,9 +18,9 @@ export interface BudgetUsageAnalyzeResult {
     project_id?: string;
     workspace_id?: string;
     data_source_id?: string;
-    provider_filter?: {
-        state?: string;
-        providers?: string[];
-    };
+    // provider_filter?: {
+    //     state?: string;
+    //     providers?: string[];
+    // };
     resource_group: Extract<ResourceGroupType, 'WORKSPACE' | 'PROJECT'>;
 }

apps/web/src/api-clients/cost-analysis/budget-usage/schema/api-verbs/list.ts

@@ -9,4 +9,5 @@ export interface BudgetUsageListParameters {
     data_source_id?: string;
     workspace_id?: string;
     project_id?: string;
+    service_account_id?: string;
 }

apps/web/src/api-clients/cost-analysis/budget-usage/schema/model.ts

@@ -3,10 +3,10 @@ import type { ResourceGroupType } from '@/api-clients/_common/schema/type';
 import type { Currency } from '@/store/display/type';
 
 
-interface ProviderFilter {
-    providers: string[];
-    state: 'ENABLED' | 'DISABLED';
-}
+// interface ProviderFilter {
+//     providers: string[];
+//     state: 'ENABLED' | 'DISABLED';
+// }
 
 export interface BudgetUsageModel {
     budget_id: string;
@@ -15,11 +15,11 @@ export interface BudgetUsageModel {
     cost: number;
     limit: number;
     currency: Currency;
-    provider_filter?: ProviderFilter;
     data_source_id: string;
     resource_group: Extract<ResourceGroupType, 'WORKSPACE'|'PROJECT'>;
     project_id: string;
     workspace_id: string;
+    service_account_id: string;
     domain_id: string;
     updated_at: string;
 }

apps/web/src/api-clients/cost-analysis/budget/schema/api-verbs/create.ts

@@ -1,21 +1,24 @@
 import type { Tags } from '@/api-clients/_common/schema/model';
 import type { ResourceGroupType } from '@/api-clients/_common/schema/type';
 import type {
-    BudgetNotification, BudgetPlannedLimit, BudgetTimeUnit, ProviderFilter,
+    BudgetNotification, BudgetPlannedLimit, BudgetTimeUnit,
 } from '@/api-clients/cost-analysis/budget/schema/type';
 
+import type { Currency } from '@/store/display/type';
+
 export interface BudgetCreateParameters {
-    data_source_id: string;
     name?: string;
     limit?: number;
     planned_limits?: BudgetPlannedLimit[];
-    provider_filter?: ProviderFilter;
+    currency: Currency;
     time_unit: BudgetTimeUnit;
     start: string;
     end: string;
-    notifications?: BudgetNotification[];
+    notification?: BudgetNotification;
     tags?: Tags;
     resource_group: Extract<ResourceGroupType, 'WORKSPACE'|'PROJECT'>;
     workspace_id?: string;
     project_id?: string;
+    service_account_id?: string;
+    budget_manager_id?: string;
 }

apps/web/src/api-clients/cost-analysis/budget/schema/api-verbs/set-notification.ts

@@ -2,5 +2,5 @@ import type { BudgetNotification } from '@/api-clients/cost-analysis/budget/sche
 
 export interface BudgetSetNotificationParameters {
     budget_id: string;
-    notifications: BudgetNotification[];
+    notification: BudgetNotification;
 }

apps/web/src/api-clients/cost-analysis/budget/schema/api-verbs/update.ts

@@ -6,5 +6,8 @@ export interface BudgetUpdateParameters {
     name?: string;
     limit?: number;
     planned_limits?: BudgetPlannedLimit[];
+    start?: string;
+    end?: string;
+    utilization_rate?: number;
     tags?: Tags;
 }