@blackcode_sa/metaestetics-api 1.12.58 → 1.12.61

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (267) hide show
  1. package/dist/admin/index.d.mts +36 -4
  2. package/dist/admin/index.d.ts +36 -4
  3. package/dist/admin/index.js +156 -28
  4. package/dist/admin/index.mjs +156 -28
  5. package/dist/index.d.mts +9 -1
  6. package/dist/index.d.ts +9 -1
  7. package/package.json +119 -119
  8. package/src/__mocks__/firstore.ts +10 -10
  9. package/src/admin/aggregation/README.md +79 -79
  10. package/src/admin/aggregation/appointment/README.md +128 -128
  11. package/src/admin/aggregation/appointment/appointment.aggregation.service.ts +1844 -1689
  12. package/src/admin/aggregation/appointment/index.ts +1 -1
  13. package/src/admin/aggregation/clinic/README.md +52 -52
  14. package/src/admin/aggregation/clinic/clinic.aggregation.service.ts +703 -703
  15. package/src/admin/aggregation/clinic/index.ts +1 -1
  16. package/src/admin/aggregation/forms/README.md +13 -13
  17. package/src/admin/aggregation/forms/filled-forms.aggregation.service.ts +322 -322
  18. package/src/admin/aggregation/forms/index.ts +1 -1
  19. package/src/admin/aggregation/index.ts +8 -8
  20. package/src/admin/aggregation/patient/README.md +27 -27
  21. package/src/admin/aggregation/patient/index.ts +1 -1
  22. package/src/admin/aggregation/patient/patient.aggregation.service.ts +141 -141
  23. package/src/admin/aggregation/practitioner/README.md +42 -42
  24. package/src/admin/aggregation/practitioner/index.ts +1 -1
  25. package/src/admin/aggregation/practitioner/practitioner.aggregation.service.ts +433 -433
  26. package/src/admin/aggregation/practitioner-invite/index.ts +1 -1
  27. package/src/admin/aggregation/practitioner-invite/practitioner-invite.aggregation.service.ts +961 -961
  28. package/src/admin/aggregation/procedure/README.md +43 -43
  29. package/src/admin/aggregation/procedure/index.ts +1 -1
  30. package/src/admin/aggregation/procedure/procedure.aggregation.service.ts +702 -702
  31. package/src/admin/aggregation/reviews/index.ts +1 -1
  32. package/src/admin/aggregation/reviews/reviews.aggregation.service.ts +641 -641
  33. package/src/admin/booking/README.md +125 -125
  34. package/src/admin/booking/booking.admin.ts +1037 -1037
  35. package/src/admin/booking/booking.calculator.ts +712 -699
  36. package/src/admin/booking/booking.types.ts +59 -59
  37. package/src/admin/booking/index.ts +3 -3
  38. package/src/admin/booking/timezones-problem.md +185 -185
  39. package/src/admin/calendar/README.md +7 -7
  40. package/src/admin/calendar/calendar.admin.service.ts +345 -345
  41. package/src/admin/calendar/index.ts +1 -1
  42. package/src/admin/documentation-templates/document-manager.admin.ts +260 -260
  43. package/src/admin/documentation-templates/index.ts +1 -1
  44. package/src/admin/free-consultation/free-consultation-utils.admin.ts +148 -148
  45. package/src/admin/free-consultation/index.ts +1 -1
  46. package/src/admin/index.ts +75 -75
  47. package/src/admin/logger/index.ts +78 -78
  48. package/src/admin/mailing/README.md +95 -95
  49. package/src/admin/mailing/appointment/appointment.mailing.service.ts +732 -732
  50. package/src/admin/mailing/appointment/index.ts +1 -1
  51. package/src/admin/mailing/appointment/templates/patient/appointment-confirmed.html +40 -40
  52. package/src/admin/mailing/base.mailing.service.ts +208 -208
  53. package/src/admin/mailing/index.ts +3 -3
  54. package/src/admin/mailing/practitionerInvite/existing-practitioner-invite.mailing.ts +611 -611
  55. package/src/admin/mailing/practitionerInvite/index.ts +2 -2
  56. package/src/admin/mailing/practitionerInvite/practitionerInvite.mailing.ts +395 -395
  57. package/src/admin/mailing/practitionerInvite/templates/existing-practitioner-invitation.template.ts +155 -155
  58. package/src/admin/mailing/practitionerInvite/templates/invitation.template.ts +101 -101
  59. package/src/admin/mailing/practitionerInvite/templates/invite-accepted-notification.template.ts +228 -228
  60. package/src/admin/mailing/practitionerInvite/templates/invite-rejected-notification.template.ts +242 -242
  61. package/src/admin/notifications/index.ts +1 -1
  62. package/src/admin/notifications/notifications.admin.ts +710 -710
  63. package/src/admin/requirements/README.md +128 -128
  64. package/src/admin/requirements/index.ts +1 -1
  65. package/src/admin/requirements/patient-requirements.admin.service.ts +475 -475
  66. package/src/admin/users/index.ts +1 -1
  67. package/src/admin/users/user-profile.admin.ts +405 -405
  68. package/src/backoffice/constants/certification.constants.ts +13 -13
  69. package/src/backoffice/constants/index.ts +1 -1
  70. package/src/backoffice/errors/backoffice.errors.ts +181 -181
  71. package/src/backoffice/errors/index.ts +1 -1
  72. package/src/backoffice/expo-safe/README.md +26 -26
  73. package/src/backoffice/expo-safe/index.ts +41 -41
  74. package/src/backoffice/index.ts +5 -5
  75. package/src/backoffice/services/FIXES_README.md +102 -102
  76. package/src/backoffice/services/README.md +40 -40
  77. package/src/backoffice/services/brand.service.ts +256 -256
  78. package/src/backoffice/services/category.service.ts +318 -318
  79. package/src/backoffice/services/constants.service.ts +385 -385
  80. package/src/backoffice/services/documentation-template.service.ts +202 -202
  81. package/src/backoffice/services/index.ts +8 -8
  82. package/src/backoffice/services/migrate-products.ts +116 -116
  83. package/src/backoffice/services/product.service.ts +553 -553
  84. package/src/backoffice/services/requirement.service.ts +235 -235
  85. package/src/backoffice/services/subcategory.service.ts +395 -395
  86. package/src/backoffice/services/technology.service.ts +1070 -1070
  87. package/src/backoffice/types/README.md +12 -12
  88. package/src/backoffice/types/admin-constants.types.ts +69 -69
  89. package/src/backoffice/types/brand.types.ts +29 -29
  90. package/src/backoffice/types/category.types.ts +62 -62
  91. package/src/backoffice/types/documentation-templates.types.ts +28 -28
  92. package/src/backoffice/types/index.ts +10 -10
  93. package/src/backoffice/types/procedure-product.types.ts +38 -38
  94. package/src/backoffice/types/product.types.ts +240 -240
  95. package/src/backoffice/types/requirement.types.ts +63 -63
  96. package/src/backoffice/types/static/README.md +18 -18
  97. package/src/backoffice/types/static/blocking-condition.types.ts +21 -21
  98. package/src/backoffice/types/static/certification.types.ts +37 -37
  99. package/src/backoffice/types/static/contraindication.types.ts +19 -19
  100. package/src/backoffice/types/static/index.ts +6 -6
  101. package/src/backoffice/types/static/pricing.types.ts +16 -16
  102. package/src/backoffice/types/static/procedure-family.types.ts +14 -14
  103. package/src/backoffice/types/static/treatment-benefit.types.ts +22 -22
  104. package/src/backoffice/types/subcategory.types.ts +34 -34
  105. package/src/backoffice/types/technology.types.ts +161 -161
  106. package/src/backoffice/validations/index.ts +1 -1
  107. package/src/backoffice/validations/schemas.ts +163 -163
  108. package/src/config/__mocks__/firebase.ts +99 -99
  109. package/src/config/firebase.ts +78 -78
  110. package/src/config/index.ts +9 -9
  111. package/src/errors/auth.error.ts +6 -6
  112. package/src/errors/auth.errors.ts +200 -200
  113. package/src/errors/clinic.errors.ts +32 -32
  114. package/src/errors/firebase.errors.ts +47 -47
  115. package/src/errors/user.errors.ts +99 -99
  116. package/src/index.backup.ts +407 -407
  117. package/src/index.ts +6 -6
  118. package/src/locales/en.ts +31 -31
  119. package/src/recommender/admin/index.ts +1 -1
  120. package/src/recommender/admin/services/recommender.service.admin.ts +5 -5
  121. package/src/recommender/front/index.ts +1 -1
  122. package/src/recommender/front/services/onboarding.service.ts +5 -5
  123. package/src/recommender/front/services/recommender.service.ts +3 -3
  124. package/src/recommender/index.ts +1 -1
  125. package/src/services/PATIENTAUTH.MD +197 -197
  126. package/src/services/README.md +106 -106
  127. package/src/services/__tests__/auth/auth.mock.test.ts +17 -17
  128. package/src/services/__tests__/auth/auth.setup.ts +293 -293
  129. package/src/services/__tests__/auth.service.test.ts +346 -346
  130. package/src/services/__tests__/base.service.test.ts +77 -77
  131. package/src/services/__tests__/user.service.test.ts +528 -528
  132. package/src/services/appointment/README.md +17 -17
  133. package/src/services/appointment/appointment.service.ts +2082 -2082
  134. package/src/services/appointment/index.ts +1 -1
  135. package/src/services/appointment/utils/appointment.utils.ts +552 -552
  136. package/src/services/appointment/utils/extended-procedure.utils.ts +314 -314
  137. package/src/services/appointment/utils/form-initialization.utils.ts +225 -225
  138. package/src/services/appointment/utils/recommended-procedure.utils.ts +195 -195
  139. package/src/services/appointment/utils/zone-management.utils.ts +353 -353
  140. package/src/services/appointment/utils/zone-photo.utils.ts +152 -152
  141. package/src/services/auth/auth.service.ts +989 -989
  142. package/src/services/auth/auth.v2.service.ts +961 -961
  143. package/src/services/auth/index.ts +7 -7
  144. package/src/services/auth/utils/error.utils.ts +90 -90
  145. package/src/services/auth/utils/firebase.utils.ts +49 -49
  146. package/src/services/auth/utils/index.ts +21 -21
  147. package/src/services/auth/utils/practitioner.utils.ts +125 -125
  148. package/src/services/base.service.ts +41 -41
  149. package/src/services/calendar/calendar.service.ts +1077 -1077
  150. package/src/services/calendar/calendar.v2.service.ts +1683 -1683
  151. package/src/services/calendar/calendar.v3.service.ts +313 -313
  152. package/src/services/calendar/externalCalendar.service.ts +178 -178
  153. package/src/services/calendar/index.ts +5 -5
  154. package/src/services/calendar/synced-calendars.service.ts +743 -743
  155. package/src/services/calendar/utils/appointment.utils.ts +265 -265
  156. package/src/services/calendar/utils/calendar-event.utils.ts +646 -646
  157. package/src/services/calendar/utils/clinic.utils.ts +237 -237
  158. package/src/services/calendar/utils/docs.utils.ts +157 -157
  159. package/src/services/calendar/utils/google-calendar.utils.ts +697 -697
  160. package/src/services/calendar/utils/index.ts +8 -8
  161. package/src/services/calendar/utils/patient.utils.ts +198 -198
  162. package/src/services/calendar/utils/practitioner.utils.ts +221 -221
  163. package/src/services/calendar/utils/synced-calendar.utils.ts +472 -472
  164. package/src/services/clinic/README.md +204 -204
  165. package/src/services/clinic/__tests__/clinic-admin.service.test.ts +287 -287
  166. package/src/services/clinic/__tests__/clinic-group.service.test.ts +352 -352
  167. package/src/services/clinic/__tests__/clinic.service.test.ts +354 -354
  168. package/src/services/clinic/billing-transactions.service.ts +217 -217
  169. package/src/services/clinic/clinic-admin.service.ts +202 -202
  170. package/src/services/clinic/clinic-group.service.ts +310 -310
  171. package/src/services/clinic/clinic.service.ts +708 -708
  172. package/src/services/clinic/index.ts +5 -5
  173. package/src/services/clinic/practitioner-invite.service.ts +519 -519
  174. package/src/services/clinic/utils/admin.utils.ts +551 -551
  175. package/src/services/clinic/utils/clinic-group.utils.ts +646 -646
  176. package/src/services/clinic/utils/clinic.utils.ts +949 -949
  177. package/src/services/clinic/utils/filter.utils.d.ts +23 -23
  178. package/src/services/clinic/utils/filter.utils.ts +446 -446
  179. package/src/services/clinic/utils/index.ts +11 -11
  180. package/src/services/clinic/utils/photos.utils.ts +188 -188
  181. package/src/services/clinic/utils/search.utils.ts +84 -84
  182. package/src/services/clinic/utils/tag.utils.ts +124 -124
  183. package/src/services/documentation-templates/documentation-template.service.ts +537 -537
  184. package/src/services/documentation-templates/filled-document.service.ts +587 -587
  185. package/src/services/documentation-templates/index.ts +2 -2
  186. package/src/services/index.ts +13 -13
  187. package/src/services/media/index.ts +1 -1
  188. package/src/services/media/media.service.ts +418 -418
  189. package/src/services/notifications/__tests__/notification.service.test.ts +242 -242
  190. package/src/services/notifications/index.ts +1 -1
  191. package/src/services/notifications/notification.service.ts +215 -215
  192. package/src/services/patient/README.md +48 -48
  193. package/src/services/patient/To-Do.md +43 -43
  194. package/src/services/patient/__tests__/patient.service.test.ts +294 -294
  195. package/src/services/patient/index.ts +2 -2
  196. package/src/services/patient/patient.service.ts +883 -883
  197. package/src/services/patient/patientRequirements.service.ts +285 -285
  198. package/src/services/patient/utils/aesthetic-analysis.utils.ts +176 -176
  199. package/src/services/patient/utils/clinic.utils.ts +80 -80
  200. package/src/services/patient/utils/docs.utils.ts +142 -142
  201. package/src/services/patient/utils/index.ts +9 -9
  202. package/src/services/patient/utils/location.utils.ts +126 -126
  203. package/src/services/patient/utils/medical-stuff.utils.ts +143 -143
  204. package/src/services/patient/utils/medical.utils.ts +458 -458
  205. package/src/services/patient/utils/practitioner.utils.ts +260 -260
  206. package/src/services/patient/utils/profile.utils.ts +510 -510
  207. package/src/services/patient/utils/sensitive.utils.ts +260 -260
  208. package/src/services/patient/utils/token.utils.ts +211 -211
  209. package/src/services/practitioner/README.md +145 -145
  210. package/src/services/practitioner/index.ts +1 -1
  211. package/src/services/practitioner/practitioner.service.ts +1742 -1742
  212. package/src/services/procedure/README.md +163 -163
  213. package/src/services/procedure/index.ts +1 -1
  214. package/src/services/procedure/procedure.service.ts +1682 -1682
  215. package/src/services/reviews/index.ts +1 -1
  216. package/src/services/reviews/reviews.service.ts +636 -636
  217. package/src/services/user/index.ts +1 -1
  218. package/src/services/user/user.service.ts +489 -489
  219. package/src/services/user/user.v2.service.ts +466 -466
  220. package/src/types/appointment/index.ts +453 -453
  221. package/src/types/calendar/index.ts +258 -258
  222. package/src/types/calendar/synced-calendar.types.ts +66 -66
  223. package/src/types/clinic/index.ts +489 -489
  224. package/src/types/clinic/practitioner-invite.types.ts +91 -91
  225. package/src/types/clinic/preferences.types.ts +159 -159
  226. package/src/types/clinic/to-do +3 -3
  227. package/src/types/documentation-templates/index.ts +308 -308
  228. package/src/types/index.ts +44 -44
  229. package/src/types/notifications/README.md +77 -77
  230. package/src/types/notifications/index.ts +265 -265
  231. package/src/types/patient/aesthetic-analysis.types.ts +66 -66
  232. package/src/types/patient/allergies.ts +58 -58
  233. package/src/types/patient/index.ts +273 -273
  234. package/src/types/patient/medical-info.types.ts +152 -152
  235. package/src/types/patient/patient-requirements.ts +92 -81
  236. package/src/types/patient/token.types.ts +61 -61
  237. package/src/types/practitioner/index.ts +206 -206
  238. package/src/types/procedure/index.ts +181 -181
  239. package/src/types/profile/index.ts +39 -39
  240. package/src/types/reviews/index.ts +130 -130
  241. package/src/types/tz-lookup.d.ts +4 -4
  242. package/src/types/user/index.ts +38 -38
  243. package/src/utils/TIMESTAMPS.md +176 -176
  244. package/src/utils/TimestampUtils.ts +241 -241
  245. package/src/utils/index.ts +1 -1
  246. package/src/validations/appointment.schema.ts +574 -574
  247. package/src/validations/calendar.schema.ts +225 -225
  248. package/src/validations/clinic.schema.ts +493 -493
  249. package/src/validations/common.schema.ts +25 -25
  250. package/src/validations/documentation-templates/index.ts +1 -1
  251. package/src/validations/documentation-templates/template.schema.ts +220 -220
  252. package/src/validations/documentation-templates.schema.ts +10 -10
  253. package/src/validations/index.ts +20 -20
  254. package/src/validations/media.schema.ts +10 -10
  255. package/src/validations/notification.schema.ts +90 -90
  256. package/src/validations/patient/aesthetic-analysis.schema.ts +55 -55
  257. package/src/validations/patient/medical-info.schema.ts +125 -125
  258. package/src/validations/patient/patient-requirements.schema.ts +84 -75
  259. package/src/validations/patient/token.schema.ts +29 -29
  260. package/src/validations/patient.schema.ts +216 -216
  261. package/src/validations/practitioner.schema.ts +222 -222
  262. package/src/validations/procedure-product.schema.ts +41 -41
  263. package/src/validations/procedure.schema.ts +124 -124
  264. package/src/validations/profile-info.schema.ts +41 -41
  265. package/src/validations/reviews.schema.ts +189 -189
  266. package/src/validations/schemas.ts +104 -104
  267. package/src/validations/shared.schema.ts +78 -78
