@blackcode_sa/metaestetics-api 1.12.32 → 1.12.34

package/src/services/appointment/utils/form-initialization.utils.ts

@@ -0,0 +1,225 @@
+import { Firestore, collection, doc, addDoc, deleteDoc, getDocs, query, where, serverTimestamp, getDoc } from 'firebase/firestore';
+import {
+  DocumentTemplate,
+  FilledDocumentStatus,
+  DOCTOR_FORMS_SUBCOLLECTION,
+  DOCUMENTATION_TEMPLATES_COLLECTION,
+} from '../../../types/documentation-templates';
+import {
+  APPOINTMENTS_COLLECTION,
+  LinkedFormInfo,
+} from '../../../types/appointment';
+import { TechnologyDocumentationTemplate } from '../../../backoffice/types/technology.types';
+
+export interface InitializeExtendedProcedureFormsResult {
+  initializedFormsInfo: LinkedFormInfo[];
+  pendingUserFormsIds: string[];
+  allLinkedFormIds: string[];
+}
+
+/**
+ * Initializes forms for an extended procedure using client-side Firestore
+ * Similar to DocumentManagerAdminService but for client-side usage
+ * @param db Firestore instance
+ * @param appointmentId Appointment ID
+ * @param procedureId Procedure ID for forms
+ * @param technologyTemplates Technology documentation templates
+ * @param patientId Patient ID
+ * @param practitionerId Practitioner ID
+ * @param clinicId Clinic ID
+ * @returns Form initialization result
+ */
+export async function initializeFormsForExtendedProcedure(
+  db: Firestore,
+  appointmentId: string,
+  procedureId: string,
+  technologyTemplates: TechnologyDocumentationTemplate[],
+  patientId: string,
+  practitionerId: string,
+  clinicId: string
+): Promise<InitializeExtendedProcedureFormsResult> {
+  const initializedFormsInfo: LinkedFormInfo[] = [];
+  const pendingUserFormsIds: string[] = [];
+  const allLinkedFormIds: string[] = [];
+
+  if (!technologyTemplates || technologyTemplates.length === 0) {
+    console.log(
+      `[FormInit] No document templates to initialize for extended procedure ${procedureId} in appointment ${appointmentId}.`
+    );
+    return {
+      initializedFormsInfo,
+      pendingUserFormsIds,
+      allLinkedFormIds,
+    };
+  }
+
+  // Fetch all template documents
+  const templateIds = technologyTemplates.map((t) => t.templateId);
+  
+  // Note: Client-side Firestore doesn't support 'in' queries with more than 10 items
+  // We'll fetch templates one by one for now (can be optimized later)
+  const templatesMap = new Map<string, DocumentTemplate>();
+  
+  for (const templateId of templateIds) {
+    try {
+      const templateDoc = doc(db, DOCUMENTATION_TEMPLATES_COLLECTION, templateId);
+      const templateSnap = await getDoc(templateDoc);
+      
+      if (templateSnap.exists()) {
+        templatesMap.set(templateId, templateSnap.data() as DocumentTemplate);
+      } else {
+        console.warn(
+          `[FormInit] Template ${templateId} not found in Firestore.`
+        );
+      }
+    } catch (error) {
+      console.error(`[FormInit] Error fetching template ${templateId}:`, error);
+    }
+  }
+
+  // Initialize forms for each template (only doctor forms for extended procedures)
+  for (const templateRef of technologyTemplates) {
+    const template = templatesMap.get(templateRef.templateId);
+    if (!template) {
+      console.warn(
+        `[FormInit] Template ${templateRef.templateId} not found in Firestore.`
+      );
+      continue;
+    }
+
+    // Skip user forms - only create doctor forms for extended procedures
+    if (templateRef.isUserForm) {
+      console.log(
+        `[FormInit] Skipping user form ${templateRef.templateId} for extended procedure ${procedureId}.`
+      );
+      continue;
+    }
+
+    const isRequired = templateRef.isRequired;
+    const formSubcollectionPath = DOCTOR_FORMS_SUBCOLLECTION;
+
+    // Create form document in subcollection
+    const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
+    const formsCollectionRef = collection(appointmentRef, formSubcollectionPath);
+    
+    const filledDocumentData = {
+      templateId: templateRef.templateId,
+      templateVersion: template.version,
+      isUserForm: false, // Always false for extended procedures
+      isRequired: isRequired,
+      appointmentId: appointmentId,
+      procedureId: procedureId,
+      patientId: patientId,
+      practitionerId: practitionerId,
+      clinicId: clinicId,
+      createdAt: serverTimestamp(),
+      updatedAt: serverTimestamp(),
+      values: {},
+      status: FilledDocumentStatus.PENDING,
+    };
+
+    try {
+      const docRef = await addDoc(formsCollectionRef, filledDocumentData);
+      const filledDocumentId = docRef.id;
+
+      // No user forms for extended procedures, so no pending user forms
+
+      allLinkedFormIds.push(filledDocumentId);
+
+      const linkedForm: LinkedFormInfo = {
+        formId: filledDocumentId,
+        templateId: template.id,
+        templateVersion: template.version,
+        title: template.title,
+        isUserForm: false, // Always false for extended procedures
+        isRequired: isRequired,
+        sortingOrder: templateRef.sortingOrder,
+        status: FilledDocumentStatus.PENDING,
+        path: docRef.path,
+      };
+      initializedFormsInfo.push(linkedForm);
+
+      console.log(
+        `[FormInit] Created FilledDocument ${filledDocumentId} (template: ${template.id}) for extended procedure ${procedureId} in appointment ${appointmentId}.`
+      );
+    } catch (error) {
+      console.error(
+        `[FormInit] Error creating form for template ${templateRef.templateId}:`,
+        error
+      );
+    }
+  }
+
+  return { initializedFormsInfo, pendingUserFormsIds, allLinkedFormIds };
+}
+
+/**
+ * Removes all forms associated with a specific procedure from an appointment
+ * @param db Firestore instance
+ * @param appointmentId Appointment ID
+ * @param procedureId Procedure ID to remove forms for
+ * @returns Array of removed form IDs
+ */
+export async function removeFormsForExtendedProcedure(
+  db: Firestore,
+  appointmentId: string,
+  procedureId: string
+): Promise<string[]> {
+  const removedFormIds: string[] = [];
+
+  // Only remove from doctor forms subcollection (no user forms for extended procedures)
+  const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
+  const doctorFormsRef = collection(appointmentRef, DOCTOR_FORMS_SUBCOLLECTION);
+
+  // Query doctor forms for this procedure
+  const doctorFormsQuery = query(
+    doctorFormsRef,
+    where('procedureId', '==', procedureId)
+  );
+  const doctorFormsSnap = await getDocs(doctorFormsQuery);
+
+  for (const formDoc of doctorFormsSnap.docs) {
+    try {
+      await deleteDoc(formDoc.ref);
+      removedFormIds.push(formDoc.id);
+      console.log(
+        `[FormInit] Removed doctor form ${formDoc.id} for extended procedure ${procedureId} from appointment ${appointmentId}.`
+      );
+    } catch (error) {
+      console.error(
+        `[FormInit] Error removing doctor form ${formDoc.id}:`,
+        error
+      );
+    }
+  }
+
+  return removedFormIds;
+}
+
+/**
+ * Gets all forms associated with a specific procedure in an appointment
+ * @param db Firestore instance
+ * @param appointmentId Appointment ID
+ * @param procedureId Procedure ID
+ * @returns Array of form IDs
+ */
+export async function getFormsForExtendedProcedure(
+  db: Firestore,
+  appointmentId: string,
+  procedureId: string
+): Promise<string[]> {
+  const formIds: string[] = [];
+
+  const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
+  const doctorFormsRef = collection(appointmentRef, DOCTOR_FORMS_SUBCOLLECTION);
+
+  // Query doctor forms for this procedure
+  const doctorFormsQuery = query(
+    doctorFormsRef,
+    where('procedureId', '==', procedureId)
+  );
+  const doctorFormsSnap = await getDocs(doctorFormsQuery);
+  doctorFormsSnap.docs.forEach(doc => formIds.push(doc.id));
+
+  return formIds;
+}

