@blackcode_sa/metaestetics-api 1.12.41 → 1.12.43

package/src/backoffice/services/category.service.ts

@@ -231,4 +231,88 @@ export class CategoryService extends BaseService implements ICategoryService {
       ...docSnap.data(),
     } as Category;
   }
+
+  /**
+   * Exports categories to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   * By default exports only active categories (set includeInactive to true to export all).
+   */
+  async exportToCsv(options?: {
+    includeInactive?: boolean;
+    includeBom?: boolean;
+  }): Promise<string> {
+    const includeInactive = options?.includeInactive ?? false;
+    const includeBom = options?.includeBom ?? true;
+
+    const headers = [
+      "id",
+      "name",
+      "description",
+      "family",
+      "isActive",
+    ];
+
+    const rows: string[] = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+
+    const PAGE_SIZE = 1000;
+    let cursor: any | undefined;
+
+    // Build base constraints
+    const constraints: any[] = [];
+    if (!includeInactive) {
+      constraints.push(where("isActive", "==", true));
+    }
+    constraints.push(orderBy("name"));
+
+    // Page through all results
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+      const queryConstraints: any[] = [...constraints, limit(PAGE_SIZE)];
+      if (cursor) queryConstraints.push(startAfter(cursor));
+
+      const q = query(this.categoriesRef, ...queryConstraints);
+      const snapshot = await getDocs(q);
+      if (snapshot.empty) break;
+
+      for (const d of snapshot.docs) {
+        const category = ({ id: d.id, ...d.data() } as unknown) as Category;
+        rows.push(this.categoryToCsvRow(category));
+      }
+
+      cursor = snapshot.docs[snapshot.docs.length - 1];
+      if (snapshot.size < PAGE_SIZE) break;
+    }
+
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+
+  private categoryToCsvRow(category: Category): string {
+    const values = [
+      category.id ?? "",
+      category.name ?? "",
+      category.description ?? "",
+      category.family ?? "",
+      String(category.isActive ?? ""),
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+
+  private formatDateIso(value: any): string {
+    // Firestore timestamps may come back as Date or Timestamp; handle both
+    if (value instanceof Date) return value.toISOString();
+    if (value && typeof value.toDate === "function") {
+      const d = value.toDate();
+      return d instanceof Date ? d.toISOString() : String(value);
+    }
+    return String(value ?? "");
+  }
+
+  private formatCsvValue(value: any): string {
+    const str = value === null || value === undefined ? "" : String(value);
+    // Escape double quotes by doubling them and wrap in quotes
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 }

package/src/backoffice/services/constants.service.ts

@@ -305,4 +305,81 @@ export class ConstantsService extends BaseService {
       contraindications: arrayRemove(toRemove),
     });
   }