@@ -1,641 +1,641 @@
1
- import * as admin from "firebase-admin";
2
- import {
3
- Review,
4
- ClinicReview,
5
- PractitionerReview,
6
- ProcedureReview,
7
- REVIEWS_COLLECTION,
8
- ClinicReviewInfo,
9
- PractitionerReviewInfo,
10
- ProcedureReviewInfo,
11
- } from "../../../types/reviews";
12
- import { CLINICS_COLLECTION } from "../../../types/clinic";
13
- import { PRACTITIONERS_COLLECTION } from "../../../types/practitioner";
14
- import { PROCEDURES_COLLECTION } from "../../../types/procedure";
15
-
16
- /**
17
- * @class ReviewsAggregationService
18
- * @description Handles aggregation tasks related to review data updates.
19
- * This service is intended to be used primarily by background functions (e.g., Cloud Functions)
20
- * triggered by changes in the reviews collection.
21
- */
22
- export class ReviewsAggregationService {
23
- private db: admin.firestore.Firestore;
24
-
25
- /**
26
- * Constructor for ReviewsAggregationService.
27
- * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
28
- */
29
- constructor(firestore?: admin.firestore.Firestore) {
30
- this.db = firestore || admin.firestore();
31
- }
32
-
33
- /**
34
- * Process a newly created review and update all related entities
35
- * @param review The newly created review
36
- * @returns Promise resolving when all updates are complete
37
- */
38
- async processNewReview(review: Review): Promise<void> {
39
- console.log(
40
- `[ReviewsAggregationService] Processing new review: ${review.id}`
41
- );
42
-
43
- const updatePromises: Promise<any>[] = [];
44
-
45
- // Update clinic if clinic review exists
46
- if (review.clinicReview) {
47
- updatePromises.push(
48
- this.updateClinicReviewInfo(review.clinicReview.clinicId)
49
- );
50
- }
51
-
52
- // Update practitioner if practitioner review exists
53
- if (review.practitionerReview) {
54
- updatePromises.push(
55
- this.updatePractitionerReviewInfo(
56
- review.practitionerReview.practitionerId
57
- )
58
- );
59
- }
60
-
61
- // Update procedure if procedure review exists
62
- if (review.procedureReview) {
63
- updatePromises.push(
64
- this.updateProcedureReviewInfo(review.procedureReview.procedureId)
65
- );
66
- }
67
-
68
- // Wait for all updates to complete
69
- await Promise.all(updatePromises);
70
- console.log(
71
- `[ReviewsAggregationService] Successfully processed review: ${review.id}`
72
- );
73
- }
74
-
75
- /**
76
- * Process a deleted review and update all related entities
77
- * @param review The deleted review
78
- * @returns Promise resolving when all updates are complete
79
- */
80
- async processDeletedReview(review: Review): Promise<void> {
81
- console.log(
82
- `[ReviewsAggregationService] Processing deleted review: ${review.id}`
83
- );
84
-
85
- const updatePromises: Promise<any>[] = [];
86
-
87
- // Update clinic if clinic review exists
88
- if (review.clinicReview) {
89
- updatePromises.push(
90
- this.updateClinicReviewInfo(
91
- review.clinicReview.clinicId,
92
- review.clinicReview,
93
- true
94
- )
95
- );
96
- }
97
-
98
- // Update practitioner if practitioner review exists
99
- if (review.practitionerReview) {
100
- updatePromises.push(
101
- this.updatePractitionerReviewInfo(
102
- review.practitionerReview.practitionerId,
103
- review.practitionerReview,
104
- true
105
- )
106
- );
107
- }
108
-
109
- // Update procedure if procedure review exists
110
- if (review.procedureReview) {
111
- updatePromises.push(
112
- this.updateProcedureReviewInfo(
113
- review.procedureReview.procedureId,
114
- review.procedureReview,
115
- true
116
- )
117
- );
118
- }
119
-
120
- // Wait for all updates to complete
121
- await Promise.all(updatePromises);
122
- console.log(
123
- `[ReviewsAggregationService] Successfully processed deleted review: ${review.id}`
124
- );
125
- }
126
-
127
- /**
128
- * Updates the review info for a clinic
129
- * @param clinicId The ID of the clinic to update
130
- * @param removedReview Optional review being removed
131
- * @param isRemoval Whether this update is for a review removal
132
- * @returns The updated clinic review info
133
- */
134
- async updateClinicReviewInfo(
135
- clinicId: string,
136
- removedReview?: ClinicReview,
137
- isRemoval: boolean = false
138
- ): Promise<ClinicReviewInfo> {
139
- console.log(
140
- `[ReviewsAggregationService] Updating review info for clinic: ${clinicId}`
141
- );
142
-
143
- // Get the current clinic document
144
- const clinicDoc = await this.db
145
- .collection(CLINICS_COLLECTION)
146
- .doc(clinicId)
147
- .get();
148
-
149
- if (!clinicDoc.exists) {
150
- console.error(
151
- `[ReviewsAggregationService] Clinic with ID ${clinicId} not found`
152
- );
153
- throw new Error(`Clinic with ID ${clinicId} not found`);
154
- }
155
-
156
- const clinicData = clinicDoc.data();
157
- const currentReviewInfo = (clinicData?.reviewInfo as ClinicReviewInfo) || {
158
- totalReviews: 0,
159
- averageRating: 0,
160
- cleanliness: 0,
161
- facilities: 0,
162
- staffFriendliness: 0,
163
- waitingTime: 0,
164
- accessibility: 0,
165
- recommendationPercentage: 0,
166
- };
167
-
168
- // Get all reviews for this clinic
169
- const reviewsQuery = await this.db
170
- .collection(REVIEWS_COLLECTION)
171
- .where("clinicReview.clinicId", "==", clinicId)
172
- .get();
173
-
174
- // If we're removing the last review or there are no reviews, set default values
175
- if ((isRemoval && reviewsQuery.size <= 1) || reviewsQuery.empty) {
176
- const updatedReviewInfo: ClinicReviewInfo = {
177
- totalReviews: 0,
178
- averageRating: 0,
179
- cleanliness: 0,
180
- facilities: 0,
181
- staffFriendliness: 0,
182
- waitingTime: 0,
183
- accessibility: 0,
184
- recommendationPercentage: 0,
185
- };
186
-
187
- await this.db.collection(CLINICS_COLLECTION).doc(clinicId).update({
188
- reviewInfo: updatedReviewInfo,
189
- updatedAt: admin.firestore.FieldValue.serverTimestamp(),
190
- });
191
-
192
- console.log(
193
- `[ReviewsAggregationService] Reset review info for clinic: ${clinicId}`
194
- );
195
- return updatedReviewInfo;
196
- }
197
-
198
- // Calculate new averages from all reviews
199
- const reviews = reviewsQuery.docs.map((doc) => doc.data() as Review);
200
- const clinicReviews = reviews
201
- .map((review) => review.clinicReview)
202
- .filter((review): review is ClinicReview => review !== undefined);
203
-
204
- // Calculate averages
205
- let totalRating = 0;
206
- let totalCleanliness = 0;
207
- let totalFacilities = 0;
208
- let totalStaffFriendliness = 0;
209
- let totalWaitingTime = 0;
210
- let totalAccessibility = 0;
211
- let totalRecommendations = 0;
212
-
213
- clinicReviews.forEach((review) => {
214
- totalRating += review.overallRating;
215
- totalCleanliness += review.cleanliness;
216
- totalFacilities += review.facilities;
217
- totalStaffFriendliness += review.staffFriendliness;
218
- totalWaitingTime += review.waitingTime;
219
- totalAccessibility += review.accessibility;
220
- if (review.wouldRecommend) totalRecommendations++;
221
- });
222
-
223
- const count = clinicReviews.length;
224
- const roundToOneDecimal = (value: number): number =>
225
- Math.round((value / count) * 10) / 10;
226
-
227
- const updatedReviewInfo: ClinicReviewInfo = {
228
- totalReviews: count,
229
- averageRating: roundToOneDecimal(totalRating),
230
- cleanliness: roundToOneDecimal(totalCleanliness),
231
- facilities: roundToOneDecimal(totalFacilities),
232
- staffFriendliness: roundToOneDecimal(totalStaffFriendliness),
233
- waitingTime: roundToOneDecimal(totalWaitingTime),
234
- accessibility: roundToOneDecimal(totalAccessibility),
235
- recommendationPercentage:
236
- Math.round((totalRecommendations / count) * 1000) / 10,
237
- };
238
-
239
- // Update the clinic with the new review info
240
- await this.db.collection(CLINICS_COLLECTION).doc(clinicId).update({
241
- reviewInfo: updatedReviewInfo,
242
- updatedAt: admin.firestore.FieldValue.serverTimestamp(),
243
- });
244
-
245
- console.log(
246
- `[ReviewsAggregationService] Updated review info for clinic: ${clinicId}`
247
- );
248
- return updatedReviewInfo;
249
- }
250
-
251
- /**
252
- * Updates the review info for a practitioner
253
- * @param practitionerId The ID of the practitioner to update
254
- * @param removedReview Optional review being removed
255
- * @param isRemoval Whether this update is for a review removal
256
- * @returns The updated practitioner review info
257
- */
258
- async updatePractitionerReviewInfo(
259
- practitionerId: string,
260
- removedReview?: PractitionerReview,
261
- isRemoval: boolean = false
262
- ): Promise<PractitionerReviewInfo> {
263
- console.log(
264
- `[ReviewsAggregationService] Updating review info for practitioner: ${practitionerId}`
265
- );
266
-
267
- // Get the current practitioner document
268
- const practitionerDoc = await this.db
269
- .collection(PRACTITIONERS_COLLECTION)
270
- .doc(practitionerId)
271
- .get();
272
-
273
- if (!practitionerDoc.exists) {
274
- console.error(
275
- `[ReviewsAggregationService] Practitioner with ID ${practitionerId} not found`
276
- );
277
- throw new Error(`Practitioner with ID ${practitionerId} not found`);
278
- }
279
-
280
- const practitionerData = practitionerDoc.data();
281
- const currentReviewInfo =
282
- (practitionerData?.reviewInfo as PractitionerReviewInfo) || {
283
- totalReviews: 0,
284
- averageRating: 0,
285
- knowledgeAndExpertise: 0,
286
- communicationSkills: 0,
287
- bedSideManner: 0,
288
- thoroughness: 0,
289
- trustworthiness: 0,
290
- recommendationPercentage: 0,
291
- };
292
-
293
- // Get all reviews for this practitioner
294
- const reviewsQuery = await this.db
295
- .collection(REVIEWS_COLLECTION)
296
- .where("practitionerReview.practitionerId", "==", practitionerId)
297
- .get();
298
-
299
- // If we're removing the last review or there are no reviews, set default values
300
- if ((isRemoval && reviewsQuery.size <= 1) || reviewsQuery.empty) {
301
- const updatedReviewInfo: PractitionerReviewInfo = {
302
- totalReviews: 0,
303
- averageRating: 0,
304
- knowledgeAndExpertise: 0,
305
- communicationSkills: 0,
306
- bedSideManner: 0,
307
- thoroughness: 0,
308
- trustworthiness: 0,
309
- recommendationPercentage: 0,
310
- };
311
-
312
- await this.db
313
- .collection(PRACTITIONERS_COLLECTION)
314
- .doc(practitionerId)
315
- .update({
316
- reviewInfo: updatedReviewInfo,
317
- updatedAt: admin.firestore.FieldValue.serverTimestamp(),
318
- });
319
-
320
- // Also update doctor info in procedures with the new rating
321
- await this.updateDoctorInfoInProcedures(practitionerId, 0);
322
-
323
- console.log(
324
- `[ReviewsAggregationService] Reset review info for practitioner: ${practitionerId}`
325
- );
326
- return updatedReviewInfo;
327
- }
328
-
329
- // Calculate new averages from all reviews
330
- const reviews = reviewsQuery.docs.map((doc) => doc.data() as Review);
331
- const practitionerReviews = reviews
332
- .map((review) => review.practitionerReview)
333
- .filter((review): review is PractitionerReview => review !== undefined);
334
-
335
- // Calculate averages
336
- let totalRating = 0;
337
- let totalKnowledgeAndExpertise = 0;
338
- let totalCommunicationSkills = 0;
339
- let totalBedSideManner = 0;
340
- let totalThoroughness = 0;
341
- let totalTrustworthiness = 0;
342
- let totalRecommendations = 0;
343
-
344
- practitionerReviews.forEach((review) => {
345
- totalRating += review.overallRating;
346
- totalKnowledgeAndExpertise += review.knowledgeAndExpertise;
347
- totalCommunicationSkills += review.communicationSkills;
348
- totalBedSideManner += review.bedSideManner;
349
- totalThoroughness += review.thoroughness;
350
- totalTrustworthiness += review.trustworthiness;
351
- if (review.wouldRecommend) totalRecommendations++;
352
- });
353
-
354
- const count = practitionerReviews.length;
355
- const roundToOneDecimal = (value: number): number =>
356
- Math.round((value / count) * 10) / 10;
357
-
358
- const updatedReviewInfo: PractitionerReviewInfo = {
359
- totalReviews: count,
360
- averageRating: roundToOneDecimal(totalRating),
361
- knowledgeAndExpertise: roundToOneDecimal(totalKnowledgeAndExpertise),
362
- communicationSkills: roundToOneDecimal(totalCommunicationSkills),
363
- bedSideManner: roundToOneDecimal(totalBedSideManner),
364
- thoroughness: roundToOneDecimal(totalThoroughness),
365
- trustworthiness: roundToOneDecimal(totalTrustworthiness),
366
- recommendationPercentage:
367
- Math.round((totalRecommendations / count) * 1000) / 10,
368
- };
369
-
370
- // Update the practitioner with the new review info
371
- await this.db
372
- .collection(PRACTITIONERS_COLLECTION)
373
- .doc(practitionerId)
374
- .update({
375
- reviewInfo: updatedReviewInfo,
376
- updatedAt: admin.firestore.FieldValue.serverTimestamp(),
377
- });
378
-
379
- // Also update doctor info in procedures with the new rating
380
- await this.updateDoctorInfoInProcedures(
381
- practitionerId,
382
- updatedReviewInfo.averageRating
383
- );
384
-
385
- console.log(
386
- `[ReviewsAggregationService] Updated review info for practitioner: ${practitionerId}`
387
- );
388
- return updatedReviewInfo;
389
- }
390
-
391
- /**
392
- * Updates the review info for a procedure
393
- * @param procedureId The ID of the procedure to update
394
- * @param removedReview Optional review being removed
395
- * @param isRemoval Whether this update is for a review removal
396
- * @returns The updated procedure review info
397
- */
398
- async updateProcedureReviewInfo(
399
- procedureId: string,
400
- removedReview?: ProcedureReview,
401
- isRemoval: boolean = false
402
- ): Promise<ProcedureReviewInfo> {
403
- console.log(
404
- `[ReviewsAggregationService] Updating review info for procedure: ${procedureId}`
405
- );
406
-
407
- // Get the current procedure document
408
- const procedureDoc = await this.db
409
- .collection(PROCEDURES_COLLECTION)
410
- .doc(procedureId)
411
- .get();
412
-
413
- if (!procedureDoc.exists) {
414
- console.error(
415
- `[ReviewsAggregationService] Procedure with ID ${procedureId} not found`
416
- );
417
- throw new Error(`Procedure with ID ${procedureId} not found`);
418
- }
419
-
420
- const procedureData = procedureDoc.data();
421
- const currentReviewInfo =
422
- (procedureData?.reviewInfo as ProcedureReviewInfo) || {
423
- totalReviews: 0,
424
- averageRating: 0,
425
- effectivenessOfTreatment: 0,
426
- outcomeExplanation: 0,
427
- painManagement: 0,
428
- followUpCare: 0,
429
- valueForMoney: 0,
430
- recommendationPercentage: 0,
431
- };
432
-
433
- // Get all reviews for this procedure
434
- const reviewsQuery = await this.db
435
- .collection(REVIEWS_COLLECTION)
436
- .where("procedureReview.procedureId", "==", procedureId)
437
- .get();
438
-
439
- // If we're removing the last review or there are no reviews, set default values
440
- if ((isRemoval && reviewsQuery.size <= 1) || reviewsQuery.empty) {
441
- const updatedReviewInfo: ProcedureReviewInfo = {
442
- totalReviews: 0,
443
- averageRating: 0,
444
- effectivenessOfTreatment: 0,
445
- outcomeExplanation: 0,
446
- painManagement: 0,
447
- followUpCare: 0,
448
- valueForMoney: 0,
449
- recommendationPercentage: 0,
450
- };
451
-
452
- await this.db.collection(PROCEDURES_COLLECTION).doc(procedureId).update({
453
- reviewInfo: updatedReviewInfo,
454
- updatedAt: admin.firestore.FieldValue.serverTimestamp(),
455
- });
456
-
457
- console.log(
458
- `[ReviewsAggregationService] Reset review info for procedure: ${procedureId}`
459
- );
460
- return updatedReviewInfo;
461
- }
462
-
463
- // Calculate new averages from all reviews
464
- const reviews = reviewsQuery.docs.map((doc) => doc.data() as Review);
465
- const procedureReviews = reviews
466
- .map((review) => review.procedureReview)
467
- .filter((review): review is ProcedureReview => review !== undefined);
468
-
469
- // Calculate averages
470
- let totalRating = 0;
471
- let totalEffectivenessOfTreatment = 0;
472
- let totalOutcomeExplanation = 0;
473
- let totalPainManagement = 0;
474
- let totalFollowUpCare = 0;
475
- let totalValueForMoney = 0;
476
- let totalRecommendations = 0;
477
-
478
- procedureReviews.forEach((review) => {
479
- totalRating += review.overallRating;
480
- totalEffectivenessOfTreatment += review.effectivenessOfTreatment;
481
- totalOutcomeExplanation += review.outcomeExplanation;
482
- totalPainManagement += review.painManagement;
483
- totalFollowUpCare += review.followUpCare;
484
- totalValueForMoney += review.valueForMoney;
485
- if (review.wouldRecommend) totalRecommendations++;
486
- });
487
-
488
- const count = procedureReviews.length;
489
- const roundToOneDecimal = (value: number): number =>
490
- Math.round((value / count) * 10) / 10;
491
-
492
- const updatedReviewInfo: ProcedureReviewInfo = {
493
- totalReviews: count,
494
- averageRating: roundToOneDecimal(totalRating),
495
- effectivenessOfTreatment: roundToOneDecimal(
496
- totalEffectivenessOfTreatment
497
- ),
498
- outcomeExplanation: roundToOneDecimal(totalOutcomeExplanation),
499
- painManagement: roundToOneDecimal(totalPainManagement),
500
- followUpCare: roundToOneDecimal(totalFollowUpCare),
501
- valueForMoney: roundToOneDecimal(totalValueForMoney),
502
- recommendationPercentage:
503
- Math.round((totalRecommendations / count) * 1000) / 10,
504
- };
505
-
506
- // Update the procedure with the new review info
507
- await this.db.collection(PROCEDURES_COLLECTION).doc(procedureId).update({
508
- reviewInfo: updatedReviewInfo,
509
- updatedAt: admin.firestore.FieldValue.serverTimestamp(),
510
- });
511
-
512
- console.log(
513
- `[ReviewsAggregationService] Updated review info for procedure: ${procedureId}`
514
- );
515
- return updatedReviewInfo;
516
- }
517
-
518
- /**
519
- * Updates doctorInfo rating in all procedures for a practitioner
520
- * @param practitionerId The ID of the practitioner
521
- * @param rating The new rating to set
522
- */
523
- private async updateDoctorInfoInProcedures(
524
- practitionerId: string,
525
- rating: number
526
- ): Promise<void> {
527
- console.log(
528
- `[ReviewsAggregationService] Updating doctor info in procedures for practitioner: ${practitionerId}`
529
- );
530
-
531
- // Find all procedures for this practitioner
532
- const proceduresQuery = await this.db
533
- .collection(PROCEDURES_COLLECTION)
534
- .where("practitionerId", "==", practitionerId)
535
- .get();
536
-
537
- if (proceduresQuery.empty) {
538
- console.log(
539
- `[ReviewsAggregationService] No procedures found for practitioner: ${practitionerId}`
540
- );
541
- return;
542
- }
543
-
544
- // Batch update all procedures
545
- const batch = this.db.batch();
546
-
547
- proceduresQuery.docs.forEach((docSnapshot) => {
548
- const procedureRef = this.db
549
- .collection(PROCEDURES_COLLECTION)
550
- .doc(docSnapshot.id);
551
- batch.update(procedureRef, {
552
- "doctorInfo.rating": rating,
553
- updatedAt: admin.firestore.FieldValue.serverTimestamp(),
554
- });
555
- });
556
-
557
- await batch.commit();
558
- console.log(
559
- `[ReviewsAggregationService] Updated doctor info in ${proceduresQuery.size} procedures for practitioner: ${practitionerId}`
560
- );
561
- }
562
-
563
- /**
564
- * Verifies a review as checked by admin/staff
565
- * @param reviewId The ID of the review to verify
566
- */
567
- async verifyReview(reviewId: string): Promise<void> {
568
- console.log(`[ReviewsAggregationService] Verifying review: ${reviewId}`);
569
-
570
- // Get the review
571
- const reviewDoc = await this.db
572
- .collection(REVIEWS_COLLECTION)
573
- .doc(reviewId)
574
- .get();
575
-
576
- if (!reviewDoc.exists) {
577
- console.error(
578
- `[ReviewsAggregationService] Review with ID ${reviewId} not found`
579
- );
580
- throw new Error(`Review with ID ${reviewId} not found`);
581
- }
582
-
583
- const review = reviewDoc.data() as Review;
584
- const batch = this.db.batch();
585
- const reviewRef = this.db.collection(REVIEWS_COLLECTION).doc(reviewId);
586
-
587
- // Update clinic review if it exists
588
- if (review.clinicReview) {
589
- review.clinicReview.isVerified = true;
590
- }
591
-
592
- // Update practitioner review if it exists
593
- if (review.practitionerReview) {
594
- review.practitionerReview.isVerified = true;
595
- }
596
-
597
- // Update procedure review if it exists
598
- if (review.procedureReview) {
599
- review.procedureReview.isVerified = true;
600
- }
601
-
602
- // Update the review
603
- batch.update(reviewRef, {
604
- clinicReview: review.clinicReview,
605
- practitionerReview: review.practitionerReview,
606
- procedureReview: review.procedureReview,
607
- updatedAt: admin.firestore.FieldValue.serverTimestamp(),
608
- });
609
-
610
- await batch.commit();
611
- console.log(
612
- `[ReviewsAggregationService] Successfully verified review: ${reviewId}`
613
- );
614
- }
615
-
616
- /**
617
- * Calculate the average of all reviews for an entity
618
- * @param entityId The entity ID
619
- * @param entityType The type of entity ('clinic', 'practitioner', or 'procedure')
620
- * @returns Promise that resolves to the calculated review info
621
- */
622
- async calculateEntityReviewInfo(
623
- entityId: string,
624
- entityType: "clinic" | "practitioner" | "procedure"
625
- ): Promise<ClinicReviewInfo | PractitionerReviewInfo | ProcedureReviewInfo> {
626
- console.log(
627
- `[ReviewsAggregationService] Calculating review info for ${entityType}: ${entityId}`
628
- );
629
-
630
- switch (entityType) {
631
- case "clinic":
632
- return this.updateClinicReviewInfo(entityId);
633
- case "practitioner":
634
- return this.updatePractitionerReviewInfo(entityId);
635
- case "procedure":
636
- return this.updateProcedureReviewInfo(entityId);
637
- default:
638
- throw new Error(`Invalid entity type: ${entityType}`);
639
- }
640
- }
641
- }
1
+ import * as admin from "firebase-admin";
2
+ import {
3
+ Review,
4
+ ClinicReview,
5
+ PractitionerReview,
6
+ ProcedureReview,
7
+ REVIEWS_COLLECTION,
8
+ ClinicReviewInfo,
9
+ PractitionerReviewInfo,
10
+ ProcedureReviewInfo,
11
+ } from "../../../types/reviews";
12
+ import { CLINICS_COLLECTION } from "../../../types/clinic";
13
+ import { PRACTITIONERS_COLLECTION } from "../../../types/practitioner";
14
+ import { PROCEDURES_COLLECTION } from "../../../types/procedure";
15
+
16
+ /**
17
+ * @class ReviewsAggregationService
18
+ * @description Handles aggregation tasks related to review data updates.
19
+ * This service is intended to be used primarily by background functions (e.g., Cloud Functions)
20
+ * triggered by changes in the reviews collection.
21
+ */
22
+ export class ReviewsAggregationService {
23
+ private db: admin.firestore.Firestore;
24
+
25
+ /**
26
+ * Constructor for ReviewsAggregationService.
27
+ * @param firestore Optional Firestore instance. If not provided, it uses the default admin SDK instance.
28
+ */
29
+ constructor(firestore?: admin.firestore.Firestore) {
30
+ this.db = firestore || admin.firestore();
31
+ }
32
+
33
+ /**
34
+ * Process a newly created review and update all related entities
35
+ * @param review The newly created review
36
+ * @returns Promise resolving when all updates are complete
37
+ */
38
+ async processNewReview(review: Review): Promise<void> {
39
+ console.log(
40
+ `[ReviewsAggregationService] Processing new review: ${review.id}`
41
+ );
42
+
43
+ const updatePromises: Promise<any>[] = [];
44
+
45
+ // Update clinic if clinic review exists
46
+ if (review.clinicReview) {
47
+ updatePromises.push(
48
+ this.updateClinicReviewInfo(review.clinicReview.clinicId)
49
+ );
50
+ }
51
+
52
+ // Update practitioner if practitioner review exists
53
+ if (review.practitionerReview) {
54
+ updatePromises.push(
55
+ this.updatePractitionerReviewInfo(
56
+ review.practitionerReview.practitionerId
57
+ )
58
+ );
59
+ }
60
+
61
+ // Update procedure if procedure review exists
62
+ if (review.procedureReview) {
63
+ updatePromises.push(
64
+ this.updateProcedureReviewInfo(review.procedureReview.procedureId)
65
+ );
66
+ }
67
+
68
+ // Wait for all updates to complete
69
+ await Promise.all(updatePromises);
70
+ console.log(
71
+ `[ReviewsAggregationService] Successfully processed review: ${review.id}`
72
+ );
73
+ }
74
+
75
+ /**
76
+ * Process a deleted review and update all related entities
77
+ * @param review The deleted review
78
+ * @returns Promise resolving when all updates are complete
79
+ */
80
+ async processDeletedReview(review: Review): Promise<void> {
81
+ console.log(
82
+ `[ReviewsAggregationService] Processing deleted review: ${review.id}`
83
+ );
84
+
85
+ const updatePromises: Promise<any>[] = [];
86
+
87
+ // Update clinic if clinic review exists
88
+ if (review.clinicReview) {
89
+ updatePromises.push(
90
+ this.updateClinicReviewInfo(
91
+ review.clinicReview.clinicId,
92
+ review.clinicReview,
93
+ true
94
+ )
95
+ );
96
+ }
97
+
98
+ // Update practitioner if practitioner review exists
99
+ if (review.practitionerReview) {
100
+ updatePromises.push(
101
+ this.updatePractitionerReviewInfo(
102
+ review.practitionerReview.practitionerId,
103
+ review.practitionerReview,
104
+ true
105
+ )
106
+ );
107
+ }
108
+
109
+ // Update procedure if procedure review exists
110
+ if (review.procedureReview) {
111
+ updatePromises.push(
112
+ this.updateProcedureReviewInfo(
113
+ review.procedureReview.procedureId,
114
+ review.procedureReview,
115
+ true
116
+ )
117
+ );
118
+ }
119
+
120
+ // Wait for all updates to complete
121
+ await Promise.all(updatePromises);
122
+ console.log(
123
+ `[ReviewsAggregationService] Successfully processed deleted review: ${review.id}`
124
+ );
125
+ }
126
+
127
+ /**
128
+ * Updates the review info for a clinic
129
+ * @param clinicId The ID of the clinic to update
130
+ * @param removedReview Optional review being removed
131
+ * @param isRemoval Whether this update is for a review removal
132
+ * @returns The updated clinic review info
133
+ */
134
+ async updateClinicReviewInfo(
135
+ clinicId: string,
136
+ removedReview?: ClinicReview,
137
+ isRemoval: boolean = false
138
+ ): Promise<ClinicReviewInfo> {
139
+ console.log(
140
+ `[ReviewsAggregationService] Updating review info for clinic: ${clinicId}`
141
+ );
142
+
143
+ // Get the current clinic document
144
+ const clinicDoc = await this.db
145
+ .collection(CLINICS_COLLECTION)
146
+ .doc(clinicId)
147
+ .get();
148
+
149
+ if (!clinicDoc.exists) {
150
+ console.error(
151
+ `[ReviewsAggregationService] Clinic with ID ${clinicId} not found`
152
+ );
153
+ throw new Error(`Clinic with ID ${clinicId} not found`);
154
+ }
155
+
156
+ const clinicData = clinicDoc.data();
157
+ const currentReviewInfo = (clinicData?.reviewInfo as ClinicReviewInfo) || {
158
+ totalReviews: 0,
159
+ averageRating: 0,
160
+ cleanliness: 0,
161
+ facilities: 0,
162
+ staffFriendliness: 0,
163
+ waitingTime: 0,
164
+ accessibility: 0,
165
+ recommendationPercentage: 0,
166
+ };
167
+
168
+ // Get all reviews for this clinic
169
+ const reviewsQuery = await this.db
170
+ .collection(REVIEWS_COLLECTION)
171
+ .where("clinicReview.clinicId", "==", clinicId)
172
+ .get();
173
+
174
+ // If we're removing the last review or there are no reviews, set default values
175
+ if ((isRemoval && reviewsQuery.size <= 1) || reviewsQuery.empty) {
176
+ const updatedReviewInfo: ClinicReviewInfo = {
177
+ totalReviews: 0,
178
+ averageRating: 0,
179
+ cleanliness: 0,
180
+ facilities: 0,
181
+ staffFriendliness: 0,
182
+ waitingTime: 0,
183
+ accessibility: 0,
184
+ recommendationPercentage: 0,
185
+ };
186
+
187
+ await this.db.collection(CLINICS_COLLECTION).doc(clinicId).update({
188
+ reviewInfo: updatedReviewInfo,
189
+ updatedAt: admin.firestore.FieldValue.serverTimestamp(),
190
+ });
191
+
192
+ console.log(
193
+ `[ReviewsAggregationService] Reset review info for clinic: ${clinicId}`
194
+ );
195
+ return updatedReviewInfo;
196
+ }
197
+
198
+ // Calculate new averages from all reviews
199
+ const reviews = reviewsQuery.docs.map((doc) => doc.data() as Review);
200
+ const clinicReviews = reviews
201
+ .map((review) => review.clinicReview)
202
+ .filter((review): review is ClinicReview => review !== undefined);
203
+
204
+ // Calculate averages
205
+ let totalRating = 0;
206
+ let totalCleanliness = 0;
207
+ let totalFacilities = 0;
208
+ let totalStaffFriendliness = 0;
209
+ let totalWaitingTime = 0;
210
+ let totalAccessibility = 0;
211
+ let totalRecommendations = 0;
212
+
213
+ clinicReviews.forEach((review) => {
214
+ totalRating += review.overallRating;
215
+ totalCleanliness += review.cleanliness;
216
+ totalFacilities += review.facilities;
217
+ totalStaffFriendliness += review.staffFriendliness;
218
+ totalWaitingTime += review.waitingTime;
219
+ totalAccessibility += review.accessibility;
220
+ if (review.wouldRecommend) totalRecommendations++;
221
+ });
222
+
223
+ const count = clinicReviews.length;
224
+ const roundToOneDecimal = (value: number): number =>
225
+ Math.round((value / count) * 10) / 10;
226
+
227
+ const updatedReviewInfo: ClinicReviewInfo = {
228
+ totalReviews: count,
229
+ averageRating: roundToOneDecimal(totalRating),
230
+ cleanliness: roundToOneDecimal(totalCleanliness),
231
+ facilities: roundToOneDecimal(totalFacilities),
232
+ staffFriendliness: roundToOneDecimal(totalStaffFriendliness),
233
+ waitingTime: roundToOneDecimal(totalWaitingTime),
234
+ accessibility: roundToOneDecimal(totalAccessibility),
235
+ recommendationPercentage:
236
+ Math.round((totalRecommendations / count) * 1000) / 10,
237
+ };
238
+
239
+ // Update the clinic with the new review info
240
+ await this.db.collection(CLINICS_COLLECTION).doc(clinicId).update({
241
+ reviewInfo: updatedReviewInfo,
242
+ updatedAt: admin.firestore.FieldValue.serverTimestamp(),
243
+ });
244
+
245
+ console.log(
246
+ `[ReviewsAggregationService] Updated review info for clinic: ${clinicId}`
247
+ );
248
+ return updatedReviewInfo;
249
+ }
250
+
251
+ /**
252
+ * Updates the review info for a practitioner
253
+ * @param practitionerId The ID of the practitioner to update
254
+ * @param removedReview Optional review being removed
255
+ * @param isRemoval Whether this update is for a review removal
256
+ * @returns The updated practitioner review info
257
+ */
258
+ async updatePractitionerReviewInfo(
259
+ practitionerId: string,
260
+ removedReview?: PractitionerReview,
261
+ isRemoval: boolean = false
262
+ ): Promise<PractitionerReviewInfo> {
263
+ console.log(
264
+ `[ReviewsAggregationService] Updating review info for practitioner: ${practitionerId}`
265
+ );
266
+
267
+ // Get the current practitioner document
268
+ const practitionerDoc = await this.db
269
+ .collection(PRACTITIONERS_COLLECTION)
270
+ .doc(practitionerId)
271
+ .get();
272
+
273
+ if (!practitionerDoc.exists) {
274
+ console.error(
275
+ `[ReviewsAggregationService] Practitioner with ID ${practitionerId} not found`
276
+ );
277
+ throw new Error(`Practitioner with ID ${practitionerId} not found`);
278
+ }
279
+
280
+ const practitionerData = practitionerDoc.data();
281
+ const currentReviewInfo =
282
+ (practitionerData?.reviewInfo as PractitionerReviewInfo) || {
283
+ totalReviews: 0,
284
+ averageRating: 0,
285
+ knowledgeAndExpertise: 0,
286
+ communicationSkills: 0,
287
+ bedSideManner: 0,
288
+ thoroughness: 0,
289
+ trustworthiness: 0,
290
+ recommendationPercentage: 0,
291
+ };
292
+
293
+ // Get all reviews for this practitioner
294
+ const reviewsQuery = await this.db
295
+ .collection(REVIEWS_COLLECTION)
296
+ .where("practitionerReview.practitionerId", "==", practitionerId)
297
+ .get();
298
+
299
+ // If we're removing the last review or there are no reviews, set default values
300
+ if ((isRemoval && reviewsQuery.size <= 1) || reviewsQuery.empty) {
301
+ const updatedReviewInfo: PractitionerReviewInfo = {
302
+ totalReviews: 0,
303
+ averageRating: 0,
304
+ knowledgeAndExpertise: 0,
305
+ communicationSkills: 0,
306
+ bedSideManner: 0,
307
+ thoroughness: 0,
308
+ trustworthiness: 0,
309
+ recommendationPercentage: 0,
310
+ };
311
+
312
+ await this.db
313
+ .collection(PRACTITIONERS_COLLECTION)
314
+ .doc(practitionerId)
315
+ .update({
316
+ reviewInfo: updatedReviewInfo,
317
+ updatedAt: admin.firestore.FieldValue.serverTimestamp(),
318
+ });
319
+
320
+ // Also update doctor info in procedures with the new rating
321
+ await this.updateDoctorInfoInProcedures(practitionerId, 0);
322
+
323
+ console.log(
324
+ `[ReviewsAggregationService] Reset review info for practitioner: ${practitionerId}`
325
+ );
326
+ return updatedReviewInfo;
327
+ }
328
+
329
+ // Calculate new averages from all reviews
330
+ const reviews = reviewsQuery.docs.map((doc) => doc.data() as Review);
331
+ const practitionerReviews = reviews
332
+ .map((review) => review.practitionerReview)
333
+ .filter((review): review is PractitionerReview => review !== undefined);
334
+
335
+ // Calculate averages
336
+ let totalRating = 0;
337
+ let totalKnowledgeAndExpertise = 0;
338
+ let totalCommunicationSkills = 0;
339
+ let totalBedSideManner = 0;
340
+ let totalThoroughness = 0;
341
+ let totalTrustworthiness = 0;
342
+ let totalRecommendations = 0;
343
+
344
+ practitionerReviews.forEach((review) => {
345
+ totalRating += review.overallRating;
346
+ totalKnowledgeAndExpertise += review.knowledgeAndExpertise;
347
+ totalCommunicationSkills += review.communicationSkills;
348
+ totalBedSideManner += review.bedSideManner;
349
+ totalThoroughness += review.thoroughness;
350
+ totalTrustworthiness += review.trustworthiness;
351
+ if (review.wouldRecommend) totalRecommendations++;
352
+ });
353
+
354
+ const count = practitionerReviews.length;
355
+ const roundToOneDecimal = (value: number): number =>
356
+ Math.round((value / count) * 10) / 10;
357
+
358
+ const updatedReviewInfo: PractitionerReviewInfo = {
359
+ totalReviews: count,
360
+ averageRating: roundToOneDecimal(totalRating),
361
+ knowledgeAndExpertise: roundToOneDecimal(totalKnowledgeAndExpertise),
362
+ communicationSkills: roundToOneDecimal(totalCommunicationSkills),
363
+ bedSideManner: roundToOneDecimal(totalBedSideManner),
364
+ thoroughness: roundToOneDecimal(totalThoroughness),
365
+ trustworthiness: roundToOneDecimal(totalTrustworthiness),
366
+ recommendationPercentage:
367
+ Math.round((totalRecommendations / count) * 1000) / 10,
368
+ };
369
+
370
+ // Update the practitioner with the new review info
371
+ await this.db
372
+ .collection(PRACTITIONERS_COLLECTION)
373
+ .doc(practitionerId)
374
+ .update({
375
+ reviewInfo: updatedReviewInfo,
376
+ updatedAt: admin.firestore.FieldValue.serverTimestamp(),
377
+ });
378
+
379
+ // Also update doctor info in procedures with the new rating
380
+ await this.updateDoctorInfoInProcedures(
381
+ practitionerId,
382
+ updatedReviewInfo.averageRating
383
+ );
384
+
385
+ console.log(
386
+ `[ReviewsAggregationService] Updated review info for practitioner: ${practitionerId}`
387
+ );
388
+ return updatedReviewInfo;
389
+ }
390
+
391
+ /**
392
+ * Updates the review info for a procedure
393
+ * @param procedureId The ID of the procedure to update
394
+ * @param removedReview Optional review being removed
395
+ * @param isRemoval Whether this update is for a review removal
396
+ * @returns The updated procedure review info
397
+ */
398
+ async updateProcedureReviewInfo(
399
+ procedureId: string,
400
+ removedReview?: ProcedureReview,
401
+ isRemoval: boolean = false
402
+ ): Promise<ProcedureReviewInfo> {
403
+ console.log(
404
+ `[ReviewsAggregationService] Updating review info for procedure: ${procedureId}`
405
+ );
406
+
407
+ // Get the current procedure document
408
+ const procedureDoc = await this.db
409
+ .collection(PROCEDURES_COLLECTION)
410
+ .doc(procedureId)
411
+ .get();
412
+
413
+ if (!procedureDoc.exists) {
414
+ console.error(
415
+ `[ReviewsAggregationService] Procedure with ID ${procedureId} not found`
416
+ );
417
+ throw new Error(`Procedure with ID ${procedureId} not found`);
418
+ }
419
+
420
+ const procedureData = procedureDoc.data();
421
+ const currentReviewInfo =
422
+ (procedureData?.reviewInfo as ProcedureReviewInfo) || {
423
+ totalReviews: 0,
424
+ averageRating: 0,
425
+ effectivenessOfTreatment: 0,
426
+ outcomeExplanation: 0,
427
+ painManagement: 0,
428
+ followUpCare: 0,
429
+ valueForMoney: 0,
430
+ recommendationPercentage: 0,
431
+ };
432
+
433
+ // Get all reviews for this procedure
434
+ const reviewsQuery = await this.db
435
+ .collection(REVIEWS_COLLECTION)
436
+ .where("procedureReview.procedureId", "==", procedureId)
437
+ .get();
438
+
439
+ // If we're removing the last review or there are no reviews, set default values
440
+ if ((isRemoval && reviewsQuery.size <= 1) || reviewsQuery.empty) {
441
+ const updatedReviewInfo: ProcedureReviewInfo = {
442
+ totalReviews: 0,
443
+ averageRating: 0,
444
+ effectivenessOfTreatment: 0,
445
+ outcomeExplanation: 0,
446
+ painManagement: 0,
447
+ followUpCare: 0,
448
+ valueForMoney: 0,
449
+ recommendationPercentage: 0,
450
+ };
451
+
452
+ await this.db.collection(PROCEDURES_COLLECTION).doc(procedureId).update({
453
+ reviewInfo: updatedReviewInfo,
454
+ updatedAt: admin.firestore.FieldValue.serverTimestamp(),
455
+ });
456
+
457
+ console.log(
458
+ `[ReviewsAggregationService] Reset review info for procedure: ${procedureId}`
459
+ );
460
+ return updatedReviewInfo;
461
+ }
462
+
463
+ // Calculate new averages from all reviews
464
+ const reviews = reviewsQuery.docs.map((doc) => doc.data() as Review);
465
+ const procedureReviews = reviews
466
+ .map((review) => review.procedureReview)
467
+ .filter((review): review is ProcedureReview => review !== undefined);
468
+
469
+ // Calculate averages
470
+ let totalRating = 0;
471
+ let totalEffectivenessOfTreatment = 0;
472
+ let totalOutcomeExplanation = 0;
473
+ let totalPainManagement = 0;
474
+ let totalFollowUpCare = 0;
475
+ let totalValueForMoney = 0;
476
+ let totalRecommendations = 0;
477
+
478
+ procedureReviews.forEach((review) => {
479
+ totalRating += review.overallRating;
480
+ totalEffectivenessOfTreatment += review.effectivenessOfTreatment;
481
+ totalOutcomeExplanation += review.outcomeExplanation;
482
+ totalPainManagement += review.painManagement;
483
+ totalFollowUpCare += review.followUpCare;
484
+ totalValueForMoney += review.valueForMoney;
485
+ if (review.wouldRecommend) totalRecommendations++;
486
+ });
487
+
488
+ const count = procedureReviews.length;
489
+ const roundToOneDecimal = (value: number): number =>
490
+ Math.round((value / count) * 10) / 10;
491
+
492
+ const updatedReviewInfo: ProcedureReviewInfo = {
493
+ totalReviews: count,
494
+ averageRating: roundToOneDecimal(totalRating),
495
+ effectivenessOfTreatment: roundToOneDecimal(
496
+ totalEffectivenessOfTreatment
497
+ ),
498
+ outcomeExplanation: roundToOneDecimal(totalOutcomeExplanation),
499
+ painManagement: roundToOneDecimal(totalPainManagement),
500
+ followUpCare: roundToOneDecimal(totalFollowUpCare),
501
+ valueForMoney: roundToOneDecimal(totalValueForMoney),
502
+ recommendationPercentage:
503
+ Math.round((totalRecommendations / count) * 1000) / 10,
504
+ };
505
+
506
+ // Update the procedure with the new review info
507
+ await this.db.collection(PROCEDURES_COLLECTION).doc(procedureId).update({
508
+ reviewInfo: updatedReviewInfo,
509
+ updatedAt: admin.firestore.FieldValue.serverTimestamp(),
510
+ });
511
+
512
+ console.log(
513
+ `[ReviewsAggregationService] Updated review info for procedure: ${procedureId}`
514
+ );
515
+ return updatedReviewInfo;
516
+ }
517
+
518
+ /**
519
+ * Updates doctorInfo rating in all procedures for a practitioner
520
+ * @param practitionerId The ID of the practitioner
521
+ * @param rating The new rating to set
522
+ */
523
+ private async updateDoctorInfoInProcedures(
524
+ practitionerId: string,
525
+ rating: number
526
+ ): Promise<void> {
527
+ console.log(
528
+ `[ReviewsAggregationService] Updating doctor info in procedures for practitioner: ${practitionerId}`
529
+ );
530
+
531
+ // Find all procedures for this practitioner
532
+ const proceduresQuery = await this.db
533
+ .collection(PROCEDURES_COLLECTION)
534
+ .where("practitionerId", "==", practitionerId)
535
+ .get();
536
+
537
+ if (proceduresQuery.empty) {
538
+ console.log(
539
+ `[ReviewsAggregationService] No procedures found for practitioner: ${practitionerId}`
540
+ );
541
+ return;
542
+ }
543
+
544
+ // Batch update all procedures
545
+ const batch = this.db.batch();
546
+
547
+ proceduresQuery.docs.forEach((docSnapshot) => {
548
+ const procedureRef = this.db
549
+ .collection(PROCEDURES_COLLECTION)
550
+ .doc(docSnapshot.id);
551
+ batch.update(procedureRef, {
552
+ "doctorInfo.rating": rating,
553
+ updatedAt: admin.firestore.FieldValue.serverTimestamp(),
554
+ });
555
+ });
556
+
557
+ await batch.commit();
558
+ console.log(
559
+ `[ReviewsAggregationService] Updated doctor info in ${proceduresQuery.size} procedures for practitioner: ${practitionerId}`
560
+ );
561
+ }
562
+
563
+ /**
564
+ * Verifies a review as checked by admin/staff
565
+ * @param reviewId The ID of the review to verify
566
+ */
567
+ async verifyReview(reviewId: string): Promise<void> {
568
+ console.log(`[ReviewsAggregationService] Verifying review: ${reviewId}`);
569
+
570
+ // Get the review
571
+ const reviewDoc = await this.db
572
+ .collection(REVIEWS_COLLECTION)
573
+ .doc(reviewId)
574
+ .get();
575
+
576
+ if (!reviewDoc.exists) {
577
+ console.error(
578
+ `[ReviewsAggregationService] Review with ID ${reviewId} not found`
579
+ );
580
+ throw new Error(`Review with ID ${reviewId} not found`);
581
+ }
582
+
583
+ const review = reviewDoc.data() as Review;
584
+ const batch = this.db.batch();
585
+ const reviewRef = this.db.collection(REVIEWS_COLLECTION).doc(reviewId);
586
+
587
+ // Update clinic review if it exists
588
+ if (review.clinicReview) {
589
+ review.clinicReview.isVerified = true;
590
+ }
591
+
592
+ // Update practitioner review if it exists
593
+ if (review.practitionerReview) {
594
+ review.practitionerReview.isVerified = true;
595
+ }
596
+
597
+ // Update procedure review if it exists
598
+ if (review.procedureReview) {
599
+ review.procedureReview.isVerified = true;
600
+ }
601
+
602
+ // Update the review
603
+ batch.update(reviewRef, {
604
+ clinicReview: review.clinicReview,
605
+ practitionerReview: review.practitionerReview,
606
+ procedureReview: review.procedureReview,
607
+ updatedAt: admin.firestore.FieldValue.serverTimestamp(),
608
+ });
609
+
610
+ await batch.commit();
611
+ console.log(
612
+ `[ReviewsAggregationService] Successfully verified review: ${reviewId}`
613
+ );
614
+ }
615
+
616
+ /**
617
+ * Calculate the average of all reviews for an entity
618
+ * @param entityId The entity ID
619
+ * @param entityType The type of entity ('clinic', 'practitioner', or 'procedure')
620
+ * @returns Promise that resolves to the calculated review info
621
+ */
622
+ async calculateEntityReviewInfo(
623
+ entityId: string,
624
+ entityType: "clinic" | "practitioner" | "procedure"
625
+ ): Promise<ClinicReviewInfo | PractitionerReviewInfo | ProcedureReviewInfo> {
626
+ console.log(
627
+ `[ReviewsAggregationService] Calculating review info for ${entityType}: ${entityId}`
628
+ );
629
+
630
+ switch (entityType) {
631
+ case "clinic":
632
+ return this.updateClinicReviewInfo(entityId);
633
+ case "practitioner":
634
+ return this.updatePractitionerReviewInfo(entityId);
635
+ case "procedure":
636
+ return this.updateProcedureReviewInfo(entityId);
637
+ default:
638
+ throw new Error(`Invalid entity type: ${entityType}`);
639
+ }
640
+ }
641
+ }