Support api management

PR.md

@@ -0,0 +1,212 @@
+=== PR Body ===
+<!-- 
+🎉 Thank you for contributing to HiMarket!
+
+Please follow these guidelines:
+
+1️⃣ PR Title Format
+   - Format: type: description
+   - Example: feat: add product feature
+   - Description must start with lowercase letter or Chinese characters
+   - Chinese example: feat: 添加产品特性配置
+
+2️⃣ Description (Required)
+   - Describe your changes in detail
+   - At least 10 characters
+
+3️⃣ Type of Change (Required)
+   - Check at least one type
+
+4️⃣ Testing (Recommended)
+   - Describe how you tested these changes
+
+5️⃣ Related Issues (Recommended)
+   - Link issues using Fix #123 or Close #456
+
+📚 For Detailed Guidelines:
+- English: .github/PR_GUIDE.md
+- 中文: .github/PR_GUIDE_zh.md
+-->
+
+## 📝 Description
+
+<!-- 
+Required: Describe your changes in detail (at least 10 characters)
+Tip: You can use bullet points for clarity
+-->
+
+Support HiMarket autonomous API management capabilities:
+- Support creating APIs directly from HiMarket
+- Support managing APIs within HiMarket
+
+<!-- 
+Examples:
+- Refactored user authentication module to improve performance
+- Added caching mechanism for frequently accessed data
+- Fixed a bug where session timeout was not properly handled
+-->
+
+
+
+## 🔗 Related Issues
+
+<!-- 
+Optional but recommended: 
+Link related issues using keywords like "Fix", "Close", or "Resolve"
+-->
+
+<!-- 
+Examples:
+- Fix #123
+- Close #456, Resolve #789
+- Related to #100
+-->
+
+
+
+## ✅ Type of Change
+
+<!-- 
+Required: Check at least one type
+-->
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [x] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Code refactoring (no functional changes)
+- [ ] Performance improvement
+- [x] Build/CI configuration change
+- [ ] Other (please describe):
+
+
+
+## 🧪 Testing
+
+<!-- 
+Optional but recommended: 
+Describe how you tested these changes
+-->
+
+Verified local build and deployment.
+
+<!-- 
+Examples:
+- Ran all unit tests in local environment
+- Manually tested various scenarios of the new feature
+- Added new integration test cases
+-->
+
+- [ ] Unit tests added/updated
+- [ ] Integration tests added/updated
+- [x] Manual testing completed
+- [x] All tests pass locally
+
+
+
+## 📋 Checklist
+
+<!-- 
+Please check the items that apply to your PR
+-->
+
+- [ ] Code has been formatted (`mvn spotless:apply` for backend, `npm run lint:fix` for frontend)
+- [ ] Code is self-reviewed
+- [ ] Comments added for complex code
+- [ ] Documentation updated (if applicable)
+- [ ] No breaking changes (or migration guide provided)
+- [ ] All CI checks pass
+
+
+
+## 📊 Test Coverage
+
+<!-- 
+Optional: 
+If code was modified, does test coverage remain or improve?
+-->
+
+<!-- 
+Examples:
+- Added 15 new unit tests
+- Overall coverage increased from 65% to 68%
+- All critical paths are covered
+-->
+
+
+
+## 📚 Additional Notes
+
+<!-- 
+Optional: 
+Any additional information reviewers should know
+-->
+
+<!-- 
+Examples:
+- This change requires database migration
+- Performance testing shows 20% improvement
+- Breaking change: API endpoint path changed
+-->
+
+
+
+===============
+
+## 📋 PR Content Check Report
+
+### ❌ Required items need attention
+
+❌ Missing description or description too short (at least 10 characters required)
+   👉 Please provide a detailed description of your changes in the "Description" section.
+
+❌ No change type selected
+   👉 Please select at least one change type in the "Type of Change" section (Bug fix, New feature, etc.).
+
+### 💡 Suggestions (Optional)
+
+💡 Consider describing how you tested these changes
+
+### 📊 PR Size Check
+
+⚠️ **Large PR** (18469 lines): Consider splitting into smaller PRs for easier review.
+
+---
+
+### 📝 PR Content Requirements
+
+**Required:**
+- **Description**: Clear explanation of your changes (at least 10 characters)
+- **Type of Change**: Check at least one change type
+
+**Optional but recommended:**
+- **Related Issues**: Link issues using `Fix #123`, `Close #456`, etc.
+- **Testing**: Describe how you tested these changes
+- **Checklist**: Check other relevant items (code formatting, self-review, tests, etc.)
+
+**Example format:**
+```markdown
+## 📝 Description
+
+- Refactored client initialization method
+- Optimized parameter handling logic
+
+## 🔗 Related Issues
+
+Fix #123
+
+## ✅ Type of Change
+
+- [x] Bug fix (non-breaking change)
+- [ ] New feature (non-breaking change)
+
+## 🧪 Testing
+
+- [x] Manual testing completed
+- [x] All tests pass locally
+```
+
+Error: Missing description or description too short (at least 10 characters required)
+Error: No change type selected
+Warning: Consider describing how you tested these changes
+Error: PR content check failed: 2 required item(s) incomplete

