@blackcode_sa/metaestetics-api 1.12.61 → 1.12.62

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

@@ -1,1682 +1,1682 @@
-import {
-  collection,
-  doc,
-  getDoc,
-  getDocs,
-  query,
-  where,
-  updateDoc,
-  setDoc,
-  deleteDoc,
-  Timestamp,
-  serverTimestamp,
-  DocumentData,
-  writeBatch,
-  arrayUnion,
-  arrayRemove,
-  FieldValue,
-  orderBy,
-  limit,
-  startAfter,
-  QueryConstraint,
-  documentId,
-} from 'firebase/firestore';
-import { BaseService } from '../base.service';
-import {
-  Procedure,
-  CreateProcedureData,
-  UpdateProcedureData,
-  PROCEDURES_COLLECTION,
-  ProcedureSummaryInfo,
-} from '../../types/procedure';
-import { createProcedureSchema, updateProcedureSchema } from '../../validations/procedure.schema';
-import { z } from 'zod';
-import { Auth } from 'firebase/auth';
-import { Firestore } from 'firebase/firestore';
-import { FirebaseApp } from 'firebase/app';
-import { Category, CATEGORIES_COLLECTION } from '../../backoffice/types/category.types';
-import { Subcategory, SUBCATEGORIES_COLLECTION } from '../../backoffice/types/subcategory.types';
-import { Technology, TECHNOLOGIES_COLLECTION } from '../../backoffice/types/technology.types';
-import { Product, PRODUCTS_COLLECTION } from '../../backoffice/types/product.types';
-import { CategoryService } from '../../backoffice/services/category.service';
-import { SubcategoryService } from '../../backoffice/services/subcategory.service';
-import { TechnologyService } from '../../backoffice/services/technology.service';
-import { ProductService } from '../../backoffice/services/product.service';
-import { Practitioner, PRACTITIONERS_COLLECTION } from '../../types/practitioner';
-import {
-  CertificationLevel,
-  CertificationSpecialty,
-  ProcedureFamily,
-  type TreatmentBenefitDynamic,
-} from '../../backoffice/types';
-import { Currency, PricingMeasure } from '../../backoffice/types/static/pricing.types';
-import { Clinic, CLINICS_COLLECTION } from '../../types/clinic';
-import { ProcedureReviewInfo } from '../../types/reviews';
-import { distanceBetween, geohashQueryBounds } from 'geofire-common';
-import { MediaService, MediaAccessLevel } from '../media/media.service';
-import type { ProcedureProduct } from '../../backoffice/types/procedure-product.types';
-
-export class ProcedureService extends BaseService {
-  private categoryService: CategoryService;
-  private subcategoryService: SubcategoryService;
-  private technologyService: TechnologyService;
-  private productService: ProductService;
-  private mediaService: MediaService;
-
-  constructor(
-    db: Firestore,
-    auth: Auth,
-    app: FirebaseApp,
-    categoryService: CategoryService,
-    subcategoryService: SubcategoryService,
-    technologyService: TechnologyService,
-    productService: ProductService,
-    mediaService: MediaService,
-  ) {
-    super(db, auth, app);
-    this.categoryService = categoryService;
-    this.subcategoryService = subcategoryService;
-    this.technologyService = technologyService;
-    this.productService = productService;
-    this.mediaService = mediaService;
-  }
-
-  /**
-   * Process media resource (string URL or File object)
-   * @param media String URL or File object
-   * @param ownerId Owner ID for the media (usually procedureId)
-   * @param collectionName Collection name for organizing files
-   * @returns URL string after processing
-   */
-  private async processMedia(
-    media: string | File | Blob | null | undefined,
-    ownerId: string,
-    collectionName: string,
-  ): Promise<string | null> {
-    if (!media) return null;
-
-    // If already a string URL, return it directly
-    if (typeof media === 'string') {
-      return media;
-    }
-
-    // If it's a File, upload it using MediaService
-    if (media instanceof File || media instanceof Blob) {
-      console.log(`[ProcedureService] Uploading ${collectionName} media for ${ownerId}`);
-      const metadata = await this.mediaService.uploadMedia(
-        media,
-        ownerId,
-        MediaAccessLevel.PUBLIC,
-        collectionName,
-      );
-      return metadata.url;
-    }
-
-    return null;
-  }
-
-  /**
-   * Process array of media resources (strings or Files)
-   * @param mediaArray Array of string URLs or File objects
-   * @param ownerId Owner ID for the media
-   * @param collectionName Collection name for organizing files
-   * @returns Array of URL strings after processing
-   */
-  private async processMediaArray(
-    mediaArray: (string | File | Blob)[] | undefined,
-    ownerId: string,
-    collectionName: string,
-  ): Promise<string[]> {
-    if (!mediaArray || mediaArray.length === 0) return [];
-
-    const result: string[] = [];
-
-    for (const media of mediaArray) {
-      const processedUrl = await this.processMedia(media, ownerId, collectionName);
-      if (processedUrl) {
-        result.push(processedUrl);
-      }
-    }
-
-    return result;
-  }
-
-  /**
-   * Transforms validated procedure product data (with productId) to ProcedureProduct objects (with full product)
-   * @param productsMetadata Array of validated procedure product data (optional)
-   * @param technologyId Technology ID to fetch products from
-   * @returns Array of ProcedureProduct objects with full product information
-   */
-  private async transformProductsMetadata(
-    productsMetadata: {
-      productId: string;
-      price: number;
-      currency: Currency;
-      pricingMeasure: PricingMeasure;
-      isDefault?: boolean;
-    }[] | undefined,
-    technologyId: string,
-  ): Promise<ProcedureProduct[]> {
-    // Return empty array if no products metadata provided (for product-free procedures like consultations)
-    if (!productsMetadata || productsMetadata.length === 0) {
-      return [];
-    }
-
-    const transformedProducts: ProcedureProduct[] = [];
-
-    for (const productData of productsMetadata) {
-      // Fetch the full product object
-      const product = await this.productService.getById(technologyId, productData.productId);
-      if (!product) {
-        throw new Error(
-          `Product with ID ${productData.productId} not found for technology ${technologyId}`,
-        );
-      }
-
-      // Transform to ProcedureProduct
-      transformedProducts.push({
-        product,
-        price: productData.price,
-        currency: productData.currency,
-        pricingMeasure: productData.pricingMeasure,
-        isDefault: productData.isDefault,
-      });
-    }
-
-    return transformedProducts;
-  }
-
-  /**
-   * Creates a new procedure
-   * @param data - The data for creating a new procedure
-   * @returns The created procedure
-   */
-  async createProcedure(data: CreateProcedureData): Promise<Procedure> {
-    const validatedData = createProcedureSchema.parse(data);
-
-    // Check if this is a product-free procedure (e.g., free consultation)
-    const isProductFree = !validatedData.productId;
-
-    // Generate procedure ID first so we can use it for media uploads
-    const procedureId = this.generateId();
-
-    // Get references to related entities (Category, Subcategory, Technology, and optionally Product)
-    const baseEntitiesPromises: Promise<Category | Subcategory | Technology | Product | null>[] = [
-      this.categoryService.getById(validatedData.categoryId),
-      this.subcategoryService.getById(validatedData.categoryId, validatedData.subcategoryId),
-      this.technologyService.getById(validatedData.technologyId),
-    ];
-
-    // Only fetch product if productId is provided
-    if (!isProductFree) {
-      baseEntitiesPromises.push(
-        this.productService.getById(validatedData.technologyId, validatedData.productId!)
-      );
-    }
-
-    const results = await Promise.all(baseEntitiesPromises);
-    const category = results[0] as Category | null;
-    const subcategory = results[1] as Subcategory | null;
-    const technology = results[2] as Technology | null;
-    const product = isProductFree ? undefined : ((results[3] as Product | null) || undefined);
-
-    if (!category || !subcategory || !technology) {
-      throw new Error('One or more required base entities not found');
-    }
-
-    // For regular procedures, validate product exists
-    if (!isProductFree && !product) {
-      throw new Error('Product not found for regular procedure');
-    }
-
-    // Get clinic and practitioner information for aggregation
-    const clinicRef = doc(this.db, CLINICS_COLLECTION, validatedData.clinicBranchId);
-    const clinicSnapshot = await getDoc(clinicRef);
-    if (!clinicSnapshot.exists()) {
-      throw new Error(`Clinic with ID ${validatedData.clinicBranchId} not found`);
-    }
-    const clinic = clinicSnapshot.data() as Clinic; // Assert type
-
-    const practitionerRef = doc(this.db, PRACTITIONERS_COLLECTION, validatedData.practitionerId);
-    const practitionerSnapshot = await getDoc(practitionerRef);
-    if (!practitionerSnapshot.exists()) {
-      throw new Error(`Practitioner with ID ${validatedData.practitionerId} not found`);
-    }
-    const practitioner = practitionerSnapshot.data() as Practitioner; // Assert type
-
-    // Process photos if provided
-    let processedPhotos: string[] = [];
-    if (validatedData.photos && validatedData.photos.length > 0) {
-      processedPhotos = await this.processMediaArray(
-        validatedData.photos,
-        procedureId,
-        'procedure-photos',
-      );
-    }
-
-    // Transform productsMetadata from validation format to ProcedureProduct format
-    const transformedProductsMetadata = await this.transformProductsMetadata(
-      validatedData.productsMetadata,
-      validatedData.technologyId,
-    );
-
-    // Create aggregated clinic info for the procedure document
-    const clinicInfo = {
-      id: clinicSnapshot.id,
-      name: clinic.name,
-      description: clinic.description || '',
-      featuredPhoto:
-        clinic.featuredPhotos && clinic.featuredPhotos.length > 0
-          ? typeof clinic.featuredPhotos[0] === 'string'
-            ? clinic.featuredPhotos[0]
-            : ''
-          : typeof clinic.coverPhoto === 'string'
-          ? clinic.coverPhoto
-          : '',
-      location: clinic.location,
-      contactInfo: clinic.contactInfo,
-    };
-
-    // Create aggregated doctor info for the procedure document
-    const doctorInfo = {
-      id: practitionerSnapshot.id,
-      name: `${practitioner.basicInfo.firstName} ${practitioner.basicInfo.lastName}`,
-      description: practitioner.basicInfo.bio || '',
-      photo:
-        typeof practitioner.basicInfo.profileImageUrl === 'string'
-          ? practitioner.basicInfo.profileImageUrl
-          : '', // Default to empty string if not a processed URL
-      rating: practitioner.reviewInfo?.averageRating || 0,
-      services: practitioner.procedures || [],
-    };
-
-    // Create the procedure object
-    const { productsMetadata: _, productId: __, photos: ___, ...validatedDataWithoutProductsMetadata } = validatedData;
-    const newProcedure: Omit<Procedure, 'createdAt' | 'updatedAt'> = {
-      id: procedureId,
-      ...validatedDataWithoutProductsMetadata,
-      // Ensure nameLower is always set even if omitted by client
-      nameLower: (validatedData as any).nameLower || validatedData.name.toLowerCase(),
-      photos: processedPhotos,
-      category, // Embed full objects
-      subcategory,
-      technology,
-      ...(product && { product }), // Only include product field if it exists (Firestore doesn't allow undefined)
-      productsMetadata: transformedProductsMetadata, // Use transformed data, not original
-      blockingConditions: technology.blockingConditions,
-      contraindications: technology.contraindications || [],
-      contraindicationIds: technology.contraindications?.map(c => c.id) || [],
-      treatmentBenefits: technology.benefits,
-      treatmentBenefitIds: Array.isArray(technology.benefits) 
-        ? technology.benefits.map(b => typeof b === 'string' ? b : b.id)
-        : [],
-      preRequirements: technology.requirements.pre,
-      postRequirements: technology.requirements.post,
-      certificationRequirement: technology.certificationRequirement,
-      documentationTemplates: technology?.documentationTemplates || [],
-      clinicInfo, // Embed aggregated info
-      doctorInfo, // Embed aggregated info
-      reviewInfo: {
-        // Default empty reviews
-        totalReviews: 0,
-        averageRating: 0,
-        effectivenessOfTreatment: 0,
-        outcomeExplanation: 0,
-        painManagement: 0,
-        followUpCare: 0,
-        valueForMoney: 0,
-        recommendationPercentage: 0,
-      },
-      isActive: true, // Default to active
-    };
-
-    // 🔥 DEBUG: Find undefined fields before writing to Firestore
-    console.log('🔥🔥🔥 CREATE PROCEDURE - Processing procedure:', procedureId);
-    console.log('🔥🔥🔥 FULL PROCEDURE OBJECT:', JSON.stringify(newProcedure, null, 2));
-    
-    const undefinedFields: string[] = [];
-    Object.entries(newProcedure).forEach(([key, value]) => {
-      if (value === undefined) {
-        undefinedFields.push(key);
-      }
-    });
-    if (undefinedFields.length > 0) {
-      console.error('🔥🔥🔥 UNDEFINED FIELDS DETECTED:', undefinedFields);
-      throw new Error(`Cannot write procedure with undefined fields: ${undefinedFields.join(', ')}`);
-    }
-    console.log('🔥🔥🔥 NO UNDEFINED FIELDS - Proceeding with setDoc');
-
-    // Create the procedure document
-    const procedureRef = doc(this.db, PROCEDURES_COLLECTION, procedureId);
-    await setDoc(procedureRef, {
-      ...newProcedure,
-      createdAt: serverTimestamp(),
-      updatedAt: serverTimestamp(),
-    });
-
-    // Return the created procedure (fetch again to get server timestamps)
-    const savedDoc = await getDoc(procedureRef);
-    return savedDoc.data() as Procedure;
-  }
-
-  /**
-   * Creates multiple procedures for a list of practitioners based on common data.
-   * This method is optimized for bulk creation to reduce database reads and writes.
-   *
-   * @param baseData - The base data for the procedures to be created, omitting the practitionerId.
-   * @param practitionerIds - An array of practitioner IDs for whom the procedures will be created.
-   * @returns A promise that resolves to an array of the newly created procedures.
-   */
-  async bulkCreateProcedures(
-    baseData: Omit<CreateProcedureData, 'practitionerId'>,
-    practitionerIds: string[],
-  ): Promise<Procedure[]> {
-    // 1. Validation
-    if (!practitionerIds || practitionerIds.length === 0) {
-      throw new Error('Practitioner IDs array cannot be empty.');
-    }
-
-    // Check if this is a product-free procedure
-    const isProductFree = !baseData.productId;
-
-    // Add a dummy practitionerId for the validation schema to pass
-    const validationData = { ...baseData, practitionerId: practitionerIds[0] };
-    const validatedData = createProcedureSchema.parse(validationData);
-
-    // 2. Fetch common data once to avoid redundant reads
-    const baseEntitiesPromises: Promise<Category | Subcategory | Technology | Product | null>[] = [
-      this.categoryService.getById(validatedData.categoryId),
-      this.subcategoryService.getById(validatedData.categoryId, validatedData.subcategoryId),
-      this.technologyService.getById(validatedData.technologyId),
-    ];
-
-    // Only fetch product if productId is provided
-    if (!isProductFree) {
-      baseEntitiesPromises.push(
-        this.productService.getById(validatedData.technologyId, validatedData.productId!)
-      );
-    }
-
-    // Fetch clinic separately to maintain type safety
-    const clinicSnapshotPromise = getDoc(doc(this.db, CLINICS_COLLECTION, validatedData.clinicBranchId));
-
-    const [baseResults, clinicSnapshot] = await Promise.all([
-      Promise.all(baseEntitiesPromises),
-      clinicSnapshotPromise
-    ]);
-    
-    const category = baseResults[0] as Category | null;
-    const subcategory = baseResults[1] as Subcategory | null;
-    const technology = baseResults[2] as Technology | null;
-    const product = isProductFree ? undefined : ((baseResults[3] as Product | null) || undefined);
-
-    if (!category || !subcategory || !technology) {
-      throw new Error('One or more required base entities not found');
-    }
-    
-    // For regular procedures, validate product exists
-    if (!isProductFree && !product) {
-      throw new Error('Product not found for regular procedure');
-    }
-    
-    if (!clinicSnapshot || !clinicSnapshot.exists()) {
-      throw new Error(`Clinic with ID ${validatedData.clinicBranchId} not found`);
-    }
-    const clinic = clinicSnapshot.data() as Clinic;
-
-    // 3. Handle media uploads once for efficiency
-    let processedPhotos: string[] = [];
-    if (validatedData.photos && validatedData.photos.length > 0) {
-      const batchId = this.generateId(); // Use a single ID for all media in this batch
-      processedPhotos = await this.processMediaArray(
-        validatedData.photos,
-        batchId,
-        'procedure-photos-batch',
-      );
-    }
-
-    // Transform productsMetadata from validation format to ProcedureProduct format
-    const transformedProductsMetadata = await this.transformProductsMetadata(
-      validatedData.productsMetadata,
-      validatedData.technologyId,
-    );
-
-    // 4. Fetch all practitioner data efficiently
-    const practitionersMap = new Map<string, Practitioner>();
-    // Use 'in' query in chunks of 30, as this is the Firestore limit
-    for (let i = 0; i < practitionerIds.length; i += 30) {
-      const chunk = practitionerIds.slice(i, i + 30);
-      const practitionersQuery = query(
-        collection(this.db, PRACTITIONERS_COLLECTION),
-        where(documentId(), 'in', chunk),
-      );
-      const practitionersSnapshot = await getDocs(practitionersQuery);
-      practitionersSnapshot.docs.forEach(doc => {
-        practitionersMap.set(doc.id, doc.data() as Practitioner);
-      });
-    }
-
-    // Verify all practitioners were found
-    if (practitionersMap.size !== practitionerIds.length) {
-      const foundIds = Array.from(practitionersMap.keys());
-      const notFoundIds = practitionerIds.filter(id => !foundIds.includes(id));
-      throw new Error(`The following practitioners were not found: ${notFoundIds.join(', ')}`);
-    }
-
-    // 5. Use a Firestore batch for atomic creation
-    const batch = writeBatch(this.db);
-    const createdProcedureIds: string[] = [];
-    const clinicInfo = {
-      id: clinicSnapshot.id,
-      name: clinic.name,
-      description: clinic.description || '',
-      featuredPhoto:
-        clinic.featuredPhotos && clinic.featuredPhotos.length > 0
-          ? typeof clinic.featuredPhotos[0] === 'string'
-            ? clinic.featuredPhotos[0]
-            : ''
-          : typeof clinic.coverPhoto === 'string'
-          ? clinic.coverPhoto
-          : '',
-      location: clinic.location,
-      contactInfo: clinic.contactInfo,
-    };
-
-    for (const practitionerId of practitionerIds) {
-      const practitioner = practitionersMap.get(practitionerId)!;
-
-      const doctorInfo = {
-        id: practitioner.id,
-        name: `${practitioner.basicInfo.firstName} ${practitioner.basicInfo.lastName}`,
-        description: practitioner.basicInfo.bio || '',
-        photo:
-          typeof practitioner.basicInfo.profileImageUrl === 'string'
-            ? practitioner.basicInfo.profileImageUrl
-            : '',
-        rating: practitioner.reviewInfo?.averageRating || 0,
-        services: practitioner.procedures || [],
-      };
-
-      const procedureId = this.generateId();
-      createdProcedureIds.push(procedureId);
-      const procedureRef = doc(this.db, PROCEDURES_COLLECTION, procedureId);
-
-      // Construct the new procedure, reusing common data
-      const { productsMetadata: _, productId: __, photos: ___, ...validatedDataWithoutProductsMetadata } = validatedData;
-      const newProcedure: Omit<Procedure, 'createdAt' | 'updatedAt'> = {
-        id: procedureId,
-        ...validatedDataWithoutProductsMetadata,
-        nameLower: (validatedData as any).nameLower || validatedData.name.toLowerCase(),
-        practitionerId: practitionerId, // Override practitionerId with the correct one
-        photos: processedPhotos,
-        category,
-        subcategory,
-        technology,
-        ...(product && { product }), // Only include product field if it exists (Firestore doesn't allow undefined)
-        productsMetadata: transformedProductsMetadata, // Use transformed data, not original
-        blockingConditions: technology.blockingConditions,
-        contraindications: technology.contraindications || [],
-        contraindicationIds: technology.contraindications?.map(c => c.id) || [],
-        treatmentBenefits: technology.benefits,
-        treatmentBenefitIds: Array.isArray(technology.benefits) 
-        ? technology.benefits.map(b => typeof b === 'string' ? b : b.id)
-        : [],
-        preRequirements: technology.requirements.pre,
-        postRequirements: technology.requirements.post,
-        certificationRequirement: technology.certificationRequirement,
-        documentationTemplates: technology?.documentationTemplates || [],
-        clinicInfo,
-        doctorInfo, // Set specific doctor info
-        reviewInfo: {
-          totalReviews: 0,
-          averageRating: 0,
-          effectivenessOfTreatment: 0,
-          outcomeExplanation: 0,
-          painManagement: 0,
-          followUpCare: 0,
-          valueForMoney: 0,
-          recommendationPercentage: 0,
-        },
-        isActive: true,
-      };
-
-      // 🔥 DEBUG: Find undefined fields before writing to Firestore
-      console.log('🔥🔥🔥 BULK CREATE - Processing procedure:', procedureId, 'for practitioner:', practitionerId);
-      console.log('🔥🔥🔥 FULL PROCEDURE OBJECT:', JSON.stringify(newProcedure, null, 2));
-      
-      const undefinedFields: string[] = [];
-      Object.entries(newProcedure).forEach(([key, value]) => {
-        if (value === undefined) {
-          undefinedFields.push(key);
-        }
-      });
-      if (undefinedFields.length > 0) {
-        console.error('🔥🔥🔥 UNDEFINED FIELDS DETECTED:', undefinedFields);
-        throw new Error(`Cannot write procedure with undefined fields: ${undefinedFields.join(', ')}`);
-      }
-      console.log('🔥🔥🔥 NO UNDEFINED FIELDS - Proceeding with batch.set');
-
-      batch.set(procedureRef, {
-        ...newProcedure,
-        createdAt: serverTimestamp(),
-        updatedAt: serverTimestamp(),
-      });
-    }
-
-    // 6. Commit the atomic batch write
-    await batch.commit();
-
-    // 7. Fetch and return the newly created procedures
-    const fetchedProcedures: Procedure[] = [];
-    for (let i = 0; i < createdProcedureIds.length; i += 30) {
-      const chunk = createdProcedureIds.slice(i, i + 30);
-      const q = query(collection(this.db, PROCEDURES_COLLECTION), where(documentId(), 'in', chunk));
-      const snapshot = await getDocs(q);
-      snapshot.forEach(doc => {
-        fetchedProcedures.push(doc.data() as Procedure);
-      });
-    }
-
-    return fetchedProcedures;
-  }
-
-  /**
-   * Gets a procedure by ID
-   * @param id - The ID of the procedure to get
-   * @returns The procedure if found, null otherwise
-   */
-  async getProcedure(id: string): Promise<Procedure | null> {
-    const docRef = doc(this.db, PROCEDURES_COLLECTION, id);
-    const docSnap = await getDoc(docRef);
-
-    if (!docSnap.exists()) {
-      return null;
-    }
-
-    return docSnap.data() as Procedure;
-  }
-
-  /**
-   * Gets all procedures for a clinic branch
-   * @param clinicBranchId - The ID of the clinic branch
-   * @returns List of procedures
-   */
-  async getProceduresByClinicBranch(clinicBranchId: string): Promise<Procedure[]> {
-    const q = query(
-      collection(this.db, PROCEDURES_COLLECTION),
-      where('clinicBranchId', '==', clinicBranchId),
-      where('isActive', '==', true),
-    );
-    const snapshot = await getDocs(q);
-    return snapshot.docs.map(doc => doc.data() as Procedure);
-  }
-
-  /**
-   * Gets all procedures for a practitioner
-   * @param practitionerId - The ID of the practitioner
-   * @returns List of procedures
-   */
-  async getProceduresByPractitioner(practitionerId: string): Promise<Procedure[]> {
-    const q = query(
-      collection(this.db, PROCEDURES_COLLECTION),
-      where('practitionerId', '==', practitionerId),
-      where('isActive', '==', true),
-    );
-    const snapshot = await getDocs(q);
-    return snapshot.docs.map(doc => doc.data() as Procedure);
-  }
-
-  /**
-   * Gets all inactive procedures for a practitioner
-   * @param practitionerId - The ID of the practitioner
-   * @returns List of inactive procedures
-   */
-  async getInactiveProceduresByPractitioner(practitionerId: string): Promise<Procedure[]> {
-    const q = query(
-      collection(this.db, PROCEDURES_COLLECTION),
-      where('practitionerId', '==', practitionerId),
-      where('isActive', '==', false),
-    );
-    const snapshot = await getDocs(q);
-    return snapshot.docs.map(doc => doc.data() as Procedure);
-  }
-
-  /**
-   * Updates a procedure
-   * @param id - The ID of the procedure to update
-   * @param data - The data to update the procedure with
-   * @returns The updated procedure
-   */
-  async updateProcedure(id: string, data: UpdateProcedureData): Promise<Procedure> {
-    const validatedData = updateProcedureSchema.parse(data);
-    const procedureRef = doc(this.db, PROCEDURES_COLLECTION, id);
-    const procedureSnapshot = await getDoc(procedureRef);
-
-    if (!procedureSnapshot.exists()) {
-      throw new Error(`Procedure with ID ${id} not found`);
-    }
-
-    const existingProcedure = procedureSnapshot.data() as Procedure;
-    let updatedProcedureData: Partial<Procedure> = {};
-
-    // Copy validated simple fields
-    if (validatedData.name !== undefined) updatedProcedureData.name = validatedData.name;
-    if (validatedData.description !== undefined)
-      updatedProcedureData.description = validatedData.description;
-    if (validatedData.price !== undefined) updatedProcedureData.price = validatedData.price;
-    if (validatedData.currency !== undefined)
-      updatedProcedureData.currency = validatedData.currency;
-    if (validatedData.pricingMeasure !== undefined)
-      updatedProcedureData.pricingMeasure = validatedData.pricingMeasure;
-    if (validatedData.duration !== undefined)
-      updatedProcedureData.duration = validatedData.duration;
-    if (validatedData.isActive !== undefined)
-      updatedProcedureData.isActive = validatedData.isActive;
-
-    let practitionerChanged = false;
-    let clinicChanged = false;
-    const oldPractitionerId = existingProcedure.practitionerId;
-    const oldClinicId = existingProcedure.clinicBranchId;
-    let newPractitioner: Practitioner | null = null;
-    let newClinic: Clinic | null = null;
-
-    // Process photos if provided
-    if (validatedData.photos !== undefined) {
-      updatedProcedureData.photos = await this.processMediaArray(
-        validatedData.photos,
-        id,
-        'procedure-photos',
-      );
-    }
-
-    // Transform productsMetadata if provided
-    if (validatedData.productsMetadata !== undefined) {
-      const technologyId = validatedData.technologyId ?? existingProcedure.technology.id;
-      if (!technologyId) {
-        throw new Error('Technology ID is required for updating products metadata');
-      }
-      updatedProcedureData.productsMetadata = await this.transformProductsMetadata(
-        validatedData.productsMetadata,
-        technologyId,
-      );
-    }
-
-    // --- Prepare updates and fetch new related data if IDs change ---
-
-    // Handle Practitioner Change
-    if (validatedData.practitionerId && validatedData.practitionerId !== oldPractitionerId) {
-      practitionerChanged = true;
-      const newPractitionerRef = doc(
-        this.db,
-        PRACTITIONERS_COLLECTION,
-        validatedData.practitionerId,
-      );
-      const newPractitionerSnap = await getDoc(newPractitionerRef);
-      if (!newPractitionerSnap.exists())
-        throw new Error(`New Practitioner ${validatedData.practitionerId} not found`);
-      newPractitioner = newPractitionerSnap.data() as Practitioner;
-      // Update doctorInfo within the procedure document
-      updatedProcedureData.doctorInfo = {
-        id: newPractitioner.id,
-        name: `${newPractitioner.basicInfo.firstName} ${newPractitioner.basicInfo.lastName}`,
-        description: newPractitioner.basicInfo.bio || '',
-        photo:
-          typeof newPractitioner.basicInfo.profileImageUrl === 'string'
-            ? newPractitioner.basicInfo.profileImageUrl
-            : '', // Default to empty string if not a processed URL
-        rating: newPractitioner.reviewInfo?.averageRating || 0,
-        services: newPractitioner.procedures || [],
-      };
-    }
-
-    // Handle Clinic Change
-    if (validatedData.clinicBranchId && validatedData.clinicBranchId !== oldClinicId) {
-      clinicChanged = true;
-      const newClinicRef = doc(this.db, CLINICS_COLLECTION, validatedData.clinicBranchId);
-      const newClinicSnap = await getDoc(newClinicRef);
-      if (!newClinicSnap.exists())
-        throw new Error(`New Clinic ${validatedData.clinicBranchId} not found`);
-      newClinic = newClinicSnap.data() as Clinic;
-      // Update clinicInfo within the procedure document
-      updatedProcedureData.clinicInfo = {
-        id: newClinic.id,
-        name: newClinic.name,
-        description: newClinic.description || '',
-        featuredPhoto:
-          newClinic.featuredPhotos && newClinic.featuredPhotos.length > 0
-            ? typeof newClinic.featuredPhotos[0] === 'string'
-              ? newClinic.featuredPhotos[0]
-              : ''
-            : typeof newClinic.coverPhoto === 'string'
-            ? newClinic.coverPhoto
-            : '',
-        location: newClinic.location,
-        contactInfo: newClinic.contactInfo,
-      };
-    }
-
-    // Handle Category/Subcategory/Technology/Product Changes
-    let finalCategoryId = existingProcedure.category.id;
-    if (validatedData.name) {
-      updatedProcedureData.nameLower = validatedData.name.toLowerCase();
-    }
-    if (validatedData.categoryId) {
-      const category = await this.categoryService.getById(validatedData.categoryId);
-      if (!category) throw new Error(`Category ${validatedData.categoryId} not found`);
-      updatedProcedureData.category = category;
-      finalCategoryId = category.id; // Update finalCategoryId if category changed
-    }
-
-    // Only fetch subcategory if its ID is provided AND we have a valid finalCategoryId
-    if (validatedData.subcategoryId && finalCategoryId) {
-      const subcategory = await this.subcategoryService.getById(
-        finalCategoryId,
-        validatedData.subcategoryId,
-      );
-      if (!subcategory)
-        throw new Error(
-          `Subcategory ${validatedData.subcategoryId} not found for category ${finalCategoryId}`,
-        );
-      updatedProcedureData.subcategory = subcategory;
-    } else if (validatedData.subcategoryId) {
-      console.warn('Attempted to update subcategory without a valid categoryId');
-    }
-
-    let finalTechnologyId = existingProcedure.technology.id;
-    if (validatedData.technologyId) {
-      const technology = await this.technologyService.getById(validatedData.technologyId);
-      if (!technology) throw new Error(`Technology ${validatedData.technologyId} not found`);
-      updatedProcedureData.technology = technology;
-      finalTechnologyId = technology.id; // Update finalTechnologyId if technology changed
-      // Update related fields derived from technology
-      updatedProcedureData.blockingConditions = technology.blockingConditions;
-      updatedProcedureData.contraindications = technology.contraindications || [];
-      updatedProcedureData.contraindicationIds = technology.contraindications?.map(c => c.id) || [];
-      updatedProcedureData.treatmentBenefits = technology.benefits;
-      updatedProcedureData.treatmentBenefitIds = Array.isArray(technology.benefits)
-        ? technology.benefits.map(b => typeof b === 'string' ? b : b.id)
-        : [];
-      updatedProcedureData.preRequirements = technology.requirements.pre;
-      updatedProcedureData.postRequirements = technology.requirements.post;
-      updatedProcedureData.certificationRequirement = technology.certificationRequirement;
-      updatedProcedureData.documentationTemplates = technology.documentationTemplates || [];
-    }
-
-    // Only fetch product if its ID is provided AND we have a valid finalTechnologyId
-    if (validatedData.productId && finalTechnologyId) {
-      const product = await this.productService.getById(finalTechnologyId, validatedData.productId);
-      if (!product)
-        throw new Error(
-          `Product ${validatedData.productId} not found for technology ${finalTechnologyId}`,
-        );
-      updatedProcedureData.product = product;
-    } else if (validatedData.productId) {
-      console.warn('Attempted to update product without a valid technologyId');
-    }
-
-    // Update the procedure document
-    await updateDoc(procedureRef, {
-      ...updatedProcedureData,
-      updatedAt: serverTimestamp(),
-    });
-
-    // Return the updated procedure
-    const updatedSnapshot = await getDoc(procedureRef);
-    return updatedSnapshot.data() as Procedure;
-  }
-
-  /**
-   * Deactivates a procedure (soft delete)
-   * @param id - The ID of the procedure to deactivate
-   */
-  async deactivateProcedure(id: string): Promise<void> {
-    const procedureRef = doc(this.db, PROCEDURES_COLLECTION, id);
-    const procedureSnap = await getDoc(procedureRef);
-    if (!procedureSnap.exists()) {
-      console.warn(`Procedure ${id} not found for deactivation.`);
-      return;
-    }
-
-    // Mark procedure as inactive
-    await updateDoc(procedureRef, {
-      isActive: false,
-      updatedAt: serverTimestamp(),
-    });
-  }
-
-  /**
-   * Deletes a procedure permanently
-   * @param id - The ID of the procedure to delete
-   * @returns A boolean indicating if the deletion was successful
-   */
-  async deleteProcedure(id: string): Promise<boolean> {
-    const procedureRef = doc(this.db, PROCEDURES_COLLECTION, id);
-    const procedureSnapshot = await getDoc(procedureRef);
-
-    if (!procedureSnapshot.exists()) {
-      // Already deleted or never existed
-      return false;
-    }
-
-    // Delete the procedure document
-    await deleteDoc(procedureRef);
-    return true;
-  }
-
-  /**
-   * Gets all procedures that a practitioner is certified to perform
-   * @param practitioner - The practitioner's profile
-   * @returns Object containing allowed technologies, families, categories, subcategories
-   */
-  async getAllowedTechnologies(practitioner: Practitioner): Promise<{
-    technologies: Technology[];
-    families: ProcedureFamily[];
-    categories: string[];
-    subcategories: string[];
-  }> {
-    // This logic depends on TechnologyService and remains valid
-    const { technologies, families, categories, subcategories } =
-      await this.technologyService.getAllowedTechnologies(practitioner);
-
-    return {
-      technologies,
-      families,
-      categories,
-      subcategories,
-    };
-  }
-
-  /**
-   * Gets all procedures with optional pagination
-   *
-   * @param pagination - Optional number of procedures per page (0 or undefined returns all)
-   * @param lastDoc - Optional last document for pagination (if continuing from a previous page)
-   * @returns Object containing procedures array and the last document for pagination
-   */
-  async getAllProcedures(
-    pagination?: number,
-    lastDoc?: any,
-  ): Promise<{ procedures: Procedure[]; lastDoc: any }> {
-    try {
-      const proceduresCollection = collection(this.db, PROCEDURES_COLLECTION);
-      let proceduresQuery = query(proceduresCollection);
-
-      // Apply pagination if specified
-      if (pagination && pagination > 0) {
-        const { limit, startAfter } = await import('firebase/firestore'); // Use dynamic import if needed top-level
-
-        if (lastDoc) {
-          proceduresQuery = query(
-            proceduresCollection,
-            orderBy('name'), // Use imported orderBy
-            startAfter(lastDoc),
-            limit(pagination),
-          );
-        } else {
-          proceduresQuery = query(proceduresCollection, orderBy('name'), limit(pagination)); // Use imported orderBy
-        }
-      } else {
-        proceduresQuery = query(proceduresCollection, orderBy('name')); // Use imported orderBy
-      }
-
-      const proceduresSnapshot = await getDocs(proceduresQuery);
-      const lastVisible = proceduresSnapshot.docs[proceduresSnapshot.docs.length - 1];
-
-      const procedures = proceduresSnapshot.docs.map(doc => {
-        const data = doc.data() as Procedure;
-        return {
-          ...data,
-          id: doc.id, // Ensure ID is present
-        };
-      });
-
-      return {
-        procedures,
-        lastDoc: lastVisible,
-      };
-    } catch (error) {
-      console.error('[PROCEDURE_SERVICE] Error getting all procedures:', error);
-      throw error;
-    }
-  }
-
-  /**
-   * Searches and filters procedures based on multiple criteria
-   *
-   * @note Frontend MORA da šalje ceo snapshot (ili barem sva polja po kojima sortiraš, npr. nameLower) kao lastDoc za paginaciju, a ne samo id!
-   *
-   * @param filters - Various filters to apply
-   * @param filters.nameSearch - Optional search text for procedure name
-   * @param filters.treatmentBenefitIds - Optional array of treatment benefits to filter by
-   * @param filters.procedureFamily - Optional procedure family to filter by
-   * @param filters.procedureCategory - Optional procedure category to filter by
-   * @param filters.procedureSubcategory - Optional procedure subcategory to filter by
-   * @param filters.procedureTechnology - Optional procedure technology to filter by
-   * @param filters.location - Optional location for distance-based search
-   * @param filters.radiusInKm - Optional radius in kilometers (required if location is provided)
-   * @param filters.minPrice - Optional minimum price
-   * @param filters.maxPrice - Optional maximum price
-   * @param filters.minRating - Optional minimum rating (0-5)
-   * @param filters.maxRating - Optional maximum rating (0-5)
-   * @param filters.pagination - Optional number of results per page
-   * @param filters.lastDoc - Optional last document for pagination
-   * @param filters.isActive - Optional filter for active procedures only
-   * @returns Filtered procedures and the last document for pagination
-   */
-  async getProceduresByFilters(filters: {
-    nameSearch?: string;
-    treatmentBenefits?: string[];
-    procedureFamily?: ProcedureFamily;
-    procedureCategory?: string;
-    procedureSubcategory?: string;
-    procedureTechnology?: string;
-    location?: { latitude: number; longitude: number };
-    radiusInKm?: number;
-    minPrice?: number;
-    maxPrice?: number;
-    minRating?: number;
-    maxRating?: number;
-    pagination?: number;
-    lastDoc?: any;
-    isActive?: boolean;
-    practitionerId?: string;
-    clinicId?: string;
-  }): Promise<{
-    procedures: (Procedure & { distance?: number })[];
-    lastDoc: any;
-  }> {
-    try {
-      console.log('[PROCEDURE_SERVICE] Starting procedure filtering with multiple strategies');
-
-      // Geo query debug i validacija
-      if (filters.location && filters.radiusInKm) {
-        console.log('[PROCEDURE_SERVICE] Executing geo query:', {
-          location: filters.location,
-          radius: filters.radiusInKm,
-          serviceName: 'ProcedureService',
-        });
-
-        // Validacija location podataka
-        if (!filters.location.latitude || !filters.location.longitude) {
-          console.warn('[PROCEDURE_SERVICE] Invalid location data:', filters.location);
-          filters.location = undefined;
-          filters.radiusInKm = undefined;
-        }
-      }
-
-      // Handle geo queries separately (they work differently)
-      const isGeoQuery = filters.location && filters.radiusInKm && filters.radiusInKm > 0;
-      if (isGeoQuery) {
-        return this.handleGeoQuery(filters);
-      }
-
-      // Base constraints (used in all strategies)
-      const getBaseConstraints = () => {
-        const constraints: QueryConstraint[] = [];
-
-        // Active status filter
-        if (filters.isActive !== undefined) {
-          constraints.push(where('isActive', '==', filters.isActive));
-        } else {
-          constraints.push(where('isActive', '==', true));
-        }
-
-        // Filter constraints
-        if (filters.procedureFamily) {
-          constraints.push(where('family', '==', filters.procedureFamily));
-        }
-        if (filters.procedureCategory) {
-          constraints.push(where('category.id', '==', filters.procedureCategory));
-        }
-        if (filters.procedureSubcategory) {
-          constraints.push(where('subcategory.id', '==', filters.procedureSubcategory));
-        }
-        if (filters.procedureTechnology) {
-          constraints.push(where('technology.id', '==', filters.procedureTechnology));
-        }
-        if (filters.practitionerId) {
-          constraints.push(where('practitionerId', '==', filters.practitionerId));
-        }
-        if (filters.clinicId) {
-          constraints.push(where('clinicBranchId', '==', filters.clinicId));
-        }
-        if (filters.minPrice !== undefined) {
-          constraints.push(where('price', '>=', filters.minPrice));
-        }
-        if (filters.maxPrice !== undefined) {
-          constraints.push(where('price', '<=', filters.maxPrice));
-        }
-        if (filters.minRating !== undefined) {
-          constraints.push(where('reviewInfo.averageRating', '>=', filters.minRating));
-        }
-        if (filters.maxRating !== undefined) {
-          constraints.push(where('reviewInfo.averageRating', '<=', filters.maxRating));
-        }
-        if (filters.treatmentBenefits && filters.treatmentBenefits.length > 0) {
-          const benefitIdsToMatch = filters.treatmentBenefits;
-          constraints.push(where('treatmentBenefitIds', 'array-contains-any', benefitIdsToMatch));
-        }
-
-        return constraints;
-      };
-
-      // Strategy 1: Try nameLower search if nameSearch exists
-      if (filters.nameSearch && filters.nameSearch.trim()) {
-        try {
-          console.log('[PROCEDURE_SERVICE] Strategy 1: Trying nameLower search');
-          const searchTerm = filters.nameSearch.trim().toLowerCase();
-          const constraints = getBaseConstraints();
-          constraints.push(where('nameLower', '>=', searchTerm));
-          constraints.push(where('nameLower', '<=', searchTerm + '\uf8ff'));
-          constraints.push(orderBy('nameLower'));
-
-          if (filters.lastDoc) {
-            if (typeof filters.lastDoc.data === 'function') {
-              constraints.push(startAfter(filters.lastDoc));
-            } else if (Array.isArray(filters.lastDoc)) {
-              constraints.push(startAfter(...filters.lastDoc));
-            } else {
-              constraints.push(startAfter(filters.lastDoc));
-            }
-          }
-          constraints.push(limit(filters.pagination || 10));
-
-          const q = query(collection(this.db, PROCEDURES_COLLECTION), ...constraints);
-          const querySnapshot = await getDocs(q);
-          const procedures = querySnapshot.docs.map(
-            doc => ({ ...doc.data(), id: doc.id } as Procedure),
-          );
-          const lastDoc =
-            querySnapshot.docs.length > 0
-              ? querySnapshot.docs[querySnapshot.docs.length - 1]
-              : null;
-
-          console.log(`[PROCEDURE_SERVICE] Strategy 1 success: ${procedures.length} procedures`);
-
-          // Fix Load More - ako je broj rezultata manji od pagination, nema više
-          if (procedures.length < (filters.pagination || 10)) {
-            return { procedures, lastDoc: null };
-          }
-          return { procedures, lastDoc };
-        } catch (error) {
-          console.log('[PROCEDURE_SERVICE] Strategy 1 failed:', error);
-        }
-      }
-
-      // Strategy 2: Try name field search as fallback
-      if (filters.nameSearch && filters.nameSearch.trim()) {
-        try {
-          console.log('[PROCEDURE_SERVICE] Strategy 2: Trying name field search');
-          const searchTerm = filters.nameSearch.trim().toLowerCase();
-          const constraints = getBaseConstraints();
-          constraints.push(where('name', '>=', searchTerm));
-          constraints.push(where('name', '<=', searchTerm + '\uf8ff'));
-          constraints.push(orderBy('name'));
-
-          if (filters.lastDoc) {
-            if (typeof filters.lastDoc.data === 'function') {
-              constraints.push(startAfter(filters.lastDoc));
-            } else if (Array.isArray(filters.lastDoc)) {
-              constraints.push(startAfter(...filters.lastDoc));
-            } else {
-              constraints.push(startAfter(filters.lastDoc));
-            }
-          }
-          constraints.push(limit(filters.pagination || 10));
-
-          const q = query(collection(this.db, PROCEDURES_COLLECTION), ...constraints);
-          const querySnapshot = await getDocs(q);
-          const procedures = querySnapshot.docs.map(
-            doc => ({ ...doc.data(), id: doc.id } as Procedure),
-          );
-          const lastDoc =
-            querySnapshot.docs.length > 0
-              ? querySnapshot.docs[querySnapshot.docs.length - 1]
-              : null;
-
-          console.log(`[PROCEDURE_SERVICE] Strategy 2 success: ${procedures.length} procedures`);
-
-          // Fix Load More - ako je broj rezultata manji od pagination, nema više
-          if (procedures.length < (filters.pagination || 10)) {
-            return { procedures, lastDoc: null };
-          }
-          return { procedures, lastDoc };
-        } catch (error) {
-          console.log('[PROCEDURE_SERVICE] Strategy 2 failed:', error);
-        }
-      }
-
-      // Strategy 3: orderBy createdAt with client-side filtering
-      try {
-        console.log(
-          '[PROCEDURE_SERVICE] Strategy 3: Using createdAt orderBy with client-side filtering',
-        );
-        const constraints = getBaseConstraints();
-        constraints.push(orderBy('createdAt', 'desc'));
-
-        if (filters.lastDoc) {
-          if (typeof filters.lastDoc.data === 'function') {
-            constraints.push(startAfter(filters.lastDoc));
-          } else if (Array.isArray(filters.lastDoc)) {
-            constraints.push(startAfter(...filters.lastDoc));
-          } else {
-            constraints.push(startAfter(filters.lastDoc));
-          }
-        }
-        constraints.push(limit(filters.pagination || 10));
-
-        const q = query(collection(this.db, PROCEDURES_COLLECTION), ...constraints);
-        const querySnapshot = await getDocs(q);
-        let procedures = querySnapshot.docs.map(
-          doc => ({ ...doc.data(), id: doc.id } as Procedure),
-        );
-
-        // Apply all client-side filters using centralized function
-        procedures = this.applyInMemoryFilters(procedures, filters);
-
-        const lastDoc =
-          querySnapshot.docs.length > 0 ? querySnapshot.docs[querySnapshot.docs.length - 1] : null;
-        console.log(`[PROCEDURE_SERVICE] Strategy 3 success: ${procedures.length} procedures`);
-
-        // Fix Load More - ako je broj rezultata manji od pagination, nema više
-        if (procedures.length < (filters.pagination || 10)) {
-          return { procedures, lastDoc: null };
-        }
-        return { procedures, lastDoc };
-      } catch (error) {
-        console.log('[PROCEDURE_SERVICE] Strategy 3 failed:', error);
-      }
-
-      // Strategy 4: Minimal query fallback
-      try {
-        console.log('[PROCEDURE_SERVICE] Strategy 4: Minimal query fallback');
-        const constraints: QueryConstraint[] = [
-          where('isActive', '==', filters.isActive !== undefined ? filters.isActive : true),
-          orderBy('createdAt', 'desc'),
-        ];
-        if (filters.practitionerId) {
-          constraints.push(where('practitionerId', '==', filters.practitionerId));
-        }
-        if (filters.clinicId) {
-          constraints.push(where('clinicBranchId', '==', filters.clinicId));
-        }
-        constraints.push(limit(filters.pagination || 10));
-
-        const q = query(collection(this.db, PROCEDURES_COLLECTION), ...constraints);
-        const querySnapshot = await getDocs(q);
-        let procedures = querySnapshot.docs.map(
-          doc => ({ ...doc.data(), id: doc.id } as Procedure),
-        );
-
-        // Apply all client-side filters using centralized function
-        procedures = this.applyInMemoryFilters(procedures, filters);
-
-        const lastDoc =
-          querySnapshot.docs.length > 0 ? querySnapshot.docs[querySnapshot.docs.length - 1] : null;
-        console.log(`[PROCEDURE_SERVICE] Strategy 4 success: ${procedures.length} procedures`);
-
-        // Fix Load More - ako je broj rezultata manji od pagination, nema više
-        if (procedures.length < (filters.pagination || 10)) {
-          return { procedures, lastDoc: null };
-        }
-        return { procedures, lastDoc };
-      } catch (error) {
-        console.log('[PROCEDURE_SERVICE] Strategy 4 failed:', error);
-      }
-
-      // All strategies failed
-      console.log('[PROCEDURE_SERVICE] All strategies failed, returning empty result');
-      return { procedures: [], lastDoc: null };
-    } catch (error) {
-      console.error('[PROCEDURE_SERVICE] Error filtering procedures:', error);
-      return { procedures: [], lastDoc: null };
-    }
-  }
-
-  /**
-   * Applies in-memory filters to procedures array
-   * Used when Firestore queries fail or for complex filtering
-   */
-  private applyInMemoryFilters(
-    procedures: Procedure[],
-    filters: any,
-  ): (Procedure & { distance?: number })[] {
-    let filteredProcedures = [...procedures]; // Create copy to avoid mutating original
-
-    // Name search filter
-    if (filters.nameSearch && filters.nameSearch.trim()) {
-      const searchTerm = filters.nameSearch.trim().toLowerCase();
-      filteredProcedures = filteredProcedures.filter(procedure => {
-        const name = (procedure.name || '').toLowerCase();
-        const nameLower = procedure.nameLower || '';
-        return name.includes(searchTerm) || nameLower.includes(searchTerm);
-      });
-      console.log(`[PROCEDURE_SERVICE] Applied name filter, results: ${filteredProcedures.length}`);
-    }
-
-    // Price filtering
-    if (filters.minPrice !== undefined || filters.maxPrice !== undefined) {
-      filteredProcedures = filteredProcedures.filter(procedure => {
-        const price = procedure.price || 0;
-        if (filters.minPrice !== undefined && price < filters.minPrice) return false;
-        if (filters.maxPrice !== undefined && price > filters.maxPrice) return false;
-        return true;
-      });
-      console.log(
-        `[PROCEDURE_SERVICE] Applied price filter (${filters.minPrice}-${filters.maxPrice}), results: ${filteredProcedures.length}`,
-      );
-    }
-
-    // Rating filtering
-    if (filters.minRating !== undefined || filters.maxRating !== undefined) {
-      filteredProcedures = filteredProcedures.filter(procedure => {
-        const rating = procedure.reviewInfo?.averageRating || 0;
-        if (filters.minRating !== undefined && rating < filters.minRating) return false;
-        if (filters.maxRating !== undefined && rating > filters.maxRating) return false;
-        return true;
-      });
-      console.log(
-        `[PROCEDURE_SERVICE] Applied rating filter, results: ${filteredProcedures.length}`,
-      );
-    }
-
-    // Treatment benefits filtering
-    if (filters.treatmentBenefits && filters.treatmentBenefits.length > 0) {
-      const benefitIdsToMatch = filters.treatmentBenefits;
-      filteredProcedures = filteredProcedures.filter(procedure => {
-        const procedureBenefitIds = procedure.treatmentBenefitIds || [];
-        return benefitIdsToMatch.some((benefitId: string) =>
-          procedureBenefitIds.includes(benefitId),
-        );
-      });
-      console.log(
-        `[PROCEDURE_SERVICE] Applied benefits filter, results: ${filteredProcedures.length}`,
-      );
-    }
-
-    // Procedure family filtering
-    if (filters.procedureFamily) {
-      filteredProcedures = filteredProcedures.filter(
-        procedure => procedure.family === filters.procedureFamily,
-      );
-      console.log(
-        `[PROCEDURE_SERVICE] Applied family filter, results: ${filteredProcedures.length}`,
-      );
-    }
-
-    // Category filtering
-    if (filters.procedureCategory) {
-      filteredProcedures = filteredProcedures.filter(
-        procedure => procedure.category?.id === filters.procedureCategory,
-      );
-      console.log(
-        `[PROCEDURE_SERVICE] Applied category filter, results: ${filteredProcedures.length}`,
-      );
-    }
-
-    // Subcategory filtering
-    if (filters.procedureSubcategory) {
-      filteredProcedures = filteredProcedures.filter(
-        procedure => procedure.subcategory?.id === filters.procedureSubcategory,
-      );
-      console.log(
-        `[PROCEDURE_SERVICE] Applied subcategory filter, results: ${filteredProcedures.length}`,
-      );
-    }
-
-    // Technology filtering
-    if (filters.procedureTechnology) {
-      filteredProcedures = filteredProcedures.filter(
-        procedure => procedure.technology?.id === filters.procedureTechnology,
-      );
-      console.log(
-        `[PROCEDURE_SERVICE] Applied technology filter, results: ${filteredProcedures.length}`,
-      );
-    }
-
-    // Practitioner filtering
-    if (filters.practitionerId) {
-      filteredProcedures = filteredProcedures.filter(
-        procedure => procedure.practitionerId === filters.practitionerId,
-      );
-      console.log(
-        `[PROCEDURE_SERVICE] Applied practitioner filter, results: ${filteredProcedures.length}`,
-      );
-    }
-
-    // Clinic filtering
-    if (filters.clinicId) {
-      filteredProcedures = filteredProcedures.filter(
-        procedure => procedure.clinicBranchId === filters.clinicId,
-      );
-      console.log(
-        `[PROCEDURE_SERVICE] Applied clinic filter, results: ${filteredProcedures.length}`,
-      );
-    }
-
-    // Geo-radius filter
-    if (filters.location && filters.radiusInKm && filters.radiusInKm > 0) {
-      const location = filters.location;
-      const radiusInKm = filters.radiusInKm;
-      filteredProcedures = filteredProcedures.filter(procedure => {
-        const clinicLocation = procedure.clinicInfo?.location;
-        if (!clinicLocation?.latitude || !clinicLocation?.longitude) {
-          return false;
-        }
-
-        const distance =
-          distanceBetween(
-            [location.latitude, location.longitude],
-            [clinicLocation.latitude, clinicLocation.longitude],
-          ) / 1000; // Convert to km
-
-        // Attach distance for frontend sorting/display
-        (procedure as any).distance = distance;
-
-        return distance <= radiusInKm;
-      });
-      console.log(`[PROCEDURE_SERVICE] Applied geo filter, results: ${filteredProcedures.length}`);
-
-      // Sort by distance when geo filtering is applied
-      filteredProcedures.sort((a, b) => ((a as any).distance || 0) - ((b as any).distance || 0));
-    }
-
-    return filteredProcedures as (Procedure & { distance?: number })[];
-  }
-
-  private handleGeoQuery(filters: any): Promise<{
-    procedures: (Procedure & { distance?: number })[];
-    lastDoc: any;
-  }> {
-    console.log('[PROCEDURE_SERVICE] Executing geo query with geohash bounds');
-    try {
-      const location = filters.location;
-      const radiusInKm = filters.radiusInKm;
-
-      if (!location || !radiusInKm) {
-        return Promise.resolve({ procedures: [], lastDoc: null });
-      }
-
-      const bounds = geohashQueryBounds([location.latitude, location.longitude], radiusInKm * 1000);
-
-      const fetches = bounds.map(b => {
-        const constraints: QueryConstraint[] = [
-          where('clinicInfo.location.geohash', '>=', b[0]),
-          where('clinicInfo.location.geohash', '<=', b[1]),
-          where('isActive', '==', filters.isActive !== undefined ? filters.isActive : true),
-        ];
-        if (filters.practitionerId) {
-          constraints.push(where('practitionerId', '==', filters.practitionerId));
-        }
-        if (filters.clinicId) {
-          constraints.push(where('clinicBranchId', '==', filters.clinicId));
-        }
-        return getDocs(query(collection(this.db, PROCEDURES_COLLECTION), ...constraints));
-      });
-
-      return Promise.all(fetches)
-        .then(snaps => {
-          const collected: Procedure[] = [];
-          snaps.forEach(snap => {
-            snap.docs.forEach(d => collected.push({ ...(d.data() as Procedure), id: d.id }));
-          });
-
-          // Deduplicate by id
-          const uniqueMap = new Map<string, Procedure>();
-          for (const p of collected) {
-            uniqueMap.set(p.id, p);
-          }
-          let procedures = Array.from(uniqueMap.values());
-
-          // Apply remaining filters including precise distance and sorting
-          procedures = this.applyInMemoryFilters(procedures, filters);
-
-          // Manual pagination
-          const pageSize = filters.pagination || 10;
-          let startIndex = 0;
-          if (
-            filters.lastDoc &&
-            typeof filters.lastDoc === 'object' &&
-            (filters.lastDoc as any).id
-          ) {
-            const idx = procedures.findIndex(p => p.id === (filters.lastDoc as any).id);
-            if (idx >= 0) startIndex = idx + 1;
-          }
-          const page = procedures.slice(startIndex, startIndex + pageSize);
-          const newLastDoc = page.length === pageSize ? page[page.length - 1] : null;
-
-          console.log(
-            `[PROCEDURE_SERVICE] Geo query success: ${page.length} (of ${procedures.length}) within ${radiusInKm}km`,
-          );
-          return { procedures: page, lastDoc: newLastDoc };
-        })
-        .catch(err => {
-          console.error('[PROCEDURE_SERVICE] Geo bounds fetch failed:', err);
-          return { procedures: [], lastDoc: null };
-        });
-    } catch (error) {
-      console.error('[PROCEDURE_SERVICE] Geo query failed:', error);
-      return Promise.resolve({ procedures: [], lastDoc: null });
-    }
-  }
-
-  /**
-   * Creates a consultation procedure without requiring a product
-   * This is a special method for consultation procedures that don't use products
-   * @param data - The data for creating a consultation procedure (without productId)
-   * @returns The created procedure
-   */
-  async createConsultationProcedure(
-    data: Omit<CreateProcedureData, 'productId'>,
-  ): Promise<Procedure> {
-    // Generate procedure ID first so we can use it for media uploads
-    const procedureId = this.generateId();
-
-    // Get references to related entities (Category, Subcategory, Technology)
-    // For consultation, we don't need a product
-    const [category, subcategory, technology] = await Promise.all([
-      this.categoryService.getById(data.categoryId),
-      this.subcategoryService.getById(data.categoryId, data.subcategoryId),
-      this.technologyService.getById(data.technologyId),
-    ]);
-
-    if (!category || !subcategory || !technology) {
-      throw new Error('One or more required base entities not found');
-    }
-
-    // Get clinic and practitioner information for aggregation
-    const clinicRef = doc(this.db, CLINICS_COLLECTION, data.clinicBranchId);
-    const clinicSnapshot = await getDoc(clinicRef);
-    if (!clinicSnapshot.exists()) {
-      throw new Error(`Clinic with ID ${data.clinicBranchId} not found`);
-    }
-    const clinic = clinicSnapshot.data() as Clinic;
-
-    const practitionerRef = doc(this.db, PRACTITIONERS_COLLECTION, data.practitionerId);
-    const practitionerSnapshot = await getDoc(practitionerRef);
-    if (!practitionerSnapshot.exists()) {
-      throw new Error(`Practitioner with ID ${data.practitionerId} not found`);
-    }
-    const practitioner = practitionerSnapshot.data() as Practitioner;
-
-    // Process photos if provided
-    let processedPhotos: string[] = [];
-    if (data.photos && data.photos.length > 0) {
-      processedPhotos = await this.processMediaArray(data.photos, procedureId, 'procedure-photos');
-    }
-
-    // Transform productsMetadata from validation format to ProcedureProduct format
-    // For consultations, this will return empty array since no products are provided
-    const transformedProductsMetadata = await this.transformProductsMetadata(
-      data.productsMetadata,
-      data.technologyId,
-    );
-
-    // Create aggregated clinic info for the procedure document
-    const clinicInfo = {
-      id: clinicSnapshot.id,
-      name: clinic.name,
-      description: clinic.description || '',
-      featuredPhoto:
-        clinic.featuredPhotos && clinic.featuredPhotos.length > 0
-          ? typeof clinic.featuredPhotos[0] === 'string'
-            ? clinic.featuredPhotos[0]
-            : ''
-          : typeof clinic.coverPhoto === 'string'
-          ? clinic.coverPhoto
-          : '',
-      location: clinic.location,
-      contactInfo: clinic.contactInfo,
-    };
-
-    // Create aggregated doctor info for the procedure document
-    const doctorInfo = {
-      id: practitionerSnapshot.id,
-      name: `${practitioner.basicInfo.firstName} ${practitioner.basicInfo.lastName}`,
-      description: practitioner.basicInfo.bio || '',
-      photo:
-        typeof practitioner.basicInfo.profileImageUrl === 'string'
-          ? practitioner.basicInfo.profileImageUrl
-          : '',
-      rating: practitioner.reviewInfo?.averageRating || 0,
-      services: practitioner.procedures || [],
-    };
-
-    // Create the procedure object
-    const { productsMetadata: _, ...dataWithoutProductsMetadata } = data;
-    const newProcedure: Omit<Procedure, 'createdAt' | 'updatedAt'> = {
-      id: procedureId,
-      ...dataWithoutProductsMetadata,
-      nameLower: (data as any).nameLower || data.name.toLowerCase(),
-      photos: processedPhotos,
-      category,
-      subcategory,
-      technology,
-      // No product field for consultations (Firestore doesn't allow undefined, so we omit it entirely)
-      productsMetadata: transformedProductsMetadata, // Empty array for consultations
-      blockingConditions: technology.blockingConditions,
-      contraindications: technology.contraindications || [],
-      contraindicationIds: technology.contraindications?.map(c => c.id) || [],
-      treatmentBenefits: technology.benefits,
-      treatmentBenefitIds: Array.isArray(technology.benefits) 
-        ? technology.benefits.map(b => typeof b === 'string' ? b : b.id)
-        : [],
-      preRequirements: technology.requirements.pre,
-      postRequirements: technology.requirements.post,
-      certificationRequirement: technology.certificationRequirement,
-      documentationTemplates: technology?.documentationTemplates || [],
-      clinicInfo,
-      doctorInfo,
-      reviewInfo: {
-        totalReviews: 0,
-        averageRating: 0,
-        effectivenessOfTreatment: 0,
-        outcomeExplanation: 0,
-        painManagement: 0,
-        followUpCare: 0,
-        valueForMoney: 0,
-        recommendationPercentage: 0,
-      },
-      isActive: true,
-    };
-
-    // Create the procedure document
-    const procedureRef = doc(this.db, PROCEDURES_COLLECTION, procedureId);
-    await setDoc(procedureRef, {
-      ...newProcedure,
-      createdAt: serverTimestamp(),
-      updatedAt: serverTimestamp(),
-    });
-
-    // Return the created procedure (fetch again to get server timestamps)
-    const savedDoc = await getDoc(procedureRef);
-    return savedDoc.data() as Procedure;
-  }
-
-  /**
-   * Gets all procedures with minimal info for map display (id, name, clinicId, clinicName, address, latitude, longitude)
-   * This is optimized for mobile map usage to reduce payload size.
-   * @returns Array of minimal procedure info for map
-   */
-  async getProceduresForMap(): Promise<
-    {
-      id: string;
-      name: string;
-      clinicId: string | undefined;
-      clinicName: string | undefined;
-      address: string;
-      latitude: number | undefined;
-      longitude: number | undefined;
-    }[]
-  > {
-    const proceduresRef = collection(this.db, PROCEDURES_COLLECTION);
-    const snapshot = await getDocs(proceduresRef);
-    const proceduresForMap = snapshot.docs.map(doc => {
-      const data = doc.data();
-      return {
-        id: doc.id,
-        name: data.name,
-        clinicId: data.clinicInfo?.id,
-        clinicName: data.clinicInfo?.name,
-        address: data.clinicInfo?.location?.address || '',
-        latitude: data.clinicInfo?.location?.latitude,
-        longitude: data.clinicInfo?.location?.longitude,
-      };
-    });
-    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));
-  }
-}
+import {
+  collection,
+  doc,
+  getDoc,
+  getDocs,
+  query,
+  where,
+  updateDoc,
+  setDoc,
+  deleteDoc,
+  Timestamp,
+  serverTimestamp,
+  DocumentData,
+  writeBatch,
+  arrayUnion,
+  arrayRemove,
+  FieldValue,
+  orderBy,
+  limit,
+  startAfter,
+  QueryConstraint,
+  documentId,
+} from 'firebase/firestore';
+import { BaseService } from '../base.service';
+import {
+  Procedure,
+  CreateProcedureData,
+  UpdateProcedureData,
+  PROCEDURES_COLLECTION,
+  ProcedureSummaryInfo,
+} from '../../types/procedure';
+import { createProcedureSchema, updateProcedureSchema } from '../../validations/procedure.schema';
+import { z } from 'zod';
+import { Auth } from 'firebase/auth';
+import { Firestore } from 'firebase/firestore';
+import { FirebaseApp } from 'firebase/app';
+import { Category, CATEGORIES_COLLECTION } from '../../backoffice/types/category.types';
+import { Subcategory, SUBCATEGORIES_COLLECTION } from '../../backoffice/types/subcategory.types';
+import { Technology, TECHNOLOGIES_COLLECTION } from '../../backoffice/types/technology.types';
+import { Product, PRODUCTS_COLLECTION } from '../../backoffice/types/product.types';
+import { CategoryService } from '../../backoffice/services/category.service';
+import { SubcategoryService } from '../../backoffice/services/subcategory.service';
+import { TechnologyService } from '../../backoffice/services/technology.service';
+import { ProductService } from '../../backoffice/services/product.service';
+import { Practitioner, PRACTITIONERS_COLLECTION } from '../../types/practitioner';
+import {
+  CertificationLevel,
+  CertificationSpecialty,
+  ProcedureFamily,
+  type TreatmentBenefitDynamic,
+} from '../../backoffice/types';
+import { Currency, PricingMeasure } from '../../backoffice/types/static/pricing.types';
+import { Clinic, CLINICS_COLLECTION } from '../../types/clinic';
+import { ProcedureReviewInfo } from '../../types/reviews';
+import { distanceBetween, geohashQueryBounds } from 'geofire-common';
+import { MediaService, MediaAccessLevel } from '../media/media.service';
+import type { ProcedureProduct } from '../../backoffice/types/procedure-product.types';
+
+export class ProcedureService extends BaseService {
+  private categoryService: CategoryService;
+  private subcategoryService: SubcategoryService;
+  private technologyService: TechnologyService;
+  private productService: ProductService;
+  private mediaService: MediaService;
+
+  constructor(
+    db: Firestore,
+    auth: Auth,
+    app: FirebaseApp,
+    categoryService: CategoryService,
+    subcategoryService: SubcategoryService,
+    technologyService: TechnologyService,
+    productService: ProductService,
+    mediaService: MediaService,
+  ) {
+    super(db, auth, app);
+    this.categoryService = categoryService;
+    this.subcategoryService = subcategoryService;
+    this.technologyService = technologyService;
+    this.productService = productService;
+    this.mediaService = mediaService;
+  }
+
+  /**
+   * Process media resource (string URL or File object)
+   * @param media String URL or File object
+   * @param ownerId Owner ID for the media (usually procedureId)
+   * @param collectionName Collection name for organizing files
+   * @returns URL string after processing
+   */
+  private async processMedia(
+    media: string | File | Blob | null | undefined,
+    ownerId: string,
+    collectionName: string,
+  ): Promise<string | null> {
+    if (!media) return null;
+
+    // If already a string URL, return it directly
+    if (typeof media === 'string') {
+      return media;
+    }
+
+    // If it's a File, upload it using MediaService
+    if (media instanceof File || media instanceof Blob) {
+      console.log(`[ProcedureService] Uploading ${collectionName} media for ${ownerId}`);
+      const metadata = await this.mediaService.uploadMedia(
+        media,
+        ownerId,
+        MediaAccessLevel.PUBLIC,
+        collectionName,
+      );
+      return metadata.url;
+    }
+
+    return null;
+  }
+
+  /**
+   * Process array of media resources (strings or Files)
+   * @param mediaArray Array of string URLs or File objects
+   * @param ownerId Owner ID for the media
+   * @param collectionName Collection name for organizing files
+   * @returns Array of URL strings after processing
+   */
+  private async processMediaArray(
+    mediaArray: (string | File | Blob)[] | undefined,
+    ownerId: string,
+    collectionName: string,
+  ): Promise<string[]> {
+    if (!mediaArray || mediaArray.length === 0) return [];
+
+    const result: string[] = [];
+
+    for (const media of mediaArray) {
+      const processedUrl = await this.processMedia(media, ownerId, collectionName);
+      if (processedUrl) {
+        result.push(processedUrl);
+      }
+    }
+
+    return result;
+  }
+
+  /**
+   * Transforms validated procedure product data (with productId) to ProcedureProduct objects (with full product)
+   * @param productsMetadata Array of validated procedure product data (optional)
+   * @param technologyId Technology ID to fetch products from
+   * @returns Array of ProcedureProduct objects with full product information
+   */
+  private async transformProductsMetadata(
+    productsMetadata: {
+      productId: string;
+      price: number;
+      currency: Currency;
+      pricingMeasure: PricingMeasure;
+      isDefault?: boolean;
+    }[] | undefined,
+    technologyId: string,
+  ): Promise<ProcedureProduct[]> {
+    // Return empty array if no products metadata provided (for product-free procedures like consultations)
+    if (!productsMetadata || productsMetadata.length === 0) {
+      return [];
+    }
+
+    const transformedProducts: ProcedureProduct[] = [];
+
+    for (const productData of productsMetadata) {
+      // Fetch the full product object
+      const product = await this.productService.getById(technologyId, productData.productId);
+      if (!product) {
+        throw new Error(
+          `Product with ID ${productData.productId} not found for technology ${technologyId}`,
+        );
+      }
+
+      // Transform to ProcedureProduct
+      transformedProducts.push({
+        product,
+        price: productData.price,
+        currency: productData.currency,
+        pricingMeasure: productData.pricingMeasure,
+        isDefault: productData.isDefault,
+      });
+    }
+
+    return transformedProducts;
+  }
+
+  /**
+   * Creates a new procedure
+   * @param data - The data for creating a new procedure
+   * @returns The created procedure
+   */
+  async createProcedure(data: CreateProcedureData): Promise<Procedure> {
+    const validatedData = createProcedureSchema.parse(data);
+
+    // Check if this is a product-free procedure (e.g., free consultation)
+    const isProductFree = !validatedData.productId;
+
+    // Generate procedure ID first so we can use it for media uploads
+    const procedureId = this.generateId();
+
+    // Get references to related entities (Category, Subcategory, Technology, and optionally Product)
+    const baseEntitiesPromises: Promise<Category | Subcategory | Technology | Product | null>[] = [
+      this.categoryService.getById(validatedData.categoryId),
+      this.subcategoryService.getById(validatedData.categoryId, validatedData.subcategoryId),
+      this.technologyService.getById(validatedData.technologyId),
+    ];
+
+    // Only fetch product if productId is provided
+    if (!isProductFree) {
+      baseEntitiesPromises.push(
+        this.productService.getById(validatedData.technologyId, validatedData.productId!)
+      );
+    }
+
+    const results = await Promise.all(baseEntitiesPromises);
+    const category = results[0] as Category | null;
+    const subcategory = results[1] as Subcategory | null;
+    const technology = results[2] as Technology | null;
+    const product = isProductFree ? undefined : ((results[3] as Product | null) || undefined);
+
+    if (!category || !subcategory || !technology) {
+      throw new Error('One or more required base entities not found');
+    }
+
+    // For regular procedures, validate product exists
+    if (!isProductFree && !product) {
+      throw new Error('Product not found for regular procedure');
+    }
+
+    // Get clinic and practitioner information for aggregation
+    const clinicRef = doc(this.db, CLINICS_COLLECTION, validatedData.clinicBranchId);
+    const clinicSnapshot = await getDoc(clinicRef);
+    if (!clinicSnapshot.exists()) {
+      throw new Error(`Clinic with ID ${validatedData.clinicBranchId} not found`);
+    }
+    const clinic = clinicSnapshot.data() as Clinic; // Assert type
+
+    const practitionerRef = doc(this.db, PRACTITIONERS_COLLECTION, validatedData.practitionerId);
+    const practitionerSnapshot = await getDoc(practitionerRef);
+    if (!practitionerSnapshot.exists()) {
+      throw new Error(`Practitioner with ID ${validatedData.practitionerId} not found`);
+    }
+    const practitioner = practitionerSnapshot.data() as Practitioner; // Assert type
+
+    // Process photos if provided
+    let processedPhotos: string[] = [];
+    if (validatedData.photos && validatedData.photos.length > 0) {
+      processedPhotos = await this.processMediaArray(
+        validatedData.photos,
+        procedureId,
+        'procedure-photos',
+      );
+    }
+
+    // Transform productsMetadata from validation format to ProcedureProduct format
+    const transformedProductsMetadata = await this.transformProductsMetadata(
+      validatedData.productsMetadata,
+      validatedData.technologyId,
+    );
+
+    // Create aggregated clinic info for the procedure document
+    const clinicInfo = {
+      id: clinicSnapshot.id,
+      name: clinic.name,
+      description: clinic.description || '',
+      featuredPhoto:
+        clinic.featuredPhotos && clinic.featuredPhotos.length > 0
+          ? typeof clinic.featuredPhotos[0] === 'string'
+            ? clinic.featuredPhotos[0]
+            : ''
+          : typeof clinic.coverPhoto === 'string'
+          ? clinic.coverPhoto
+          : '',
+      location: clinic.location,
+      contactInfo: clinic.contactInfo,
+    };
+
+    // Create aggregated doctor info for the procedure document
+    const doctorInfo = {
+      id: practitionerSnapshot.id,
+      name: `${practitioner.basicInfo.firstName} ${practitioner.basicInfo.lastName}`,
+      description: practitioner.basicInfo.bio || '',
+      photo:
+        typeof practitioner.basicInfo.profileImageUrl === 'string'
+          ? practitioner.basicInfo.profileImageUrl
+          : '', // Default to empty string if not a processed URL
+      rating: practitioner.reviewInfo?.averageRating || 0,
+      services: practitioner.procedures || [],
+    };
+
+    // Create the procedure object
+    const { productsMetadata: _, productId: __, photos: ___, ...validatedDataWithoutProductsMetadata } = validatedData;
+    const newProcedure: Omit<Procedure, 'createdAt' | 'updatedAt'> = {
+      id: procedureId,
+      ...validatedDataWithoutProductsMetadata,
+      // Ensure nameLower is always set even if omitted by client
+      nameLower: (validatedData as any).nameLower || validatedData.name.toLowerCase(),
+      photos: processedPhotos,
+      category, // Embed full objects
+      subcategory,
+      technology,
+      ...(product && { product }), // Only include product field if it exists (Firestore doesn't allow undefined)
+      productsMetadata: transformedProductsMetadata, // Use transformed data, not original
+      blockingConditions: technology.blockingConditions,
+      contraindications: technology.contraindications || [],
+      contraindicationIds: technology.contraindications?.map(c => c.id) || [],
+      treatmentBenefits: technology.benefits,
+      treatmentBenefitIds: Array.isArray(technology.benefits) 
+        ? technology.benefits.map(b => typeof b === 'string' ? b : b.id)
+        : [],
+      preRequirements: technology.requirements.pre,
+      postRequirements: technology.requirements.post,
+      certificationRequirement: technology.certificationRequirement,
+      documentationTemplates: technology?.documentationTemplates || [],
+      clinicInfo, // Embed aggregated info
+      doctorInfo, // Embed aggregated info
+      reviewInfo: {
+        // Default empty reviews
+        totalReviews: 0,
+        averageRating: 0,
+        effectivenessOfTreatment: 0,
+        outcomeExplanation: 0,
+        painManagement: 0,
+        followUpCare: 0,
+        valueForMoney: 0,
+        recommendationPercentage: 0,
+      },
+      isActive: true, // Default to active
+    };
+
+    // 🔥 DEBUG: Find undefined fields before writing to Firestore
+    console.log('🔥🔥🔥 CREATE PROCEDURE - Processing procedure:', procedureId);
+    console.log('🔥🔥🔥 FULL PROCEDURE OBJECT:', JSON.stringify(newProcedure, null, 2));
+    
+    const undefinedFields: string[] = [];
+    Object.entries(newProcedure).forEach(([key, value]) => {
+      if (value === undefined) {
+        undefinedFields.push(key);
+      }
+    });
+    if (undefinedFields.length > 0) {
+      console.error('🔥🔥🔥 UNDEFINED FIELDS DETECTED:', undefinedFields);
+      throw new Error(`Cannot write procedure with undefined fields: ${undefinedFields.join(', ')}`);
+    }
+    console.log('🔥🔥🔥 NO UNDEFINED FIELDS - Proceeding with setDoc');
+
+    // Create the procedure document
+    const procedureRef = doc(this.db, PROCEDURES_COLLECTION, procedureId);
+    await setDoc(procedureRef, {
+      ...newProcedure,
+      createdAt: serverTimestamp(),
+      updatedAt: serverTimestamp(),
+    });
+
+    // Return the created procedure (fetch again to get server timestamps)
+    const savedDoc = await getDoc(procedureRef);
+    return savedDoc.data() as Procedure;
+  }
+
+  /**
+   * Creates multiple procedures for a list of practitioners based on common data.
+   * This method is optimized for bulk creation to reduce database reads and writes.
+   *
+   * @param baseData - The base data for the procedures to be created, omitting the practitionerId.
+   * @param practitionerIds - An array of practitioner IDs for whom the procedures will be created.
+   * @returns A promise that resolves to an array of the newly created procedures.
+   */
+  async bulkCreateProcedures(
+    baseData: Omit<CreateProcedureData, 'practitionerId'>,
+    practitionerIds: string[],
+  ): Promise<Procedure[]> {
+    // 1. Validation
+    if (!practitionerIds || practitionerIds.length === 0) {
+      throw new Error('Practitioner IDs array cannot be empty.');
+    }
+
+    // Check if this is a product-free procedure
+    const isProductFree = !baseData.productId;
+
+    // Add a dummy practitionerId for the validation schema to pass
+    const validationData = { ...baseData, practitionerId: practitionerIds[0] };
+    const validatedData = createProcedureSchema.parse(validationData);
+
+    // 2. Fetch common data once to avoid redundant reads
+    const baseEntitiesPromises: Promise<Category | Subcategory | Technology | Product | null>[] = [
+      this.categoryService.getById(validatedData.categoryId),
+      this.subcategoryService.getById(validatedData.categoryId, validatedData.subcategoryId),
+      this.technologyService.getById(validatedData.technologyId),
+    ];
+
+    // Only fetch product if productId is provided
+    if (!isProductFree) {
+      baseEntitiesPromises.push(
+        this.productService.getById(validatedData.technologyId, validatedData.productId!)
+      );
+    }
+
+    // Fetch clinic separately to maintain type safety
+    const clinicSnapshotPromise = getDoc(doc(this.db, CLINICS_COLLECTION, validatedData.clinicBranchId));
+
+    const [baseResults, clinicSnapshot] = await Promise.all([
+      Promise.all(baseEntitiesPromises),
+      clinicSnapshotPromise
+    ]);
+    
+    const category = baseResults[0] as Category | null;
+    const subcategory = baseResults[1] as Subcategory | null;
+    const technology = baseResults[2] as Technology | null;
+    const product = isProductFree ? undefined : ((baseResults[3] as Product | null) || undefined);
+
+    if (!category || !subcategory || !technology) {
+      throw new Error('One or more required base entities not found');
+    }
+    
+    // For regular procedures, validate product exists
+    if (!isProductFree && !product) {
+      throw new Error('Product not found for regular procedure');
+    }
+    
+    if (!clinicSnapshot || !clinicSnapshot.exists()) {
+      throw new Error(`Clinic with ID ${validatedData.clinicBranchId} not found`);
+    }
+    const clinic = clinicSnapshot.data() as Clinic;
+
+    // 3. Handle media uploads once for efficiency
+    let processedPhotos: string[] = [];
+    if (validatedData.photos && validatedData.photos.length > 0) {
+      const batchId = this.generateId(); // Use a single ID for all media in this batch
+      processedPhotos = await this.processMediaArray(
+        validatedData.photos,
+        batchId,
+        'procedure-photos-batch',
+      );
+    }
+
+    // Transform productsMetadata from validation format to ProcedureProduct format
+    const transformedProductsMetadata = await this.transformProductsMetadata(
+      validatedData.productsMetadata,
+      validatedData.technologyId,
+    );
+
+    // 4. Fetch all practitioner data efficiently
+    const practitionersMap = new Map<string, Practitioner>();
+    // Use 'in' query in chunks of 30, as this is the Firestore limit
+    for (let i = 0; i < practitionerIds.length; i += 30) {
+      const chunk = practitionerIds.slice(i, i + 30);
+      const practitionersQuery = query(
+        collection(this.db, PRACTITIONERS_COLLECTION),
+        where(documentId(), 'in', chunk),
+      );
+      const practitionersSnapshot = await getDocs(practitionersQuery);
+      practitionersSnapshot.docs.forEach(doc => {
+        practitionersMap.set(doc.id, doc.data() as Practitioner);
+      });
+    }
+
+    // Verify all practitioners were found
+    if (practitionersMap.size !== practitionerIds.length) {
+      const foundIds = Array.from(practitionersMap.keys());
+      const notFoundIds = practitionerIds.filter(id => !foundIds.includes(id));
+      throw new Error(`The following practitioners were not found: ${notFoundIds.join(', ')}`);
+    }
+
+    // 5. Use a Firestore batch for atomic creation
+    const batch = writeBatch(this.db);
+    const createdProcedureIds: string[] = [];
+    const clinicInfo = {
+      id: clinicSnapshot.id,
+      name: clinic.name,
+      description: clinic.description || '',
+      featuredPhoto:
+        clinic.featuredPhotos && clinic.featuredPhotos.length > 0
+          ? typeof clinic.featuredPhotos[0] === 'string'
+            ? clinic.featuredPhotos[0]
+            : ''
+          : typeof clinic.coverPhoto === 'string'
+          ? clinic.coverPhoto
+          : '',
+      location: clinic.location,
+      contactInfo: clinic.contactInfo,
+    };
+
+    for (const practitionerId of practitionerIds) {
+      const practitioner = practitionersMap.get(practitionerId)!;
+
+      const doctorInfo = {
+        id: practitioner.id,
+        name: `${practitioner.basicInfo.firstName} ${practitioner.basicInfo.lastName}`,
+        description: practitioner.basicInfo.bio || '',
+        photo:
+          typeof practitioner.basicInfo.profileImageUrl === 'string'
+            ? practitioner.basicInfo.profileImageUrl
+            : '',
+        rating: practitioner.reviewInfo?.averageRating || 0,
+        services: practitioner.procedures || [],
+      };
+
+      const procedureId = this.generateId();
+      createdProcedureIds.push(procedureId);
+      const procedureRef = doc(this.db, PROCEDURES_COLLECTION, procedureId);
+
+      // Construct the new procedure, reusing common data
+      const { productsMetadata: _, productId: __, photos: ___, ...validatedDataWithoutProductsMetadata } = validatedData;
+      const newProcedure: Omit<Procedure, 'createdAt' | 'updatedAt'> = {
+        id: procedureId,
+        ...validatedDataWithoutProductsMetadata,
+        nameLower: (validatedData as any).nameLower || validatedData.name.toLowerCase(),
+        practitionerId: practitionerId, // Override practitionerId with the correct one
+        photos: processedPhotos,
+        category,
+        subcategory,
+        technology,
+        ...(product && { product }), // Only include product field if it exists (Firestore doesn't allow undefined)
+        productsMetadata: transformedProductsMetadata, // Use transformed data, not original
+        blockingConditions: technology.blockingConditions,
+        contraindications: technology.contraindications || [],
+        contraindicationIds: technology.contraindications?.map(c => c.id) || [],
+        treatmentBenefits: technology.benefits,
+        treatmentBenefitIds: Array.isArray(technology.benefits) 
+        ? technology.benefits.map(b => typeof b === 'string' ? b : b.id)
+        : [],
+        preRequirements: technology.requirements.pre,
+        postRequirements: technology.requirements.post,
+        certificationRequirement: technology.certificationRequirement,
+        documentationTemplates: technology?.documentationTemplates || [],
+        clinicInfo,
+        doctorInfo, // Set specific doctor info
+        reviewInfo: {
+          totalReviews: 0,
+          averageRating: 0,
+          effectivenessOfTreatment: 0,
+          outcomeExplanation: 0,
+          painManagement: 0,
+          followUpCare: 0,
+          valueForMoney: 0,
+          recommendationPercentage: 0,
+        },
+        isActive: true,
+      };
+
+      // 🔥 DEBUG: Find undefined fields before writing to Firestore
+      console.log('🔥🔥🔥 BULK CREATE - Processing procedure:', procedureId, 'for practitioner:', practitionerId);
+      console.log('🔥🔥🔥 FULL PROCEDURE OBJECT:', JSON.stringify(newProcedure, null, 2));
+      
+      const undefinedFields: string[] = [];
+      Object.entries(newProcedure).forEach(([key, value]) => {
+        if (value === undefined) {
+          undefinedFields.push(key);
+        }
+      });
+      if (undefinedFields.length > 0) {
+        console.error('🔥🔥🔥 UNDEFINED FIELDS DETECTED:', undefinedFields);
+        throw new Error(`Cannot write procedure with undefined fields: ${undefinedFields.join(', ')}`);
+      }
+      console.log('🔥🔥🔥 NO UNDEFINED FIELDS - Proceeding with batch.set');
+
+      batch.set(procedureRef, {
+        ...newProcedure,
+        createdAt: serverTimestamp(),
+        updatedAt: serverTimestamp(),
+      });
+    }
+
+    // 6. Commit the atomic batch write
+    await batch.commit();
+
+    // 7. Fetch and return the newly created procedures
+    const fetchedProcedures: Procedure[] = [];
+    for (let i = 0; i < createdProcedureIds.length; i += 30) {
+      const chunk = createdProcedureIds.slice(i, i + 30);
+      const q = query(collection(this.db, PROCEDURES_COLLECTION), where(documentId(), 'in', chunk));
+      const snapshot = await getDocs(q);
+      snapshot.forEach(doc => {
+        fetchedProcedures.push(doc.data() as Procedure);
+      });
+    }
+
+    return fetchedProcedures;
+  }
+
+  /**
+   * Gets a procedure by ID
+   * @param id - The ID of the procedure to get
+   * @returns The procedure if found, null otherwise
+   */
+  async getProcedure(id: string): Promise<Procedure | null> {
+    const docRef = doc(this.db, PROCEDURES_COLLECTION, id);
+    const docSnap = await getDoc(docRef);
+
+    if (!docSnap.exists()) {
+      return null;
+    }
+
+    return docSnap.data() as Procedure;
+  }
+
+  /**
+   * Gets all procedures for a clinic branch
+   * @param clinicBranchId - The ID of the clinic branch
+   * @returns List of procedures
+   */
+  async getProceduresByClinicBranch(clinicBranchId: string): Promise<Procedure[]> {
+    const q = query(
+      collection(this.db, PROCEDURES_COLLECTION),
+      where('clinicBranchId', '==', clinicBranchId),
+      where('isActive', '==', true),
+    );
+    const snapshot = await getDocs(q);
+    return snapshot.docs.map(doc => doc.data() as Procedure);
+  }
+
+  /**
+   * Gets all procedures for a practitioner
+   * @param practitionerId - The ID of the practitioner
+   * @returns List of procedures
+   */
+  async getProceduresByPractitioner(practitionerId: string): Promise<Procedure[]> {
+    const q = query(
+      collection(this.db, PROCEDURES_COLLECTION),
+      where('practitionerId', '==', practitionerId),
+      where('isActive', '==', true),
+    );
+    const snapshot = await getDocs(q);
+    return snapshot.docs.map(doc => doc.data() as Procedure);
+  }
+
+  /**
+   * Gets all inactive procedures for a practitioner
+   * @param practitionerId - The ID of the practitioner
+   * @returns List of inactive procedures
+   */
+  async getInactiveProceduresByPractitioner(practitionerId: string): Promise<Procedure[]> {
+    const q = query(
+      collection(this.db, PROCEDURES_COLLECTION),
+      where('practitionerId', '==', practitionerId),
+      where('isActive', '==', false),
+    );
+    const snapshot = await getDocs(q);
+    return snapshot.docs.map(doc => doc.data() as Procedure);
+  }
+
+  /**
+   * Updates a procedure
+   * @param id - The ID of the procedure to update
+   * @param data - The data to update the procedure with
+   * @returns The updated procedure
+   */
+  async updateProcedure(id: string, data: UpdateProcedureData): Promise<Procedure> {
+    const validatedData = updateProcedureSchema.parse(data);
+    const procedureRef = doc(this.db, PROCEDURES_COLLECTION, id);
+    const procedureSnapshot = await getDoc(procedureRef);
+
+    if (!procedureSnapshot.exists()) {
+      throw new Error(`Procedure with ID ${id} not found`);
+    }
+
+    const existingProcedure = procedureSnapshot.data() as Procedure;
+    let updatedProcedureData: Partial<Procedure> = {};
+
+    // Copy validated simple fields
+    if (validatedData.name !== undefined) updatedProcedureData.name = validatedData.name;
+    if (validatedData.description !== undefined)
+      updatedProcedureData.description = validatedData.description;
+    if (validatedData.price !== undefined) updatedProcedureData.price = validatedData.price;
+    if (validatedData.currency !== undefined)
+      updatedProcedureData.currency = validatedData.currency;
+    if (validatedData.pricingMeasure !== undefined)
+      updatedProcedureData.pricingMeasure = validatedData.pricingMeasure;
+    if (validatedData.duration !== undefined)
+      updatedProcedureData.duration = validatedData.duration;
+    if (validatedData.isActive !== undefined)
+      updatedProcedureData.isActive = validatedData.isActive;
+
+    let practitionerChanged = false;
+    let clinicChanged = false;
+    const oldPractitionerId = existingProcedure.practitionerId;
+    const oldClinicId = existingProcedure.clinicBranchId;
+    let newPractitioner: Practitioner | null = null;
+    let newClinic: Clinic | null = null;
+
+    // Process photos if provided
+    if (validatedData.photos !== undefined) {
+      updatedProcedureData.photos = await this.processMediaArray(
+        validatedData.photos,
+        id,
+        'procedure-photos',
+      );
+    }
+
+    // Transform productsMetadata if provided
+    if (validatedData.productsMetadata !== undefined) {
+      const technologyId = validatedData.technologyId ?? existingProcedure.technology.id;
+      if (!technologyId) {
+        throw new Error('Technology ID is required for updating products metadata');
+      }
+      updatedProcedureData.productsMetadata = await this.transformProductsMetadata(
+        validatedData.productsMetadata,
+        technologyId,
+      );
+    }
+
+    // --- Prepare updates and fetch new related data if IDs change ---
+
+    // Handle Practitioner Change
+    if (validatedData.practitionerId && validatedData.practitionerId !== oldPractitionerId) {
+      practitionerChanged = true;
+      const newPractitionerRef = doc(
+        this.db,
+        PRACTITIONERS_COLLECTION,
+        validatedData.practitionerId,
+      );
+      const newPractitionerSnap = await getDoc(newPractitionerRef);
+      if (!newPractitionerSnap.exists())
+        throw new Error(`New Practitioner ${validatedData.practitionerId} not found`);
+      newPractitioner = newPractitionerSnap.data() as Practitioner;
+      // Update doctorInfo within the procedure document
+      updatedProcedureData.doctorInfo = {
+        id: newPractitioner.id,
+        name: `${newPractitioner.basicInfo.firstName} ${newPractitioner.basicInfo.lastName}`,
+        description: newPractitioner.basicInfo.bio || '',
+        photo:
+          typeof newPractitioner.basicInfo.profileImageUrl === 'string'
+            ? newPractitioner.basicInfo.profileImageUrl
+            : '', // Default to empty string if not a processed URL
+        rating: newPractitioner.reviewInfo?.averageRating || 0,
+        services: newPractitioner.procedures || [],
+      };
+    }
+
+    // Handle Clinic Change
+    if (validatedData.clinicBranchId && validatedData.clinicBranchId !== oldClinicId) {
+      clinicChanged = true;
+      const newClinicRef = doc(this.db, CLINICS_COLLECTION, validatedData.clinicBranchId);
+      const newClinicSnap = await getDoc(newClinicRef);
+      if (!newClinicSnap.exists())
+        throw new Error(`New Clinic ${validatedData.clinicBranchId} not found`);
+      newClinic = newClinicSnap.data() as Clinic;
+      // Update clinicInfo within the procedure document
+      updatedProcedureData.clinicInfo = {
+        id: newClinic.id,
+        name: newClinic.name,
+        description: newClinic.description || '',
+        featuredPhoto:
+          newClinic.featuredPhotos && newClinic.featuredPhotos.length > 0
+            ? typeof newClinic.featuredPhotos[0] === 'string'
+              ? newClinic.featuredPhotos[0]
+              : ''
+            : typeof newClinic.coverPhoto === 'string'
+            ? newClinic.coverPhoto
+            : '',
+        location: newClinic.location,
+        contactInfo: newClinic.contactInfo,
+      };
+    }
+
+    // Handle Category/Subcategory/Technology/Product Changes
+    let finalCategoryId = existingProcedure.category.id;
+    if (validatedData.name) {
+      updatedProcedureData.nameLower = validatedData.name.toLowerCase();
+    }
+    if (validatedData.categoryId) {
+      const category = await this.categoryService.getById(validatedData.categoryId);
+      if (!category) throw new Error(`Category ${validatedData.categoryId} not found`);
+      updatedProcedureData.category = category;
+      finalCategoryId = category.id; // Update finalCategoryId if category changed
+    }
+
+    // Only fetch subcategory if its ID is provided AND we have a valid finalCategoryId
+    if (validatedData.subcategoryId && finalCategoryId) {
+      const subcategory = await this.subcategoryService.getById(
+        finalCategoryId,
+        validatedData.subcategoryId,
+      );
+      if (!subcategory)
+        throw new Error(
+          `Subcategory ${validatedData.subcategoryId} not found for category ${finalCategoryId}`,
+        );
+      updatedProcedureData.subcategory = subcategory;
+    } else if (validatedData.subcategoryId) {
+      console.warn('Attempted to update subcategory without a valid categoryId');
+    }
+
+    let finalTechnologyId = existingProcedure.technology.id;
+    if (validatedData.technologyId) {
+      const technology = await this.technologyService.getById(validatedData.technologyId);
+      if (!technology) throw new Error(`Technology ${validatedData.technologyId} not found`);
+      updatedProcedureData.technology = technology;
+      finalTechnologyId = technology.id; // Update finalTechnologyId if technology changed
+      // Update related fields derived from technology
+      updatedProcedureData.blockingConditions = technology.blockingConditions;
+      updatedProcedureData.contraindications = technology.contraindications || [];
+      updatedProcedureData.contraindicationIds = technology.contraindications?.map(c => c.id) || [];
+      updatedProcedureData.treatmentBenefits = technology.benefits;
+      updatedProcedureData.treatmentBenefitIds = Array.isArray(technology.benefits)
+        ? technology.benefits.map(b => typeof b === 'string' ? b : b.id)
+        : [];
+      updatedProcedureData.preRequirements = technology.requirements.pre;
+      updatedProcedureData.postRequirements = technology.requirements.post;
+      updatedProcedureData.certificationRequirement = technology.certificationRequirement;
+      updatedProcedureData.documentationTemplates = technology.documentationTemplates || [];
+    }
+
+    // Only fetch product if its ID is provided AND we have a valid finalTechnologyId
+    if (validatedData.productId && finalTechnologyId) {
+      const product = await this.productService.getById(finalTechnologyId, validatedData.productId);
+      if (!product)
+        throw new Error(
+          `Product ${validatedData.productId} not found for technology ${finalTechnologyId}`,
+        );
+      updatedProcedureData.product = product;
+    } else if (validatedData.productId) {
+      console.warn('Attempted to update product without a valid technologyId');
+    }
+
+    // Update the procedure document
+    await updateDoc(procedureRef, {
+      ...updatedProcedureData,
+      updatedAt: serverTimestamp(),
+    });
+
+    // Return the updated procedure
+    const updatedSnapshot = await getDoc(procedureRef);
+    return updatedSnapshot.data() as Procedure;
+  }
+
+  /**
+   * Deactivates a procedure (soft delete)
+   * @param id - The ID of the procedure to deactivate
+   */
+  async deactivateProcedure(id: string): Promise<void> {
+    const procedureRef = doc(this.db, PROCEDURES_COLLECTION, id);
+    const procedureSnap = await getDoc(procedureRef);
+    if (!procedureSnap.exists()) {
+      console.warn(`Procedure ${id} not found for deactivation.`);
+      return;
+    }
+
+    // Mark procedure as inactive
+    await updateDoc(procedureRef, {
+      isActive: false,
+      updatedAt: serverTimestamp(),
+    });
+  }
+
+  /**
+   * Deletes a procedure permanently
+   * @param id - The ID of the procedure to delete
+   * @returns A boolean indicating if the deletion was successful
+   */
+  async deleteProcedure(id: string): Promise<boolean> {
+    const procedureRef = doc(this.db, PROCEDURES_COLLECTION, id);
+    const procedureSnapshot = await getDoc(procedureRef);
+
+    if (!procedureSnapshot.exists()) {
+      // Already deleted or never existed
+      return false;
+    }
+
+    // Delete the procedure document
+    await deleteDoc(procedureRef);
+    return true;
+  }
+
+  /**
+   * Gets all procedures that a practitioner is certified to perform
+   * @param practitioner - The practitioner's profile
+   * @returns Object containing allowed technologies, families, categories, subcategories
+   */
+  async getAllowedTechnologies(practitioner: Practitioner): Promise<{
+    technologies: Technology[];
+    families: ProcedureFamily[];
+    categories: string[];
+    subcategories: string[];
+  }> {
+    // This logic depends on TechnologyService and remains valid
+    const { technologies, families, categories, subcategories } =
+      await this.technologyService.getAllowedTechnologies(practitioner);
+
+    return {
+      technologies,
+      families,
+      categories,
+      subcategories,
+    };
+  }
+
+  /**
+   * Gets all procedures with optional pagination
+   *
+   * @param pagination - Optional number of procedures per page (0 or undefined returns all)
+   * @param lastDoc - Optional last document for pagination (if continuing from a previous page)
+   * @returns Object containing procedures array and the last document for pagination
+   */
+  async getAllProcedures(
+    pagination?: number,
+    lastDoc?: any,
+  ): Promise<{ procedures: Procedure[]; lastDoc: any }> {
+    try {
+      const proceduresCollection = collection(this.db, PROCEDURES_COLLECTION);
+      let proceduresQuery = query(proceduresCollection);
+
+      // Apply pagination if specified
+      if (pagination && pagination > 0) {
+        const { limit, startAfter } = await import('firebase/firestore'); // Use dynamic import if needed top-level
+
+        if (lastDoc) {
+          proceduresQuery = query(
+            proceduresCollection,
+            orderBy('name'), // Use imported orderBy
+            startAfter(lastDoc),
+            limit(pagination),
+          );
+        } else {
+          proceduresQuery = query(proceduresCollection, orderBy('name'), limit(pagination)); // Use imported orderBy
+        }
+      } else {
+        proceduresQuery = query(proceduresCollection, orderBy('name')); // Use imported orderBy
+      }
+
+      const proceduresSnapshot = await getDocs(proceduresQuery);
+      const lastVisible = proceduresSnapshot.docs[proceduresSnapshot.docs.length - 1];
+
+      const procedures = proceduresSnapshot.docs.map(doc => {
+        const data = doc.data() as Procedure;
+        return {
+          ...data,
+          id: doc.id, // Ensure ID is present
+        };
+      });
+
+      return {
+        procedures,
+        lastDoc: lastVisible,
+      };
+    } catch (error) {
+      console.error('[PROCEDURE_SERVICE] Error getting all procedures:', error);
+      throw error;
+    }
+  }
+
+  /**
+   * Searches and filters procedures based on multiple criteria
+   *
+   * @note Frontend MORA da šalje ceo snapshot (ili barem sva polja po kojima sortiraš, npr. nameLower) kao lastDoc za paginaciju, a ne samo id!
+   *
+   * @param filters - Various filters to apply
+   * @param filters.nameSearch - Optional search text for procedure name
+   * @param filters.treatmentBenefitIds - Optional array of treatment benefits to filter by
+   * @param filters.procedureFamily - Optional procedure family to filter by
+   * @param filters.procedureCategory - Optional procedure category to filter by
+   * @param filters.procedureSubcategory - Optional procedure subcategory to filter by
+   * @param filters.procedureTechnology - Optional procedure technology to filter by
+   * @param filters.location - Optional location for distance-based search
+   * @param filters.radiusInKm - Optional radius in kilometers (required if location is provided)
+   * @param filters.minPrice - Optional minimum price
+   * @param filters.maxPrice - Optional maximum price
+   * @param filters.minRating - Optional minimum rating (0-5)
+   * @param filters.maxRating - Optional maximum rating (0-5)
+   * @param filters.pagination - Optional number of results per page
+   * @param filters.lastDoc - Optional last document for pagination
+   * @param filters.isActive - Optional filter for active procedures only
+   * @returns Filtered procedures and the last document for pagination
+   */
+  async getProceduresByFilters(filters: {
+    nameSearch?: string;
+    treatmentBenefits?: string[];
+    procedureFamily?: ProcedureFamily;
+    procedureCategory?: string;
+    procedureSubcategory?: string;
+    procedureTechnology?: string;
+    location?: { latitude: number; longitude: number };
+    radiusInKm?: number;
+    minPrice?: number;
+    maxPrice?: number;
+    minRating?: number;
+    maxRating?: number;
+    pagination?: number;
+    lastDoc?: any;
+    isActive?: boolean;
+    practitionerId?: string;
+    clinicId?: string;
+  }): Promise<{
+    procedures: (Procedure & { distance?: number })[];
+    lastDoc: any;
+  }> {
+    try {
+      console.log('[PROCEDURE_SERVICE] Starting procedure filtering with multiple strategies');
+
+      // Geo query debug i validacija
+      if (filters.location && filters.radiusInKm) {
+        console.log('[PROCEDURE_SERVICE] Executing geo query:', {
+          location: filters.location,
+          radius: filters.radiusInKm,
+          serviceName: 'ProcedureService',
+        });
+
+        // Validacija location podataka
+        if (!filters.location.latitude || !filters.location.longitude) {
+          console.warn('[PROCEDURE_SERVICE] Invalid location data:', filters.location);
+          filters.location = undefined;
+          filters.radiusInKm = undefined;
+        }
+      }
+
+      // Handle geo queries separately (they work differently)
+      const isGeoQuery = filters.location && filters.radiusInKm && filters.radiusInKm > 0;
+      if (isGeoQuery) {
+        return this.handleGeoQuery(filters);
+      }
+
+      // Base constraints (used in all strategies)
+      const getBaseConstraints = () => {
+        const constraints: QueryConstraint[] = [];
+
+        // Active status filter
+        if (filters.isActive !== undefined) {
+          constraints.push(where('isActive', '==', filters.isActive));
+        } else {
+          constraints.push(where('isActive', '==', true));
+        }
+
+        // Filter constraints
+        if (filters.procedureFamily) {
+          constraints.push(where('family', '==', filters.procedureFamily));
+        }
+        if (filters.procedureCategory) {
+          constraints.push(where('category.id', '==', filters.procedureCategory));
+        }
+        if (filters.procedureSubcategory) {
+          constraints.push(where('subcategory.id', '==', filters.procedureSubcategory));
+        }
+        if (filters.procedureTechnology) {
+          constraints.push(where('technology.id', '==', filters.procedureTechnology));
+        }
+        if (filters.practitionerId) {
+          constraints.push(where('practitionerId', '==', filters.practitionerId));
+        }
+        if (filters.clinicId) {
+          constraints.push(where('clinicBranchId', '==', filters.clinicId));
+        }
+        if (filters.minPrice !== undefined) {
+          constraints.push(where('price', '>=', filters.minPrice));
+        }
+        if (filters.maxPrice !== undefined) {
+          constraints.push(where('price', '<=', filters.maxPrice));
+        }
+        if (filters.minRating !== undefined) {
+          constraints.push(where('reviewInfo.averageRating', '>=', filters.minRating));
+        }
+        if (filters.maxRating !== undefined) {
+          constraints.push(where('reviewInfo.averageRating', '<=', filters.maxRating));
+        }
+        if (filters.treatmentBenefits && filters.treatmentBenefits.length > 0) {
+          const benefitIdsToMatch = filters.treatmentBenefits;
+          constraints.push(where('treatmentBenefitIds', 'array-contains-any', benefitIdsToMatch));
+        }
+
+        return constraints;
+      };
+
+      // Strategy 1: Try nameLower search if nameSearch exists
+      if (filters.nameSearch && filters.nameSearch.trim()) {
+        try {
+          console.log('[PROCEDURE_SERVICE] Strategy 1: Trying nameLower search');
+          const searchTerm = filters.nameSearch.trim().toLowerCase();
+          const constraints = getBaseConstraints();
+          constraints.push(where('nameLower', '>=', searchTerm));
+          constraints.push(where('nameLower', '<=', searchTerm + '\uf8ff'));
+          constraints.push(orderBy('nameLower'));
+
+          if (filters.lastDoc) {
+            if (typeof filters.lastDoc.data === 'function') {
+              constraints.push(startAfter(filters.lastDoc));
+            } else if (Array.isArray(filters.lastDoc)) {
+              constraints.push(startAfter(...filters.lastDoc));
+            } else {
+              constraints.push(startAfter(filters.lastDoc));
+            }
+          }
+          constraints.push(limit(filters.pagination || 10));
+
+          const q = query(collection(this.db, PROCEDURES_COLLECTION), ...constraints);
+          const querySnapshot = await getDocs(q);
+          const procedures = querySnapshot.docs.map(
+            doc => ({ ...doc.data(), id: doc.id } as Procedure),
+          );
+          const lastDoc =
+            querySnapshot.docs.length > 0
+              ? querySnapshot.docs[querySnapshot.docs.length - 1]
+              : null;
+
+          console.log(`[PROCEDURE_SERVICE] Strategy 1 success: ${procedures.length} procedures`);
+
+          // Fix Load More - ako je broj rezultata manji od pagination, nema više
+          if (procedures.length < (filters.pagination || 10)) {
+            return { procedures, lastDoc: null };
+          }
+          return { procedures, lastDoc };
+        } catch (error) {
+          console.log('[PROCEDURE_SERVICE] Strategy 1 failed:', error);
+        }
+      }
+
+      // Strategy 2: Try name field search as fallback
+      if (filters.nameSearch && filters.nameSearch.trim()) {
+        try {
+          console.log('[PROCEDURE_SERVICE] Strategy 2: Trying name field search');
+          const searchTerm = filters.nameSearch.trim().toLowerCase();
+          const constraints = getBaseConstraints();
+          constraints.push(where('name', '>=', searchTerm));
+          constraints.push(where('name', '<=', searchTerm + '\uf8ff'));
+          constraints.push(orderBy('name'));
+
+          if (filters.lastDoc) {
+            if (typeof filters.lastDoc.data === 'function') {
+              constraints.push(startAfter(filters.lastDoc));
+            } else if (Array.isArray(filters.lastDoc)) {
+              constraints.push(startAfter(...filters.lastDoc));
+            } else {
+              constraints.push(startAfter(filters.lastDoc));
+            }
+          }
+          constraints.push(limit(filters.pagination || 10));
+
+          const q = query(collection(this.db, PROCEDURES_COLLECTION), ...constraints);
+          const querySnapshot = await getDocs(q);
+          const procedures = querySnapshot.docs.map(
+            doc => ({ ...doc.data(), id: doc.id } as Procedure),
+          );
+          const lastDoc =
+            querySnapshot.docs.length > 0
+              ? querySnapshot.docs[querySnapshot.docs.length - 1]
+              : null;
+
+          console.log(`[PROCEDURE_SERVICE] Strategy 2 success: ${procedures.length} procedures`);
+
+          // Fix Load More - ako je broj rezultata manji od pagination, nema više
+          if (procedures.length < (filters.pagination || 10)) {
+            return { procedures, lastDoc: null };
+          }
+          return { procedures, lastDoc };
+        } catch (error) {
+          console.log('[PROCEDURE_SERVICE] Strategy 2 failed:', error);
+        }
+      }
+
+      // Strategy 3: orderBy createdAt with client-side filtering
+      try {
+        console.log(
+          '[PROCEDURE_SERVICE] Strategy 3: Using createdAt orderBy with client-side filtering',
+        );
+        const constraints = getBaseConstraints();
+        constraints.push(orderBy('createdAt', 'desc'));
+
+        if (filters.lastDoc) {
+          if (typeof filters.lastDoc.data === 'function') {
+            constraints.push(startAfter(filters.lastDoc));
+          } else if (Array.isArray(filters.lastDoc)) {
+            constraints.push(startAfter(...filters.lastDoc));
+          } else {
+            constraints.push(startAfter(filters.lastDoc));
+          }
+        }
+        constraints.push(limit(filters.pagination || 10));
+
+        const q = query(collection(this.db, PROCEDURES_COLLECTION), ...constraints);
+        const querySnapshot = await getDocs(q);
+        let procedures = querySnapshot.docs.map(
+          doc => ({ ...doc.data(), id: doc.id } as Procedure),
+        );
+
+        // Apply all client-side filters using centralized function
+        procedures = this.applyInMemoryFilters(procedures, filters);
+
+        const lastDoc =
+          querySnapshot.docs.length > 0 ? querySnapshot.docs[querySnapshot.docs.length - 1] : null;
+        console.log(`[PROCEDURE_SERVICE] Strategy 3 success: ${procedures.length} procedures`);
+
+        // Fix Load More - ako je broj rezultata manji od pagination, nema više
+        if (procedures.length < (filters.pagination || 10)) {
+          return { procedures, lastDoc: null };
+        }
+        return { procedures, lastDoc };
+      } catch (error) {
+        console.log('[PROCEDURE_SERVICE] Strategy 3 failed:', error);
+      }
+
+      // Strategy 4: Minimal query fallback
+      try {
+        console.log('[PROCEDURE_SERVICE] Strategy 4: Minimal query fallback');
+        const constraints: QueryConstraint[] = [
+          where('isActive', '==', filters.isActive !== undefined ? filters.isActive : true),
+          orderBy('createdAt', 'desc'),
+        ];
+        if (filters.practitionerId) {
+          constraints.push(where('practitionerId', '==', filters.practitionerId));
+        }
+        if (filters.clinicId) {
+          constraints.push(where('clinicBranchId', '==', filters.clinicId));
+        }
+        constraints.push(limit(filters.pagination || 10));
+
+        const q = query(collection(this.db, PROCEDURES_COLLECTION), ...constraints);
+        const querySnapshot = await getDocs(q);
+        let procedures = querySnapshot.docs.map(
+          doc => ({ ...doc.data(), id: doc.id } as Procedure),
+        );
+
+        // Apply all client-side filters using centralized function
+        procedures = this.applyInMemoryFilters(procedures, filters);
+
+        const lastDoc =
+          querySnapshot.docs.length > 0 ? querySnapshot.docs[querySnapshot.docs.length - 1] : null;
+        console.log(`[PROCEDURE_SERVICE] Strategy 4 success: ${procedures.length} procedures`);
+
+        // Fix Load More - ako je broj rezultata manji od pagination, nema više
+        if (procedures.length < (filters.pagination || 10)) {
+          return { procedures, lastDoc: null };
+        }
+        return { procedures, lastDoc };
+      } catch (error) {
+        console.log('[PROCEDURE_SERVICE] Strategy 4 failed:', error);
+      }
+
+      // All strategies failed
+      console.log('[PROCEDURE_SERVICE] All strategies failed, returning empty result');
+      return { procedures: [], lastDoc: null };
+    } catch (error) {
+      console.error('[PROCEDURE_SERVICE] Error filtering procedures:', error);
+      return { procedures: [], lastDoc: null };
+    }
+  }
+
+  /**
+   * Applies in-memory filters to procedures array
+   * Used when Firestore queries fail or for complex filtering
+   */
+  private applyInMemoryFilters(
+    procedures: Procedure[],
+    filters: any,
+  ): (Procedure & { distance?: number })[] {
+    let filteredProcedures = [...procedures]; // Create copy to avoid mutating original
+
+    // Name search filter
+    if (filters.nameSearch && filters.nameSearch.trim()) {
+      const searchTerm = filters.nameSearch.trim().toLowerCase();
+      filteredProcedures = filteredProcedures.filter(procedure => {
+        const name = (procedure.name || '').toLowerCase();
+        const nameLower = procedure.nameLower || '';
+        return name.includes(searchTerm) || nameLower.includes(searchTerm);
+      });
+      console.log(`[PROCEDURE_SERVICE] Applied name filter, results: ${filteredProcedures.length}`);
+    }
+
+    // Price filtering
+    if (filters.minPrice !== undefined || filters.maxPrice !== undefined) {
+      filteredProcedures = filteredProcedures.filter(procedure => {
+        const price = procedure.price || 0;
+        if (filters.minPrice !== undefined && price < filters.minPrice) return false;
+        if (filters.maxPrice !== undefined && price > filters.maxPrice) return false;
+        return true;
+      });
+      console.log(
+        `[PROCEDURE_SERVICE] Applied price filter (${filters.minPrice}-${filters.maxPrice}), results: ${filteredProcedures.length}`,
+      );
+    }
+
+    // Rating filtering
+    if (filters.minRating !== undefined || filters.maxRating !== undefined) {
+      filteredProcedures = filteredProcedures.filter(procedure => {
+        const rating = procedure.reviewInfo?.averageRating || 0;
+        if (filters.minRating !== undefined && rating < filters.minRating) return false;
+        if (filters.maxRating !== undefined && rating > filters.maxRating) return false;
+        return true;
+      });
+      console.log(
+        `[PROCEDURE_SERVICE] Applied rating filter, results: ${filteredProcedures.length}`,
+      );
+    }
+
+    // Treatment benefits filtering
+    if (filters.treatmentBenefits && filters.treatmentBenefits.length > 0) {
+      const benefitIdsToMatch = filters.treatmentBenefits;
+      filteredProcedures = filteredProcedures.filter(procedure => {
+        const procedureBenefitIds = procedure.treatmentBenefitIds || [];
+        return benefitIdsToMatch.some((benefitId: string) =>
+          procedureBenefitIds.includes(benefitId),
+        );
+      });
+      console.log(
+        `[PROCEDURE_SERVICE] Applied benefits filter, results: ${filteredProcedures.length}`,
+      );
+    }
+
+    // Procedure family filtering
+    if (filters.procedureFamily) {
+      filteredProcedures = filteredProcedures.filter(
+        procedure => procedure.family === filters.procedureFamily,
+      );
+      console.log(
+        `[PROCEDURE_SERVICE] Applied family filter, results: ${filteredProcedures.length}`,
+      );
+    }
+
+    // Category filtering
+    if (filters.procedureCategory) {
+      filteredProcedures = filteredProcedures.filter(
+        procedure => procedure.category?.id === filters.procedureCategory,
+      );
+      console.log(
+        `[PROCEDURE_SERVICE] Applied category filter, results: ${filteredProcedures.length}`,
+      );
+    }
+
+    // Subcategory filtering
+    if (filters.procedureSubcategory) {
+      filteredProcedures = filteredProcedures.filter(
+        procedure => procedure.subcategory?.id === filters.procedureSubcategory,
+      );
+      console.log(
+        `[PROCEDURE_SERVICE] Applied subcategory filter, results: ${filteredProcedures.length}`,
+      );
+    }
+
+    // Technology filtering
+    if (filters.procedureTechnology) {
+      filteredProcedures = filteredProcedures.filter(
+        procedure => procedure.technology?.id === filters.procedureTechnology,
+      );
+      console.log(
+        `[PROCEDURE_SERVICE] Applied technology filter, results: ${filteredProcedures.length}`,
+      );
+    }
+
+    // Practitioner filtering
+    if (filters.practitionerId) {
+      filteredProcedures = filteredProcedures.filter(
+        procedure => procedure.practitionerId === filters.practitionerId,
+      );
+      console.log(
+        `[PROCEDURE_SERVICE] Applied practitioner filter, results: ${filteredProcedures.length}`,
+      );
+    }
+
+    // Clinic filtering
+    if (filters.clinicId) {
+      filteredProcedures = filteredProcedures.filter(
+        procedure => procedure.clinicBranchId === filters.clinicId,
+      );
+      console.log(
+        `[PROCEDURE_SERVICE] Applied clinic filter, results: ${filteredProcedures.length}`,
+      );
+    }
+
+    // Geo-radius filter
+    if (filters.location && filters.radiusInKm && filters.radiusInKm > 0) {
+      const location = filters.location;
+      const radiusInKm = filters.radiusInKm;
+      filteredProcedures = filteredProcedures.filter(procedure => {
+        const clinicLocation = procedure.clinicInfo?.location;
+        if (!clinicLocation?.latitude || !clinicLocation?.longitude) {
+          return false;
+        }
+
+        const distance =
+          distanceBetween(
+            [location.latitude, location.longitude],
+            [clinicLocation.latitude, clinicLocation.longitude],
+          ) / 1000; // Convert to km
+
+        // Attach distance for frontend sorting/display
+        (procedure as any).distance = distance;
+
+        return distance <= radiusInKm;
+      });
+      console.log(`[PROCEDURE_SERVICE] Applied geo filter, results: ${filteredProcedures.length}`);
+
+      // Sort by distance when geo filtering is applied
+      filteredProcedures.sort((a, b) => ((a as any).distance || 0) - ((b as any).distance || 0));
+    }
+
+    return filteredProcedures as (Procedure & { distance?: number })[];
+  }
+
+  private handleGeoQuery(filters: any): Promise<{
+    procedures: (Procedure & { distance?: number })[];
+    lastDoc: any;
+  }> {
+    console.log('[PROCEDURE_SERVICE] Executing geo query with geohash bounds');
+    try {
+      const location = filters.location;
+      const radiusInKm = filters.radiusInKm;
+
+      if (!location || !radiusInKm) {
+        return Promise.resolve({ procedures: [], lastDoc: null });
+      }
+
+      const bounds = geohashQueryBounds([location.latitude, location.longitude], radiusInKm * 1000);
+
+      const fetches = bounds.map(b => {
+        const constraints: QueryConstraint[] = [
+          where('clinicInfo.location.geohash', '>=', b[0]),
+          where('clinicInfo.location.geohash', '<=', b[1]),
+          where('isActive', '==', filters.isActive !== undefined ? filters.isActive : true),
+        ];
+        if (filters.practitionerId) {
+          constraints.push(where('practitionerId', '==', filters.practitionerId));
+        }
+        if (filters.clinicId) {
+          constraints.push(where('clinicBranchId', '==', filters.clinicId));
+        }
+        return getDocs(query(collection(this.db, PROCEDURES_COLLECTION), ...constraints));
+      });
+
+      return Promise.all(fetches)
+        .then(snaps => {
+          const collected: Procedure[] = [];
+          snaps.forEach(snap => {
+            snap.docs.forEach(d => collected.push({ ...(d.data() as Procedure), id: d.id }));
+          });
+
+          // Deduplicate by id
+          const uniqueMap = new Map<string, Procedure>();
+          for (const p of collected) {
+            uniqueMap.set(p.id, p);
+          }
+          let procedures = Array.from(uniqueMap.values());
+
+          // Apply remaining filters including precise distance and sorting
+          procedures = this.applyInMemoryFilters(procedures, filters);
+
+          // Manual pagination
+          const pageSize = filters.pagination || 10;
+          let startIndex = 0;
+          if (
+            filters.lastDoc &&
+            typeof filters.lastDoc === 'object' &&
+            (filters.lastDoc as any).id
+          ) {
+            const idx = procedures.findIndex(p => p.id === (filters.lastDoc as any).id);
+            if (idx >= 0) startIndex = idx + 1;
+          }
+          const page = procedures.slice(startIndex, startIndex + pageSize);
+          const newLastDoc = page.length === pageSize ? page[page.length - 1] : null;
+
+          console.log(
+            `[PROCEDURE_SERVICE] Geo query success: ${page.length} (of ${procedures.length}) within ${radiusInKm}km`,
+          );
+          return { procedures: page, lastDoc: newLastDoc };
+        })
+        .catch(err => {
+          console.error('[PROCEDURE_SERVICE] Geo bounds fetch failed:', err);
+          return { procedures: [], lastDoc: null };
+        });
+    } catch (error) {
+      console.error('[PROCEDURE_SERVICE] Geo query failed:', error);
+      return Promise.resolve({ procedures: [], lastDoc: null });
+    }
+  }
+
+  /**
+   * Creates a consultation procedure without requiring a product
+   * This is a special method for consultation procedures that don't use products
+   * @param data - The data for creating a consultation procedure (without productId)
+   * @returns The created procedure
+   */
+  async createConsultationProcedure(
+    data: Omit<CreateProcedureData, 'productId'>,
+  ): Promise<Procedure> {
+    // Generate procedure ID first so we can use it for media uploads
+    const procedureId = this.generateId();
+
+    // Get references to related entities (Category, Subcategory, Technology)
+    // For consultation, we don't need a product
+    const [category, subcategory, technology] = await Promise.all([
+      this.categoryService.getById(data.categoryId),
+      this.subcategoryService.getById(data.categoryId, data.subcategoryId),
+      this.technologyService.getById(data.technologyId),
+    ]);
+
+    if (!category || !subcategory || !technology) {
+      throw new Error('One or more required base entities not found');
+    }
+
+    // Get clinic and practitioner information for aggregation
+    const clinicRef = doc(this.db, CLINICS_COLLECTION, data.clinicBranchId);
+    const clinicSnapshot = await getDoc(clinicRef);
+    if (!clinicSnapshot.exists()) {
+      throw new Error(`Clinic with ID ${data.clinicBranchId} not found`);
+    }
+    const clinic = clinicSnapshot.data() as Clinic;
+
+    const practitionerRef = doc(this.db, PRACTITIONERS_COLLECTION, data.practitionerId);
+    const practitionerSnapshot = await getDoc(practitionerRef);
+    if (!practitionerSnapshot.exists()) {
+      throw new Error(`Practitioner with ID ${data.practitionerId} not found`);
+    }
+    const practitioner = practitionerSnapshot.data() as Practitioner;
+
+    // Process photos if provided
+    let processedPhotos: string[] = [];
+    if (data.photos && data.photos.length > 0) {
+      processedPhotos = await this.processMediaArray(data.photos, procedureId, 'procedure-photos');
+    }
+
+    // Transform productsMetadata from validation format to ProcedureProduct format
+    // For consultations, this will return empty array since no products are provided
+    const transformedProductsMetadata = await this.transformProductsMetadata(
+      data.productsMetadata,
+      data.technologyId,
+    );
+
+    // Create aggregated clinic info for the procedure document
+    const clinicInfo = {
+      id: clinicSnapshot.id,
+      name: clinic.name,
+      description: clinic.description || '',
+      featuredPhoto:
+        clinic.featuredPhotos && clinic.featuredPhotos.length > 0
+          ? typeof clinic.featuredPhotos[0] === 'string'
+            ? clinic.featuredPhotos[0]
+            : ''
+          : typeof clinic.coverPhoto === 'string'
+          ? clinic.coverPhoto
+          : '',
+      location: clinic.location,
+      contactInfo: clinic.contactInfo,
+    };
+
+    // Create aggregated doctor info for the procedure document
+    const doctorInfo = {
+      id: practitionerSnapshot.id,
+      name: `${practitioner.basicInfo.firstName} ${practitioner.basicInfo.lastName}`,
+      description: practitioner.basicInfo.bio || '',
+      photo:
+        typeof practitioner.basicInfo.profileImageUrl === 'string'
+          ? practitioner.basicInfo.profileImageUrl
+          : '',
+      rating: practitioner.reviewInfo?.averageRating || 0,
+      services: practitioner.procedures || [],
+    };
+
+    // Create the procedure object
+    const { productsMetadata: _, ...dataWithoutProductsMetadata } = data;
+    const newProcedure: Omit<Procedure, 'createdAt' | 'updatedAt'> = {
+      id: procedureId,
+      ...dataWithoutProductsMetadata,
+      nameLower: (data as any).nameLower || data.name.toLowerCase(),
+      photos: processedPhotos,
+      category,
+      subcategory,
+      technology,
+      // No product field for consultations (Firestore doesn't allow undefined, so we omit it entirely)
+      productsMetadata: transformedProductsMetadata, // Empty array for consultations
+      blockingConditions: technology.blockingConditions,
+      contraindications: technology.contraindications || [],
+      contraindicationIds: technology.contraindications?.map(c => c.id) || [],
+      treatmentBenefits: technology.benefits,
+      treatmentBenefitIds: Array.isArray(technology.benefits) 
+        ? technology.benefits.map(b => typeof b === 'string' ? b : b.id)
+        : [],
+      preRequirements: technology.requirements.pre,
+      postRequirements: technology.requirements.post,
+      certificationRequirement: technology.certificationRequirement,
+      documentationTemplates: technology?.documentationTemplates || [],
+      clinicInfo,
+      doctorInfo,
+      reviewInfo: {
+        totalReviews: 0,
+        averageRating: 0,
+        effectivenessOfTreatment: 0,
+        outcomeExplanation: 0,
+        painManagement: 0,
+        followUpCare: 0,
+        valueForMoney: 0,
+        recommendationPercentage: 0,
+      },
+      isActive: true,
+    };
+
+    // Create the procedure document
+    const procedureRef = doc(this.db, PROCEDURES_COLLECTION, procedureId);
+    await setDoc(procedureRef, {
+      ...newProcedure,
+      createdAt: serverTimestamp(),
+      updatedAt: serverTimestamp(),
+    });
+
+    // Return the created procedure (fetch again to get server timestamps)
+    const savedDoc = await getDoc(procedureRef);
+    return savedDoc.data() as Procedure;
+  }
+
+  /**
+   * Gets all procedures with minimal info for map display (id, name, clinicId, clinicName, address, latitude, longitude)
+   * This is optimized for mobile map usage to reduce payload size.
+   * @returns Array of minimal procedure info for map
+   */
+  async getProceduresForMap(): Promise<
+    {
+      id: string;
+      name: string;
+      clinicId: string | undefined;
+      clinicName: string | undefined;
+      address: string;
+      latitude: number | undefined;
+      longitude: number | undefined;
+    }[]
+  > {
+    const proceduresRef = collection(this.db, PROCEDURES_COLLECTION);
+    const snapshot = await getDocs(proceduresRef);
+    const proceduresForMap = snapshot.docs.map(doc => {
+      const data = doc.data();
+      return {
+        id: doc.id,
+        name: data.name,
+        clinicId: data.clinicInfo?.id,
+        clinicName: data.clinicInfo?.name,
+        address: data.clinicInfo?.location?.address || '',
+        latitude: data.clinicInfo?.location?.latitude,
+        longitude: data.clinicInfo?.location?.longitude,
+      };
+    });
+    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));
+  }
+}