feat: modularized routing and configuration in frontend

Author: matbmoser

ichub-frontend/docs/CONFIGURATION_ARCHITECTURE.md

@@ -0,0 +1,137 @@
+# Configuration Architecture
+
+This document outlines the new modular configuration architecture for the Industry Core Hub Frontend.
+
+## Overview
+
+The configuration is now organized based on usage patterns:
+
+- **Shared Configuration**: Used by multiple features or the base application
+- **Feature-Specific Configuration**: Used by only one feature
+
+## Configuration Structure
+
+```
+src/
+├── config/                     # Shared configuration
+│   ├── index.ts               # Main config exports
+│   ├── types.ts               # Shared types and interfaces
+│   └── base.ts                # Base application configuration
+└── features/
+    ├── part-discovery/
+    │   └── config.ts          # Part discovery specific config
+    ├── catalog-management/
+    │   └── config.ts          # Catalog management specific config
+    ├── partner-management/
+    │   └── config.ts          # Partner management specific config
+    └── serialized-parts/
+        └── config.ts          # Serialized parts specific config
+```
+
+## Shared Configuration (`src/config/`)
+
+### Base Configuration (`base.ts`)
+- Application-wide settings
+- API base URL
+- Participant ID
+- Security configuration
+- Common utilities
+
+### Types (`types.ts`)
+- Shared interfaces and types
+- Re-exports from EnvironmentService
+- Base configuration interfaces
+
+## Feature-Specific Configuration
+
+Each feature module now contains its own `config.ts` file with:
+
+### API Configuration
+- Feature-specific endpoints
+- URL builders
+- Request/response configurations
+
+### Validation Rules
+- Form validation patterns
+- Business rules
+- Data constraints
+
+### UI Configuration
+- Table settings (page sizes, columns)
+- Form configurations
+- Component-specific settings
+
+### Feature-Specific Policies
+- Governance policies (Part Discovery)
+- DTR policies (Part Discovery)
+- Feature flags
+
+## Examples
+
+### Using Shared Configuration
+```typescript
+import { baseConfig, configUtils } from '../../config';
+
+// Get base API URL
+const apiUrl = baseConfig.apiUrl;
+
+// Build full URL
+const fullUrl = configUtils.buildApiUrl('/my-endpoint');
+
+// Check feature flag
+const isEnabled = configUtils.isFeatureEnabled('myFeature');
+```
+
+### Using Feature Configuration
+```typescript
+import { partDiscoveryConfig } from './config';
+
+// Get feature-specific endpoint
+const url = partDiscoveryConfig.api.buildUrl('CATALOG_PART_MANAGEMENT');
+
+// Get governance policies
+const policies = partDiscoveryConfig.governance.getDtrPoliciesConfig();
+
+// Get pagination settings
+const pageSize = partDiscoveryConfig.pagination.defaultPageSize;
+```
+
+## Migration Benefits
+
+1. **Modularity**: Each feature owns its configuration
+2. **Maintainability**: Easier to find and update feature-specific settings
+3. **Reusability**: Shared configuration prevents duplication
+4. **Type Safety**: Better TypeScript support with typed configurations
+5. **Performance**: Only load configuration needed by active features
+
+## Configuration Guidelines
+
+### When to Use Shared Configuration
+- Settings used by 2+ features
+- Application-wide defaults
+- Core infrastructure configuration
+- Common utilities and helpers
+
+### When to Use Feature Configuration
+- Settings specific to one feature
+- Feature-specific validation rules
+- Component-specific configurations
+- Feature flags and toggles
+
+### Adding New Configuration
+
+1. **For shared settings**: Add to `src/config/base.ts`
+2. **For feature settings**: Add to `src/features/{feature}/config.ts`
+3. **Update exports**: Ensure proper exports in index files
+4. **Document**: Update this file with new configuration options
+
+## Environment Variables
+
+Environment variables are still centralized in `EnvironmentService.ts` but are now consumed through the configuration modules:
+
+- `VITE_ICHUB_BACKEND_URL` → `baseConfig.apiUrl`
+- `VITE_PARTICIPANT_ID` → `baseConfig.participantId`
+- `VITE_GOVERNANCE_CONFIG` → `partDiscoveryConfig.governance`
+- Feature flags: `VITE_FEATURE_{NAME}_ENABLED`
+
+This approach maintains backward compatibility while providing a cleaner, more organized configuration architecture.

ichub-frontend/src/config/base.ts

