@blackcode_sa/metaestetics-api 1.12.67 → 1.12.69

package/src/admin/aggregation/appointment/appointment.aggregation.service.ts

@@ -37,6 +37,7 @@ import { AppointmentMailingService } from '../../mailing/appointment/appointment
 import { Logger } from '../../logger';
 import { UserRole } from '../../../types';
 import { CalendarEventStatus } from '../../../types/calendar';
+import { NotificationType } from '../../../types/notifications';
 
 // Mailgun client will be injected via constructor
 
@@ -540,6 +541,13 @@ export class AppointmentAggregationService {
         await this.handleZonePhotosUpdate(before, after);
       }
 
+      // Handle Recommended Procedures Added
+      const recommendationsChanged = this.hasRecommendationsChanged(before, after);
+      if (recommendationsChanged) {
+        Logger.info(`[AggService] Recommended procedures changed for appointment ${after.id}`);
+        await this.handleRecommendedProceduresUpdate(before, after, patientProfile);
+      }
+
       // TODO: Handle Review Added
       // const reviewAdded = !before.reviewInfo && after.reviewInfo;
       // if (reviewAdded) { ... }
@@ -1841,4 +1849,136 @@ export class AppointmentAggregationService {
       // Don't throw - this is a side effect and shouldn't break the main update flow
     }
   }
+
+  /**
+   * Checks if recommended procedures have changed between two appointment states
+   * @param before - The appointment state before update
+   * @param after - The appointment state after update
+   * @returns True if recommendations have changed, false otherwise
+   */
+  private hasRecommendationsChanged(before: Appointment, after: Appointment): boolean {
+    const beforeRecommendations = before.metadata?.recommendedProcedures || [];
+    const afterRecommendations = after.metadata?.recommendedProcedures || [];
+
+    // If lengths differ, there's a change
+    if (beforeRecommendations.length !== afterRecommendations.length) {
+      return true;
+    }
+
+    // Compare each recommendation (simple comparison - if any differ, return true)
+    // For simplicity, we compare by procedure ID and note
+    for (let i = 0; i < afterRecommendations.length; i++) {
+      const beforeRec = beforeRecommendations[i];
+      const afterRec = afterRecommendations[i];
+
+      if (!beforeRec || !afterRec) {
+        return true;
+      }
+
+      if (
+        beforeRec.procedure.procedureId !== afterRec.procedure.procedureId ||
+        beforeRec.note !== afterRec.note ||
+        beforeRec.timeframe.value !== afterRec.timeframe.value ||
+        beforeRec.timeframe.unit !== afterRec.timeframe.unit
+      ) {
+        return true;
+      }
+    }
+
+    return false;
+  }
+
+  /**
+   * Handles recommended procedures update - creates notifications for newly added recommendations
+   * @param before - The appointment state before update
+   * @param after - The appointment state after update
+   * @param patientProfile - The patient profile (for expo tokens)
+   */
+  private async handleRecommendedProceduresUpdate(
+    before: Appointment,
+    after: Appointment,
+    patientProfile: PatientProfile | null,
+  ): Promise<void> {
+    try {
+      const beforeRecommendations = before.metadata?.recommendedProcedures || [];
+      const afterRecommendations = after.metadata?.recommendedProcedures || [];
+
+      // Find newly added recommendations
+      const newRecommendations = afterRecommendations.slice(beforeRecommendations.length);
+
+      if (newRecommendations.length === 0) {
+        Logger.info(
+          `[AggService] No new recommendations detected for appointment ${after.id}`,
+        );
+        return;
+      }
+
+      Logger.info(
+        `[AggService] Found ${newRecommendations.length} new recommendation(s) for appointment ${after.id}`,
+      );
+
+      // Create notifications for each new recommendation
+      for (let i = 0; i < newRecommendations.length; i++) {
+        const recommendation = newRecommendations[i];
+        const recommendationIndex = beforeRecommendations.length + i;
+        const recommendationId = `${after.id}:${recommendationIndex}`;
+
+        // Format timeframe for display
+        const timeframeText = `${recommendation.timeframe.value} ${recommendation.timeframe.unit}${recommendation.timeframe.value > 1 ? 's' : ''}`;
+
+        // Create notification
+        const notificationPayload: Omit<
+          any,
+          'id' | 'createdAt' | 'updatedAt' | 'status' | 'isRead'
+        > = {
+          userId: after.patientId,
+          userRole: UserRole.PATIENT,
+          notificationType: NotificationType.PROCEDURE_RECOMMENDATION,
+          notificationTime: admin.firestore.Timestamp.now(),
+          notificationTokens: patientProfile?.expoTokens || [],
+          title: 'New Procedure Recommendation',
+          body: `${after.practitionerInfo?.name || 'Your doctor'} recommended "${recommendation.procedure.procedureName}" for you. Suggested timeframe: in ${timeframeText}`,
+          appointmentId: after.id,
+          recommendationId,
+          procedureId: recommendation.procedure.procedureId,
+          procedureName: recommendation.procedure.procedureName,
+          practitionerName: after.practitionerInfo?.name || 'Unknown Practitioner',
+          clinicName: after.clinicInfo?.name || 'Unknown Clinic',
+          note: recommendation.note,
+          timeframe: recommendation.timeframe,
+        };
+
+        try {
+          const notificationId = await this.notificationsAdmin.createNotification(
+            notificationPayload as any,
+          );
+
+          Logger.info(
+            `[AggService] Created notification ${notificationId} for recommendation ${recommendationId}`,
+          );
+
+          // Send push notification immediately if patient has tokens
+          if (patientProfile?.expoTokens && patientProfile.expoTokens.length > 0) {
+            const notification = await this.notificationsAdmin.getNotification(notificationId);
+            if (notification) {
+              await this.notificationsAdmin.sendPushNotification(notification);
+              Logger.info(
+                `[AggService] Sent push notification for recommendation ${recommendationId}`,
+              );
+            }
+          }
+        } catch (error) {
+          Logger.error(
+            `[AggService] Error creating notification for recommendation ${recommendationId}:`,
+            error,
+          );
+        }
+      }
+    } catch (error) {
+      Logger.error(
+        `[AggService] Error handling recommended procedures update for appointment ${after.id}:`,
+        error,
+      );
+    }
+  }
 }

package/src/backoffice/services/README.md

@@ -38,3 +38,20 @@ Manages administrative constants like treatment benefits and contraindications.
 - **`addContraindication(contraindication)`**: Adds a new contraindication.
 - **`updateContraindication(contraindication)`**: Updates an existing contraindication.
 - **`deleteContraindication(contraindicationId)`**: Deletes a contraindication.
+
+### `AnalyticsService` (Proposed)
+
+Comprehensive financial and analytical intelligence service for the Clinic Admin app. Provides insights about doctors, procedures, appointments, patients, products, and clinic operations.
+
+**Status**: Proposal phase - See [analytics.service.proposal.md](./analytics.service.proposal.md) for detailed design and implementation plan.
+
+**Planned Features**:
+- Practitioner performance analytics (appointments, cancellations, time efficiency, revenue)
+- Procedure analytics (popularity, profitability, product usage)
+- Appointment time analytics (booked vs actual time, efficiency metrics)
+- Cancellation & no-show analytics (by clinic, practitioner, patient, procedure)
+- Financial analytics (revenue, costs, payment status, trends)
+- Product usage analytics (usage patterns, revenue contribution)
+- Patient analytics (lifetime value, retention, appointment frequency)
+- Clinic analytics (performance metrics, comparisons)
+- Comprehensive dashboard data aggregation