@blackcode_sa/metaestetics-api 1.4.18 → 1.5.1

package/src/services/practitioner/practitioner.service.ts

@@ -17,11 +17,20 @@ import {
   CreatePractitionerData,
   UpdatePractitionerData,
   PRACTITIONERS_COLLECTION,
+  REGISTER_TOKENS_COLLECTION,
+  PractitionerStatus,
+  CreateDraftPractitionerData,
+  PractitionerToken,
+  CreatePractitionerTokenData,
+  PractitionerTokenStatus,
 } from "../../types/practitioner";
 import { ClinicService } from "../clinic/clinic.service";
 import {
   practitionerSchema,
   createPractitionerSchema,
+  createDraftPractitionerSchema,
+  practitionerTokenSchema,
+  createPractitionerTokenSchema,
 } from "../../validations/practitioner.schema";
 import { z } from "zod";
 import { Auth } from "firebase/auth";
@@ -92,8 +101,10 @@ export class PractitionerService extends BaseService {
         basicInfo: validatedData.basicInfo,
         certification: validatedData.certification,
         clinics: validatedData.clinics || [],
+        clinicWorkingHours: validatedData.clinicWorkingHours || [],
         isActive: validatedData.isActive,
         isVerified: validatedData.isVerified,
+        status: validatedData.status || PractitionerStatus.ACTIVE,
         createdAt: serverTimestamp(),
         updatedAt: serverTimestamp(),
       };
@@ -125,6 +136,278 @@ export class PractitionerService extends BaseService {
     }
   }
 
