Blame view

api/routes/search.py 8.46 KB
be52af70   tangwang   first commit
1
2
3
4
  """
  Search API routes.
  """
  
16c42787   tangwang   feat: implement r...
5
  from fastapi import APIRouter, HTTPException, Query, Request
be52af70   tangwang   first commit
6
  from typing import Optional
16c42787   tangwang   feat: implement r...
7
  import uuid
be52af70   tangwang   first commit
8
9
10
11
12
  
  from ..models import (
      SearchRequest,
      ImageSearchRequest,
      SearchResponse,
6aa246be   tangwang   问题:Pydantic 应该能自动...
13
      SearchSuggestResponse,
be52af70   tangwang   first commit
14
15
16
      DocumentResponse,
      ErrorResponse
  )
16c42787   tangwang   feat: implement r...
17
  from context.request_context import create_request_context, set_current_request_context, clear_current_request_context
be52af70   tangwang   first commit
18
19
20
21
  
  router = APIRouter(prefix="/search", tags=["search"])
  
  
16c42787   tangwang   feat: implement r...
22
23
24
25
26
27
28
29
30
31
32
  def extract_request_info(request: Request) -> tuple[str, str]:
      """Extract request ID and user ID from HTTP request"""
      # Try to get request ID from headers
      reqid = request.headers.get('X-Request-ID') or str(uuid.uuid4())[:8]
  
      # Try to get user ID from headers or default to anonymous
      uid = request.headers.get('X-User-ID') or request.headers.get('User-ID') or 'anonymous'
  
      return reqid, uid
  
  
be52af70   tangwang   first commit
33
  @router.post("/", response_model=SearchResponse)
16c42787   tangwang   feat: implement r...
34
  async def search(request: SearchRequest, http_request: Request):
be52af70   tangwang   first commit
35
      """
6aa246be   tangwang   问题:Pydantic 应该能自动...
36
      Execute text search query (重构版).
be52af70   tangwang   first commit
37
38
39
40
41
42
  
      Supports:
      - Multi-language query processing
      - Boolean operators (AND, OR, RANK, ANDNOT)
      - Semantic search with embeddings
      - Custom ranking functions
6aa246be   tangwang   问题:Pydantic 应该能自动...
43
44
      - Exact match filters and range filters
      - Faceted search
be52af70   tangwang   first commit
45
      """
16c42787   tangwang   feat: implement r...
46
47
48
49
50
51
52
      reqid, uid = extract_request_info(http_request)
  
      # Create request context
      context = create_request_context(reqid=reqid, uid=uid)
  
      # Set context in thread-local storage
      set_current_request_context(context)
be52af70   tangwang   first commit
53
54
  
      try:
16c42787   tangwang   feat: implement r...
55
56
57
58
59
60
61
          # Log request start
          context.logger.info(
              f"收到搜索请求 | IP: {http_request.client.host if http_request.client else 'unknown'} | "
              f"用户代理: {http_request.headers.get('User-Agent', 'unknown')[:100]}",
              extra={'reqid': context.reqid, 'uid': context.uid}
          )
  
be52af70   tangwang   first commit
62
          # Get searcher from app state
bb3c5ef8   tangwang   灌入数据流程跑通
63
          from api.app import get_searcher
be52af70   tangwang   first commit
64
65
          searcher = get_searcher()
  
16c42787   tangwang   feat: implement r...
66
          # Execute search with context (using backend defaults from config)
be52af70   tangwang   first commit
67
68
69
70
71
          result = searcher.search(
              query=request.query,
              size=request.size,
              from_=request.from_,
              filters=request.filters,
6aa246be   tangwang   问题:Pydantic 应该能自动...
72
73
              range_filters=request.range_filters,
              facets=request.facets,
16c42787   tangwang   feat: implement r...
74
              min_score=request.min_score,
c86c8237   tangwang   支持聚合。过滤项补充了逻辑,但是有问题
75
              context=context,
c86c8237   tangwang   支持聚合。过滤项补充了逻辑,但是有问题
76
              sort_by=request.sort_by,
1f071951   tangwang   补充调试信息,记录包括各个阶段的 ...
77
78
              sort_order=request.sort_order,
              debug=request.debug
be52af70   tangwang   first commit
79
80
          )
  
