@blackcode_sa/metaestetics-api 1.5.28 → 1.5.30

package/src/services/clinic/README.md

@@ -0,0 +1,87 @@
+# Clinic Service
+
+This service manages clinic data within the Firestore database. It provides methods for creating, reading, updating, and managing clinics, their branches, and associated data like tags and administrators.
+
+**Note:** This service relies on helper functions defined in the `./utils` directory for specific operations like photo uploads, geo-queries, and data fetching. Cloud Functions handle data aggregation into related entities (Practitioners, Procedures, ClinicGroups).
+
+## `ClinicService` Class
+
+Extends `BaseService`.
+
+### Constructor
+
+```typescript
+constructor(
+  db: Firestore,
+  auth: Auth,
+  app: FirebaseApp,
+  clinicGroupService: ClinicGroupService,
+  clinicAdminService: ClinicAdminService
+)
+```
+
+Initializes the service with Firestore, Auth, App instances, and required dependency services (`ClinicGroupService`, `ClinicAdminService`).
+
+### Core Methods
+
+- **`createClinic(data: CreateClinicData, creatorAdminId: string): Promise<Clinic>`**
+  - Creates a new clinic document in Firestore.
+  - Validates input data using `createClinicSchema`.
+  - Verifies the `creatorAdminId` and their association with the specified `clinicGroupId`.
+  - Calculates the geohash for the clinic's location.
+  - Initializes default review information.
+  - Handles photo uploads for logo, cover photo, featured photos, and photos with tags using utility functions.
+  - Updates the creator admin's `clinicsManaged` list.
+  - **Aggregation Note:** Adding the clinic to the `ClinicGroup` is handled by Cloud Functions.
+- **`updateClinic(clinicId: string, data: Partial<Omit<Clinic, \"id\" | \"createdAt\" | \"clinicGroupId\">>, adminId: string): Promise<Clinic>`**
+  - Updates an existing clinic document.
+  - Fetches the current clinic data.
+  - Validates the partial update data against the `clinicSchema` after merging with existing data.
+  - Updates the geohash if the location is changed.
+  - Handles photo updates/uploads if necessary.
+  - **Aggregation Note:** Aggregation updates in related entities (Practitioners, Procedures, ClinicGroup) are handled by Cloud Functions.
+- **`deactivateClinic(clinicId: string, adminId: string): Promise<void>`**
+  - Sets the `isActive` flag of a clinic to `false`.
+  - Requires admin permission (verification logic might be in the calling function or assumed).
+  - **Aggregation Note:** Aggregation updates (e.g., removing from active lists, updating related entities) are handled by Cloud Functions.
+- **`getClinic(clinicId: string): Promise<Clinic | null>`**
+  - Retrieves a single clinic document by its ID using `ClinicUtils.getClinic`.
+- **`getClinicsByGroup(groupId: string): Promise<Clinic[]>`**
+  - Retrieves all clinic documents belonging to a specific `clinicGroupId` using `ClinicUtils.getClinicsByGroup`.
+- **`findClinicsInRadius(center: { latitude: number; longitude: number }, radiusInKm: number, filters?: { procedures?: string[]; tags?: ClinicTag[] }): Promise<Clinic[]>`**
+  - Finds active clinics within a specified radius using geohash queries.
+  - Leverages `SearchUtils.findClinicsInRadius`.
+  - Optionally filters results by procedure IDs (services) and tags.
+- **`addTags(clinicId: string, adminId: string, newTags: { tags?: ClinicTag[] }): Promise<Clinic>`**
+  - Adds specified tags to a clinic's `tags` array using `TagUtils.addTags`.
+  - Ensures the admin has permission. Prevents duplicates.
+- **`removeTags(clinicId: string, adminId: string, tagsToRemove: { tags?: ClinicTag[] }): Promise<Clinic>`**
+  - Removes specified tags from a clinic's `tags` array using `TagUtils.removeTags`.
+  - Ensures the admin has permission.
+- **`getClinicsByAdmin(adminId: string, options?: { isActive?: boolean; includeGroupClinics?: boolean }): Promise<Clinic[]>`**
+  - Retrieves clinics associated with a specific admin using `ClinicUtils.getClinicsByAdmin`.
+  - Handles options for filtering by `isActive` and including all group clinics for owners.
+- **`getActiveClinicsByAdmin(adminId: string): Promise<Clinic[]>`**
+  - Retrieves only the active clinics associated with a specific admin using `ClinicUtils.getActiveClinicsByAdmin`.
+- **`createClinicBranch(clinicGroupId: string, setupData: ClinicBranchSetupData, adminId: string): Promise<Clinic>`**
+  - Creates a new clinic (branch) within an existing `clinicGroupId`.
+  - Validates group existence. Uses `createClinic` internally.
+- **`getClinicById(clinicId: string): Promise<Clinic | null>`**
+  - Retrieves a single clinic document by its ID using `ClinicUtils.getClinicById`.
+- **`getAllClinics(pagination?: number, lastDoc?: any): Promise<{ clinics: Clinic[]; lastDoc: any }>`**
+  - Retrieves all clinics, ordered by ID, optionally with pagination, using `ClinicUtils.getAllClinics`.
+- **`getAllClinicsInRange(center: { latitude: number; longitude: number }, rangeInKm: number, pagination?: number, lastDoc?: any): Promise<{ clinics: (Clinic & { distance: number })[]; lastDoc: any }>`**
+  - Retrieves all clinics within a range, sorted by distance, optionally with pagination, using `ClinicUtils.getAllClinicsInRange`.
+- **`getClinicsByFilters(filters: { ... }): Promise<{ clinics: (Clinic & { distance?: number })[]; lastDoc: any }>`**
+  - Retrieves clinics based on complex filters (location, tags, procedures, rating, etc.).
+  - Uses `FilterUtils.getClinicsByFilters` for combined query and in-memory filtering.
+
+### Utility Functions (`./utils`)
+
+- **`clinic.utils.ts`**: Core fetching (`getClinic`, `getClinicsByGroup`, etc.), create/update/deactivate logic wrappers, admin checks.
+- **`filter.utils.ts`**: Complex filtering logic (`getClinicsByFilters`), including geo-queries.
+- **`clinic-group.utils.ts`**: Helpers for clinic group interactions (used by `ClinicGroupService`).
+- **`tag.utils.ts`**: Logic for adding/removing tags (`addTags`, `removeTags`).
+- **`photos.utils.ts`**: Firebase Storage interactions (`uploadPhoto`, `uploadMultiplePhotos`, `deletePhoto`).
+- **`admin.utils.ts`**: Helpers for clinic admin interactions (used by `ClinicAdminService`).
+- **`search.utils.ts`**: Geo-radius search logic (`findClinicsInRadius`).

