13 Nov, 2025

8 commits

  • tangwang
     
  • 创建统一配置文件 config/config.yaml(从 base 配置迁移,移除 customer_name)
    
    创建脚本体系
    启动、停止、重启、moc数据到mysql、从mysql灌入数据到ES 这些脚本
    restart.sh
    run.sh 内部调用 启动前后端
    scripts/mock_data.sh  mock数据 -> mysql
    scripts/ingest.sh  mysql->ES
    tangwang
     
  • tangwang
     
  • 主要变更:
    1. 创建.env文件,添加MySQL数据库配置(Shoplazza生产环境)
    2. 更新config/env_config.py,添加DB_CONFIG配置
    3. 创建demo_base.sh脚本,完整的演示流程:
       - 生成测试数据
       - 导入MySQL
       - 导入Elasticsearch
       - 启动后端服务
       - 启动前端服务
    4. 创建create_base_frontend.py,生成base配置专用的前端JS
    5. 创建frontend/base.html,base配置专用前端页面
    6. 更新frontend_server.py,支持base.html路由和PORT环境变量
    7. 创建stop_base.sh,停止演示服务脚本
    
    使用方式:
      bash scripts/demo_base.sh [tenant_id]
    
    访问地址:
      http://localhost:6003/base
    tangwang
     
  • tangwang
     
  • tangwang
     
  • 主要变更:
    1. 去掉数据源应用结构配置化,我们只针对店匠的spu sku表设计索引,数据灌入流程是写死的(只是满足测试需求,后面外层应用负责数据全量+增量灌入)。搜索系统主要关注如何适配外部搜索需求
    目前有两个数据灌入脚本,一种是之前的,一种是现在的从两个店匠的表sku表+spu表读取并且以spu为单位组织doc。
       - 配置只关注ES搜索相关配置,提高可维护性
       - 创建base配置(店匠通用配置)
    
    2. 索引结构重构(SPU维度)
       - 所有客户共享search_products索引,通过tenant_id隔离
       - 支持嵌套variants字段(SKU变体数组)
       - 创建SPUTransformer用于SPU数据转换
    
    3. API响应格式优化
       - 约定一套搜索结果的格式,而不是直接暴露ES doc的结构(_id _score _source内的字段)
       - 添加ProductResult和VariantResult模型
       - 添加suggestions和related_searches字段 (预留接口,逻辑暂未实现)
    
    4. 数据导入流程
       - 创建店匠数据导入脚本(ingest_shoplazza.py)
       - Pipeline层决定数据源,配置不包含数据源信息
       - 创建测试数据生成和导入脚本
    
    5. 文档更新
       - 更新设计文档,反映新架构
       - 创建BASE_CONFIG_GUIDE.md使用指南
    tangwang
     
  • tangwang
     

12 Nov, 2025

8 commits

  • tangwang
     
  • tangwang
     
  • tangwang
     
  • 核心改动:
    1. 配置化打分规则
       - 新增FunctionScoreConfig和RerankConfig配置类
       - 支持filter_weight、field_value_factor、decay三种ES原生function
       - 从代码中移除硬编码的打分逻辑
    
    2. 配置模型定义
       - FunctionScoreConfig: score_mode, boost_mode, functions
       - RerankConfig: enabled, expression(当前禁用)
       - 添加到CustomerConfig中
    
    3. 查询构建器改造
       - MultiLanguageQueryBuilder.init添加function_score_config引用
       - _build_score_functions从配置动态构建ES functions
       - 支持配置的score_mode和boost_mode
    
    4. 配置文件示例
       - 添加完整的function_score配置示例
       - 包含3种function类型的详细注释
       - 提供常见场景的配置模板
    
    5. ES原生能力支持
       - Filter+Weight: 条件匹配提权
       - Field Value Factor: 字段值映射打分
         * modifier支持: none, log, log1p, log2p, ln, ln1p, ln2p, square, sqrt, reciprocal
       - Decay Functions: 衰减函数
         * 支持: gauss, exp, linear
    
    配置示例:
    - 7天新品提权(weight: 1.3)
    - 30天新品提权(weight: 1.15)
    - 有视频提权(weight: 1.05)
    - 销量因子(field_value_factor + log1p)
    - 时间衰减(gauss decay)
    
    优势:
    ✓ 配置化 - 客户自己调整,无需改代码
    ✓ 基于ES原生 - 性能最优,功能完整
    ✓ 灵活易用 - YAML格式,有示例和注释
    ✓ 统一约定 - function_score必需,简化设计
    
    参考:https://www.elastic.co/docs/reference/query-languages/query-dsl/query-dsl-function-score-query
    tangwang
     
  • 核心改动:
    1. 修复facets类型问题
       - 统一使用Pydantic模型(FacetResult, FacetValue)
       - SearchResult.facets改为List[FacetResult]
       - _standardize_facets直接构建Pydantic对象
    
    2. 修复RangeFilter支持日期时间
       - RangeFilter字段改为Union[float, str]
       - 支持数值范围和ISO日期时间字符串
       - 修复前端listing time筛选422错误
    
    3. 重构ES查询结构(核心)
       - 使用function_score包裹整个查询
       - 文本和KNN放入内层bool.should(minimum_should_match=1)
       - Filter在外层bool,同时作用于文本和KNN查询
       - 添加时效性加权函数(days_since_last_update<=30 weight:1.1)
    
    4. RankingEngine重构
       - 重命名为RerankEngine(语义更准确)
       - 默认禁用(enabled=False)
       - 优先使用ES的function_score打分
    
    5. 统一约定原则
       - 移除所有字典兼容代码
       - 全系统统一使用Pydantic模型
       - build_facets只接受str或FacetConfig
       - _build_filters直接接受RangeFilter模型
    
    修改文件:
    - search/multilang_query_builder.py: 重构查询构建逻辑
    - search/es_query_builder.py: 统一Pydantic模型支持
    - search/searcher.py: 使用RerankEngine,更新导入
    - search/rerank_engine.py: 新建(从ranking_engine.py重命名)
    - search/ranking_engine.py: 删除
    - search/__init__.py: 更新导出
    - api/models.py: RangeFilter支持Union[float, str]
    
    测试验证:
    ✓ Facets正常返回
    ✓ Filter同时作用于文本和KNN
    ✓ 日期时间范围过滤正常
    ✓ Function score时效性加权正常
    ✓ 所有测试通过
    
    架构原则:统一约定,不做兼容,保持简单
    tangwang
     
  • tangwang
     
  • tangwang
     
  • tangwang
     

11 Nov, 2025

9 commits


10 Nov, 2025

3 commits


08 Nov, 2025

6 commits


07 Nov, 2025

1 commit