WIP search params

Author: nikomakela

apps/events-helsinki/README.md

@@ -183,6 +183,61 @@ The application configuration is done via the [AppConfig.ts](./src/domain/app/Ap
 
 > NOTE: This section easily runs out-of-date.
 
+### Main event search
+
+```ts
+    [EVENT_SEARCH_FILTERS.TEXT]: !isEmpty(text) ? text?.join(',') : undefined, // NOTE: only *OngoingAnd supports Array.
+    [EVENT_SEARCH_FILTERS.ONGOING]: true,
+    [EVENT_SEARCH_FILTERS.DIVISIONS]: division,
+    end,
+    include,
+    publisherAncestor,
+    isFree: isFree || undefined,
+    internetBased: onlyRemoteEvents || undefined,
+    keywordOrSet2: [...(keyword ?? []), ...mappedCategories],
+    keywordAnd,
+    keywordNot,
+    language,
+    location: places.sort(),
+    pageSize,
+    publisher,
+    sort: sortOrder,
+    start,
+    startsAfter,
+    superEventType,
+    superEvent,
+    eventType: AppConfig.supportedEventTypes,
+```
+
+The "main events search" component is used in the search page at `/search`.
+
+| parameter         | default value                            | controllable | required | description                                                               |
+| ----------------- | ---------------------------------------- | ------------ | -------- | ------------------------------------------------------------------------- |
+| eventType         | "General"                                | -            | x        | Select only "general" type events                                         |
+| xFullText         | ""                                       | x            | x        | A text scoring mathcher (title, place, description, ...)                  |
+| include           | ['keywords', 'location']                 | -            | x        | Fetch related data from datasource                                        |
+| pageSize          | 10                                       | -            | x        | How many items are fetched per page                                       |
+| place             | Null                                     | x            | -        | Filter by location / venue / place (source: LinkedEvents)                 |
+| sortOrder         | "end_time"                               | x            | x        | Sorting order of the result set. Default is "event end time as ascending" |
+| division          | "ocd-division/country:fi/kunta:helsinki" | -            | x        | Only city of Helsinki events                                              |
+| start             | "now"                                    | x            | x        | Filter by location / venue / place (source: LinkedEvents)                 |
+| startsAfter       | ""                                       | x            | x        |                                                                           |
+| end               | null                                     | x            | x        |                                                                           |
+| keywordAnd        | ""                                       | -            | -        |                                                                           |
+| keywordOrSet2     | ""                                       | -            | -        |                                                                           |
+| keywordNot        | ""                                       | -            | -        |                                                                           |
+| language          | ""                                       | -            | -        |                                                                           |
+| publisher         | ""                                       | -            | -        |                                                                           |
+| publisherAncestor | ""                                       | -            | -        |                                                                           |
+| isFree            | false                                    | -            | -        |                                                                           |
+| internetBased     | false                                    | -            | -        |                                                                           |
+| superEventType    | ""                                       | -            | -        |                                                                           |
+| superEvent        | ""                                       | -            | -        |                                                                           |
+
+### Similar events
+
+### Upcoming events
+
 ## Learn more
 
 You can learn more in the [NextJs documentation](https://nextjs.org/docs/getting-started).