package/src/services/appointment/utils/zone-management.utils.ts

@@ -0,0 +1,335 @@
+import { Firestore, getDoc, updateDoc, serverTimestamp } from 'firebase/firestore';
+import {
+  ZoneItemData,
+  AppointmentMetadata,
+  FinalBilling,
+  Appointment,
+  APPOINTMENTS_COLLECTION,
+} from '../../../types/appointment';
+import { getAppointmentByIdUtil } from './appointment.utils';
+import { doc } from 'firebase/firestore';
+
+/**
+ * Validates that a zone key follows the category.zone format
+ * @param zoneKey Zone key to validate
+ * @throws Error if format is invalid
+ */
+export function validateZoneKeyFormat(zoneKey: string): void {
+  const parts = zoneKey.split('.');
+  if (parts.length !== 2) {
+    throw new Error(
+      `Invalid zone key format: "${zoneKey}". Must be "category.zone" (e.g., "face.forehead")`
+    );
+  }
+}
+
+/**
+ * Calculates subtotal for a zone item
+ * @param item Zone item data
+ * @returns Calculated subtotal
+ */
+export function calculateItemSubtotal(item: Partial<ZoneItemData>): number {
+  if (item.type === 'note') {
+    return 0;
+  }
+
+  // If price override amount is set, use it
+  if (item.priceOverrideAmount !== undefined && item.priceOverrideAmount !== null) {
+    return item.priceOverrideAmount;
+  }
+
+  // Calculate normally: price * quantity
+  const price = item.price || 0;
+  const quantity = item.quantity || 0;
+  return price * quantity;
+}
+
+/**
+ * Recalculates final billing based on all zone items
+ * @param zonesData Zone items data
+ * @param taxRate Tax rate (e.g., 0.20 for 20%)
+ * @returns Calculated final billing
+ */
+export function calculateFinalBilling(
+  zonesData: Record<string, ZoneItemData[]>,
+  taxRate: number = 0.20
+): FinalBilling {
+  let subtotalAll = 0;
+
+  // Sum up all zone items
+  Object.values(zonesData).forEach(items => {
+    items.forEach(item => {
+      if (item.type === 'item' && item.subtotal) {
+        subtotalAll += item.subtotal;
+      }
+    });
+  });
+
+  const taxPrice = subtotalAll * taxRate;
+  const finalPrice = subtotalAll + taxPrice;
+
+  // Get currency from first item (assuming all same currency)
+  let currency: any = 'CHF'; // Default
+
+  for (const items of Object.values(zonesData)) {
+    const firstItem = items.find(i => i.type === 'item');
+    if (firstItem) {
+      currency = firstItem.currency || currency;
+      break;
+    }
+  }
+
+  return {
+    subtotalAll,
+    taxRate,
+    taxPrice,
+    finalPrice,
+    currency,
+  };
+}
+
+/**
+ * Gets appointment and validates it exists
+ * @param db Firestore instance
+ * @param appointmentId Appointment ID
+ * @returns Appointment document
+ */
+export async function getAppointmentOrThrow(
+  db: Firestore,
+  appointmentId: string
+): Promise<Appointment> {
+  const appointment = await getAppointmentByIdUtil(db, appointmentId);
+  if (!appointment) {
+    throw new Error(`Appointment with ID ${appointmentId} not found`);
+  }
+  return appointment;
+}
+
+/**
+ * Initializes appointment metadata if it doesn't exist
+ * @param appointment Appointment document
+ * @returns Initialized metadata
+ */
+export function initializeMetadata(
+  appointment: Appointment
+): AppointmentMetadata {
+  return appointment.metadata || {
+    selectedZones: null,
+    zonePhotos: null,
+    zonesData: null,
+    appointmentProducts: [],
+    extendedProcedures: [],
+    finalbilling: null,
+    finalizationNotes: null,
+  };
+}
+
+/**
+ * Adds an item to a specific zone
+ * @param db Firestore instance
+ * @param appointmentId Appointment ID
+ * @param zoneId Zone ID (must be category.zone format)
+ * @param item Zone item data to add (without parentZone)
+ * @returns Updated appointment
+ */
+export async function addItemToZoneUtil(
+  db: Firestore,
+  appointmentId: string,
+  zoneId: string,
+  item: Omit<ZoneItemData, 'subtotal' | 'parentZone'>
+): Promise<Appointment> {
+  // Validate zone key format
+  validateZoneKeyFormat(zoneId);
+
+  // Get appointment
+  const appointment = await getAppointmentOrThrow(db, appointmentId);
+  const metadata = initializeMetadata(appointment);
+
+  // Initialize zonesData if needed
+  const zonesData = metadata.zonesData || {};
+
+  // Initialize zone array if needed
+  if (!zonesData[zoneId]) {
+    zonesData[zoneId] = [];
+  }
+
+  // Calculate subtotal for the item
+  const itemWithSubtotal: ZoneItemData = {
+    ...item,
+    parentZone: zoneId, // Set parentZone to the zone key
+    subtotal: calculateItemSubtotal(item),
+  };
+
+  // Add item to zone
+  zonesData[zoneId].push(itemWithSubtotal);
+
+  // Recalculate final billing
+  const finalbilling = calculateFinalBilling(zonesData); //TODO: add correct amount of tax
+
+  // Update appointment
+  const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
+  await updateDoc(appointmentRef, {
+    'metadata.zonesData': zonesData,
+    'metadata.finalbilling': finalbilling,
+    updatedAt: serverTimestamp(),
+  });
+
+  // Return updated appointment
+  return getAppointmentOrThrow(db, appointmentId);
+}
+
+/**
+ * Removes an item from a specific zone
+ * @param db Firestore instance
+ * @param appointmentId Appointment ID
+ * @param zoneId Zone ID
+ * @param itemIndex Index of item to remove
+ * @returns Updated appointment
+ */
+export async function removeItemFromZoneUtil(
+  db: Firestore,
+  appointmentId: string,
+  zoneId: string,
+  itemIndex: number
+): Promise<Appointment> {
+  validateZoneKeyFormat(zoneId);
+
+  const appointment = await getAppointmentOrThrow(db, appointmentId);
+  const metadata = initializeMetadata(appointment);
+
+  if (!metadata.zonesData || !metadata.zonesData[zoneId]) {
+    throw new Error(`No items found for zone ${zoneId}`);
+  }
+
+  const items = metadata.zonesData[zoneId];
+  if (itemIndex < 0 || itemIndex >= items.length) {
+    throw new Error(`Invalid item index ${itemIndex} for zone ${zoneId}`);
+  }
+
+  // Remove item
+  items.splice(itemIndex, 1);
+
+  // If zone is now empty, remove it
+  if (items.length === 0) {
+    delete metadata.zonesData[zoneId];
+  }
+
+  // Recalculate final billing
+  const finalbilling = calculateFinalBilling(metadata.zonesData); //TODO: add correct amount of tax
+
+  // Update appointment
+  const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
+  await updateDoc(appointmentRef, {
+    'metadata.zonesData': metadata.zonesData,
+    'metadata.finalbilling': finalbilling,
+    updatedAt: serverTimestamp(),
+  });
+
+  return getAppointmentOrThrow(db, appointmentId);
+}
+
+/**
+ * Updates a specific item in a zone
+ * @param db Firestore instance
+ * @param appointmentId Appointment ID
+ * @param zoneId Zone ID
+ * @param itemIndex Index of item to update
+ * @param updates Partial updates to apply
+ * @returns Updated appointment
+ */
+export async function updateZoneItemUtil(
+  db: Firestore,
+  appointmentId: string,
+  zoneId: string,
+  itemIndex: number,
+  updates: Partial<ZoneItemData>
+): Promise<Appointment> {
+  validateZoneKeyFormat(zoneId);
+
+  const appointment = await getAppointmentOrThrow(db, appointmentId);
+  const metadata = initializeMetadata(appointment);
+
+  if (!metadata.zonesData || !metadata.zonesData[zoneId]) {
+    throw new Error(`No items found for zone ${zoneId}`);
+  }
+
+  const items = metadata.zonesData[zoneId];
+  if (itemIndex < 0 || itemIndex >= items.length) {
+    throw new Error(`Invalid item index ${itemIndex} for zone ${zoneId}`);
+  }
+
+  // Update item
+  items[itemIndex] = {
+    ...items[itemIndex],
+    ...updates,
+  };
+
+  // Recalculate subtotal for this item
+  items[itemIndex].subtotal = calculateItemSubtotal(items[itemIndex]);
+
+  // Recalculate final billing
+  const finalbilling = calculateFinalBilling(metadata.zonesData); //TODO: add correct amount of tax
+
+  // Update appointment
+  const appointmentRef = doc(db, APPOINTMENTS_COLLECTION, appointmentId);
+  await updateDoc(appointmentRef, {
+    'metadata.zonesData': metadata.zonesData,
+    'metadata.finalbilling': finalbilling,
+    updatedAt: serverTimestamp(),
+  });
+
+  return getAppointmentOrThrow(db, appointmentId);
+}
+
+/**
+ * Overrides price for a specific zone item
+ * @param db Firestore instance
+ * @param appointmentId Appointment ID
+ * @param zoneId Zone ID
+ * @param itemIndex Index of item
+ * @param newPrice New price amount
+ * @returns Updated appointment
+ */
+export async function overridePriceForZoneItemUtil(
+  db: Firestore,
+  appointmentId: string,
+  zoneId: string,
+  itemIndex: number,
+  newPrice: number
+): Promise<Appointment> {
+  return updateZoneItemUtil(db, appointmentId, zoneId, itemIndex, {
+    priceOverrideAmount: newPrice,
+  });
+}
+
+/**
+ * Updates subzones for a specific zone item
+ * @param db Firestore instance
+ * @param appointmentId Appointment ID
+ * @param zoneId Zone ID
+ * @param itemIndex Index of item
+ * @param subzones Array of subzone keys (empty array = entire zone)
+ * @returns Updated appointment
+ */
+export async function updateSubzonesUtil(
+  db: Firestore,
+  appointmentId: string,
+  zoneId: string,
+  itemIndex: number,
+  subzones: string[]
+): Promise<Appointment> {
+  // Validate subzone format if provided
+  subzones.forEach(subzone => {
+    const parts = subzone.split('.');
+    if (parts.length !== 3) {
+      throw new Error(
+        `Invalid subzone format: "${subzone}". Must be "category.zone.subzone" (e.g., "face.forehead.left")`
+      );
+    }
+  });
+
+  return updateZoneItemUtil(db, appointmentId, zoneId, itemIndex, {
+    subzones,
+  });
+}
+

