diff --git a/api/app.py b/api/app.py index cfcd6c8..b425887 100644 --- a/api/app.py +++ b/api/app.py @@ -41,15 +41,16 @@ limiter = Limiter(key_func=get_remote_address) sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) from config.env_config import ES_CONFIG +from config import ConfigLoader from utils import ESClient from search import Searcher -from search.query_config import DEFAULT_INDEX_NAME from query import QueryParser # Global instances _es_client: Optional[ESClient] = None _searcher: Optional[Searcher] = None _query_parser: Optional[QueryParser] = None +_config = None def init_service(es_host: str = "http://localhost:9200"): @@ -59,11 +60,17 @@ def init_service(es_host: str = "http://localhost:9200"): Args: es_host: Elasticsearch host URL """ - global _es_client, _searcher, _query_parser + global _es_client, _searcher, _query_parser, _config start_time = time.time() logger.info("Initializing search service (multi-tenant)") + # Load configuration + logger.info("Loading configuration...") + config_loader = ConfigLoader("config/config.yaml") + _config = config_loader.load_config() + logger.info("Configuration loaded") + # Get ES credentials es_username = os.getenv('ES_USERNAME') or ES_CONFIG.get('username') es_password = os.getenv('ES_PASSWORD') or ES_CONFIG.get('password') @@ -81,13 +88,13 @@ def init_service(es_host: str = "http://localhost:9200"): # Initialize components logger.info("Initializing query parser...") - _query_parser = QueryParser() + _query_parser = QueryParser(_config) logger.info("Initializing searcher...") - _searcher = Searcher(_es_client, _query_parser, index_name=DEFAULT_INDEX_NAME) + _searcher = Searcher(_es_client, _config, _query_parser) elapsed = time.time() - start_time - logger.info(f"Search service ready! (took {elapsed:.2f}s) | Index: {DEFAULT_INDEX_NAME}") + logger.info(f"Search service ready! (took {elapsed:.2f}s) | Index: {_config.es_index_name}") @@ -113,6 +120,13 @@ def get_query_parser() -> QueryParser: return _query_parser +def get_config(): + """Get global config instance.""" + if _config is None: + raise RuntimeError("Service not initialized") + return _config + + # Create FastAPI app with enhanced configuration app = FastAPI( title="E-Commerce Search API", diff --git a/config/__init__.py b/config/__init__.py index d8c5d12..28bc0ac 100644 --- a/config/__init__.py +++ b/config/__init__.py @@ -23,6 +23,10 @@ from .config_loader import ( RerankConfig, ConfigurationError ) +from .utils import ( + get_match_fields_for_index, + get_domain_fields +) __all__ = [ # Field types @@ -46,4 +50,6 @@ __all__ = [ 'FunctionScoreConfig', 'RerankConfig', 'ConfigurationError', + 'get_match_fields_for_index', + 'get_domain_fields', ] diff --git a/config/config.yaml b/config/config.yaml index c5c95ab..33e8038 100644 --- a/config/config.yaml +++ b/config/config.yaml @@ -412,6 +412,11 @@ query_config: text_embedding_field: "title_embedding" # Field name for text embeddings image_embedding_field: null # Field name for image embeddings (if not set, will auto-detect) + # Embedding disable thresholds (disable vector search for short queries) + embedding_disable_thresholds: + chinese_char_limit: 4 # Disable embedding for Chinese queries with <= 4 characters + english_word_limit: 3 # Disable embedding for English queries with <= 3 words + # Translation API (DeepL) translation_service: "deepl" translation_api_key: null # Set via environment variable diff --git a/config/config_loader.py b/config/config_loader.py index e3f4c24..83edbe5 100644 --- a/config/config_loader.py +++ b/config/config_loader.py @@ -58,6 +58,10 @@ class QueryConfig: text_embedding_field: Optional[str] = None # Field name for text embeddings (e.g., "title_embedding") image_embedding_field: Optional[str] = None # Field name for image embeddings (e.g., "image_embedding") + # Embedding disable thresholds (disable vector search for short queries) + embedding_disable_chinese_char_limit: int = 4 # Disable embedding for Chinese queries with <= this many characters + embedding_disable_english_word_limit: int = 3 # Disable embedding for English queries with <= this many words + # ES source fields configuration - fields to return in search results # If None, auto-collect from field configs (fields with return_in_source=True) # If empty list, return all fields. Otherwise, only return specified fields. @@ -165,15 +169,18 @@ class ConfigLoader: return rewrite_dict - def load_config(self) -> SearchConfig: + def load_config(self, validate: bool = True) -> SearchConfig: """ Load unified configuration from YAML file. + Args: + validate: Whether to validate configuration after loading (default: True) + Returns: SearchConfig object Raises: - ConfigurationError: If config file not found or invalid + ConfigurationError: If config file not found, invalid, or validation fails """ if not self.config_file.exists(): raise ConfigurationError(f"Configuration file not found: {self.config_file}") @@ -184,7 +191,16 @@ class ConfigLoader: except yaml.YAMLError as e: raise ConfigurationError(f"Invalid YAML in {self.config_file}: {e}") - return self._parse_config(config_data) + config = self._parse_config(config_data) + + # Auto-validate configuration + if validate: + errors = self.validate_config(config) + if errors: + error_msg = "Configuration validation failed:\n" + "\n".join(f" - {err}" for err in errors) + raise ConfigurationError(error_msg) + + return config def _parse_config(self, config_data: Dict[str, Any]) -> SearchConfig: """Parse configuration dictionary into SearchConfig object.""" @@ -214,43 +230,48 @@ class ConfigLoader: if field.return_in_source ] + # Parse embedding disable thresholds + embedding_thresholds = query_config_data.get("embedding_disable_thresholds", {}) + query_config = QueryConfig( - supported_languages=query_config_data.get("supported_languages", ["zh", "en"]), - default_language=query_config_data.get("default_language", "zh"), + supported_languages=query_config_data.get("supported_languages") or ["zh", "en"], + default_language=query_config_data.get("default_language") or "zh", enable_translation=query_config_data.get("enable_translation", True), enable_text_embedding=query_config_data.get("enable_text_embedding", True), enable_query_rewrite=query_config_data.get("enable_query_rewrite", True), rewrite_dictionary=rewrite_dictionary, translation_api_key=query_config_data.get("translation_api_key"), - translation_service=query_config_data.get("translation_service", "deepl"), + translation_service=query_config_data.get("translation_service") or "deepl", translation_glossary_id=query_config_data.get("translation_glossary_id"), - translation_context=query_config_data.get("translation_context", "e-commerce product search"), + translation_context=query_config_data.get("translation_context") or "e-commerce product search", text_embedding_field=query_config_data.get("text_embedding_field"), image_embedding_field=query_config_data.get("image_embedding_field"), + embedding_disable_chinese_char_limit=embedding_thresholds.get("chinese_char_limit", 4), + embedding_disable_english_word_limit=embedding_thresholds.get("english_word_limit", 3), source_fields=source_fields ) # Parse ranking config ranking_data = config_data.get("ranking", {}) ranking = RankingConfig( - expression=ranking_data.get("expression", "bm25() + 0.2*text_embedding_relevance()"), - description=ranking_data.get("description", "Default BM25 + text embedding ranking") + expression=ranking_data.get("expression") or "bm25() + 0.2*text_embedding_relevance()", + description=ranking_data.get("description") or "Default BM25 + text embedding ranking" ) # Parse Function Score configuration fs_data = config_data.get("function_score", {}) function_score = FunctionScoreConfig( - score_mode=fs_data.get("score_mode", "sum"), - boost_mode=fs_data.get("boost_mode", "multiply"), - functions=fs_data.get("functions", []) + score_mode=fs_data.get("score_mode") or "sum", + boost_mode=fs_data.get("boost_mode") or "multiply", + functions=fs_data.get("functions") or [] ) # Parse Rerank configuration rerank_data = config_data.get("rerank", {}) rerank = RerankConfig( enabled=rerank_data.get("enabled", False), - expression=rerank_data.get("expression", ""), - description=rerank_data.get("description", "") + expression=rerank_data.get("expression") or "", + description=rerank_data.get("description") or "" ) # Parse SPU config @@ -447,21 +468,43 @@ class ConfigLoader: output_path = Path(output_path) # Convert config back to dictionary format + query_config_dict = { + "supported_languages": config.query_config.supported_languages, + "default_language": config.query_config.default_language, + "enable_translation": config.query_config.enable_translation, + "enable_text_embedding": config.query_config.enable_text_embedding, + "enable_query_rewrite": config.query_config.enable_query_rewrite, + "translation_service": config.query_config.translation_service, + } + + # Add optional fields only if they are set + if config.query_config.translation_api_key: + query_config_dict["translation_api_key"] = config.query_config.translation_api_key + if config.query_config.translation_glossary_id: + query_config_dict["translation_glossary_id"] = config.query_config.translation_glossary_id + if config.query_config.translation_context: + query_config_dict["translation_context"] = config.query_config.translation_context + if config.query_config.text_embedding_field: + query_config_dict["text_embedding_field"] = config.query_config.text_embedding_field + if config.query_config.image_embedding_field: + query_config_dict["image_embedding_field"] = config.query_config.image_embedding_field + if config.query_config.source_fields: + query_config_dict["source_fields"] = config.query_config.source_fields + + # Add embedding disable thresholds + if (config.query_config.embedding_disable_chinese_char_limit != 4 or + config.query_config.embedding_disable_english_word_limit != 3): + query_config_dict["embedding_disable_thresholds"] = { + "chinese_char_limit": config.query_config.embedding_disable_chinese_char_limit, + "english_word_limit": config.query_config.embedding_disable_english_word_limit + } + config_dict = { "es_index_name": config.es_index_name, "es_settings": config.es_settings, "fields": [self._field_to_dict(field) for field in config.fields], "indexes": [self._index_to_dict(index) for index in config.indexes], - "query_config": { - "supported_languages": config.query_config.supported_languages, - "default_language": config.query_config.default_language, - "enable_translation": config.query_config.enable_translation, - "enable_text_embedding": config.query_config.enable_text_embedding, - "enable_query_rewrite": config.query_config.enable_query_rewrite, - # rewrite_dictionary is stored in separate file, not in config - "translation_api_key": config.query_config.translation_api_key, - "translation_service": config.query_config.translation_service, - }, + "query_config": query_config_dict, "ranking": { "expression": config.ranking.expression, "description": config.ranking.description @@ -505,7 +548,7 @@ class ConfigLoader: f.write(f"{key}\t{value}\n") def _field_to_dict(self, field: FieldConfig) -> Dict[str, Any]: - """Convert FieldConfig to dictionary.""" + """Convert FieldConfig to dictionary, preserving all fields.""" result = { "name": field.name, "type": field.field_type.value, @@ -513,36 +556,49 @@ class ConfigLoader: "boost": field.boost, "store": field.store, "index": field.index, + "return_in_source": field.return_in_source, } + # Add optional fields only if they differ from defaults or are set if field.analyzer: result["analyzer"] = field.analyzer.value if field.search_analyzer: result["search_analyzer"] = field.search_analyzer.value if field.multi_language: result["multi_language"] = field.multi_language - result["languages"] = field.languages + if field.languages: + result["languages"] = field.languages if field.embedding_dims != 1024: result["embedding_dims"] = field.embedding_dims if field.embedding_similarity != "dot_product": result["embedding_similarity"] = field.embedding_similarity if field.nested: result["nested"] = field.nested - result["nested_properties"] = field.nested_properties + if field.nested_properties: + result["nested_properties"] = field.nested_properties + if field.keyword_subfield: + result["keyword_subfield"] = field.keyword_subfield + if field.keyword_ignore_above != 256: + result["keyword_ignore_above"] = field.keyword_ignore_above + if field.keyword_normalizer: + result["keyword_normalizer"] = field.keyword_normalizer return result def _index_to_dict(self, index: IndexConfig) -> Dict[str, Any]: - """Convert IndexConfig to dictionary.""" + """Convert IndexConfig to dictionary, preserving all fields.""" result = { "name": index.name, "label": index.label, "fields": index.fields, "analyzer": index.analyzer.value, - "boost": index.boost, - "example": index.example } - + + # Add optional fields only if they differ from defaults or are set + if index.boost != 1.0: + result["boost"] = index.boost + if index.example: + result["example"] = index.example if index.language_field_mapping: result["language_field_mapping"] = index.language_field_mapping diff --git a/config/utils.py b/config/utils.py new file mode 100644 index 0000000..96c0ef1 --- /dev/null +++ b/config/utils.py @@ -0,0 +1,70 @@ +""" +Configuration utility functions. + +Helper functions for working with SearchConfig objects. +""" + +from typing import Dict, List +from .config_loader import SearchConfig + + +def get_match_fields_for_index(config: SearchConfig, index_name: str = "default") -> List[str]: + """ + Generate match fields list with boost from IndexConfig and FieldConfig. + + Args: + config: SearchConfig instance + index_name: Name of the index domain (default: "default") + + Returns: + List of field names with boost, e.g., ["title_zh^3.0", "brief_zh^1.5"] + """ + # Find the index config + index_config = None + for idx in config.indexes: + if idx.name == index_name: + index_config = idx + break + + if not index_config: + return [] + + # Create a field name to FieldConfig mapping + field_map = {field.name: field for field in config.fields} + + # Generate match fields with boost + match_fields = [] + for field_name in index_config.fields: + field_config = field_map.get(field_name) + if field_config: + # Combine index boost and field boost + total_boost = index_config.boost * field_config.boost + if total_boost != 1.0: + match_fields.append(f"{field_name}^{total_boost}") + else: + match_fields.append(field_name) + else: + # Field not found in config, use index boost only + if index_config.boost != 1.0: + match_fields.append(f"{field_name}^{index_config.boost}") + else: + match_fields.append(field_name) + + return match_fields + + +def get_domain_fields(config: SearchConfig) -> Dict[str, List[str]]: + """ + Generate domain-specific match fields from all index configs. + + Args: + config: SearchConfig instance + + Returns: + Dictionary mapping domain name to list of match fields + """ + domain_fields = {} + for index_config in config.indexes: + domain_fields[index_config.name] = get_match_fields_for_index(config, index_config.name) + return domain_fields + diff --git a/frontend/index.html b/frontend/index.html index bca1767..bcb736c 100644 --- a/frontend/index.html +++ b/frontend/index.html @@ -100,9 +100,10 @@