+  /**
+   * Kreira novi draft profil zdravstvenog radnika bez povezanog korisnika
+   * Koristi se od strane administratora klinike za kreiranje profila i kasnije pozivanje
+   * @param data Podaci za kreiranje draft profila
+   * @param createdBy ID administratora koji kreira profil
+   * @param clinicId ID klinike za koju se kreira profil
+   * @returns Objekt koji sadrži kreirani draft profil i token za registraciju
+   */
+  async createDraftPractitioner(
+    data: CreateDraftPractitionerData,
+    createdBy: string,
+    clinicId: string
+  ): Promise<{ practitioner: Practitioner; token: PractitionerToken }> {
+    try {
+      // Validacija ulaznih podataka
+      const validatedData = createDraftPractitionerSchema.parse(data);
+
+      // Provera da li klinika postoji
+      const clinic = await this.getClinicService().getClinic(clinicId);
+      if (!clinic) {
+        throw new Error(`Clinic ${clinicId} not found`);
+      }
+
+      // Priprema podataka za kreiranje profila
+      const clinics = data.clinics || [clinicId];
+
+      // Provera da li sve dodatno navedene klinike postoje
+      if (data.clinics) {
+        for (const cId of data.clinics) {
+          if (cId !== clinicId) {
+            const otherClinic = await this.getClinicService().getClinic(cId);
+            if (!otherClinic) {
+              throw new Error(`Clinic ${cId} not found`);
+            }
+          }
+        }
+      }
+
+      const practitionerId = this.generateId();
+      const practitionerData: Omit<Practitioner, "createdAt" | "updatedAt"> & {
+        createdAt: ReturnType<typeof serverTimestamp>;
+        updatedAt: ReturnType<typeof serverTimestamp>;
+      } = {
+        id: practitionerId,
+        userRef: "", // Prazno - biće popunjeno kada korisnik kreira nalog
+        basicInfo: validatedData.basicInfo,
+        certification: validatedData.certification,
+        clinics: clinics,
+        clinicWorkingHours: validatedData.clinicWorkingHours || [],
+        isActive:
+          validatedData.isActive !== undefined ? validatedData.isActive : false,
+        isVerified:
+          validatedData.isVerified !== undefined
+            ? validatedData.isVerified
+            : false,
+        status: PractitionerStatus.DRAFT,
+        createdAt: serverTimestamp(),
+        updatedAt: serverTimestamp(),
+      };
+
+      // Validacija kompletnog objekta
+      // Koristimo privremeni userRef za validaciju, biće prazan u bazi
+      practitionerSchema.parse({
+        ...practitionerData,
+        userRef: "temp-for-validation",
+        createdAt: Timestamp.now(),
+        updatedAt: Timestamp.now(),
+      });
+
+      // Čuvamo u Firestore
+      await setDoc(
+        doc(this.db, PRACTITIONERS_COLLECTION, practitionerData.id),
+        practitionerData
+      );
+
+      const savedPractitioner = await this.getPractitioner(practitionerData.id);
+      if (!savedPractitioner) {
+        throw new Error("Failed to create draft practitioner profile");
+      }
+
+      // Automatski kreiramo token za registraciju
+      const tokenString = this.generateId().slice(0, 6).toUpperCase();
+
+      // Default expiration is 7 days from now
+      const expiration = new Date(Date.now() + 7 * 24 * 60 * 60 * 1000);
+
+      const token: PractitionerToken = {
+        id: this.generateId(),
+        token: tokenString,
+        practitionerId: practitionerId,
+        email: practitionerData.basicInfo.email,
+        clinicId: clinicId,
+        status: PractitionerTokenStatus.ACTIVE,
+        createdBy: createdBy,
+        createdAt: Timestamp.now(),
+        expiresAt: Timestamp.fromDate(expiration),
+      };
+
+      // Validate token object
+      practitionerTokenSchema.parse(token);
+
+      // Store the token in the practitioner document's register_tokens subcollection
+      const tokenPath = `${PRACTITIONERS_COLLECTION}/${practitionerId}/${REGISTER_TOKENS_COLLECTION}/${token.id}`;
+      await setDoc(doc(this.db, tokenPath), token);
+
+      // Ovde bi bilo slanje emaila sa tokenom, ali to ćemo implementirati kasnije
+      // TODO: Implement email sending with Cloud Functions
+
+      return { practitioner: savedPractitioner, token };
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        throw new Error("Invalid practitioner data: " + error.message);
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Creates a token for inviting practitioner to claim their profile
+   * @param data Data for creating token
+   * @param createdBy ID of the user creating the token
+   * @returns Created token
+   */
+  async createPractitionerToken(
+    data: CreatePractitionerTokenData,
+    createdBy: string
+  ): Promise<PractitionerToken> {
+    try {
+      // Validate data
+      const validatedData = createPractitionerTokenSchema.parse(data);
+
+      // Check if practitioner exists and is in DRAFT status
+      const practitioner = await this.getPractitioner(
+        validatedData.practitionerId
+      );
+      if (!practitioner) {
+        throw new Error("Practitioner not found");
+      }
+
+      if (practitioner.status !== PractitionerStatus.DRAFT) {
+        throw new Error(
+          "Can only create tokens for practitioners in DRAFT status"
+        );
+      }
+
+      // Check if clinic exists and practitioner belongs to it
+      const clinic = await this.getClinicService().getClinic(
+        validatedData.clinicId
+      );
+      if (!clinic) {
+        throw new Error(`Clinic ${validatedData.clinicId} not found`);
+      }
+
+      if (!practitioner.clinics.includes(validatedData.clinicId)) {
+        throw new Error("Practitioner is not associated with this clinic");
+      }
+
+      // Default expiration is 7 days from now if not specified
+      const expiration =
+        validatedData.expiresAt ||
+        new Date(Date.now() + 7 * 24 * 60 * 60 * 1000);
+
+      // Generate a token (6 characters) using generateId from BaseService
+      const tokenString = this.generateId().slice(0, 6).toUpperCase();
+
+      const token: PractitionerToken = {
+        id: this.generateId(),
+        token: tokenString,
+        practitionerId: validatedData.practitionerId,
+        email: validatedData.email,
+        clinicId: validatedData.clinicId,
+        status: PractitionerTokenStatus.ACTIVE,
+        createdBy: createdBy,
+        createdAt: Timestamp.now(),
+        expiresAt: Timestamp.fromDate(expiration),
+      };
+
+      // Validate token object
+      practitionerTokenSchema.parse(token);
+
+      // Store the token in the practitioner document's register_tokens subcollection
+      const tokenPath = `${PRACTITIONERS_COLLECTION}/${validatedData.practitionerId}/${REGISTER_TOKENS_COLLECTION}/${token.id}`;
+      await setDoc(doc(this.db, tokenPath), token);
+
+      return token;
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        throw new Error("Invalid token data: " + error.message);
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Gets active tokens for a practitioner
+   * @param practitionerId ID of the practitioner
+   * @returns Array of active tokens
+   */
+  async getPractitionerActiveTokens(
+    practitionerId: string
+  ): Promise<PractitionerToken[]> {
+    const tokensRef = collection(
+      this.db,
+      `${PRACTITIONERS_COLLECTION}/${practitionerId}/${REGISTER_TOKENS_COLLECTION}`
+    );
+
+    const q = query(
+      tokensRef,
+      where("status", "==", PractitionerTokenStatus.ACTIVE),
+      where("expiresAt", ">", Timestamp.now())
+    );
+
+    const querySnapshot = await getDocs(q);
+    return querySnapshot.docs.map((doc) => doc.data() as PractitionerToken);
+  }
+
+  /**
+   * Gets a token by its string value and validates it
+   * @param tokenString The token string to find
+   * @returns The token if found and valid, null otherwise
+   */
+  async validateToken(tokenString: string): Promise<PractitionerToken | null> {
+    // We need to search through all practitioners' register_tokens subcollections
+    const practitionersRef = collection(this.db, PRACTITIONERS_COLLECTION);
+    const practitionersSnapshot = await getDocs(practitionersRef);
+
+    for (const practitionerDoc of practitionersSnapshot.docs) {
+      const practitionerId = practitionerDoc.id;
+      const tokensRef = collection(
+        this.db,
+        `${PRACTITIONERS_COLLECTION}/${practitionerId}/${REGISTER_TOKENS_COLLECTION}`
+      );
+
+      const q = query(
+        tokensRef,
+        where("token", "==", tokenString),
+        where("status", "==", PractitionerTokenStatus.ACTIVE),
+        where("expiresAt", ">", Timestamp.now())
+      );
+
+      const tokenSnapshot = await getDocs(q);
+      if (!tokenSnapshot.empty) {
+        return tokenSnapshot.docs[0].data() as PractitionerToken;
+      }
+    }
+
+    return null;
+  }
+
+  /**
+   * Marks a token as used
+   * @param tokenId ID of the token
+   * @param practitionerId ID of the practitioner
+   * @param userId ID of the user using the token
+   */
+  async markTokenAsUsed(
+    tokenId: string,
+    practitionerId: string,
+    userId: string
+  ): Promise<void> {
+    const tokenRef = doc(
+      this.db,
+      `${PRACTITIONERS_COLLECTION}/${practitionerId}/${REGISTER_TOKENS_COLLECTION}/${tokenId}`
+    );
+
+    await updateDoc(tokenRef, {
+      status: PractitionerTokenStatus.USED,
+      usedBy: userId,
+      usedAt: Timestamp.now(),
+    });
+  }
+
   /**
    * Dohvata zdravstvenog radnika po ID-u
    */
@@ -166,7 +449,24 @@ export class PractitionerService extends BaseService {
     const q = query(
       collection(this.db, PRACTITIONERS_COLLECTION),
       where("clinics", "array-contains", clinicId),
-      where("isActive", "==", true)
+      where("isActive", "==", true),
+      where("status", "==", PractitionerStatus.ACTIVE)
+    );
+
+    const querySnapshot = await getDocs(q);
+    return querySnapshot.docs.map((doc) => doc.data() as Practitioner);
+  }
+
+  /**
+   * Dohvata sve draft zdravstvene radnike za određenu kliniku
+   */
+  async getDraftPractitionersByClinic(
+    clinicId: string
+  ): Promise<Practitioner[]> {
+    const q = query(
+      collection(this.db, PRACTITIONERS_COLLECTION),
+      where("clinics", "array-contains", clinicId),
+      where("status", "==", PractitionerStatus.DRAFT)
     );
 
     const querySnapshot = await getDocs(q);
@@ -302,4 +602,49 @@ export class PractitionerService extends BaseService {
 
     await deleteDoc(doc(this.db, PRACTITIONERS_COLLECTION, practitionerId));
   }
+
+  /**
+   * Validates a registration token and claims the associated draft practitioner profile
+   * @param tokenString The token provided by the practitioner
+   * @param userId The ID of the user claiming the profile
+   * @returns The claimed practitioner profile or null if token is invalid
+   */
+  async validateTokenAndClaimProfile(
+    tokenString: string,
+    userId: string
+  ): Promise<Practitioner | null> {
+    // Find the token
+    const token = await this.validateToken(tokenString);
+    if (!token) {
+      return null; // Token not found or not valid
+    }
+
+    // Get the practitioner profile
+    const practitioner = await this.getPractitioner(token.practitionerId);
+    if (!practitioner) {
+      return null; // Practitioner not found
+    }
+
+    // Ensure practitioner is in DRAFT status
+    if (practitioner.status !== PractitionerStatus.DRAFT) {
+      throw new Error("This practitioner profile has already been claimed");
+    }
+
+    // Check if user already has a practitioner profile
+    const existingPractitioner = await this.getPractitionerByUserRef(userId);
+    if (existingPractitioner) {
+      throw new Error("User already has a practitioner profile");
+    }
+
+    // Claim the profile by linking it to the user
+    const updatedPractitioner = await this.updatePractitioner(practitioner.id, {
+      userRef: userId,
+      status: PractitionerStatus.ACTIVE,
+    });
+
+    // Mark the token as used
+    await this.markTokenAsUsed(token.id, token.practitionerId, userId);
+
+    return updatedPractitioner;
+  }
 }

package/src/types/calendar/index.ts

@@ -0,0 +1,187 @@
+import { Timestamp, FieldValue } from "firebase/firestore";
+import type { ClinicLocation } from "../clinic";
+import type {
+  Category,
+  ProcedureFamily,
+  Product,
+  Subcategory,
+  Technology,
+} from "../../backoffice";
+import type { SyncedCalendarProvider } from "./synced-calendar.types";
+import type { Gender } from "../patient";
+import type { PractitionerCertification } from "../practitioner";
+import type { Currency } from "../../backoffice/types/static/pricing.types";
+import type {
+  ClinicInfo,
+  PractitionerProfileInfo,
+  PatientProfileInfo,
+} from "../profile";
+
+/**
+ * Enum for calendar event status
+ */
+export enum CalendarEventStatus {
+  PENDING = "pending", // When event is created, but not confirmed
+  CONFIRMED = "confirmed", // When event is confirmed and ready to be used
+  REJECTED = "rejected", // When event is rejected by the clinic administrator or patient
+  CANCELED = "canceled", // When event is canceled by the patient
+  RESCHEDULED = "rescheduled", // When event is rescheduled by the clinic administrator
+  COMPLETED = "completed", // When event is completed
+}
+
+/**
+ * Enum for calendar event sync status
+ */
+export enum CalendarSyncStatus {
+  INTERNAL = "internal",
+  EXTERNAL = "external",
+}
+
+/**
+ * Enum for calendar event types
+ */
+export enum CalendarEventType {
+  APPOINTMENT = "appointment",
+  BLOCKING = "blocking",
+  BREAK = "break",
+  FREE_DAY = "free_day",
+  OTHER = "other",
+}
+
+/**
+ * Interface for calendar event time
+ */
+export interface CalendarEventTime {
+  start: Timestamp;
+  end: Timestamp;
+}
+
+export interface ProcedureInfo {
+  // TO-DO: Create detailed procedure info when procedures are integrated
+  name: string;
+  description: string;
+  duration: number;
+  price: number;
+  currency: Currency;
+}
+
+export interface ProcedureCategorization {
+  procedureFamily: ProcedureFamily;
+  procedureCategory: Category;
+  procedureSubcategory: Subcategory;
+  procedureTechnology: Technology;
+  procedureProduct: Product;
+}
+
+export interface SyncedCalendarEvent {
+  eventId: string;
+  syncedCalendarProvider: SyncedCalendarProvider;
+  syncedAt: Timestamp; // Timestamp when the event was last synced with the external calendar
+}
+
+/**
+ * Interface for calendar event
+ */
+export interface CalendarEvent {
+  id: string;
+  clinicBranchId?: string | null;
+  clinicBranchInfo?: ClinicInfo | null;
+  practitionerProfileId?: string | null;
+  practitionerProfileInfo?: PractitionerProfileInfo | null;
+  patientProfileId?: string | null;
+  patientProfileInfo?: PatientProfileInfo | null;
+  procedureId?: string | null;
+  procedureInfo?: ProcedureInfo | null;
+  procedureCategorization?: ProcedureCategorization | null;
+  appointmentId?: string | null; // Created when calendar event is confirmed and it's type is APPOINTMENT
+  syncedCalendarEventId?: SyncedCalendarEvent[] | null;
+  eventName: string;
+  eventLocation?: ClinicLocation;
+  eventTime: CalendarEventTime;
+  description?: string;
+  status: CalendarEventStatus;
+  syncStatus: CalendarSyncStatus;
+  eventType: CalendarEventType;
+  createdAt: Timestamp;
+  updatedAt: Timestamp;
+}
+
+/**
+ * Interface for creating a calendar event
+ */
+export interface CreateCalendarEventData {
+  id: string;
+  clinicBranchId?: string | null;
+  clinicBranchInfo?: ClinicInfo | null;
+  practitionerProfileId?: string | null;
+  practitionerProfileInfo?: PractitionerProfileInfo | null;
+  patientProfileId?: string | null;
+  patientProfileInfo?: PatientProfileInfo | null;
+  procedureId?: string | null;
+  appointmentId?: string | null; // Not needed if event type is not APPOINTMENT, or if there is no automatic appointment confirmation
+  syncedCalendarEventId?: SyncedCalendarEvent[] | null;
+  eventName: string;
+  eventLocation?: ClinicLocation;
+  eventTime: CalendarEventTime;
+  description?: string;
+  status: CalendarEventStatus;
+  syncStatus: CalendarSyncStatus;
+  eventType: CalendarEventType;
+  createdAt: FieldValue;
+  updatedAt: FieldValue;
+}
+
+/**
+ * Interface for updating a calendar event
+ */
+export interface UpdateCalendarEventData {
+  syncedCalendarEventId?: SyncedCalendarEvent[] | null;
+  appointmentId?: string | null; // Updated when calendar event is confirmed and it's type is APPOINTMENT, plus Appointment is created
+  eventName?: string;
+  eventTime?: CalendarEventTime;
+  description?: string;
+  status?: CalendarEventStatus;
+  syncStatus?: CalendarSyncStatus;
+  eventType?: CalendarEventType;
+  updatedAt: FieldValue;
+}
+
+/**
+ * Interface for available time slot
+ */
+export interface TimeSlot {
+  start: Date;
+  end: Date;
+  isAvailable: boolean;
+}
+
+/**
+ * Interface for appointment creation parameters
+ */
+export interface CreateAppointmentParams {
+  clinicId: string;
+  doctorId: string;
+  patientId: string;
+  procedureId: string;
+  eventLocation: ClinicLocation;
+  eventTime: CalendarEventTime;
+  description?: string;
+}
+
+/**
+ * Interface for appointment update parameters
+ */
+export interface UpdateAppointmentParams {
+  appointmentId: string;
+  clinicId: string;
+  doctorId: string;
+  patientId: string;
+  eventTime?: CalendarEventTime;
+  description?: string;
+  status?: CalendarEventStatus;
+}
+
+/**
+ * Collection names for calendar
+ */
+export const CALENDAR_COLLECTION = "calendar";

package/src/types/calendar/synced-calendar.types.ts

@@ -0,0 +1,66 @@
+import { Timestamp, FieldValue } from "firebase/firestore";
+
+/**
+ * Enum for synced calendar provider
+ */
+export enum SyncedCalendarProvider {
+  GOOGLE = "google",
+  OUTLOOK = "outlook",
+  APPLE = "apple",
+}
+
+/**
+ * Interface for synced calendar
+ */
+export interface SyncedCalendar {
+  id: string;
+  provider: SyncedCalendarProvider;
+  name: string;
+  description?: string;
+  accessToken: string;
+  refreshToken: string;
+  tokenExpiry: Timestamp;
+  calendarId: string;
+  isActive: boolean;
+  lastSyncedAt?: Timestamp;
+  createdAt: Timestamp;
+  updatedAt: Timestamp;
+}
+
+/**
+ * Interface for creating a synced calendar
+ */
+export interface CreateSyncedCalendarData {
+  id: string;
+  provider: SyncedCalendarProvider;
+  name: string;
+  description?: string;
+  accessToken: string;
+  refreshToken: string;
+  tokenExpiry: Timestamp;
+  calendarId: string;
+  isActive: boolean;
+  lastSyncedAt?: Timestamp;
+  createdAt: FieldValue;
+  updatedAt: FieldValue;
+}
+
+/**
+ * Interface for updating a synced calendar
+ */
+export interface UpdateSyncedCalendarData {
+  name?: string;
+  description?: string;
+  accessToken?: string;
+  refreshToken?: string;
+  tokenExpiry?: Timestamp;
+  calendarId?: string;
+  isActive?: boolean;
+  lastSyncedAt?: Timestamp;
+  updatedAt: FieldValue;
+}
+
+/**
+ * Collection name for synced calendars
+ */
+export const SYNCED_CALENDARS_COLLECTION = "syncedCalendars";

package/src/types/clinic/index.ts

@@ -5,6 +5,7 @@ import type {
   Currency,
   PricingMeasure,
 } from "../../backoffice/types/static/pricing.types";
+import type { ClinicInfo } from "../profile";
 
 export const CLINIC_GROUPS_COLLECTION = "clinic_groups";
 export const CLINIC_ADMINS_COLLECTION = "clinic_admins";
@@ -94,18 +95,6 @@ export interface ContactPerson {
   phoneNumber?: string | null;
 }
 
-/**
- * Interface for clinic information
- */
-export interface ClinicInfo {
-  id: string;
-  featuredPhoto: string;
-  name: string;
-  description?: string;
-  location: ClinicLocation;
-  contactInfo: ClinicContactInfo;
-}
-
 /**
  * Interface for clinic admin
  */

package/src/types/index.ts

@@ -41,3 +41,7 @@ export type FirebaseUser = FirebaseAuthUser;
 export * from "./documentation-templates";
 export const DOCUMENTATION_TEMPLATES_COLLECTION = "documentation-templates";
 export const FILLED_DOCUMENTS_COLLECTION = "filled-documents";
+
+// Calendar
+export * from "./calendar";
+export const CALENDAR_COLLECTION = "calendar";