Create GET "/api/ca_dashboard/stats" endpoint

[aaronskiba]

Changes proposed in this PR:

• Add GET "/api/ca_dashboard/stats" endpoint to fetch "stats"
• The following is an example JSON response returned after a proper request to GET "/api/ca_dashboard/stats":

  {
      "application": "DMP Assistant",
      "source": "GET /api/ca_dashboard/stats",
      "time": "2024-08-14T18:53:15-06:00",
      "caller": "DMP Administrator",
      "code": 200,
      "message": "OK",
      "total_items": 0,
      "stats": {
          "totals": {
              "all_time": {
                  "plans": 13696,
                  "orgs": 127,
                  "users": 17823
              },
              "last_30_days": {
                  "plans": 0,
                  "orgs": 0,
                  "users": 0
              },
              "custom_range": {
                  "plans": 2429,
                  "orgs": 27,
                  "users": 1848
              }
          }
      }
  }

  • The "custom_range": { "plans": 2429, "orgs": 27, "users": 1848 } part of the above JSON structure is only returned when the user specifies a valid start and/or end parameter when making the API request. Otherwise, the following JSON structure is returned:

  {
      "application": "DMP Assistant",
      "source": "GET /api/ca_dashboard/stats",
      "time": "2024-08-14T19:04:31-06:00",
      "caller": "DMP Administrator",
      "code": 200,
      "message": "OK",
      "total_items": 0,
      "stats": {
          "totals": {
              "all_time": {
                  "plans": 13696,
                  "orgs": 127,
                  "users": 17823
              },
              "last_30_days": {
                  "plans": 0,
                  "orgs": 0,
                  "users": 0
              }
          }
      }
  }

[lagoan]

Just a quick question @aaronskiba , why do we have the value "total_items": 0, in the resulting json output?

Is that something we need ?

[aaronskiba]

Good question; I guess that's just being inherited from api/v1/standard_response. I think it corresponds to the number of plans returned, which would always be zero for this new API endpoint:

I guess it does a similar thing when I check api/v1/heartbeat:

{
  "application": "DMP Assistant",
  "source": "GET /api/v1/heartbeat",
  "time": "2024-08-29T18:21:17+00:00",
  "caller": "142.244.108.150",
  "code": 200,
  "message": "OK",
  "total_items": 0,
  "items": [
  ]
}

Here's an API request for a specific plan:

{
  "application": "DMP Assistant",
  "source": "GET /api/v1/plans/id_redacted",
  "time": "2024-08-29T18:18:34+00:00",
  "caller": "DMP Administrator",
  "code": 200,
  "message": "OK",
  "page": 1,
  "per_page": 100,
  "total_items": 1,
  "items": [
    {
      "dmp": {
        "schema": "https://github.com/RDA-DMP-Common/RDA-DMP-Common-Standard/tree/master/examples/JSON/JSON-schema/1.0",
        "title": "v4.1.3 Test"
...

[lagoan]