himarket-bootstrap/src/main/java/com/alibaba/himarket/HiMarketApplication.java

@@ -27,7 +27,7 @@
 @EnableJpaAuditing
 public class HiMarketApplication {
 
-    public static void main(String[] args) {
+public static void main(String[] args) {
         SpringApplication.run(HiMarketApplication.class, args);
     }
 }

himarket-bootstrap/src/main/resources/db/migration/V6__Add_api_lifecycle_tables.sql

@@ -0,0 +1,149 @@
+-- V6__Add_api_lifecycle_tables.sql
+-- Add API lifecycle management tables
+-- Description: Support for API Definition, Endpoint, Publish Record and History
+
+START TRANSACTION;
+
+-- ========================================
+-- API Definition table
+-- ========================================
+CREATE TABLE IF NOT EXISTS `api_definition` (
+    `id` bigint NOT NULL AUTO_INCREMENT,
+    `api_definition_id` varchar(64) NOT NULL COMMENT 'API Definition unique identifier',
+    `base_path` varchar(255) COMMENT 'API base path',
+    `name` varchar(255) NOT NULL COMMENT 'API name',
+    `description` text COMMENT 'API description',
+    `type` varchar(32) NOT NULL COMMENT 'API type: MCP_SERVER, REST_API, AGENT_API, MODEL_API',
+    `status` varchar(32) NOT NULL DEFAULT 'DRAFT' COMMENT 'Status: DRAFT, PUBLISHING, PUBLISHED, DEPRECATED, ARCHIVED',
+    `version` varchar(32) COMMENT 'API version',
+    `properties` json COMMENT 'API Properties (formerly extensions from PublishConfig)',
+    `metadata` json COMMENT 'Metadata (tags, documentation, etc.)',
+    `created_at` datetime(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+    `updated_at` datetime(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
+    `deleted_at` datetime(3) DEFAULT NULL,
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uk_api_definition_id` (`api_definition_id`),
+    KEY `idx_type` (`type`),
+    KEY `idx_status` (`status`),
+    KEY `idx_deleted_at` (`deleted_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='API Definition table';
+
+-- ========================================
+-- API Endpoint table
+-- ========================================
+CREATE TABLE IF NOT EXISTS `api_endpoint` (
+    `id` bigint NOT NULL AUTO_INCREMENT,
+    `endpoint_id` varchar(64) NOT NULL COMMENT 'Endpoint unique identifier',
+    `api_definition_id` varchar(64) NOT NULL COMMENT 'Associated API Definition ID',
+    `type` varchar(32) NOT NULL COMMENT 'Endpoint type: MCP_TOOL, REST_ROUTE, AGENT, MODEL',
+    `name` varchar(255) NOT NULL COMMENT 'Endpoint name',
+    `description` text COMMENT 'Endpoint description',
+    `sort_order` int DEFAULT 0 COMMENT 'Display order',
+    `config` json NOT NULL COMMENT 'Type-specific configuration',
+    `created_at` datetime(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+    `updated_at` datetime(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uk_endpoint_id` (`endpoint_id`),
+    KEY `idx_api_definition_id` (`api_definition_id`),
+    KEY `idx_type` (`type`),
+    CONSTRAINT `fk_endpoint_api_definition` FOREIGN KEY (`api_definition_id`) REFERENCES `api_definition` (`api_definition_id`) ON DELETE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='API Endpoint table';
+
+-- ========================================
+-- API Publish Record table
+-- ========================================
+CREATE TABLE IF NOT EXISTS `api_publish_record` (
+    `id` bigint NOT NULL AUTO_INCREMENT,
+    `record_id` varchar(64) NOT NULL COMMENT 'Record unique identifier',
+    `api_definition_id` varchar(64) NOT NULL COMMENT 'Associated API Definition ID',
+    `gateway_id` varchar(64) NOT NULL COMMENT 'Gateway ID',
+    `gateway_name` varchar(255) COMMENT 'Gateway name',
+    `gateway_type` varchar(32) NOT NULL COMMENT 'Gateway type',
+    `version` varchar(32) COMMENT 'Published API version',
+    `status` varchar(32) NOT NULL COMMENT 'Status: ACTIVE, INACTIVE, PUBLISHING, UNPUBLISHING, FAILED. Application enforces uniqueness for PUBLISHING/UNPUBLISHING per API+Gateway',
+    `action` varchar(32) COMMENT 'Action: PUBLISH, UNPUBLISH, UPDATE',
+    `publish_config` json COMMENT 'Publish configuration including serviceConfig, extensions, etc.',
+    `gateway_resource_config` varchar(255) COMMENT 'Gateway resource config',
+    `access_endpoint` varchar(512) COMMENT 'Access endpoint URL',
+    `error_message` text COMMENT 'Error message if failed',
+    `publish_note` text COMMENT 'Publish note',
+    `operator` varchar(64) COMMENT 'Operator user ID',
+    `snapshot` json COMMENT 'API Definition snapshot',
+    `published_at` datetime(3) COMMENT 'Published timestamp',
+    `last_sync_at` datetime(3) COMMENT 'Last synchronization timestamp',
+    `created_at` datetime(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+    `updated_at` datetime(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uk_record_id` (`record_id`),
+    KEY `idx_api_definition_id` (`api_definition_id`),
+    KEY `idx_gateway_id` (`gateway_id`),
+    KEY `idx_api_gateway_status` (`api_definition_id`, `gateway_id`, `status`),
+    CONSTRAINT `fk_publish_record_api_definition` FOREIGN KEY (`api_definition_id`) REFERENCES `api_definition` (`api_definition_id`) ON DELETE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='API Publish Record table';
+
+
+
+-- ========================================
+-- Add api_definition_ids column to product_ref table
+-- ========================================
+SET @dbname = DATABASE();
+SET @tablename = 'product_ref';
+SET @columnname = 'api_definition_id';
+SET @preparedStatement = (SELECT IF(
+  (
+    SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS
+    WHERE
+      (TABLE_SCHEMA = @dbname)
+      AND (TABLE_NAME = @tablename)
+      AND (COLUMN_NAME = @columnname)
+  ) > 0,
+  'SELECT 1',
+  'ALTER TABLE `product_ref` ADD COLUMN `api_definition_id` varchar(64) COMMENT ''Associated API Definition ID (for MANAGED API)'''
+));
+PREPARE alterIfNotExists FROM @preparedStatement;
+EXECUTE alterIfNotExists;
+DEALLOCATE PREPARE alterIfNotExists;
+
+-- ========================================
+-- Add sofa_higress_config column to gateway table
+-- ========================================
+SET @dbname = DATABASE();
+SET @tablename = 'gateway';
+SET @columnname = 'sofa_higress_config';
+SET @preparedStatement = (SELECT IF(
+  (
+    SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS
+    WHERE
+      (TABLE_SCHEMA = @dbname)
+      AND (TABLE_NAME = @tablename)
+      AND (COLUMN_NAME = @columnname)
+  ) > 0,
+  'SELECT 1',
+  'ALTER TABLE `gateway` ADD COLUMN `sofa_higress_config` json DEFAULT NULL'
+));
+PREPARE alterIfNotExists FROM @preparedStatement;
+EXECUTE alterIfNotExists;
+DEALLOCATE PREPARE alterIfNotExists;
+
+-- ========================================
+-- Add sofa_higress_ref_config column to product_ref table
+-- ========================================
+SET @dbname = DATABASE();
+SET @tablename = 'product_ref';
+SET @columnname = 'sofa_higress_ref_config';
+SET @preparedStatement = (SELECT IF(
+  (
+    SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS
+    WHERE
+      (TABLE_SCHEMA = @dbname)
+      AND (TABLE_NAME = @tablename)
+      AND (COLUMN_NAME = @columnname)
+  ) > 0,
+  'SELECT 1',
+  'ALTER TABLE `product_ref` ADD COLUMN `sofa_higress_ref_config` json DEFAULT NULL'
+));
+PREPARE alterIfNotExists FROM @preparedStatement;
+EXECUTE alterIfNotExists;
+DEALLOCATE PREPARE alterIfNotExists;
+
+COMMIT;