package/src/services/clinic/clinic.service.ts

@@ -13,19 +13,26 @@ import {
   GeoPoint,
   QueryConstraint,
   FieldValue,
+  writeBatch,
+  arrayUnion,
+  arrayRemove,
 } from "firebase/firestore";
 import { BaseService } from "../base.service";
 import {
   Clinic,
   CreateClinicData,
   CLINICS_COLLECTION,
-  ClinicReview,
   ClinicTag,
   ClinicTags,
   ClinicGroup,
+  CLINIC_GROUPS_COLLECTION,
   ClinicBranchSetupData,
   CLINIC_ADMINS_COLLECTION,
+  DoctorInfo,
 } from "../../types/clinic";
+// Correct imports
+import { ProcedureSummaryInfo } from "../../types/procedure";
+import { ClinicInfo } from "../../types/profile";
 import { ClinicGroupService } from "./clinic-group.service";
 import { ClinicAdminService } from "./clinic-admin.service";
 import {
@@ -36,17 +43,18 @@ import {
 import {
   clinicSchema,
   createClinicSchema,
-  clinicReviewSchema,
 } from "../../validations/clinic.schema";
 import { z } from "zod";
 import { Auth } from "firebase/auth";
 import { Firestore } from "firebase/firestore";
 import { FirebaseApp } from "firebase/app";
 import * as ClinicUtils from "./utils/clinic.utils";
-import * as ReviewUtils from "./utils/review.utils";
 import * as TagUtils from "./utils/tag.utils";
 import * as SearchUtils from "./utils/search.utils";
 import * as AdminUtils from "./utils/admin.utils";
+import * as FilterUtils from "./utils/filter.utils";
+import { ClinicReviewInfo } from "../../types/reviews";
+import { PRACTITIONERS_COLLECTION } from "../../types/practitioner";
 
 export class ClinicService extends BaseService {
   private clinicGroupService: ClinicGroupService;
@@ -65,20 +73,172 @@ export class ClinicService extends BaseService {
   }
 
   /**
-   * Kreira novu kliniku
+   * Creates a new clinic.
    */
   async createClinic(
     data: CreateClinicData,
     creatorAdminId: string
   ): Promise<Clinic> {
-    return ClinicUtils.createClinic(
-      this.db,
-      data,
-      creatorAdminId,
-      this.clinicGroupService,
-      this.clinicAdminService,
-      this.app
-    );
+    try {
+      const validatedData = createClinicSchema.parse(data);
+      const group = await this.clinicGroupService.getClinicGroup(
+        validatedData.clinicGroupId
+      );
+      if (!group)
+        throw new Error(
+          `Clinic group ${validatedData.clinicGroupId} not found`
+        );
+      const location = validatedData.location;
+      const hash = geohashForLocation([location.latitude, location.longitude]);
+      const defaultReviewInfo: ClinicReviewInfo = {
+        totalReviews: 0,
+        averageRating: 0,
+        cleanliness: 0,
+        facilities: 0,
+        staffFriendliness: 0,
+        waitingTime: 0,
+        accessibility: 0,
+        recommendationPercentage: 0,
+      };
+      const clinicId = this.generateId();
+
+      const clinicData: Omit<Clinic, "createdAt" | "updatedAt"> & {
+        createdAt: FieldValue;
+        updatedAt: FieldValue;
+      } = {
+        id: clinicId,
+        clinicGroupId: validatedData.clinicGroupId,
+        name: validatedData.name,
+        description: validatedData.description,
+        location: { ...location, geohash: hash },
+        contactInfo: validatedData.contactInfo,
+        workingHours: validatedData.workingHours,
+        tags: validatedData.tags,
+        featuredPhotos: validatedData.featuredPhotos || [],
+        coverPhoto: validatedData.coverPhoto,
+        photosWithTags: validatedData.photosWithTags,
+        doctors: [],
+        procedures: [],
+        doctorsInfo: [],
+        proceduresInfo: [],
+        reviewInfo: defaultReviewInfo,
+        admins: [creatorAdminId],
+        isActive: validatedData.isActive,
+        isVerified: validatedData.isVerified,
+        logo: validatedData.logo,
+        createdAt: serverTimestamp(),
+        updatedAt: serverTimestamp(),
+      };
+
+      // Re-validate before saving (ensure schema matches the final object)
+      clinicSchema.parse({
+        ...clinicData,
+        createdAt: Timestamp.now(),
+        updatedAt: Timestamp.now(),
+      });
+
+      const batch = writeBatch(this.db);
+      const clinicRef = doc(this.db, CLINICS_COLLECTION, clinicId);
+      batch.set(clinicRef, clinicData);
+
+      // Update admin relationship - this part is still needed
+      const adminRef = doc(this.db, CLINIC_ADMINS_COLLECTION, creatorAdminId);
+      batch.update(adminRef, {
+        clinicsManaged: arrayUnion(clinicId),
+        updatedAt: serverTimestamp(),
+      });
+
+      await batch.commit();
+      const savedClinic = await this.getClinic(clinicId);
+      if (!savedClinic) throw new Error("Failed to retrieve created clinic");
+      return savedClinic;
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        throw new Error("Invalid clinic data: " + error.message);
+      }
+      console.error("Error creating clinic:", error);
+      throw error;
+    }
+  }
+
+  /**
+   * Updates a clinic.
+   */
+  async updateClinic(
+    clinicId: string,
+    data: Partial<Omit<Clinic, "id" | "createdAt" | "clinicGroupId">>,
+    adminId: string
+  ): Promise<Clinic> {
+    const clinicRef = doc(this.db, CLINICS_COLLECTION, clinicId);
+    const clinicDoc = await getDoc(clinicRef);
+    if (!clinicDoc.exists()) {
+      throw new Error(`Clinic ${clinicId} not found`);
+    }
+
+    try {
+      const currentClinic = clinicDoc.data() as Clinic;
+      // Explicitly Omit fields managed by other services or internally
+      const { doctorsInfo, proceduresInfo, ...updatePayload } =
+        data as Partial<Clinic>;
+
+      if (updatePayload.location) {
+        const loc = updatePayload.location;
+        updatePayload.location = {
+          ...loc,
+          geohash: geohashForLocation([loc.latitude, loc.longitude]),
+        };
+      }
+
+      // Merge with current data for validation and aggregation, preserving arrays managed elsewhere
+      const finalStateForValidation = {
+        ...currentClinic,
+        ...updatePayload, // Apply safe updates
+        // Explicitly keep arrays managed by other services from current state
+        doctorsInfo: currentClinic.doctorsInfo,
+        proceduresInfo: currentClinic.proceduresInfo,
+      };
+
+      // Ensure required fields for validation are present
+      clinicSchema.parse({
+        ...finalStateForValidation,
+        updatedAt: Timestamp.now(), // Use current time for validation
+      });
+
+      // Prepare final update data for Firestore, including timestamp
+      const updateDataForFirestore = {
+        ...updatePayload,
+        updatedAt: serverTimestamp(),
+      };
+
+      await updateDoc(clinicRef, updateDataForFirestore);
+
+      const updatedClinic = await this.getClinic(clinicId);
+      if (!updatedClinic) throw new Error("Failed to retrieve updated clinic");
+      return updatedClinic;
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        throw new Error(
+          "Invalid clinic update data: " +
+            error.errors
+              .map((e) => `${e.path.join(".")} - ${e.message}`)
+              .join(", ")
+        );
+      }
+      console.error(`Error updating clinic ${clinicId}:`, error);
+      throw error;
+    }
+  }
+
+  /**
+   * Deactivates a clinic.
+   */
+  async deactivateClinic(clinicId: string, adminId: string): Promise<void> {
+    // Permission check omitted
+    const clinicRef = doc(this.db, CLINICS_COLLECTION, clinicId);
+    await updateDoc(clinicRef, {
+      isActive: false,
+      updatedAt: serverTimestamp(),
+    });
   }
 
   /**
@@ -102,8 +262,9 @@ export class ClinicService extends BaseService {
     center: { latitude: number; longitude: number },
     radiusInKm: number,
     filters?: {
-      services?: string[];
+      procedures?: string[];
       tags?: ClinicTag[];
+      // Add other relevant filters based on Clinic/ProcedureSummaryInfo fields
     }
   ): Promise<Clinic[]> {
     return SearchUtils.findClinicsInRadius(
@@ -114,52 +275,6 @@ export class ClinicService extends BaseService {
     );
   }
 
-  /**
-   * Ažurira kliniku
-   */
-  async updateClinic(
-    clinicId: string,
-    data: Partial<Clinic>,
-    adminId: string
-  ): Promise<Clinic> {
-    return ClinicUtils.updateClinic(
-      this.db,
-      clinicId,
-      data,
-      adminId,
-      this.clinicAdminService,
-      this.app
-    );
-  }
-
-  /**
-   * Dodaje recenziju klinici
-   */
-  async addReview(
-    clinicId: string,
-    review: Omit<
-      ClinicReview,
-      "id" | "clinicId" | "createdAt" | "updatedAt" | "isVerified"
-    >
-  ): Promise<ClinicReview> {
-    return ReviewUtils.addReview(this.db, clinicId, review, this.app);
-  }
-
-  /**
-   * Deaktivira kliniku
-   */
-  async deactivateClinic(clinicId: string, adminId: string): Promise<void> {
-    return ClinicUtils.deactivateClinic(
-      this.db,
-      clinicId,
-      adminId,
-      this.clinicAdminService
-    );
-  }
-
-  /**
-   * Dodaje tagove klinici
-   */
   async addTags(
     clinicId: string,
     adminId: string,
@@ -177,9 +292,6 @@ export class ClinicService extends BaseService {
     );
   }
 
-  /**
-   * Uklanja tagove iz klinike
-   */
   async removeTags(
     clinicId: string,
     adminId: string,
@@ -197,9 +309,6 @@ export class ClinicService extends BaseService {
     );
   }
 
-  /**
-   * Dohvata sve klinike gde je korisnik admin
-   */
   async getClinicsByAdmin(
     adminId: string,
     options?: {
@@ -216,9 +325,6 @@ export class ClinicService extends BaseService {
     );
   }
 
-  /**
-   * Dohvata sve aktivne klinike gde je korisnik admin
-   */
   async getActiveClinicsByAdmin(adminId: string): Promise<Clinic[]> {
     return ClinicUtils.getActiveClinicsByAdmin(
       this.db,
@@ -228,14 +334,6 @@ export class ClinicService extends BaseService {
     );
   }
 
-  /**
-   * Creates a new clinic branch for a clinic group
-   *
-   * @param clinicGroupId - The ID of the clinic group
-   * @param setupData - The setup data for the clinic branch
-   * @param adminId - The ID of the admin creating the branch
-   * @returns The created clinic
-   */
   async createClinicBranch(
     clinicGroupId: string,
     setupData: ClinicBranchSetupData,
@@ -276,7 +374,7 @@ export class ClinicService extends BaseService {
       coverPhoto: setupData.coverPhoto || null,
       photosWithTags: setupData.photosWithTags || [],
       doctors: [],
-      services: [],
+      procedures: [],
       admins: [adminId],
       isActive: true,
       isVerified: false,
@@ -302,23 +400,10 @@ export class ClinicService extends BaseService {
     return clinic;
   }
 
-  /**
-   * Retrieves a clinic by its ID
-   *
-   * @param clinicId - ID of the clinic to retrieve
-   * @returns The clinic if found, null otherwise
-   */
   async getClinicById(clinicId: string): Promise<Clinic | null> {
     return ClinicUtils.getClinicById(this.db, clinicId);
   }
 
-  /**
-   * Retrieves all clinics with optional pagination
-   *
-   * @param pagination - Optional number of clinics per page (0 or undefined returns all)
-   * @param lastDoc - Optional last document for pagination (if continuing from a previous page)
-   * @returns Array of clinics and the last document for pagination
-   */
   async getAllClinics(
     pagination?: number,
     lastDoc?: any
@@ -326,33 +411,38 @@ export class ClinicService extends BaseService {
     return ClinicUtils.getAllClinics(this.db, pagination, lastDoc);
   }
 
-  /**
-   * Retrieves all clinics within a specified range from a location with optional pagination
-   *
-   * @param center - The center location coordinates {latitude, longitude}
-   * @param rangeInKm - The range in kilometers to search within
-   * @param pagination - Optional number of clinics per page (0 or undefined returns all)
-   * @param lastDoc - Optional last document for pagination (if continuing from a previous page)
-   * @param filters - Optional filters to apply to the search (isActive, tags, etc.)
-   * @returns Array of clinics with distance information and the last document for pagination
-   */
   async getAllClinicsInRange(
     center: { latitude: number; longitude: number },
     rangeInKm: number,
     pagination?: number,
-    lastDoc?: any,
-    filters?: {
-      isActive?: boolean;
-      tags?: ClinicTag[];
-    }
+    lastDoc?: any
   ): Promise<{ clinics: (Clinic & { distance: number })[]; lastDoc: any }> {
     return ClinicUtils.getAllClinicsInRange(
       this.db,
       center,
       rangeInKm,
       pagination,
-      lastDoc,
-      filters
+      lastDoc
     );
   }
+
+  async getClinicsByFilters(filters: {
+    center?: { latitude: number; longitude: number };
+    radiusInKm?: number;
+    tags?: ClinicTag[];
+    procedureFamily?: string;
+    procedureCategory?: string;
+    procedureSubcategory?: string;
+    procedureTechnology?: string;
+    minRating?: number;
+    maxRating?: number;
+    pagination?: number;
+    lastDoc?: any;
+    isActive?: boolean;
+  }): Promise<{
+    clinics: (Clinic & { distance?: number })[];
+    lastDoc: any;
+  }> {
+    return FilterUtils.getClinicsByFilters(this.db, filters);
+  }
 }