package/src/services/patient/patient.service.ts

@@ -93,6 +93,17 @@ import {
   getActiveInviteTokensByPatientUtil,
 } from './utils';
 
+import {
+  getAestheticAnalysisUtil,
+  createOrUpdateAestheticAnalysisUtil,
+} from './utils/aesthetic-analysis.utils';
+
+import {
+  AestheticAnalysis,
+  CreateAestheticAnalysisData,
+  UpdateAestheticAnalysisData,
+} from '../../types/patient';
+
 import { CreatePatientTokenData, PatientToken } from '../../types/patient/token.types';
 
 export class PatientService extends BaseService {
@@ -834,4 +845,39 @@ export class PatientService extends BaseService {
     // the admin has permission to view this patient's tokens.
     return getActiveInviteTokensByPatientUtil(this.db, patientId);
   }
+
+  async getAestheticAnalysis(patientId: string): Promise<AestheticAnalysis | null> {
+    const currentUser = await this.getCurrentUser();
+    return getAestheticAnalysisUtil(this.db, patientId, currentUser.uid, currentUser.roles);
+  }
+
+  async createAestheticAnalysis(
+    patientId: string,
+    data: CreateAestheticAnalysisData
+  ): Promise<void> {
+    const currentUser = await this.getCurrentUser();
+    return createOrUpdateAestheticAnalysisUtil(
+      this.db,
+      patientId,
+      data,
+      currentUser.uid,
+      currentUser.roles,
+      false
+    );
+  }
+
+  async updateAestheticAnalysis(
+    patientId: string,
+    data: UpdateAestheticAnalysisData
+  ): Promise<void> {
+    const currentUser = await this.getCurrentUser();
+    return createOrUpdateAestheticAnalysisUtil(
+      this.db,
+      patientId,
+      data,
+      currentUser.uid,
+      currentUser.roles,
+      true
+    );
+  }
 }

