ECP-469: Finalize new search schema

design-documents/graph-ql/coverage/search.md

@@ -0,0 +1,82 @@
+# Queries
+
+```graphql
+type Query {
+    #Filter supports multiple clauses which will be wrapped in logical AND operator
+    productSearch(
+        phrase: String!,
+        "Desired size of the search result page"
+        pageSize: Int = 20,
+        currentPage: Int = 1,
+        filter: [SearchClauseInput],
+        sort: [ProductSearchSortInput]
+    ): ProductSearchResponse!
+}
+
+input ProductSearchSortInput
+{
+    attribute: String!
+    direction: SortEnum!
+}
+
+# If from or to fields are omitted, $gte or $lte filter will be applied
+input SearchRangeInput {
+    from: Float
+    to: Float
+}
+
+input SearchClauseInput {
+    attribute_code: String!
+    in: [String]
+    eq: String
+    range: SearchRangeInput
+}
+
+type ProductSearchResponse {
+    items: [ProductSearchItem]
+    facets: [Aggregation]
+    facets_values: [Aggregation]
+    suggestions: [String]
+    related_terms: [String]
+    page_info: SearchResultPageInfo
+    total_count: Int
+}
+
+type ProductSearchItem {
+    product: ProductInterface!
+    highlights: [Highlight]
+}
+
+type Highlight {
+    attribute: String!
+    value: String!
+    matched_words: [String]!
+}
+
+interface Bucket {
+    #Human readable bucket title
+    title: String!
+}
+
+type StatsBucket implements Bucket {
+    min: Float!
+    max: Float!
+}
+
+type ScalarBucket implements Bucket {
+    #Could be used for filtering and may contain non-human readable data
+    id: ID!
+    count: Int!
+}
+
+type RangeBucket implements Bucket {
+    from: Float!
+    to: Float!
+    count: Int!
+}
+
+interface Aggregation {
+    attribute_code: String!
+    buckets: [Bucket]!
+}
+```