+
+  // =================================================================
+  // CSV Export Methods
+  // =================================================================
+
+  /**
+   * Exports treatment benefits to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   */
+  async exportBenefitsToCsv(options?: {
+    includeBom?: boolean;
+  }): Promise<string> {
+    const includeBom = options?.includeBom ?? true;
+
+    const headers = ["id", "name", "description"];
+
+    const rows: string[] = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+
+    const benefits = await this.getAllBenefitsForFilter();
+
+    for (const benefit of benefits) {
+      rows.push(this.benefitToCsvRow(benefit));
+    }
+
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+
+  /**
+   * Exports contraindications to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   */
+  async exportContraindicationsToCsv(options?: {
+    includeBom?: boolean;
+  }): Promise<string> {
+    const includeBom = options?.includeBom ?? true;
+
+    const headers = ["id", "name", "description"];
+
+    const rows: string[] = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+
+    const contraindications = await this.getAllContraindicationsForFilter();
+
+    for (const contraindication of contraindications) {
+      rows.push(this.contraindicationToCsvRow(contraindication));
+    }
+
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+
+  private benefitToCsvRow(benefit: TreatmentBenefitDynamic): string {
+    const values = [
+      benefit.id ?? "",
+      benefit.name ?? "",
+      benefit.description ?? "",
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+
+  private contraindicationToCsvRow(contraindication: ContraindicationDynamic): string {
+    const values = [
+      contraindication.id ?? "",
+      contraindication.name ?? "",
+      contraindication.description ?? "",
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+
+  private formatCsvValue(value: any): string {
+    const str = value === null || value === undefined ? "" : String(value);
+    // Escape double quotes by doubling them and wrap in quotes
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 }

package/src/backoffice/services/product.service.ts

@@ -134,9 +134,8 @@ export class ProductService extends BaseService implements IProductService {
   }
 
   /**
-   * Gets counts of active products grouped by technology.
-   * NOTE: Only counts top-level collection to avoid duplication during migration.
-   * Categories/subcategories not available in top-level structure.
+   * Gets counts of active products grouped by category, subcategory, and technology.
+   * Queries technology subcollections which have the legacy fields synced by Cloud Functions.
    */
   async getProductCounts(): Promise<{
     byCategory: Record<string, number>;
@@ -149,18 +148,22 @@ export class ProductService extends BaseService implements IProductService {
       byTechnology: {} as Record<string, number>,
     };
 
-    // Query top-level collection only (to avoid duplication during migration)
-    const q = query(this.getTopLevelProductsRef(), where('isActive', '==', true));
+    // Query technology subcollections (which have synced legacy fields)
+    const q = query(collectionGroup(this.db, PRODUCTS_COLLECTION), where('isActive', '==', true));
     const snapshot = await getDocs(q);
 
     snapshot.docs.forEach(doc => {
       const product = doc.data() as Product;
       
-      // Count by technology using assignedTechnologyIds
-      if (product.assignedTechnologyIds && Array.isArray(product.assignedTechnologyIds)) {
-        product.assignedTechnologyIds.forEach(techId => {
-          counts.byTechnology[techId] = (counts.byTechnology[techId] || 0) + 1;
-        });
+      // Use legacy fields from subcollections
+      if (product.categoryId) {
+        counts.byCategory[product.categoryId] = (counts.byCategory[product.categoryId] || 0) + 1;
+      }
+      if (product.subcategoryId) {
+        counts.bySubcategory[product.subcategoryId] = (counts.bySubcategory[product.subcategoryId] || 0) + 1;
+      }
+      if (product.technologyId) {
+        counts.byTechnology[product.technologyId] = (counts.byTechnology[product.technologyId] || 0) + 1;
       }
     });
 
@@ -447,4 +450,104 @@ export class ProductService extends BaseService implements IProductService {
         } as Product),
     );
   }
+
+  /**
+   * Exports products to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   * By default exports only active products (set includeInactive to true to export all).
+   */
+  async exportToCsv(options?: {
+    includeInactive?: boolean;
+    includeBom?: boolean;
+  }): Promise<string> {
+    const includeInactive = options?.includeInactive ?? false;
+    const includeBom = options?.includeBom ?? true;
+
+    const headers = [
+      "id",
+      "name",
+      "brandId",
+      "brandName",
+      "assignedTechnologyIds",
+      "description",
+      "technicalDetails",
+      "dosage",
+      "composition",
+      "indications",
+      "contraindications",
+      "warnings",
+      "isActive",
+    ];
+
+    const rows: string[] = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+
+    const PAGE_SIZE = 1000;
+    let cursor: any | undefined;
+
+    // Build base constraints
+    const constraints: QueryConstraint[] = [];
+    if (!includeInactive) {
+      constraints.push(where("isActive", "==", true));
+    }
+    constraints.push(orderBy("name"));
+
+    // Page through all results from top-level collection
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+      const queryConstraints: QueryConstraint[] = [...constraints, limit(PAGE_SIZE)];
+      if (cursor) queryConstraints.push(startAfter(cursor));
+
+      const q = query(this.getTopLevelProductsRef(), ...queryConstraints);
+      const snapshot = await getDocs(q);
+      if (snapshot.empty) break;
+
+      for (const d of snapshot.docs) {
+        const product = ({ id: d.id, ...d.data() } as unknown) as Product;
+        rows.push(this.productToCsvRow(product));
+      }
+
+      cursor = snapshot.docs[snapshot.docs.length - 1];
+      if (snapshot.size < PAGE_SIZE) break;
+    }
+
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+
+  private productToCsvRow(product: Product): string {
+    const values = [
+      product.id ?? "",
+      product.name ?? "",
+      product.brandId ?? "",
+      product.brandName ?? "",
+      product.assignedTechnologyIds?.join(";") ?? "",
+      product.description ?? "",
+      product.technicalDetails ?? "",
+      product.dosage ?? "",
+      product.composition ?? "",
+      product.indications?.join(";") ?? "",
+      product.contraindications?.map(c => c.name).join(";") ?? "",
+      product.warnings?.join(";") ?? "",
+      String(product.isActive ?? ""),
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+
+  private formatDateIso(value: any): string {
+    // Firestore timestamps may come back as Date or Timestamp; handle both
+    if (value instanceof Date) return value.toISOString();
+    if (value && typeof value.toDate === "function") {
+      const d = value.toDate();
+      return d instanceof Date ? d.toISOString() : String(value);
+    }
+    return String(value ?? "");
+  }
+
+  private formatCsvValue(value: any): string {
+    const str = value === null || value === undefined ? "" : String(value);
+    // Escape double quotes by doubling them and wrap in quotes
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 }

package/src/backoffice/services/requirement.service.ts

@@ -7,6 +7,7 @@ import {
   query,
   updateDoc,
   where,
+  orderBy,
 } from "firebase/firestore";
 import {
   Requirement,
@@ -156,4 +157,79 @@ export class RequirementService extends BaseService {
       ...docSnap.data(),
     } as Requirement;
   }
+
+  /**
+   * Exports requirements to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   * By default exports only active requirements (set includeInactive to true to export all).
+   */
+  async exportToCsv(options?: {
+    includeInactive?: boolean;
+    includeBom?: boolean;
+  }): Promise<string> {
+    const includeInactive = options?.includeInactive ?? false;
+    const includeBom = options?.includeBom ?? true;
+
+    const headers = [
+      "id",
+      "type",
+      "name",
+      "description",
+      "timeframe_duration",
+      "timeframe_unit",
+      "timeframe_notifyAt",
+      "importance",
+      "isActive",
+    ];
+
+    const rows: string[] = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+
+    // Get all requirements (they're not paginated in the original service)
+    const q = includeInactive
+      ? query(this.requirementsRef, orderBy("name"))
+      : query(this.requirementsRef, where("isActive", "==", true), orderBy("name"));
+    
+    const snapshot = await getDocs(q);
+
+    for (const d of snapshot.docs) {
+      const requirement = ({ id: d.id, ...d.data() } as unknown) as Requirement;
+      rows.push(this.requirementToCsvRow(requirement));
+    }
+
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+
+  private requirementToCsvRow(requirement: Requirement): string {
+    const values = [
+      requirement.id ?? "",
+      requirement.type ?? "",
+      requirement.name ?? "",
+      requirement.description ?? "",
+      requirement.timeframe?.duration?.toString() ?? "",
+      requirement.timeframe?.unit ?? "",
+      requirement.timeframe?.notifyAt?.join(";") ?? "",
+      requirement.importance ?? "",
+      String(requirement.isActive ?? ""),
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+
+  private formatDateIso(value: any): string {
+    // Firestore timestamps may come back as Date or Timestamp; handle both
+    if (value instanceof Date) return value.toISOString();
+    if (value && typeof value.toDate === "function") {
+      const d = value.toDate();
+      return d instanceof Date ? d.toISOString() : String(value);
+    }
+    return String(value ?? "");
+  }
+
+  private formatCsvValue(value: any): string {
+    const str = value === null || value === undefined ? "" : String(value);
+    // Escape double quotes by doubling them and wrap in quotes
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 }

package/src/backoffice/services/subcategory.service.ts

@@ -305,4 +305,91 @@ export class SubcategoryService extends BaseService {
       ...docSnap.data(),
     } as Subcategory;
   }
+
+  /**
+   * Exports subcategories to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   * By default exports only active subcategories (set includeInactive to true to export all).
+   */
+  async exportToCsv(options?: {
+    includeInactive?: boolean;
+    includeBom?: boolean;
+  }): Promise<string> {
+    const includeInactive = options?.includeInactive ?? false;
+    const includeBom = options?.includeBom ?? true;
+
+    const headers = [
+      "id",
+      "name",
+      "categoryId",
+      "description",
+      "isActive",
+    ];
+
+    const rows: string[] = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+
+    const PAGE_SIZE = 1000;
+    let cursor: any | undefined;
+
+    // Build base constraints
+    const constraints: any[] = [];
+    if (!includeInactive) {
+      constraints.push(where("isActive", "==", true));
+    }
+    constraints.push(orderBy("name"));
+
+    // Page through all results using collectionGroup
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+      const queryConstraints: any[] = [...constraints, limit(PAGE_SIZE)];
+      if (cursor) queryConstraints.push(startAfter(cursor));
+
+      const q = query(
+        collectionGroup(this.db, SUBCATEGORIES_COLLECTION),
+        ...queryConstraints
+      );
+      const snapshot = await getDocs(q);
+      if (snapshot.empty) break;
+
+      for (const d of snapshot.docs) {
+        const subcategory = ({ id: d.id, ...d.data() } as unknown) as Subcategory;
+        rows.push(this.subcategoryToCsvRow(subcategory));
+      }
+
+      cursor = snapshot.docs[snapshot.docs.length - 1];
+      if (snapshot.size < PAGE_SIZE) break;
+    }
+
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+
+  private subcategoryToCsvRow(subcategory: Subcategory): string {
+    const values = [
+      subcategory.id ?? "",
+      subcategory.name ?? "",
+      subcategory.categoryId ?? "",
+      subcategory.description ?? "",
+      String(subcategory.isActive ?? ""),
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+
+  private formatDateIso(value: any): string {
+    // Firestore timestamps may come back as Date or Timestamp; handle both
+    if (value instanceof Date) return value.toISOString();
+    if (value && typeof value.toDate === "function") {
+      const d = value.toDate();
+      return d instanceof Date ? d.toISOString() : String(value);
+    }
+    return String(value ?? "");
+  }
+
+  private formatCsvValue(value: any): string {
+    const str = value === null || value === undefined ? "" : String(value);
+    // Escape double quotes by doubling them and wrap in quotes
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 }

package/src/backoffice/services/technology.service.ts

@@ -16,6 +16,7 @@ import {
   arrayRemove,
   Firestore,
   writeBatch,
+  QueryConstraint,
 } from 'firebase/firestore';
 import { Technology, TECHNOLOGIES_COLLECTION, ITechnologyService } from '../types/technology.types';
 import { Requirement, RequirementType } from '../types/requirement.types';
@@ -242,7 +243,25 @@ export class TechnologyService extends BaseService implements ITechnologyService
     updateData.updatedAt = new Date();
 
     const docRef = doc(this.technologiesRef, id);
+    
+    // Get the technology before update to check what changed
+    const beforeTech = await this.getById(id);
+    
     await updateDoc(docRef, updateData);
+    
+    // If categoryId, subcategoryId, or name changed, update all products in subcollection
+    const categoryChanged = beforeTech && updateData.categoryId && beforeTech.categoryId !== updateData.categoryId;
+    const subcategoryChanged = beforeTech && updateData.subcategoryId && beforeTech.subcategoryId !== updateData.subcategoryId;
+    const nameChanged = beforeTech && updateData.name && beforeTech.name !== updateData.name;
+    
+    if (categoryChanged || subcategoryChanged || nameChanged) {
+      await this.updateProductsInSubcollection(id, {
+        categoryId: updateData.categoryId,
+        subcategoryId: updateData.subcategoryId,
+        technologyName: updateData.name,
+      });
+    }
+    
     return this.getById(id);
   }
 
@@ -889,4 +908,163 @@ export class TechnologyService extends BaseService implements ITechnologyService
       byBrand,
     };
   }
+
+  /**
+   * Updates products in technology subcollection when technology metadata changes
+   * @param technologyId - ID of the technology
+   * @param updates - Fields to update (categoryId, subcategoryId, technologyName)
+   */
+  private async updateProductsInSubcollection(
+    technologyId: string,
+    updates: { categoryId?: string; subcategoryId?: string; technologyName?: string }
+  ): Promise<void> {
+    const productsRef = collection(this.db, TECHNOLOGIES_COLLECTION, technologyId, PRODUCTS_COLLECTION);
+    const productsSnapshot = await getDocs(productsRef);
+    
+    if (productsSnapshot.empty) {
+      return;
+    }
+    
+    const batch = writeBatch(this.db);
+    
+    for (const productDoc of productsSnapshot.docs) {
+      const productRef = productDoc.ref;
+      const updateFields: any = {};
+      
+      if (updates.categoryId !== undefined) {
+        updateFields.categoryId = updates.categoryId;
+      }
+      if (updates.subcategoryId !== undefined) {
+        updateFields.subcategoryId = updates.subcategoryId;
+      }
+      if (updates.technologyName !== undefined) {
+        updateFields.technologyName = updates.technologyName;
+      }
+      
+      if (Object.keys(updateFields).length > 0) {
+        batch.update(productRef, updateFields);
+      }
+    }
+    
+    await batch.commit();
+  }
+
+  /**
+   * Exports technologies to CSV string, suitable for Excel/Sheets.
+   * Includes headers and optional UTF-8 BOM.
+   * By default exports only active technologies (set includeInactive to true to export all).
+   * Includes product names from subcollections.
+   */
+  async exportToCsv(options?: {
+    includeInactive?: boolean;
+    includeBom?: boolean;
+  }): Promise<string> {
+    const includeInactive = options?.includeInactive ?? false;
+    const includeBom = options?.includeBom ?? true;
+
+    const headers = [
+      "id",
+      "name",
+      "description",
+      "family",
+      "categoryId",
+      "subcategoryId",
+      "technicalDetails",
+      "requirements_pre",
+      "requirements_post",
+      "blockingConditions",
+      "contraindications",
+      "benefits",
+      "certificationMinimumLevel",
+      "certificationRequiredSpecialties",
+      "documentationTemplateIds",
+      "productNames",
+      "isActive",
+    ];
+
+    const rows: string[] = [];
+    rows.push(headers.map((h) => this.formatCsvValue(h)).join(","));
+
+    const PAGE_SIZE = 1000;
+    let cursor: any | undefined;
+
+    // Build base constraints
+    const constraints: QueryConstraint[] = [];
+    if (!includeInactive) {
+      constraints.push(where("isActive", "==", true));
+    }
+    constraints.push(orderBy("name"));
+
+    // Page through all results
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+      const queryConstraints: QueryConstraint[] = [...constraints, limit(PAGE_SIZE)];
+      if (cursor) queryConstraints.push(startAfter(cursor));
+
+      const q = query(this.technologiesRef, ...queryConstraints);
+      const snapshot = await getDocs(q);
+      if (snapshot.empty) break;
+
+      for (const d of snapshot.docs) {
+        const technology = ({ id: d.id, ...d.data() } as unknown) as Technology;
+        // Fetch products for this technology
+        const productNames = await this.getProductNamesForTechnology(technology.id!);
+        rows.push(this.technologyToCsvRow(technology, productNames));
+      }
+
+      cursor = snapshot.docs[snapshot.docs.length - 1];
+      if (snapshot.size < PAGE_SIZE) break;
+    }
+
+    const csvBody = rows.join("\r\n");
+    return includeBom ? "\uFEFF" + csvBody : csvBody;
+  }
+
+  /**
+   * Gets product names from the technology's product subcollection
+   */
+  private async getProductNamesForTechnology(technologyId: string): Promise<string[]> {
+    try {
+      const productsRef = collection(this.db, TECHNOLOGIES_COLLECTION, technologyId, PRODUCTS_COLLECTION);
+      const q = query(productsRef, where("isActive", "==", true));
+      const snapshot = await getDocs(q);
+      return snapshot.docs.map(doc => {
+        const product = doc.data() as Product;
+        return product.name || "";
+      }).filter(name => name); // Filter out empty names
+    } catch (error) {
+      console.error(`Error fetching products for technology ${technologyId}:`, error);
+      return [];
+    }
+  }
+
+  private technologyToCsvRow(technology: Technology, productNames: string[] = []): string {
+    const values = [
+      technology.id ?? "",
+      technology.name ?? "",
+      technology.description ?? "",
+      technology.family ?? "",
+      technology.categoryId ?? "",
+      technology.subcategoryId ?? "",
+      technology.technicalDetails ?? "",
+      technology.requirements?.pre?.map(r => r.name).join(";") ?? "",
+      technology.requirements?.post?.map(r => r.name).join(";") ?? "",
+      technology.blockingConditions?.join(";") ?? "",
+      technology.contraindications?.map(c => c.name).join(";") ?? "",
+      technology.benefits?.map(b => b.name).join(";") ?? "",
+      technology.certificationRequirement?.minimumLevel ?? "",
+      technology.certificationRequirement?.requiredSpecialties?.join(";") ?? "",
+      technology.documentationTemplates?.map(t => t.templateId).join(";") ?? "",
+      productNames.join(";"),
+      String(technology.isActive ?? ""),
+    ];
+    return values.map((v) => this.formatCsvValue(v)).join(",");
+  }
+
+  private formatCsvValue(value: any): string {
+    const str = value === null || value === undefined ? "" : String(value);
+    // Escape double quotes by doubling them and wrap in quotes
+    const escaped = str.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
 }