[Task]: Add the ability to query the search endpoint by post and close date ranges (search v1)

[acouch]

---

Migrated from navapbc#163
Originally created by @chouinar on Mon, 22 Jul 2024 16:56:28 GMT

---

Summary

NOTE: This ticket won't implement the query to the search index, but is just modifying the API schema, a follow-up PR will be created to fully connect this work.

We want to add the ability to filter specific date fields in our search endpoint.

For context, our search endpoints request looks like:

{
  "filters": {
    "agency": {
      "one_of": [
        "USAID",
        "ARPAH"
      ]
    },
    "applicant_type": {
      "one_of": [
        "state_governments",
        "county_governments",
        "individuals"
      ]
    },
  },
  "pagination": {
    "order_by": "opportunity_id",
    "page_offset": 1,
    "page_size": 25,
    "sort_direction": "descending"
  },
  "query": "research"
}

We want to support a new set of filters for that will look like:

{
    "post_date": {
          "start_date": "2024-01-01",
          "end_date": "2024-02-01"
    },
    "close_date": {
          "start_date": "2024-01-01",
    },
}

Start and end date will both be optional fields that can be null (we'll treat missing/null as an open-ended range).

---

To make this change, we'll need to modify our OpportunitySearchFilterV1Schema class to have these fields, and configure the allowed fields within the models. Rather than manually define the schemas which would require a lot of additional classes, we can generate the schemas following a similar pattern to how we generate the string search parameters in StrSearchSchemaBuilder, but for dates instead.

Acceptance criteria

• Search request schema is updated (specifically the v1 opportunity search endpoint, ignore v0+v0.1)
• Example requests (defined in opportunity_routes) have been updated, just need to update the "all filters" one.
• Basic unit tests have been added to the opportunity search tests to validate the validations work
  • null values allowed
  • fields not being set allowed
  • errors if you pass in an incorrect type