32884 analytics dashboard fill dates (dotCMS#33034)

### Proposed Changes

This pull request refactors the handling of time range options for
analytics queries to improve consistency, maintainability, and type
safety. The main changes include centralizing time range constants,
updating service and store logic to use these new constants, and
adjusting related types and tests accordingly.

**Time Range Constants Refactoring:**

* Introduced a new `TIME_RANGE_OPTIONS` constant for internal time range
keys and a `TIME_RANGE_CUBEJS_MAPPING` for Cube.js-compatible values in
`dot-analytics.constants.ts`. These are now exported via a new
`constants` barrel file.
[[1]](diffhunk://#diff-0d3fae337a838afd84911fc8b3587e656c3c8ddc1e2b3f96bcd4113d9782aa89R1-R15)
[[2]](diffhunk://#diff-9a6d064319b5b88cf3f0a012b5ca60b259eb4ee29e6c26ba78139a9a05a0f346R1)
[[3]](diffhunk://#diff-adb26a280c70da63050345af049168a8480129fb4d4e8d72796fcf6e8590b519R10-R12)
* Removed the old `TimeRangeOptions` and `DEFAULT_TIME_RANGE` from
`common.types.ts`, updating the `TimeRange` type to use the new
constants, and added a new `TimeRangeCubeJS` type for Cube.js
compatibility.

**Service and Store Updates:**

* Updated all methods in `dot-analytics.service.ts` to use
`TIME_RANGE_OPTIONS.last7days` as the default time range and to convert
internal time range keys to Cube.js values using a new private
`#getTimeRange` method.
[[1]](diffhunk://#diff-c0a594cb6bf35693b60035c742263700865b55e180715509ac6b9377ddaeb95bL34-R45)
[[2]](diffhunk://#diff-c0a594cb6bf35693b60035c742263700865b55e180715509ac6b9377ddaeb95bL54-R65)
[[3]](diffhunk://#diff-c0a594cb6bf35693b60035c742263700865b55e180715509ac6b9377ddaeb95bL74-R78)
[[4]](diffhunk://#diff-c0a594cb6bf35693b60035c742263700865b55e180715509ac6b9377ddaeb95bL83-R87)
[[5]](diffhunk://#diff-c0a594cb6bf35693b60035c742263700865b55e180715509ac6b9377ddaeb95bL97-R101)
[[6]](diffhunk://#diff-c0a594cb6bf35693b60035c742263700865b55e180715509ac6b9377ddaeb95bL107-R124)
[[7]](diffhunk://#diff-c0a594cb6bf35693b60035c742263700865b55e180715509ac6b9377ddaeb95bL129-R133)
[[8]](diffhunk://#diff-c0a594cb6bf35693b60035c742263700865b55e180715509ac6b9377ddaeb95bL143-R147)
[[9]](diffhunk://#diff-c0a594cb6bf35693b60035c742263700865b55e180715509ac6b9377ddaeb95bL153-R157)
[[10]](diffhunk://#diff-c0a594cb6bf35693b60035c742263700865b55e180715509ac6b9377ddaeb95bR166-R175)
* Updated the initial state in `dot-analytics-dashboard.store.ts` to use
`TIME_RANGE_OPTIONS.last7days`.
[[1]](diffhunk://#diff-e3042fd9ba0c764b3ca7c9bcb6dfc598a9ffe7a1d69f7b6696b67b6bfd4e8e0aR25)
[[2]](diffhunk://#diff-e3042fd9ba0c764b3ca7c9bcb6dfc598a9ffe7a1d69f7b6696b67b6bfd4e8e0aL46-R47)

**Testing and Utility Adjustments:**

* Updated all related tests and utility usages to reference the new
constants, ensuring that both internal and Cube.js time range values are
used appropriately in assertions and query building.
[[1]](diffhunk://#diff-99331c74e1a5318c227da2286205a09c838813f9e2e732e45c6734cdde4b1793L5-R9)
[[2]](diffhunk://#diff-99331c74e1a5318c227da2286205a09c838813f9e2e732e45c6734cdde4b1793L47-R57)
[[3]](diffhunk://#diff-a11851d401e09fa4b1ba675b0febfb10a15425a8b0e7375b55b6dc0f479d25adL3-R3)
[[4]](diffhunk://#diff-a11851d401e09fa4b1ba675b0febfb10a15425a8b0e7375b55b6dc0f479d25adL157-R175)
[[5]](diffhunk://#diff-a11851d401e09fa4b1ba675b0febfb10a15425a8b0e7375b55b6dc0f479d25adL205-R207)
[[6]](diffhunk://#diff-a11851d401e09fa4b1ba675b0febfb10a15425a8b0e7375b55b6dc0f479d25adL225-R227)
[[7]](diffhunk://#diff-a11851d401e09fa4b1ba675b0febfb10a15425a8b0e7375b55b6dc0f479d25adL236-R238)
[[8]](diffhunk://#diff-a11851d401e09fa4b1ba675b0febfb10a15425a8b0e7375b55b6dc0f479d25adL256-R258)
[[9]](diffhunk://#diff-a11851d401e09fa4b1ba675b0febfb10a15425a8b0e7375b55b6dc0f479d25adL268-R270)
[[10]](diffhunk://#diff-a11851d401e09fa4b1ba675b0febfb10a15425a8b0e7375b55b6dc0f479d25adL290-R292)

### Checklist
- [x] Tests
- [x] Translations
- [x] Security Implications Contemplated (add notes if applicable)

Author: nicobytes

core-web/libs/portlets/dot-analytics/data-access/src/lib/services/dot-analytics.service.ts

@@ -19,7 +19,10 @@ import {
 } from '../../index';
 import { TIME_RANGE_CUBEJS_MAPPING, TIME_RANGE_OPTIONS } from '../constants';
 import { createCubeQuery } from '../utils/cube/cube-query-builder.util';
-import { determineGranularityForTimeRange } from '../utils/data/analytics-data.utils';
+import {
+    determineGranularityForTimeRange,
+    fillMissingDates
+} from '../utils/data/analytics-data.utils';
 
 @Injectable({
     providedIn: 'root'
@@ -111,7 +114,7 @@ export class DotAnalyticsService {
 
         return this.#http
             .post<AnalyticsApiResponse<PageViewTimeLineEntity>>(this.#BASE_URL, query)
-            .pipe(map((response) => response.entity));
+            .pipe(map((response) => fillMissingDates(response.entity, timeRange, granularity)));
     }
 
     /**

core-web/libs/portlets/dot-analytics/data-access/src/lib/utils/data/analytics-data.utils.spec.ts

@@ -1,11 +1,12 @@
-import { startOfDay, endOfDay, addHours } from 'date-fns';
+import { startOfDay, endOfDay, addHours, format } from 'date-fns';
 
 import {
     determineGranularityForTimeRange,
     extractPageTitle,
     extractPageViews,
     extractSessions,
     extractTopPageValue,
+    getDateRange,
     transformDeviceBrowsersData,
     transformPageViewTimeLineData,
     transformTopPagesTableData
@@ -740,4 +741,95 @@ describe('Analytics Data Utils', () => {
             });
         });
     });
+
+    describe('getDateRange', () => {
+        beforeEach(() => {
+            jest.useFakeTimers();
+            jest.setSystemTime(new Date('2024-01-15T04:00:00.000'));
+        });
+
+        afterEach(() => {
+            jest.useRealTimers();
+        });
+
+        describe('success cases', () => {
+            it('should return today range correctly', () => {
+                const result = getDateRange('today');
+                const [startDate, endDate] = result;
+
+                expect(format(startDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-01-15 00:00:00');
+                expect(format(endDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-01-15 23:59:59');
+            });
+
+            it('should return yesterday range correctly', () => {
+                const result = getDateRange('yesterday');
+                const [startDate, endDate] = result;
+
+                expect(format(startDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-01-14 00:00:00');
+                expect(format(endDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-01-14 23:59:59');
+            });
+
+            it('should return last 7 days range correctly', () => {
+                const result = getDateRange('last7days');
+                const [startDate, endDate] = result;
+
+                expect(format(startDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-01-09 00:00:00');
+                expect(format(endDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-01-15 23:59:59');
+            });
+
+            it('should return last 30 days range correctly', () => {
+                const result = getDateRange('last30days');
+                const [startDate, endDate] = result;
+
+                expect(format(startDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2023-12-17 00:00:00');
+                expect(format(endDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-01-15 23:59:59');
+            });
+
+            it('should handle custom date range array correctly', () => {
+                const result = getDateRange(['2024-01-01', '2024-01-31']);
+                const [startDate, endDate] = result;
+
+                expect(format(startDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-01-01 00:00:00');
+                expect(format(endDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-01-31 23:59:59');
+            });
+
+            it('should handle single day custom range correctly', () => {
+                const result = getDateRange(['2024-01-15', '2024-01-15']);
+                const [startDate, endDate] = result;
+
+                expect(format(startDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-01-15 00:00:00');
+                expect(format(endDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-01-15 23:59:59');
+            });
+
+            it('should handle leap year dates correctly', () => {
+                jest.setSystemTime(new Date('2024-02-15T12:00:00.000Z'));
+
+                const result = getDateRange('yesterday');
+                const [startDate, endDate] = result;
+
+                expect(format(startDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-02-14 00:00:00');
+                expect(format(endDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2024-02-14 23:59:59');
+            });
+
+            it('should handle month boundary dates correctly', () => {
+                jest.setSystemTime(new Date('2024-01-01T12:00:00.000Z'));
+
+                const result = getDateRange('yesterday');
+                const [startDate, endDate] = result;
+
+                expect(format(startDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2023-12-31 00:00:00');
+                expect(format(endDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2023-12-31 23:59:59');
+            });
+
+            it('should handle year boundary dates correctly', () => {
+                jest.setSystemTime(new Date('2024-01-01T12:00:00.000Z'));
+
+                const result = getDateRange('yesterday');
+                const [startDate, endDate] = result;
+
+                expect(format(startDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2023-12-31 00:00:00');
+                expect(format(endDate, 'yyyy-MM-dd HH:mm:ss')).toEqual('2023-12-31 23:59:59');
+            });
+        });
+    });
 });

core-web/libs/portlets/dot-analytics/data-access/src/lib/utils/data/analytics-data.utils.ts

@@ -1,4 +1,14 @@
-import { format, isSameDay, isSameMonth, parse } from 'date-fns';
+import {
+    addDays,
+    addHours,
+    endOfDay,
+    format,
+    isSameDay,
+    isSameMonth,
+    parse,
+    startOfDay,
+    subDays
+} from 'date-fns';
 
 import { TIME_RANGE_OPTIONS } from '../../constants';
 import {
@@ -279,3 +289,86 @@ export const transformDeviceBrowsersData = (
         ]
     };
 };
+
+/**
+ * Fills missing dates in the data array based on the granularity
+ * @param data - The data array to fill missing dates
+ * @param granularity - The granularity of the data
+ * @returns The data array with missing dates filled
+ */
+export const fillMissingDates = (
+    data: PageViewTimeLineEntity[],
+    timeRange: TimeRangeInput,
+    granularity: Granularity
+): PageViewTimeLineEntity[] => {
+    if (!data || !Array.isArray(data)) {
+        return [];
+    }
+
+    const [startDate, endDate] = getDateRange(timeRange);
+
+    const dataMap = new Map();
+    data.forEach((item) => {
+        const dateKey = new Date(item['request.createdAt']).toISOString();
+        dataMap.set(dateKey, item);
+    });
+
+    const filledData = [];
+    let currentDate = startDate;
+    while (currentDate <= endDate) {
+        const currentDateKey = currentDate.toISOString();
+
+        if (dataMap.has(currentDateKey)) {
+            filledData.push(dataMap.get(currentDateKey));
+        } else {
+            filledData.push({
+                'request.createdAt': currentDateKey,
+                'request.totalRequest': '0'
+            });
+        }
+        currentDate = granularity === 'hour' ? addHours(currentDate, 1) : addDays(currentDate, 1);
+    }
+
+    return filledData;
+};
+
+/**
+ * Get the date range for the given time range
+ * @param timeRange - The time range to get the date range for
+ * @returns The date range
+ */
+export const getDateRange = (timeRange: TimeRangeInput): [Date, Date] => {
+    const today = new Date();
+
+    if (Array.isArray(timeRange)) {
+        const startDate = startOfDay(parse(timeRange[0], 'yyyy-MM-dd', today));
+        const endDate = endOfDay(parse(timeRange[1], 'yyyy-MM-dd', today));
+
+        return [startDate, endDate];
+    }
+
+    switch (timeRange) {
+        case TIME_RANGE_OPTIONS.today:
+            return [startOfDay(today), endOfDay(today)];
+        case TIME_RANGE_OPTIONS.yesterday: {
+            const yesterday = subDays(today, 1);
+
+            return [startOfDay(yesterday), endOfDay(yesterday)];
+        }
+
+        case TIME_RANGE_OPTIONS.last7days: {
+            const sevenDaysAgo = subDays(today, 6);
+
+            return [startOfDay(sevenDaysAgo), endOfDay(today)];
+        }
+
+        case TIME_RANGE_OPTIONS.last30days: {
+            const thirtyDaysAgo = subDays(today, 29);
+
+            return [startOfDay(thirtyDaysAgo), endOfDay(today)];
+        }
+
+        default:
+            return [startOfDay(today), endOfDay(today)];
+    }
+};

core-web/libs/portlets/dot-analytics/portlet/src/lib/dot-analytics-dashboard/components/dot-analytics-dashboard-chart/dot-analytics-dashboard-chart.component.ts

@@ -151,10 +151,13 @@ export class DotAnalyticsDashboardChartComponent {
                           x: {
                               ticks: {
                                   maxTicksLimit: isMobile ? 6 : 10,
-                                  autoSkip: isMobile,
+                                  autoSkip: true,
                                   maxRotation: 45,
                                   minRotation: 0
                               }
+                          },
+                          y: {
+                              beginAtZero: true
                           }
                       }
                     : undefined