@blackcode_sa/metaestetics-api 1.13.3 → 1.13.5

package/src/services/analytics/utils/trend-calculation.utils.ts

@@ -1,200 +1,200 @@
-import { Appointment } from '../../../types/appointment';
-import { Timestamp } from 'firebase/firestore';
-
-/**
- * Trend period type
- */
-export type TrendPeriod = 'week' | 'month' | 'quarter' | 'year';
-
-/**
- * Period information for trend grouping
- */
-export interface PeriodInfo {
-  period: string; // e.g., "2024-W01", "2024-01", "2024-Q1", "2024"
-  startDate: Date;
-  endDate: Date;
-}
-
-/**
- * Calculates the start and end dates for a given period
- */
-export function getPeriodDates(date: Date, period: TrendPeriod): PeriodInfo {
-  const year = date.getFullYear();
-  const month = date.getMonth();
-  const day = date.getDate();
-
-  let startDate: Date;
-  let endDate: Date;
-  let periodString: string;
-
-  switch (period) {
-    case 'week': {
-      // Get Monday of the week
-      const dayOfWeek = date.getDay();
-      const diff = date.getDate() - dayOfWeek + (dayOfWeek === 0 ? -6 : 1); // Adjust when day is Sunday
-      startDate = new Date(year, month, diff);
-      startDate.setHours(0, 0, 0, 0);
-      
-      endDate = new Date(startDate);
-      endDate.setDate(endDate.getDate() + 6);
-      endDate.setHours(23, 59, 59, 999);
-
-      // ISO week format: YYYY-Www
-      const weekNumber = getWeekNumber(date);
-      periodString = `${year}-W${weekNumber.toString().padStart(2, '0')}`;
-      break;
-    }
-
-    case 'month': {
-      startDate = new Date(year, month, 1);
-      startDate.setHours(0, 0, 0, 0);
-      
-      endDate = new Date(year, month + 1, 0);
-      endDate.setHours(23, 59, 59, 999);
-
-      periodString = `${year}-${(month + 1).toString().padStart(2, '0')}`;
-      break;
-    }
-
-    case 'quarter': {
-      const quarter = Math.floor(month / 3);
-      const quarterStartMonth = quarter * 3;
-      
-      startDate = new Date(year, quarterStartMonth, 1);
-      startDate.setHours(0, 0, 0, 0);
-      
-      endDate = new Date(year, quarterStartMonth + 3, 0);
-      endDate.setHours(23, 59, 59, 999);
-
-      periodString = `${year}-Q${quarter + 1}`;
-      break;
-    }
-
-    case 'year': {
-      startDate = new Date(year, 0, 1);
-      startDate.setHours(0, 0, 0, 0);
-      
-      endDate = new Date(year, 11, 31);
-      endDate.setHours(23, 59, 59, 999);
-
-      periodString = `${year}`;
-      break;
-    }
-  }
-
-  return {
-    period: periodString,
-    startDate,
-    endDate,
-  };
-}
-
-/**
- * Gets ISO week number for a date
- */
-function getWeekNumber(date: Date): number {
-  const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
-  const dayNum = d.getUTCDay() || 7;
-  d.setUTCDate(d.getUTCDate() + 4 - dayNum);
-  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
-  return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
-}
-
-/**
- * Groups appointments by trend period
- */
-export function groupAppointmentsByPeriod(
-  appointments: Appointment[],
-  period: TrendPeriod,
-): Map<string, Appointment[]> {
-  const periodMap = new Map<string, Appointment[]>();
-
-  appointments.forEach(appointment => {
-    const appointmentDate = appointment.appointmentStartTime.toDate();
-    const periodInfo = getPeriodDates(appointmentDate, period);
-    const periodKey = periodInfo.period;
-
-    if (!periodMap.has(periodKey)) {
-      periodMap.set(periodKey, []);
-    }
-    periodMap.get(periodKey)!.push(appointment);
-  });
-
-  return periodMap;
-}
-
-/**
- * Generates all periods between start and end date for a given period type
- */
-export function generatePeriods(
-  startDate: Date,
-  endDate: Date,
-  period: TrendPeriod,
-): PeriodInfo[] {
-  const periods: PeriodInfo[] = [];
-  const current = new Date(startDate);
-
-  while (current <= endDate) {
-    const periodInfo = getPeriodDates(current, period);
-    
-    // Only add if period overlaps with our date range
-    if (periodInfo.endDate >= startDate && periodInfo.startDate <= endDate) {
-      periods.push(periodInfo);
-    }
-
-    // Move to next period
-    switch (period) {
-      case 'week':
-        current.setDate(current.getDate() + 7);
-        break;
-      case 'month':
-        current.setMonth(current.getMonth() + 1);
-        break;
-      case 'quarter':
-        current.setMonth(current.getMonth() + 3);
-        break;
-      case 'year':
-        current.setFullYear(current.getFullYear() + 1);
-        break;
-    }
-  }
-
-  return periods.sort((a, b) => a.startDate.getTime() - b.startDate.getTime());
-}
-
-/**
- * Calculates percentage change between two values
- * @param current - Current value
- * @param previous - Previous value
- * @returns Percentage change (positive = increase, negative = decrease)
- */
-export function calculatePercentageChange(current: number, previous: number): number {
-  if (previous === 0) {
-    return current > 0 ? 100 : 0;
-  }
-  return ((current - previous) / previous) * 100;
-}
-
-/**
- * Gets trend direction and percentage change
- */
-export interface TrendChange {
-  value: number;
-  previousValue: number;
-  percentageChange: number;
-  direction: 'up' | 'down' | 'stable';
-}
-
-export function getTrendChange(current: number, previous: number): TrendChange {
-  const percentageChange = calculatePercentageChange(current, previous);
-  const direction: 'up' | 'down' | 'stable' =
-    percentageChange > 0.01 ? 'up' : percentageChange < -0.01 ? 'down' : 'stable';
-
-  return {
-    value: current,
-    previousValue: previous,
-    percentageChange: Math.abs(percentageChange),
-    direction,
-  };
-}
-
+import { Appointment } from '../../../types/appointment';
+import { Timestamp } from 'firebase/firestore';
+
+/**
+ * Trend period type
+ */
+export type TrendPeriod = 'week' | 'month' | 'quarter' | 'year';
+
+/**
+ * Period information for trend grouping
+ */
+export interface PeriodInfo {
+  period: string; // e.g., "2024-W01", "2024-01", "2024-Q1", "2024"
+  startDate: Date;
+  endDate: Date;
+}
+
+/**
+ * Calculates the start and end dates for a given period
+ */
+export function getPeriodDates(date: Date, period: TrendPeriod): PeriodInfo {
+  const year = date.getFullYear();
+  const month = date.getMonth();
+  const day = date.getDate();
+
+  let startDate: Date;
+  let endDate: Date;
+  let periodString: string;
+
+  switch (period) {
+    case 'week': {
+      // Get Monday of the week
+      const dayOfWeek = date.getDay();
+      const diff = date.getDate() - dayOfWeek + (dayOfWeek === 0 ? -6 : 1); // Adjust when day is Sunday
+      startDate = new Date(year, month, diff);
+      startDate.setHours(0, 0, 0, 0);
+      
+      endDate = new Date(startDate);
+      endDate.setDate(endDate.getDate() + 6);
+      endDate.setHours(23, 59, 59, 999);
+
+      // ISO week format: YYYY-Www
+      const weekNumber = getWeekNumber(date);
+      periodString = `${year}-W${weekNumber.toString().padStart(2, '0')}`;
+      break;
+    }
+
+    case 'month': {
+      startDate = new Date(year, month, 1);
+      startDate.setHours(0, 0, 0, 0);
+      
+      endDate = new Date(year, month + 1, 0);
+      endDate.setHours(23, 59, 59, 999);
+
+      periodString = `${year}-${(month + 1).toString().padStart(2, '0')}`;
+      break;
+    }
+
+    case 'quarter': {
+      const quarter = Math.floor(month / 3);
+      const quarterStartMonth = quarter * 3;
+      
+      startDate = new Date(year, quarterStartMonth, 1);
+      startDate.setHours(0, 0, 0, 0);
+      
+      endDate = new Date(year, quarterStartMonth + 3, 0);
+      endDate.setHours(23, 59, 59, 999);
+
+      periodString = `${year}-Q${quarter + 1}`;
+      break;
+    }
+
+    case 'year': {
+      startDate = new Date(year, 0, 1);
+      startDate.setHours(0, 0, 0, 0);
+      
+      endDate = new Date(year, 11, 31);
+      endDate.setHours(23, 59, 59, 999);
+
+      periodString = `${year}`;
+      break;
+    }
+  }
+
+  return {
+    period: periodString,
+    startDate,
+    endDate,
+  };
+}
+
+/**
+ * Gets ISO week number for a date
+ */
+function getWeekNumber(date: Date): number {
+  const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+  const dayNum = d.getUTCDay() || 7;
+  d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+  return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+}
+
+/**
+ * Groups appointments by trend period
+ */
+export function groupAppointmentsByPeriod(
+  appointments: Appointment[],
+  period: TrendPeriod,
+): Map<string, Appointment[]> {
+  const periodMap = new Map<string, Appointment[]>();
+
+  appointments.forEach(appointment => {
+    const appointmentDate = appointment.appointmentStartTime.toDate();
+    const periodInfo = getPeriodDates(appointmentDate, period);
+    const periodKey = periodInfo.period;
+
+    if (!periodMap.has(periodKey)) {
+      periodMap.set(periodKey, []);
+    }
+    periodMap.get(periodKey)!.push(appointment);
+  });
+
+  return periodMap;
+}
+
+/**
+ * Generates all periods between start and end date for a given period type
+ */
+export function generatePeriods(
+  startDate: Date,
+  endDate: Date,
+  period: TrendPeriod,
+): PeriodInfo[] {
+  const periods: PeriodInfo[] = [];
+  const current = new Date(startDate);
+
+  while (current <= endDate) {
+    const periodInfo = getPeriodDates(current, period);
+    
+    // Only add if period overlaps with our date range
+    if (periodInfo.endDate >= startDate && periodInfo.startDate <= endDate) {
+      periods.push(periodInfo);
+    }
+
+    // Move to next period
+    switch (period) {
+      case 'week':
+        current.setDate(current.getDate() + 7);
+        break;
+      case 'month':
+        current.setMonth(current.getMonth() + 1);
+        break;
+      case 'quarter':
+        current.setMonth(current.getMonth() + 3);
+        break;
+      case 'year':
+        current.setFullYear(current.getFullYear() + 1);
+        break;
+    }
+  }
+
+  return periods.sort((a, b) => a.startDate.getTime() - b.startDate.getTime());
+}
+
+/**
+ * Calculates percentage change between two values
+ * @param current - Current value
+ * @param previous - Previous value
+ * @returns Percentage change (positive = increase, negative = decrease)
+ */
+export function calculatePercentageChange(current: number, previous: number): number {
+  if (previous === 0) {
+    return current > 0 ? 100 : 0;
+  }
+  return ((current - previous) / previous) * 100;
+}
+
+/**
+ * Gets trend direction and percentage change
+ */
+export interface TrendChange {
+  value: number;
+  previousValue: number;
+  percentageChange: number;
+  direction: 'up' | 'down' | 'stable';
+}
+
+export function getTrendChange(current: number, previous: number): TrendChange {
+  const percentageChange = calculatePercentageChange(current, previous);
+  const direction: 'up' | 'down' | 'stable' =
+    percentageChange > 0.01 ? 'up' : percentageChange < -0.01 ? 'down' : 'stable';
+
+  return {
+    value: current,
+    previousValue: previous,
+    percentageChange: Math.abs(percentageChange),
+    direction,
+  };
+}
+

