From 97a5d59da1145aebba9496e9d2921f4034bce488 Mon Sep 17 00:00:00 2001
From: tangwang <tangwang@essa.top>
Date: Mon, 17 Nov 2025 18:13:47 +0800
Subject: [PATCH] 文档修改

---
 CLAUDE.md                     |  4 ----
 docs/搜索API对接指南.md | 31 ++++++++++++++++++-------------
 docs/索引字段说明.md    | 20 ++++++++++++++++++++
 3 files changed, 38 insertions(+), 17 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index f2103ae..f0d5a7d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -54,10 +54,6 @@ The system uses two types of configurations per tenant:
    - Query domain definitions (default, category_name, title, brand_name, etc.)
    - BM25 parameters and similarity configurations
 
-Reference files:
-- `商品数据源入ES配置规范.md` - ES mapping and analyzer configuration standards
-- `阿里opensearch电商行业.md` - Application and index structure examples from Alibaba OpenSearch
-
 ### Query Processing
 
 The `queryParser` performs:
diff --git a/docs/搜索API对接指南.md b/docs/搜索API对接指南.md
index be6be65..1d21f08 100644
--- a/docs/搜索API对接指南.md
+++ b/docs/搜索API对接指南.md
@@ -25,42 +25,47 @@
 ### 最简单的搜索请求
 
 ```bash
-curl -X POST "http://localhost:6002/search/" \
+curl -X POST "http://120.76.41.98:6002/search/" \
   -H "Content-Type: application/json" \
-  -d '{
-    "query": "芭比娃娃"
-  }'
+  -H "X-Tenant-ID: 2" \
+  -d '{"query": "芭比娃娃"}'
 ```
 
 ### curl示例：带过滤与分页
 
 ```bash
-curl -X POST "http://localhost:6002/search/" \
+curl -X POST "http://120.76.41.98:6002/search/" \
   -H "Content-Type: application/json" \
+  -H "X-Tenant-ID: 2" \
   -d '{
-    "tenant_id": "demo-tenant",
-    "query": "芭比娃娃 AND 配件",
+    "query": "芭比娃娃",
     "size": 5,
     "from": 10,
-    "filters": {
-      "vendor.keyword": ["乐高", "孩之宝"]
+  "range_filters": {
+    "min_price": {
+      "gte": 50,
+      "lte": 200
     },
+    "create_time": {
+      "gte": "2020-01-01T00:00:00Z" 
+    }
+  },
     "sort_by": "min_price",
     "sort_order": "asc"
   }'
 ```
 
-### curl示例：开启调试与分面
+### curl示例：开启分面
 
 ```bash
-curl -X POST "http://localhost:6002/search/" \
+curl -X POST "http://120.76.41.98:6002/search/" \
   -H "Content-Type: application/json" \
+  -H "X-Tenant-ID: 2" \
   -d '{
     "tenant_id": "demo-tenant",
     "query": "芭比娃娃",
     "facets": ["category.keyword", "vendor.keyword"],
-    "min_score": 0.2,
-    "debug": true
+    "min_score": 0.2
   }'
 ```
 
diff --git a/docs/索引字段说明.md b/docs/索引字段说明.md
index b576f07..807f46e 100644
--- a/docs/索引字段说明.md
+++ b/docs/索引字段说明.md
@@ -16,6 +16,26 @@
 - 返回的结果格式约定为店匠系列的 SPU/SKU嵌套结构。  
  - 支撑 facet/过滤/排序业务需求：用户可以选择任何一个 keyword 或 HKText 类型的字段做筛选、聚合；也可以选择任何一个数值型字段做 Range 过滤或排序。
 
+## 数据源调研
+
+店匠的商品结构:
+
+固定字段：
+1、必填：品名
+2、非必填：副标题、类目、专辑、标签、供应商、市场
+
+动态字段：商品属性
+1、款式（一款，或者多款）这部分是可以动态自定义的
+款式可以支持直接生成一个 SKU，也可以选择不启用
+2、类目没有预设动态属性值，都是自定义的
+
+我们的目标客户店匠的两个店铺，男装和女装
+
+商品信息：品名、颜色、尺码，基本上就这三个信息
+
+spu/sku表：
+
+
 ## 索引基本信息
 
 - **索引名称**: `search_products`
--
libgit2 0.21.2