建立表字典sdk

config/subconfigs/configure_config.go

@@ -10,7 +10,7 @@ import (
 type ConfigureConfig struct {
 	core.BaseConfig
 	Url   string `yaml:"url" desc:"配置中心地址"`
-	token string `yaml:"token" desc:"访问配置中心的token"`
+	Token string `yaml:"token" desc:"访问配置中心的token"`
 }
 
 func (c *ConfigureConfig) Description() string {
@@ -22,8 +22,8 @@ func NewConfgigureConfig() *ConfigureConfig {
 }
 
 func (c *ConfigureConfig) SetDefaults() {
-	c.Url = "http://localhost:8000"
-	c.token = "123"
+	c.Url = "http://localhost:8080"
+	c.Token = "123"
 }
 
 func (c *ConfigureConfig) Load(data map[string]interface{}) error {

sdk/configure/client.go

@@ -0,0 +1,246 @@
+package configure
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"strings"
+	"time"
+
+	"git.x2erp.com/qdy/go-base/model/response"
+)
+
+// Client 配置中心客户端
+type Client struct {
+	config     ClientConfig
+	httpClient *http.Client
+}
+
+// ResponseWrapper 包装API响应
+type ResponseWrapper[T any] struct {
+	response.QueryResult[T]
+}
+
+// NewClient 创建新的配置中心客户端
+func NewClient() (*Client, error) {
+	config := DefaultConfig()
+	return NewClientWithConfig(config)
+}
+
+// NewClientWithConfig 使用自定义配置创建客户端
+func NewClientWithConfig(config ClientConfig) (*Client, error) {
+	// 验证配置
+	if err := config.Validate(); err != nil {
+		return nil, err
+	}
+
+	// 创建HTTP客户端
+	httpClient := &http.Client{
+		Timeout: config.HTTPTimeout,
+	}
+
+	return &Client{
+		config:     config,
+		httpClient: httpClient,
+	}, nil
+}
+
+// NewBasicAuthClient 创建使用Basic认证的客户端
+func NewBasicAuthClient(baseURL, username, password string) (*Client, error) {
+	config := ClientConfig{
+		BaseURL:     baseURL,
+		AuthType:    AuthTypeBasic,
+		Username:    username,
+		Password:    password,
+		HTTPTimeout: 30 * time.Second,
+	}
+
+	return NewClientWithConfig(config)
+}
+
+// NewTokenAuthClient 创建使用Token认证的客户端
+func NewTokenAuthClient(baseURL, token string) (*Client, error) {
+	config := ClientConfig{
+		BaseURL:     baseURL,
+		AuthType:    AuthTypeToken,
+		Token:       token,
+		HTTPTimeout: 30 * time.Second,
+	}
+
+	return NewClientWithConfig(config)
+}
+
+// ListTables 查询数据库表字典列表
+func (c *Client) ListTables(ctx context.Context, query *DicTableQueryRequest) (*DicTableList, error) {
+	endpoint := "/api/dic-table/list"
+
+	var result ResponseWrapper[[]DicTableDB]
+	if err := c.doRequest(ctx, http.MethodPost, endpoint, query, &result); err != nil {
+		return nil, err
+	}
+
+	if !result.Success {
+		return nil, NewClientError("list_tables", fmt.Sprintf("API error: %s", result.Error), nil)
+	}
+
+	return &DicTableList{
+		TotalCount: result.TotalCount,
+		LastPage:   result.LastPage,
+		Data:       result.Data,
+	}, nil
+}
+
+// GetTable 查询数据库表字典详情
+func (c *Client) GetTable(ctx context.Context, tableID string) (*DicTableDetail, error) {
+	endpoint := fmt.Sprintf("/api/dic-table/detail/%s", tableID)
+
+	var result ResponseWrapper[DicTableDetail]
+	if err := c.doRequest(ctx, http.MethodPost, endpoint, nil, &result); err != nil {
+		return nil, err
+	}
+
+	if !result.Success {
+		// 检查是否是"未找到"错误
+		if result.Error == "not found" ||
+			result.Error == "数据库表字典不存在" ||
+			result.Error == "查询数据库表字典主表失败: sql: no rows in result set" ||
+			result.Error == "查询数据库表字典主表失败: context canceled" {
+			return nil, ErrNotFound
+		}
+		// 检查是否是context取消错误
+		if result.Error == "查询数据库表字典主表失败: context canceled" ||
+			strings.Contains(result.Error, "context canceled") ||
+			strings.Contains(result.Error, "context deadline exceeded") {
+			return nil, WrapError("get_table", "context canceled", nil)
+		}
+		return nil, NewClientError("get_table", fmt.Sprintf("API error: %s", result.Error), nil)
+	}
+
+	return &result.Data, nil
+}
+
+// SaveTable 创建或更新数据库表字典
+func (c *Client) SaveTable(ctx context.Context, req *DicTableRequest) (*DicTableDetail, error) {
+	endpoint := "/api/dic-table/save"
+
+	var result ResponseWrapper[DicTableDetail]
+	if err := c.doRequest(ctx, http.MethodPost, endpoint, req, &result); err != nil {
+		return nil, err
+	}
+
+	if !result.Success {
+		return nil, NewClientError("save_table", fmt.Sprintf("API error: %s", result.Error), nil)
+	}
+
+	return &result.Data, nil
+}
+
+// DeleteTable 删除数据库表字典
+func (c *Client) DeleteTable(ctx context.Context, tableID string) error {
+	endpoint := fmt.Sprintf("/api/dic-table/delete/%s", tableID)
+
+	var result ResponseWrapper[int64]
+	if err := c.doRequest(ctx, http.MethodPost, endpoint, nil, &result); err != nil {
+		return err
+	}
+
+	if !result.Success {
+		return NewClientError("delete_table", fmt.Sprintf("API error: %s", result.Error), nil)
+	}
+
+	return nil
+}
+
+// doRequest 执行HTTP请求
+func (c *Client) doRequest(ctx context.Context, method, endpoint string, body interface{}, result interface{}) error {
+	// 构建URL
+	url := c.config.BaseURL + endpoint
+
+	// 准备请求体
+	var requestBody io.Reader
+	if body != nil {
+		jsonData, err := json.Marshal(body)
+		if err != nil {
+			return WrapError("do_request", "failed to marshal request body", err)
+		}
+		requestBody = bytes.NewBuffer(jsonData)
+	}
+
+	// 创建请求
+	req, err := http.NewRequestWithContext(ctx, method, url, requestBody)
+	if err != nil {
+		return WrapError("do_request", "failed to create request", err)
+	}
+
+	// 设置认证头
+	if err := c.setAuthHeader(req); err != nil {
+		return err
+	}
+
+	// 设置内容类型
+	// 对于POST、PUT、PATCH方法，即使body为nil也设置Content-Type
+	if body != nil || method == http.MethodPost || method == http.MethodPut || method == http.MethodPatch {
+		req.Header.Set("Content-Type", "application/json")
+	}
+
+	// 执行请求
+	resp, err := c.httpClient.Do(req)
+	if err != nil {
+		if ctx.Err() == context.DeadlineExceeded {
+			return ErrRequestTimeout
+		}
+		return WrapError("do_request", "HTTP request failed", err)
+	}
+	defer resp.Body.Close()
+
+	// 读取响应体
+	respBody, err := io.ReadAll(resp.Body)
+	if err != nil {
+		return WrapError("do_request", "failed to read response body", err)
+	}
+
+	// 检查HTTP状态码
+	if resp.StatusCode != http.StatusOK {
+		switch resp.StatusCode {
+		case http.StatusUnauthorized:
+			return ErrUnauthorized
+		case http.StatusForbidden:
+			return ErrForbidden
+		case http.StatusNotFound:
+			return ErrNotFound
+		case http.StatusBadRequest:
+			return ErrValidationFailed
+		default:
+			return NewClientError("do_request",
+				fmt.Sprintf("HTTP error %d: %s", resp.StatusCode, string(respBody)), nil)
+		}
+	}
+
+	// 解析响应
+	if err := json.Unmarshal(respBody, result); err != nil {
+		return WrapError("do_request", "failed to unmarshal response", err)
+	}
+
+	return nil
+}
+
+// setAuthHeader 设置认证头
+func (c *Client) setAuthHeader(req *http.Request) error {
+	switch c.config.AuthType {
+	case AuthTypeBasic:
+		req.SetBasicAuth(c.config.Username, c.config.Password)
+	case AuthTypeToken:
+		req.Header.Set("Authorization", "Bearer "+c.config.Token)
+	default:
+		return ErrConfigInvalidAuthType
+	}
+	return nil
+}
+
+// GetConfig 获取客户端配置
+func (c *Client) GetConfig() ClientConfig {
+	return c.config
+}

sdk/configure/config.go

@@ -0,0 +1,72 @@
+package configure
+
+import (
+	"time"
+
+	"git.x2erp.com/qdy/go-base/config"
+)
+
+// AuthType 认证类型
+type AuthType string
+
+const (
+	// AuthTypeBasic Basic认证
+	AuthTypeBasic AuthType = "basic"
+	// AuthTypeToken Token认证
+	AuthTypeToken AuthType = "token"
+)
+
+// ClientConfig 客户端配置
+type ClientConfig struct {
+	// BaseURL 配置中心基础URL
+	BaseURL string `json:"baseURL" yaml:"baseURL"`
+
+	// AuthType 认证类型
+	AuthType AuthType `json:"authType" yaml:"authType"`
+
+	// Basic认证配置
+	Username string `json:"username,omitempty" yaml:"username,omitempty"`
+	Password string `json:"password,omitempty" yaml:"password,omitempty"`
+
+	// Token认证配置
+	Token string `json:"token,omitempty" yaml:"token,omitempty"`
+
+	// HTTP配置
+	HTTPTimeout time.Duration `json:"httpTimeout,omitempty" yaml:"httpTimeout,omitempty"`
+	Insecure    bool          `json:"insecure,omitempty" yaml:"insecure,omitempty"`
+}
+
+// DefaultConfig 返回默认配置
+// 从全局配置中获取ConfigureConfig的URL和Token
+func DefaultConfig() ClientConfig {
+	cfg := config.GetConfigureConfig()
+	return ClientConfig{
+		BaseURL:     cfg.Url,
+		AuthType:    AuthTypeToken,
+		Token:       cfg.Token,
+		HTTPTimeout: 30 * time.Second,
+		Insecure:    false,
+	}
+}
+
+// Validate 验证配置
+func (c *ClientConfig) Validate() error {
+	if c.BaseURL == "" {
+		return ErrConfigInvalidURL
+	}
+
+	switch c.AuthType {
+	case AuthTypeBasic:
+		if c.Username == "" || c.Password == "" {
+			return ErrConfigInvalidAuth
+		}
+	case AuthTypeToken:
+		if c.Token == "" {
+			return ErrConfigInvalidAuth
+		}
+	default:
+		return ErrConfigInvalidAuthType
+	}
+
+	return nil
+}

sdk/configure/doc.go

@@ -0,0 +1,69 @@
+// Package configure 提供配置中心客户端的SDK，支持数据库字典的增删改查操作。
+//
+// 主要功能：
+//   - 数据库表字典的创建、查询、更新、删除
+//   - 支持Basic认证和Token认证
+//   - 自动从全局配置加载配置中心地址和token
+//   - 完整的错误处理和类型安全
+//
+// 快速开始：
+//
+//	// 使用默认配置（从全局config获取）
+//	client, err := configure.NewClient()
+//	if err != nil {
+//	    log.Fatal(err)
+//	}
+//
+//	// 查询数据库表字典列表
+//	query := &configure.DicTableQueryRequest{
+//	    QueryRequest: queryreq.QueryRequest{
+//	        Page:     0,
+//	        PageSize: 10,
+//	    },
+//	}
+//
+//	result, err := client.ListTables(context.Background(), query)
+//	if err != nil {
+//	    log.Fatal(err)
+//	}
+//
+//	// 创建数据库表字典
+//	req := &configure.DicTableRequest{
+//	    TableID:     "test_table_001",
+//	    TableType:   "实体表",
+//	    Name:        "测试表",
+//	    Description: "测试表描述",
+//	    Fields: []configure.DicTableFieldRequest{
+//	        {
+//	            FieldID:     "test_table_001.id",
+//	            TableID:     "test_table_001",
+//	            FiledType:   "实际字段",
+//	            DataType:    "数值型",
+//	            FieldName:   "id",
+//	            FieldNameCN: "主键ID",
+//	            Description: "主键字段",
+//	        },
+//	    },
+//	}
+//
+//	detail, err := client.SaveTable(context.Background(), req)
+//	if err != nil {
+//	    log.Fatal(err)
+//	}
+//
+// 配置说明：
+//
+// 客户端支持两种认证方式：
+//   - Basic认证：使用用户名和密码
+//   - Token认证：使用Bearer token
+//
+// 配置可以从以下方式获取：
+//   - 全局配置：通过config.GetConfigureConfig()获取配置中心地址和token
+//   - 自定义配置：通过NewClientWithConfig()传入自定义配置
+//
+// API端点：
+//   - POST /api/dic-table/list     - 查询数据库表字典列表
+//   - POST /api/dic-table/detail/{table_id} - 查询数据库表字典详情
+//   - POST /api/dic-table/save     - 创建或更新数据库表字典
+//   - POST /api/dic-table/delete/{table_id} - 删除数据库表字典
+package configure

sdk/configure/errors.go

@@ -0,0 +1,72 @@
+package configure
+
+import (
+	"fmt"
+)
+
+// ClientError SDK客户端错误
+type ClientError struct {
+	Op      string // 操作名称
+	Message string // 错误信息
+	Err     error  // 底层错误
+}
+
+// Error 实现error接口
+func (e *ClientError) Error() string {
+	if e.Err != nil {
+		return fmt.Sprintf("configure client error [%s]: %s: %v", e.Op, e.Message, e.Err)
+	}
+	return fmt.Sprintf("configure client error [%s]: %s", e.Op, e.Message)
+}
+
+// Unwrap 实现错误解包
+func (e *ClientError) Unwrap() error {
+	return e.Err
+}
+
+// 错误定义
+var (
+	// 配置错误
+	ErrConfigInvalidURL      = &ClientError{Op: "config", Message: "invalid URL"}
+	ErrConfigInvalidAuth     = &ClientError{Op: "config", Message: "invalid authentication credentials"}
+	ErrConfigInvalidAuthType = &ClientError{Op: "config", Message: "invalid authentication type"}
+
+	// 请求错误
+	ErrRequestFailed   = &ClientError{Op: "request", Message: "HTTP request failed"}
+	ErrRequestTimeout  = &ClientError{Op: "request", Message: "request timeout"}
+	ErrInvalidResponse = &ClientError{Op: "request", Message: "invalid response format"}
+
+	// API错误
+	ErrAPIError         = &ClientError{Op: "api", Message: "API returned error"}
+	ErrNotFound         = &ClientError{Op: "api", Message: "resource not found"}
+	ErrAlreadyExists    = &ClientError{Op: "api", Message: "resource already exists"}
+	ErrUnauthorized     = &ClientError{Op: "api", Message: "unauthorized"}
+	ErrForbidden        = &ClientError{Op: "api", Message: "forbidden"}
+	ErrValidationFailed = &ClientError{Op: "api", Message: "validation failed"}
+
+	// 客户端错误
+	ErrClientNotInitialized = &ClientError{Op: "client", Message: "client not initialized"}
+)
+
+// NewClientError 创建新的客户端错误
+func NewClientError(op, message string, err error) *ClientError {
+	return &ClientError{
+		Op:      op,
+		Message: message,
+		Err:     err,
+	}
+}
+
+// WrapError 包装错误为客户端错误
+func WrapError(op, message string, err error) error {
+	if err == nil {
+		return nil
+	}
+
+	// 如果已经是ClientError，直接返回
+	if ce, ok := err.(*ClientError); ok {
+		return ce
+	}
+
+	return NewClientError(op, message, err)
+}

sdk/configure/example.go

@@ -0,0 +1,217 @@
+// Package configure 使用示例
+//
+// 以下示例演示如何使用配置中心客户端SDK
+package configure
+
+import (
+	"context"
+	"fmt"
+	"log"
+	"time"
+
+	"git.x2erp.com/qdy/go-base/model/request/queryreq"
+)
+
+// ExampleUsage 演示SDK的基本用法
+func ExampleUsage() {
+	// 示例1：创建客户端
+	exampleCreateClient()
+
+	// 示例2：查询列表
+	exampleListTables()
+
+	// 示例3：创建表
+	exampleSaveTable()
+
+	// 示例4：查询详情
+	exampleGetTable()
+
+	// 示例5：删除表
+	exampleDeleteTable()
+}
+
+func exampleCreateClient() {
+	fmt.Println("=== 示例1：创建客户端 ===")
+
+	// 方法1：使用默认配置
+	client1, err := NewClient()
+	if err != nil {
+		log.Printf("Failed to create default client: %v", err)
+	} else {
+		fmt.Printf("Default client created: URL=%s\n", client1.GetConfig().BaseURL)
+	}
+
+	// 方法2：使用Basic认证
+	if _, err := NewBasicAuthClient("http://localhost:8080", "admin", "123"); err != nil {
+		log.Printf("Failed to create basic auth client: %v", err)
+	} else {
+		fmt.Println("Basic auth client created")
+	}
+
+	// 方法3：使用Token认证
+	if _, err := NewTokenAuthClient("http://localhost:8080", "your-token-here"); err != nil {
+		log.Printf("Failed to create token auth client: %v", err)
+	} else {
+		fmt.Println("Token auth client created")
+	}
+
+	fmt.Println()
+}
+
+func exampleListTables() {
+	fmt.Println("=== 示例2：查询数据库表字典列表 ===")
+
+	// 创建客户端
+	client, err := NewBasicAuthClient("http://localhost:8080", "admin", "123")
+	if err != nil {
+		log.Printf("Failed to create client: %v", err)
+		return
+	}
+
+	// 创建查询请求
+	query := &DicTableQueryRequest{
+		QueryRequest: queryreq.QueryRequest{
+			Page:     0,
+			PageSize: 10,
+		},
+	}
+
+	// 执行查询
+	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel()
+
+	result, err := client.ListTables(ctx, query)
+	if err != nil {
+		log.Printf("Error listing tables: %v", err)
+		return
+	}
+
+	fmt.Printf("Total tables: %d\n", result.TotalCount)
+	fmt.Printf("Last page: %d\n", result.LastPage)
+	fmt.Println()
+}
+
+func exampleSaveTable() {
+	fmt.Println("=== 示例3：创建数据库表字典 ===")
+
+	// 创建客户端
+	client, err := NewBasicAuthClient("http://localhost:8080", "admin", "123")
+	if err != nil {
+		log.Printf("Failed to create client: %v", err)
+		return
+	}
+
+	// 创建请求
+	req := &DicTableRequest{
+		TableID:     "example_table_001",
+		TableType:   "实体表",
+		Name:        "示例表001",
+		Description: "这是一个示例表",
+		Creator:     "admin",
+		CreatedAt:   time.Now(),
+		UpdatedAt:   time.Now(),
+		Fields: []DicTableFieldRequest{
+			{
+				FieldID:     "example_table_001.id",
+				TableID:     "example_table_001",
+				FiledType:   "实际字段",
+				DataType:    "数值型",
+				FieldName:   "id",
+				FieldNameCN: "主键ID",
+				Description: "主键字段",
+				Creator:     "admin",
+				CreatedAt:   time.Now(),
+				UpdatedAt:   time.Now(),
+			},
+			{
+				FieldID:     "example_table_001.name",
+				TableID:     "example_table_001",
+				FiledType:   "实际字段",
+				DataType:    "字符型",
+				FieldName:   "name",
+				FieldNameCN: "名称",
+				Description: "名称字段",
+				Creator:     "admin",
+				CreatedAt:   time.Now(),
+				UpdatedAt:   time.Now(),
+			},
+		},
+	}
+
+	// 执行保存
+	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel()
+
+	detail, err := client.SaveTable(ctx, req)
+	if err != nil {
+		log.Printf("Error saving table: %v", err)
+		return
+	}
+
+	fmt.Printf("Table saved successfully: %s\n", detail.Table.TableID)
+	fmt.Printf("Table name: %s\n", detail.Table.Name)
+	fmt.Printf("Number of fields: %d\n", len(detail.Fields))
+	fmt.Println()
+}
+
+func exampleGetTable() {
+	fmt.Println("=== 示例4：查询数据库表字典详情 ===")
+
+	// 创建客户端
+	client, err := NewBasicAuthClient("http://localhost:8080", "admin", "123")
+	if err != nil {
+		log.Printf("Failed to create client: %v", err)
+		return
+	}
+
+	// 查询表详情
+	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel()
+
+	tableID := "example_table_001"
+	detail, err := client.GetTable(ctx, tableID)
+	if err != nil {
+		if err == ErrNotFound {
+			fmt.Printf("Table %s not found\n", tableID)
+		} else {
+			log.Printf("Error getting table: %v", err)
+		}
+		return
+	}
+
+	fmt.Printf("Table ID: %s\n", detail.Table.TableID)
+	fmt.Printf("Table Type: %s\n", detail.Table.TableType)
+	fmt.Printf("Name: %s\n", detail.Table.Name)
+	fmt.Printf("Description: %s\n", detail.Table.Description)
+	fmt.Printf("Creator: %s\n", detail.Table.Creator)
+	fmt.Printf("Fields count: %d\n", len(detail.Fields))
+	fmt.Println()
+}
+
+func exampleDeleteTable() {
+	fmt.Println("=== 示例5：删除数据库表字典 ===")
+
+	// 创建客户端
+	client, err := NewBasicAuthClient("http://localhost:8080", "admin", "123")
+	if err != nil {
+		log.Printf("Failed to create client: %v", err)
+		return
+	}
+
+	// 删除表
+	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel()
+
+	tableID := "example_table_001"
+	if err := client.DeleteTable(ctx, tableID); err != nil {
+		if err == ErrNotFound {
+			fmt.Printf("Table %s not found\n", tableID)
+		} else {
+			log.Printf("Error deleting table: %v", err)
+		}
+		return
+	}
+
+	fmt.Printf("Table %s deleted successfully\n", tableID)
+	fmt.Println()
+}

sdk/configure/types.go

@@ -0,0 +1,92 @@
+package configure
+
+import (
+	"time"
+
+	"git.x2erp.com/qdy/go-base/model/request/queryreq"
+)
+
+// DicTableRequest 数据库表字典请求（主表+子表合并）
+type DicTableRequest struct {
+	// 主表字段
+	TableID     string `json:"tableID" binding:"required"`   // 表ID（主键）
+	TableType   string `json:"tableType" binding:"required"` // 表类型: 实体表,视图,物化视图
+	Name        string `json:"name" binding:"required"`      // 表名称
+	Description string `json:"description"`                  // 表描述
+
+	// 子表字段（字段列表）
+	Fields []DicTableFieldRequest `json:"fields"` // 表字段列表
+
+	// 系统字段（创建时自动填充）
+	Creator   string    `json:"creator,omitempty"`   // 创建人
+	CreatedAt time.Time `json:"createdAt,omitempty"` // 创建时间
+	UpdatedAt time.Time `json:"updatedAt,omitempty"` // 更新时间
+}
+
+// DicTableFieldRequest 数据库表字段字典请求（子表）
+type DicTableFieldRequest struct {
+	// 注意：子表主键规则为 table_id + "." + field_name
+	FieldID     string `json:"fieldID" binding:"required"`   // 字段ID（主键，由系统生成）
+	TableID     string `json:"tableID" binding:"required"`   // 表ID（关联主表）
+	FiledType   string `json:"filedType" binding:"required"` // 字段类型: 实际字段,计算字段
+	DataType    string `json:"dataType" binding:"required"`  // 数据类型: 字符型,数值型等
+	FieldName   string `json:"fieldName" binding:"required"` // 字段名称
+	FieldNameCN string `json:"fieldNameCN"`                  // 字段中文名称（ERP中业务名称）
+	Description string `json:"description"`                  // 字段描述
+
+	// 系统字段（创建时自动填充）
+	Creator   string    `json:"creator,omitempty"`   // 创建人
+	CreatedAt time.Time `json:"createdAt,omitempty"` // 创建时间
+	UpdatedAt time.Time `json:"updatedAt,omitempty"` // 更新时间
+}
+
+// DicTableDetail 数据库表字典详情（主表+子表）
+type DicTableDetail struct {
+	// 主表信息
+	Table DicTableDB `json:"table"`
+
+	// 子表信息
+	Fields []DicTableFieldDB `json:"fields"`
+}
+
+// DicTableList 数据库表字典列表
+type DicTableList struct {
+	TotalCount int          `json:"totalCount"`
+	LastPage   int          `json:"lastPage"`
+	Data       []DicTableDB `json:"data"`
+}
+
+// DicTableQueryRequest 数据库表字典查询请求
+type DicTableQueryRequest struct {
+	QueryRequest queryreq.QueryRequest `json:"queryRequest"`
+	TableID      string                `json:"tableID,omitempty"`
+}
+
+// DicTableDB 数据库表字典数据库模型
+type DicTableDB struct {
+	ID          string     `db:"id" json:"id"`
+	TableID     string     `db:"table_id" json:"tableID"`
+	TableType   string     `db:"table_type" json:"tableType"`
+	Name        string     `db:"table_name" json:"name"`
+	Description string     `db:"description" json:"description"`
+	Creator     string     `db:"creator" json:"creator"`
+	CreatedAt   time.Time  `db:"created_at" json:"createdAt"`
+	UpdatedAt   time.Time  `db:"updated_at" json:"updatedAt"`
+	DeletedAt   *time.Time `db:"deleted_at" json:"deletedAt"`
+}
+
+// DicTableFieldDB 数据库表字段字典数据库模型
+type DicTableFieldDB struct {
+	ID          string     `db:"id" json:"id"`
+	FieldID     string     `db:"field_id" json:"fieldID"`
+	TableID     string     `db:"table_id" json:"tableID"`
+	FiledType   string     `db:"filed_type" json:"filedType"`
+	DataType    string     `db:"data_type" json:"dataType"`
+	FieldName   string     `db:"field_name" json:"fieldName"`
+	FieldNameCN string     `db:"field_name_cn" json:"fieldNameCN"`
+	Description string     `db:"description" json:"description"`
+	Creator     string     `db:"creator" json:"creator"`
+	CreatedAt   time.Time  `db:"created_at" json:"createdAt"`
+	UpdatedAt   time.Time  `db:"updated_at" json:"updatedAt"`
+	DeletedAt   *time.Time `db:"deleted_at" json:"deletedAt"`
+}

test_sdk.go

@@ -0,0 +1,163 @@
+package main
+
+import (
+	"context"
+	"fmt"
+	"log"
+	"time"
+
+	"git.x2erp.com/qdy/go-base/model/request/queryreq"
+	"git.x2erp.com/qdy/go-base/sdk/configure"
+)
+
+func main() {
+	fmt.Println("Testing Configure SDK...")
+
+	// 1. 测试创建客户端
+	client, err := configure.NewBasicAuthClient("http://localhost:8080", "admin", "123")
+	if err != nil {
+		log.Fatalf("Failed to create client: %v", err)
+	}
+	fmt.Printf("Client created successfully: URL=%s\n", client.GetConfig().BaseURL)
+
+	// 2. 测试查询列表
+	fmt.Println("\nTesting ListTables...")
+	query := &configure.DicTableQueryRequest{
+		QueryRequest: queryreq.QueryRequest{
+			Page:     0,
+			PageSize: 10,
+		},
+	}
+
+	ctx1, cancel1 := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel1()
+
+	result, err := client.ListTables(ctx1, query)
+	if err != nil {
+		log.Fatalf("Failed to list tables: %v", err)
+	}
+
+	fmt.Printf("ListTables success: TotalCount=%d, LastPage=%d\n", result.TotalCount, result.LastPage)
+	fmt.Printf("Tables count: %d\n", len(result.Data))
+
+	// 3. 测试创建表
+	fmt.Println("\nTesting SaveTable...")
+	req := &configure.DicTableRequest{
+		TableID:     "sdk_test_table_001",
+		TableType:   "实体表",
+		Name:        "SDK测试表001",
+		Description: "SDK集成测试表",
+		Creator:     "admin",
+		CreatedAt:   time.Now(),
+		UpdatedAt:   time.Now(),
+		Fields: []configure.DicTableFieldRequest{
+			{
+				FieldID:     "sdk_test_table_001.id",
+				TableID:     "sdk_test_table_001",
+				FiledType:   "实际字段",
+				DataType:    "数值型",
+				FieldName:   "id",
+				FieldNameCN: "主键ID",
+				Description: "SDK测试主键字段",
+				Creator:     "admin",
+				CreatedAt:   time.Now(),
+				UpdatedAt:   time.Now(),
+			},
+			{
+				FieldID:     "sdk_test_table_001.name",
+				TableID:     "sdk_test_table_001",
+				FiledType:   "实际字段",
+				DataType:    "字符型",
+				FieldName:   "name",
+				FieldNameCN: "名称",
+				Description: "SDK测试名称字段",
+				Creator:     "admin",
+				CreatedAt:   time.Now(),
+				UpdatedAt:   time.Now(),
+			},
+		},
+	}
+
+	ctx2, cancel2 := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel2()
+
+	detail, err := client.SaveTable(ctx2, req)
+	if err != nil {
+		log.Fatalf("Failed to save table: %v", err)
+	}
+
+	fmt.Printf("SaveTable success: TableID=%s, Name=%s, Fields=%d\n",
+		detail.Table.TableID, detail.Table.Name, len(detail.Fields))
+
+	// 4. 测试查询详情
+	fmt.Println("\nTesting GetTable...")
+	ctx3, cancel3 := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel3()
+
+	tableDetail, err := client.GetTable(ctx3, "sdk_test_table_001")
+	if err != nil {
+		log.Fatalf("Failed to get table: %v", err)
+	}
+
+	fmt.Printf("GetTable success: TableID=%s, Description=%s\n",
+		tableDetail.Table.TableID, tableDetail.Table.Description)
+	fmt.Printf("Fields in detail: %d\n", len(tableDetail.Fields))
+
+	// 5. 测试更新表
+	fmt.Println("\nTesting UpdateTable...")
+	ctx4, cancel4 := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel4()
+
+	req.Description = "更新后的SDK测试表描述"
+	req.Name = "更新后的SDK测试表001"
+	req.UpdatedAt = time.Now()
+
+	// 添加一个新字段
+	req.Fields = append(req.Fields, configure.DicTableFieldRequest{
+		FieldID:     "sdk_test_table_001.status",
+		TableID:     "sdk_test_table_001",
+		FiledType:   "实际字段",
+		DataType:    "字符型",
+		FieldName:   "status",
+		FieldNameCN: "状态",
+		Description: "SDK测试状态字段",
+		Creator:     "admin",
+		CreatedAt:   time.Now(),
+		UpdatedAt:   time.Now(),
+	})
+
+	updatedDetail, err := client.SaveTable(ctx4, req)
+	if err != nil {
+		log.Fatalf("Failed to update table: %v", err)
+	}
+
+	fmt.Printf("UpdateTable success: Description=%s, Fields=%d\n",
+		updatedDetail.Table.Description, len(updatedDetail.Fields))
+
+	// 6. 测试删除表
+	fmt.Println("\nTesting DeleteTable...")
+	ctx5, cancel5 := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel5()
+
+	if err := client.DeleteTable(ctx5, "sdk_test_table_001"); err != nil {
+		log.Fatalf("Failed to delete table: %v", err)
+	}
+
+	fmt.Println("DeleteTable success")
+
+	// 7. 验证删除
+	fmt.Println("\nVerifying deletion...")
+	ctx6, cancel6 := context.WithTimeout(context.Background(), 10*time.Second)
+	defer cancel6()
+
+	_, err = client.GetTable(ctx6, "sdk_test_table_001")
+	if err == configure.ErrNotFound {
+		fmt.Println("Table deleted successfully (NotFound error as expected)")
+	} else if err != nil {
+		fmt.Printf("Unexpected error: %v\n", err)
+	} else {
+		fmt.Println("ERROR: Table still exists after deletion!")
+	}
+
+	fmt.Println("\nAll tests passed!")
+}