@blackcode_sa/metaestetics-api 1.13.5 → 1.13.8

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

@@ -1,353 +1,353 @@
-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;
-  }
-
-  const quantity = item.quantity || 0;
-
-  // If price override amount is set, use it as price per unit
-  if (item.priceOverrideAmount !== undefined && item.priceOverrideAmount !== null) {
-    return item.priceOverrideAmount * quantity;
-  }
-
-  // Calculate normally: price * quantity
-  const price = item.price || 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.081,
-): 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: [],
-      recommendedProcedures: [],
-      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 now = new Date().toISOString();
-  const itemWithSubtotal: ZoneItemData = {
-    ...item,
-    parentZone: zoneId, // Set parentZone to the zone key
-    subtotal: calculateItemSubtotal(item),
-    createdAt: now,
-    updatedAt: now,
-  };
-
-  // Add item to zone
-  zonesData[zoneId].push(itemWithSubtotal);
-
-  // Recalculate final billing with Swiss tax rate (8.1%)
-  const finalbilling = calculateFinalBilling(zonesData, 0.081);
-
-  // 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 with Swiss tax rate (8.1%)
-  const finalbilling = calculateFinalBilling(metadata.zonesData, 0.081);
-
-  // 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 with updatedAt timestamp
-  items[itemIndex] = {
-    ...items[itemIndex],
-    ...updates,
-    updatedAt: new Date().toISOString(),
-  };
-
-  console.log(`[updateZoneItemUtil] BEFORE recalculation:`, {
-    itemIndex,
-    quantity: items[itemIndex].quantity,
-    priceOverrideAmount: items[itemIndex].priceOverrideAmount,
-    price: items[itemIndex].price,
-    oldSubtotal: items[itemIndex].subtotal,
-  });
-
-  // Recalculate subtotal for this item
-  items[itemIndex].subtotal = calculateItemSubtotal(items[itemIndex]);
-
-  console.log(`[updateZoneItemUtil] AFTER recalculation:`, {
-    itemIndex,
-    newSubtotal: items[itemIndex].subtotal,
-  });
-
-  // Recalculate final billing with Swiss tax rate (8.1%)
-  const finalbilling = calculateFinalBilling(metadata.zonesData, 0.081);
-
-  // 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,
-  });
-}
+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;
+  }
+
+  const quantity = item.quantity || 0;
+
+  // If price override amount is set, use it as price per unit
+  if (item.priceOverrideAmount !== undefined && item.priceOverrideAmount !== null) {
+    return item.priceOverrideAmount * quantity;
+  }
+
+  // Calculate normally: price * quantity
+  const price = item.price || 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.081,
+): 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: [],
+      recommendedProcedures: [],
+      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 now = new Date().toISOString();
+  const itemWithSubtotal: ZoneItemData = {
+    ...item,
+    parentZone: zoneId, // Set parentZone to the zone key
+    subtotal: calculateItemSubtotal(item),
+    createdAt: now,
+    updatedAt: now,
+  };
+
+  // Add item to zone
+  zonesData[zoneId].push(itemWithSubtotal);
+
+  // Recalculate final billing with Swiss tax rate (8.1%)
+  const finalbilling = calculateFinalBilling(zonesData, 0.081);
+
+  // 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 with Swiss tax rate (8.1%)
+  const finalbilling = calculateFinalBilling(metadata.zonesData, 0.081);
+
+  // 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 with updatedAt timestamp
+  items[itemIndex] = {
+    ...items[itemIndex],
+    ...updates,
+    updatedAt: new Date().toISOString(),
+  };
+
+  console.log(`[updateZoneItemUtil] BEFORE recalculation:`, {
+    itemIndex,
+    quantity: items[itemIndex].quantity,
+    priceOverrideAmount: items[itemIndex].priceOverrideAmount,
+    price: items[itemIndex].price,
+    oldSubtotal: items[itemIndex].subtotal,
+  });
+
+  // Recalculate subtotal for this item
+  items[itemIndex].subtotal = calculateItemSubtotal(items[itemIndex]);
+
+  console.log(`[updateZoneItemUtil] AFTER recalculation:`, {
+    itemIndex,
+    newSubtotal: items[itemIndex].subtotal,
+  });
+
+  // Recalculate final billing with Swiss tax rate (8.1%)
+  const finalbilling = calculateFinalBilling(metadata.zonesData, 0.081);
+
+  // 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,
+  });
+}