i dZddlmZddlmZddlmZmZedZddl m Z m Z Gdde Z Gd d e Z Gd d e ZGd de ZGdde ZGdde ZdS)uPydantic models for the search API. 混合检索接口的请求/响应数据模型。 定义搜索筛选条件、搜索请求、文档结果、搜索响应， 以及自动补全建议的请求和响应结构。 ) annotations)date)AnyLiteral)alltitlecontent doc_number) BaseModelFieldceZdZUdZeddZded<eddZded<edd Zded <edd Z ded <edd Z ded<eddddZ ded<eddZ ded<eddZ ded<eddZded<eddZded<ed d!Zd"ed#<dS)$ SearchFiltersz3Optional facet filters applied to a search request.Nu!发文机关（单个或多个） descriptionzlist[str] | str | None issuing_orgu!公文种类（单个或多个）doc_typeu知识分类/业务分类knowledge_categoryu/文档场景类型，如 standard_service_guidedocument_scene_typeu6签发人筛选，支持输入完整或部分签发人 str | Nonesignerili4u发布日期年份，如 2024)gelerz int | None publish_yearu0文号筛选，支持输入完整或部分文号r u发布日期起始z date | None date_fromu发布日期截止date_tou主题词列表zlist[str] | None subject_wordsru*检索范围：综合/标题/正文/文号 SearchScope search_scope)__name__ __module__ __qualname____doc__r r__annotations__rrrrrr rrrr0D:\work\zm-rag\backend\app\api\schemas\search.pyrrs==*/%Be*f*f*fKffff',uT?b'c'c'cHcccc16tId1e1e1eeeee27%J{2|2|2|||||t1ijjjFjjjj$uTdtIhiiiLiiii"U45ghhhJhhhh"U45IJJJIJJJJ 53GHHHGHHHH&+eD>O&P&P&PMPPPP %e9e f f fLffffffr%rceZdZUdZeddddZded<d Zd ed <edd Zd ed<edddZ d ed<d S) SearchRequestzPayload for ``POST /search``..iu$搜索关键词或自然语言问句) min_length max_lengthrstrqueryNzSearchFilters | Nonefilters)rintpagedrr page_size) rr r!r"r r-r#r.r0r4r$r%r&r(r($s''sqSFlmmmEmmmm$(G((((aADU2!,,,I,,,,,,r%r(c.eZdZUdZded<eddZded<edd Zd ed <ded <d Zded<d Z ded<d Z ded<d Z ded<d Z ded<d Z ded<ed dZded<ed dZded<eeZded<d S)DocumentResultaA single document hit returned in the search response. Each result represents a unique piece of content (``content_hash``). ``doc_id`` is the best-matching version for the current user. ``version_count`` indicates how many document versions share this content. r,doc_idu$内容标识（相同内容共享）r content_hashr)u'用户可见的同内容文档版本数r/ version_countrNrr rrr publish_datez float | NonescoreuBM25 文本相关性分数 bm25_scoreukNN 向量相似度分数 knn_scoredefault_factory list[str] highlights)rr r!r"r#r r9r:r rrrr;r<r=r>listrBr$r%r&r6r6-s9KKKb.TUUULUUUUq.WXXXMXXXXJJJ!J!!!!%)))))"K""""H#L####E$uT7STTTJTTTT#eD6QRRRIRRRR!E$777J777777r%r6c^eZdZUdZded<ded<ded<ded<eeZd ed <d S) SearchResponsez'Response envelope for ``POST /search``.r/totalr0r4zlist[DocumentResult] documentsr?zdict[str, Any] aggregationsN)rr r!r"r#r dictrHr$r%r&rErEDs]11JJJ IIINNN#####(5#>#>#>L>>>>>>r%rEc`eZdZUdZedddZded<eddd Zd ed <d S)SuggestRequestz%Payload for ``POST /search/suggest``..r))r*r+r,r-r1r3r/sizeN)rr r!r"r r-r#rNr$r%r&rKrKNs\//sqS999E9999aA"%%%D%%%%%%r%rKc6eZdZUdZeeZded<dS)SuggestResponsez/Response envelope for ``POST /search/suggest``.r?rA suggestionsN)rr r!r"r rCrQr#r$r%r&rPrPUs699"U4888K888888r%rPN)r" __future__rdatetimertypingrrrpydanticr r rr(r6rErKrPr$r%r&rVs#"""""=> %%%%%%%% g g g g gI g g g -----I---88888Y888.?????Y???&&&&&Y&&&99999i99999r%