@@ -0,0 +1,75 @@
+/********************************************************************************
+ * Eclipse Tractus-X - Industry Core Hub Frontend
+ *
+ * Copyright (c) 2025 Contributors to the Eclipse Foundation
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information regarding copyright ownership.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Apache License, Version 2.0 which is available at
+ * https://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the
+ * License for the specific language govern in permissions and limitations
+ * under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ ********************************************************************************/
+
+import { getIchubBackendUrl, getParticipantId } from '../services/EnvironmentService';
+import { BaseConfig, ApiEndpoints } from './types';
+
+/**
+ * Base application configuration used across all features
+ */
+export const baseConfig: BaseConfig = {
+  apiUrl: getIchubBackendUrl(),
+  participantId: getParticipantId(),
+};
+
+/**
+ * Shared API endpoints used by multiple features
+ */
+export const sharedApiEndpoints: ApiEndpoints = {
+  // Base paths used by multiple features
+  BASE_API: '/api/v1',
+  HEALTH: '/health',
+  AUTH: '/auth',
+};
+
+/**
+ * CORS and security configuration
+ */
+export const securityConfig = {
+  requireHttps: () => {
+    try {
+      return import.meta.env.VITE_REQUIRE_HTTPS_URL_PATTERN !== 'false';
+    } catch {
+      return true; // Default to secure
+    }
+  },
+};
+
+/**
+ * Common configuration utilities
+ */
+export const configUtils = {
+  /**
+   * Build full API URL
+   */
+  buildApiUrl: (endpoint: string): string => {
+    return `${baseConfig.apiUrl}${endpoint}`;
+  },
+
+  /**
+   * Check if feature is enabled
+   */
+  isFeatureEnabled: (feature: string): boolean => {
+    const envVar = `VITE_FEATURE_${feature.toUpperCase()}_ENABLED`;
+    return import.meta.env[envVar] !== 'false';
+  },
+};

ichub-frontend/src/config/index.ts

@@ -0,0 +1,28 @@
+/********************************************************************************
+ * Eclipse Tractus-X - Industry Core Hub Frontend
+ *
+ * Copyright (c) 2025 Contributors to the Eclipse Foundation
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information regarding copyright ownership.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Apache License, Version 2.0 which is available at
+ * https://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the
+ * License for the specific language govern in permissions and limitations
+ * under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ ********************************************************************************/
+
+// Export all configuration modules
+export * from './types';
+export * from './base';
+
+// Feature-specific configurations are exported from their respective features
+// e.g., import { catalogManagementConfig } from '../features/catalog-management';

ichub-frontend/src/config/types.ts

@@ -0,0 +1,41 @@
+/********************************************************************************
+ * Eclipse Tractus-X - Industry Core Hub Frontend
+ *
+ * Copyright (c) 2025 Contributors to the Eclipse Foundation
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information regarding copyright ownership.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Apache License, Version 2.0 which is available at
+ * https://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the
+ * License for the specific language govern in permissions and limitations
+ * under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ ********************************************************************************/
+
+/**
+ * Base configuration types and interfaces used across the application
+ */
+
+export interface BaseConfig {
+  apiUrl: string;
+  participantId: string;
+}
+
+export interface ApiEndpoints {
+  [key: string]: string;
+}
+
+export interface FeatureFlags {
+  [feature: string]: boolean;
+}
+
+// Re-export shared configuration types
+export * from '../services/EnvironmentService';

ichub-frontend/src/features/catalog-management/api.ts

@@ -24,14 +24,12 @@ import axios from 'axios';
 import { getIchubBackendUrl } from '../../services/EnvironmentService';
 import { ApiPartData } from '../../types/product';
 import { CatalogPartTwinCreateType, TwinReadType } from '../../types/twin';
+import { catalogManagementConfig } from './config';
 
-const CATALOG_PART_MANAGEMENT_BASE_PATH = '/part-management/catalog-part';
-const SHARE_CATALOG_PART_BASE_PATH = '/share/catalog-part';
-const TWIN_MANAGEMENT_BASE_PATH = '/twin-management/catalog-part-twin';
 const backendUrl = getIchubBackendUrl();
 
 export const fetchCatalogParts = async (): Promise<ApiPartData[]> => {
-  const response = await axios.get<ApiPartData[]>(`${backendUrl}${CATALOG_PART_MANAGEMENT_BASE_PATH}`);
+  const response = await axios.get<ApiPartData[]>(`${backendUrl}${catalogManagementConfig.api.endpoints.CATALOG_PARTS}`);
   return response.data;
 };
 
@@ -40,7 +38,7 @@ export const fetchCatalogPart = async (
   manufacturerPartId: string
 ): Promise<ApiPartData> => {
   const response = await axios.get<ApiPartData>(
-    `${backendUrl}${CATALOG_PART_MANAGEMENT_BASE_PATH}/${manufacturerId}/${manufacturerPartId}`
+    `${backendUrl}${catalogManagementConfig.api.endpoints.CATALOG_PARTS}/${manufacturerId}/${manufacturerPartId}`
   );
   return response.data;
 };
@@ -64,7 +62,7 @@ export const shareCatalogPart = async (
   };
 
   const response = await axios.post<ApiPartData>(
-    `${backendUrl}${SHARE_CATALOG_PART_BASE_PATH}`,
+    `${backendUrl}${catalogManagementConfig.api.endpoints.SHARE_CATALOG_PART}`,
     requestBody
   );
   return response.data;
@@ -74,7 +72,7 @@ export const registerCatalogPartTwin = async (
   twinData: CatalogPartTwinCreateType
 ): Promise<TwinReadType> => {
   const response = await axios.post<TwinReadType>(
-    `${backendUrl}${TWIN_MANAGEMENT_BASE_PATH}`,
+    `${backendUrl}${catalogManagementConfig.api.endpoints.TWIN_MANAGEMENT}`,
     twinData
   );
   return response.data;