package/src/services/appointment/README.md

@@ -1,17 +1,17 @@
-# Appointment Service
-
-This service is responsible for managing appointments.
-
-## Methods
-
-### `countCompletedAppointments(patientId: string, clinicBranchId?: string, excludeClinic: boolean = true): Promise<number>`
-
-Counts the number of completed appointments for a given patient.
-
-- `patientId`: The ID of the patient.
-- `clinicBranchId` (optional): The ID of a clinic branch to filter by.
-- `excludeClinic` (optional, default: `true`):
-  - If `true`, it counts appointments _outside_ the specified `clinicBranchId`.
-  - If `false`, it counts appointments _only within_ the specified `clinicBranchId`.
-
-If `clinicBranchId` is not provided, it counts all completed appointments for the patient across all clinics.
+# Appointment Service
+
+This service is responsible for managing appointments.
+
+## Methods
+
+### `countCompletedAppointments(patientId: string, clinicBranchId?: string, excludeClinic: boolean = true): Promise<number>`
+
+Counts the number of completed appointments for a given patient.
+
+- `patientId`: The ID of the patient.
+- `clinicBranchId` (optional): The ID of a clinic branch to filter by.
+- `excludeClinic` (optional, default: `true`):
+  - If `true`, it counts appointments _outside_ the specified `clinicBranchId`.
+  - If `false`, it counts appointments _only within_ the specified `clinicBranchId`.
+
+If `clinicBranchId` is not provided, it counts all completed appointments for the patient across all clinics.