package/src/services/procedure/procedure.service.ts

@@ -1508,4 +1508,58 @@ export class ProcedureService extends BaseService {
     });
     return proceduresForMap;
   }
+
+  /**
+   * Gets procedures filtered by clinic and practitioner with optional family filter
+   * @param clinicBranchId Clinic branch ID to filter by
+   * @param practitionerId Practitioner ID to filter by
+   * @param filterByFamily If true, shows only procedures of the same family as the default procedure
+   * @param defaultProcedureId Optional default procedure ID to determine the family
+   * @returns Array of procedures
+   */
+  async getProceduresForConsultation(
+    clinicBranchId: string,
+    practitionerId: string,
+    filterByFamily: boolean = true,
+    defaultProcedureId?: string
+  ): Promise<Procedure[]> {
+    let familyToFilter: ProcedureFamily | null = null;
+
+    // If family filtering is enabled and we have a default procedure, get its family
+    if (filterByFamily && defaultProcedureId) {
+      const defaultProcedureRef = doc(this.db, PROCEDURES_COLLECTION, defaultProcedureId);
+      const defaultProcedureSnap = await getDoc(defaultProcedureRef);
+      
+      if (defaultProcedureSnap.exists()) {
+        const defaultProcedure = defaultProcedureSnap.data() as Procedure;
+        familyToFilter = defaultProcedure.family;
+      }
+    }
+
+    // Build query constraints
+    const constraints: QueryConstraint[] = [
+      where('clinicBranchId', '==', clinicBranchId),
+      where('practitionerId', '==', practitionerId),
+      where('isActive', '==', true),
+    ];
+
+    // Add family filter if applicable
+    if (filterByFamily && familyToFilter) {
+      constraints.push(where('family', '==', familyToFilter));
+    }
+
+    // Execute query
+    const proceduresQuery = query(
+      collection(this.db, PROCEDURES_COLLECTION),
+      ...constraints,
+      orderBy('name', 'asc')
+    );
+
+    const querySnapshot = await getDocs(proceduresQuery);
+    
+    return querySnapshot.docs.map(doc => ({
+      id: doc.id,
+      ...doc.data(),
+    } as Procedure));
+  }
 }