16c42787   tangwang   feat: implement r...
81
82
83
          # Include performance summary in response
          performance_summary = context.get_summary() if context else None
  
be52af70   tangwang   first commit
84
85
86
87
88
89
          # Convert to response model
          return SearchResponse(
              hits=result.hits,
              total=result.total,
              max_score=result.max_score,
              took_ms=result.took_ms,
6aa246be   tangwang   问题:Pydantic 应该能自动...
90
              facets=result.facets,
16c42787   tangwang   feat: implement r...
91
              query_info=result.query_info,
1f071951   tangwang   补充调试信息,记录包括各个阶段的 ...
92
93
              performance_info=performance_summary,
              debug_info=result.debug_info
be52af70   tangwang   first commit
94
95
96
          )
  
      except Exception as e:
16c42787   tangwang   feat: implement r...
97
98
99
100
101
102
103
          # Log error in context
          if context:
              context.set_error(e)
              context.logger.error(
                  f"搜索请求失败 | 错误: {str(e)}",
                  extra={'reqid': context.reqid, 'uid': context.uid}
              )
be52af70   tangwang   first commit
104
          raise HTTPException(status_code=500, detail=str(e))
16c42787   tangwang   feat: implement r...
105
106
107
      finally:
          # Clear thread-local context
          clear_current_request_context()
be52af70   tangwang   first commit
108
109
110
  
  
  @router.post("/image", response_model=SearchResponse)
16c42787   tangwang   feat: implement r...
111
  async def search_by_image(request: ImageSearchRequest, http_request: Request):
be52af70   tangwang   first commit
112
      """
6aa246be   tangwang   问题:Pydantic 应该能自动...
113
      Search by image similarity (重构版).
be52af70   tangwang   first commit
114
115
  
      Uses image embeddings to find visually similar products.
6aa246be   tangwang   问题:Pydantic 应该能自动...
116
      Supports exact match filters and range filters.
be52af70   tangwang   first commit
117
      """
16c42787   tangwang   feat: implement r...
118
119
120
121
122
123
124
125
      reqid, uid = extract_request_info(http_request)
  
      # Create request context
      context = create_request_context(reqid=reqid, uid=uid)
  
      # Set context in thread-local storage
      set_current_request_context(context)
  
be52af70   tangwang   first commit
126
      try:
16c42787   tangwang   feat: implement r...
127
128
129
130
131
132
133
          # Log request start
          context.logger.info(
              f"收到图片搜索请求 | 图片URL: {request.image_url} | "
              f"IP: {http_request.client.host if http_request.client else 'unknown'}",
              extra={'reqid': context.reqid, 'uid': context.uid}
          )
  
bb3c5ef8   tangwang   灌入数据流程跑通
134
          from api.app import get_searcher
be52af70   tangwang   first commit
135
136
137
138
139
140
          searcher = get_searcher()
  
          # Execute image search
          result = searcher.search_by_image(
              image_url=request.image_url,
              size=request.size,
6aa246be   tangwang   问题:Pydantic 应该能自动...
141
142
              filters=request.filters,
              range_filters=request.range_filters
be52af70   tangwang   first commit
143
144
          )
  
16c42787   tangwang   feat: implement r...
145
146
147
          # Include performance summary in response
          performance_summary = context.get_summary() if context else None
  
be52af70   tangwang   first commit
148
149
150
151
152
          return SearchResponse(
              hits=result.hits,
              total=result.total,
              max_score=result.max_score,
              took_ms=result.took_ms,
6aa246be   tangwang   问题:Pydantic 应该能自动...
153
              facets=result.facets,
16c42787   tangwang   feat: implement r...
154
155
              query_info=result.query_info,
              performance_info=performance_summary
be52af70   tangwang   first commit
156
157
158
          )
  
      except ValueError as e:
16c42787   tangwang   feat: implement r...
159
160
161
162
163
164
          if context:
              context.set_error(e)
              context.logger.error(
                  f"图片搜索请求参数错误 | 错误: {str(e)}",
                  extra={'reqid': context.reqid, 'uid': context.uid}
              )
be52af70   tangwang   first commit
165
166
          raise HTTPException(status_code=400, detail=str(e))
      except Exception as e:
16c42787   tangwang   feat: implement r...
167
168
169
170
171
172
          if context:
              context.set_error(e)
              context.logger.error(
                  f"图片搜索请求失败 | 错误: {str(e)}",
                  extra={'reqid': context.reqid, 'uid': context.uid}
              )
be52af70   tangwang   first commit
173
          raise HTTPException(status_code=500, detail=str(e))
16c42787   tangwang   feat: implement r...
174
175
176
      finally:
          # Clear thread-local context
          clear_current_request_context()
be52af70   tangwang   first commit
177
178
  
  
6aa246be   tangwang   问题:Pydantic 应该能自动...
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
  @router.get("/suggestions", response_model=SearchSuggestResponse)
  async def search_suggestions(
      q: str = Query(..., min_length=1, description="搜索查询"),
      size: int = Query(5, ge=1, le=20, description="建议数量"),
      types: str = Query("query", description="建议类型(逗号分隔): query, product, category, brand")
  ):
      """
      获取搜索建议(自动补全)。
      
      功能说明:
      - 查询建议(query):基于历史搜索和热门搜索
      - 商品建议(product):匹配的商品
      - 类目建议(category):匹配的类目
      - 品牌建议(brand):匹配的品牌
      
      注意:此功能暂未实现,仅返回框架响应。
      """
      import time
      start_time = time.time()
      
      # TODO: 实现搜索建议逻辑
      # 1. 从搜索历史中获取建议
      # 2. 从商品标题中匹配前缀
      # 3. 从类目、品牌中匹配
      
      # 临时返回空结果
      suggestions = []
      
      # 示例结构(暂不实现):
      # suggestions = [
      #     {
      #         "text": "芭比娃娃",
      #         "type": "query",
      #         "highlight": "<em>芭</em>比娃娃",
      #         "popularity": 850
      #     }
      # ]
      
      took_ms = int((time.time() - start_time) * 1000)
      
      return SearchSuggestResponse(
          query=q,
          suggestions=suggestions,
          took_ms=took_ms
      )
  
  
  @router.get("/instant", response_model=SearchResponse)
  async def instant_search(
      q: str = Query(..., min_length=2, description="搜索查询"),
      size: int = Query(5, ge=1, le=20, description="结果数量")
  ):
      """
      即时搜索(Instant Search)。
      
      功能说明:
      - 边输入边搜索,无需点击搜索按钮
      - 返回简化的搜索结果
      
      注意:此功能暂未实现,调用标准搜索接口。
      TODO: 优化即时搜索性能
      - 添加防抖/节流
      - 实现结果缓存
      - 简化返回字段
      """
      from api.app import get_searcher
      searcher = get_searcher()
      
      result = searcher.search(
          query=q,
          size=size,
          from_=0
      )
      
      return SearchResponse(
          hits=result.hits,
          total=result.total,
          max_score=result.max_score,
          took_ms=result.took_ms,
          facets=result.facets,
          query_info=result.query_info
      )
  
  
be52af70   tangwang   first commit
263
264
265
266
267
268
  @router.get("/{doc_id}", response_model=DocumentResponse)
  async def get_document(doc_id: str):
      """
      Get a single document by ID.
      """
      try:
bb3c5ef8   tangwang   灌入数据流程跑通
269
          from api.app import get_searcher
be52af70   tangwang   first commit
270
271
272
273
274
275
276
277
278
279
280
281
282
          searcher = get_searcher()
  
          doc = searcher.get_document(doc_id)
  
          if doc is None:
              raise HTTPException(status_code=404, detail=f"Document {doc_id} not found")
  
          return DocumentResponse(id=doc_id, source=doc)
  
      except HTTPException:
          raise
      except Exception as e:
          raise HTTPException(status_code=500, detail=str(e))