@blackcode_sa/metaestetics-api 1.15.16 → 1.15.17-staging.1

package/src/backoffice/types/product.types.ts

@@ -1,239 +1,239 @@
-/**
- * Product used in procedures
- * Simplified structure with only essential fields and flexible metadata
- *
- * @property id - Unique identifier of the product
- * @property name - Name of the product
- * @property brandId - Reference to the Brand document ID
- * @property brandName - Display name of the brand (denormalized for performance)
- * @property description - Detailed description of the product
- * @property assignedTechnologyIds - Array of technology IDs this product is assigned to
- * @property metadata - Flexible key-value pairs for additional product information
- * @property isActive - Whether the product is active in the system
- * @property createdAt - Creation date
- * @property updatedAt - Last update date
- */
-export interface Product {
-  id?: string;
-  name: string;
-  brandId: string;                  // Reference to Brand document
-  brandName: string;                // Denormalized brand name for display
-  description: string;
-  category?: string;                // "Injectables", "Laser Devices", "Skincare", etc.
-  
-  // Technology assignment tracking
-  assignedTechnologyIds?: string[];
-  
-  // Flexible metadata for any additional information
-  metadata?: Record<string, string | number | boolean>;
-  
-  // System fields
-  isActive: boolean;
-  createdAt: Date;
-  updatedAt: Date;
-  
-  // LEGACY FIELDS: Only present in technology subcollections (/technologies/{id}/products/)
-  // These fields are synced by Cloud Functions for backward compatibility
-  // NOT stored in top-level /products collection
-  /** Present only in subcollections - synced from technology metadata */
-  technologyId?: string;
-  /** Present only in subcollections - synced from technology name */
-  technologyName?: string;
-  /** Present only in subcollections - synced from technology categoryId */
-  categoryId?: string;
-  /** Present only in subcollections - synced from technology subcategoryId */
-  subcategoryId?: string;
-}
-
-/**
- * Collection in Firestore database where products are stored
- */
-export const PRODUCTS_COLLECTION = 'products';
-
-/**
- * Interface for the ProductService class
- * 
- * NOTE: This interface maintains backward compatibility while adding new top-level collection methods.
- * Old methods using technologyId are kept for existing code, new methods work with top-level collection.
- */
-export interface IProductService {
-  // ==========================================
-  // NEW METHODS: Top-level collection (preferred)
-  // ==========================================
-  
-  /**
-   * Creates a new product in the top-level collection
-   * @param product - Product data
-   * @param technologyIds - Optional array of technology IDs to assign this product to
-   */
-  createTopLevel(
-    product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'assignedTechnologyIds'>,
-    technologyIds?: string[],
-  ): Promise<Product>;
-
-  /**
-   * Gets all products from the top-level collection
-   * @param options - Query options
-   */
-  getAllTopLevel(options: {
-    rowsPerPage: number;
-    lastVisible?: any;
-    brandId?: string;
-    category?: string;
-  }): Promise<{ products: Product[]; lastVisible: any }>;
-
-  /**
-   * Gets a product by ID from the top-level collection
-   * @param productId - ID of the product
-   */
-  getByIdTopLevel(productId: string): Promise<Product | null>;
-
-  /**
-   * Updates a product in the top-level collection
-   * @param productId - ID of the product to update
-   * @param product - Updated product data
-   */
-  updateTopLevel(
-    productId: string,
-    product: Partial<Omit<Product, 'id' | 'createdAt'>>,
-  ): Promise<Product | null>;
-
-  /**
-   * Deletes a product from the top-level collection (soft delete)
-   * @param productId - ID of the product to delete
-   */
-  deleteTopLevel(productId: string): Promise<void>;
-
-  /**
-   * Assigns a product to a technology
-   * @param productId - ID of the product
-   * @param technologyId - ID of the technology
-   */
-  assignToTechnology(productId: string, technologyId: string): Promise<void>;
-
-  /**
-   * Unassigns a product from a technology
-   * @param productId - ID of the product
-   * @param technologyId - ID of the technology
-   */
-  unassignFromTechnology(productId: string, technologyId: string): Promise<void>;
-
-  /**
-   * Gets products assigned to a specific technology
-   * @param technologyId - ID of the technology
-   */
-  getAssignedProducts(technologyId: string): Promise<Product[]>;
-
-  /**
-   * Gets products NOT assigned to a specific technology
-   * @param technologyId - ID of the technology
-   */
-  getUnassignedProducts(technologyId: string): Promise<Product[]>;
-
-  /**
-   * Gets all products for a brand
-   * @param brandId - ID of the brand
-   */
-  getByBrand(brandId: string): Promise<Product[]>;
-
-  /**
-   * Exports products to CSV format
-   * @param options - Export options
-   */
-  exportToCsv(options?: {
-    includeInactive?: boolean;
-    includeBom?: boolean;
-  }): Promise<string>;
-
-  // ==========================================
-  // DEPRECATED METHODS: Kept for backward compatibility
-  // ==========================================
-  
-  /**
-   * @deprecated Use createTopLevel instead
-   * Creates a new product
-   * @param technologyId - ID of the technology this product is used with
-   * @param brandId - ID of the brand that manufactures this product
-   * @param product - Product data
-   */
-  create(
-    technologyId: string,
-    brandId: string,
-    product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'brandId' | 'technologyId'>,
-  ): Promise<Product>;
-
-  /**
-   * @deprecated Use getAllTopLevel instead
-   * Gets a paginated list of all products, with optional filters.
-   */
-  getAll(options: {
-    rowsPerPage: number;
-    lastVisible?: any;
-    categoryId?: string;
-    subcategoryId?: string;
-    technologyId?: string;
-  }): Promise<{ products: Product[]; lastVisible: any }>;
-
-  /**
-   * @deprecated Use alternative counting methods
-   * Gets the total count of active products, with optional filters.
-   */
-  getProductsCount(options: {
-    categoryId?: string;
-    subcategoryId?: string;
-    technologyId?: string;
-  }): Promise<number>;
-
-  /**
-   * @deprecated Use alternative counting methods
-   * Gets counts of active products grouped by category, subcategory, and technology.
-   */
-  getProductCounts(): Promise<{
-    byCategory: Record<string, number>;
-    bySubcategory: Record<string, number>;
-    byTechnology: Record<string, number>;
-  }>;
-
-  /**
-   * @deprecated Use getAssignedProducts instead
-   * Gets all products for a specific technology (non-paginated, for filters/dropdowns)
-   * @param technologyId - ID of the technology
-   */
-  getAllByTechnology(technologyId: string): Promise<Product[]>;
-
-  /**
-   * @deprecated Use getByBrand instead
-   * Gets all products for a brand
-   * @param brandId - ID of the brand
-   */
-  getAllByBrand(brandId: string): Promise<Product[]>;
-
-  /**
-   * @deprecated Use updateTopLevel instead
-   * Updates a product
-   * @param technologyId - ID of the technology
-   * @param productId - ID of the product to update
-   * @param product - Updated product data
-   */
-  update(
-    technologyId: string,
-    productId: string,
-    product: Partial<Omit<Product, 'id' | 'createdAt' | 'brandId' | 'technologyId'>>,
-  ): Promise<Product | null>;
-
-  /**
-   * @deprecated Use deleteTopLevel instead
-   * Deletes a product (soft delete)
-   * @param technologyId - ID of the technology
-   * @param productId - ID of the product to delete
-   */
-  delete(technologyId: string, productId: string): Promise<void>;
-
-  /**
-   * @deprecated Use getByIdTopLevel instead
-   * Gets a product by ID
-   * @param technologyId - ID of the technology
-   * @param productId - ID of the product
-   */
-  getById(technologyId: string, productId: string): Promise<Product | null>;
-}
+/**
+ * Product used in procedures
+ * Simplified structure with only essential fields and flexible metadata
+ *
+ * @property id - Unique identifier of the product
+ * @property name - Name of the product
+ * @property brandId - Reference to the Brand document ID
+ * @property brandName - Display name of the brand (denormalized for performance)
+ * @property description - Detailed description of the product
+ * @property assignedTechnologyIds - Array of technology IDs this product is assigned to
+ * @property metadata - Flexible key-value pairs for additional product information
+ * @property isActive - Whether the product is active in the system
+ * @property createdAt - Creation date
+ * @property updatedAt - Last update date
+ */
+export interface Product {
+  id?: string;
+  name: string;
+  brandId: string;                  // Reference to Brand document
+  brandName: string;                // Denormalized brand name for display
+  description: string;
+  category?: string;                // "Injectables", "Laser Devices", "Skincare", etc.
+  
+  // Technology assignment tracking
+  assignedTechnologyIds?: string[];
+  
+  // Flexible metadata for any additional information
+  metadata?: Record<string, string | number | boolean>;
+  
+  // System fields
+  isActive: boolean;
+  createdAt: Date;
+  updatedAt: Date;
+  
+  // LEGACY FIELDS: Only present in technology subcollections (/technologies/{id}/products/)
+  // These fields are synced by Cloud Functions for backward compatibility
+  // NOT stored in top-level /products collection
+  /** Present only in subcollections - synced from technology metadata */
+  technologyId?: string;
+  /** Present only in subcollections - synced from technology name */
+  technologyName?: string;
+  /** Present only in subcollections - synced from technology categoryId */
+  categoryId?: string;
+  /** Present only in subcollections - synced from technology subcategoryId */
+  subcategoryId?: string;
+}
+
+/**
+ * Collection in Firestore database where products are stored
+ */
+export const PRODUCTS_COLLECTION = 'products';
+
+/**
+ * Interface for the ProductService class
+ * 
+ * NOTE: This interface maintains backward compatibility while adding new top-level collection methods.
+ * Old methods using technologyId are kept for existing code, new methods work with top-level collection.
+ */
+export interface IProductService {
+  // ==========================================
+  // NEW METHODS: Top-level collection (preferred)
+  // ==========================================
+  
+  /**
+   * Creates a new product in the top-level collection
+   * @param product - Product data
+   * @param technologyIds - Optional array of technology IDs to assign this product to
+   */
+  createTopLevel(
+    product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'assignedTechnologyIds'>,
+    technologyIds?: string[],
+  ): Promise<Product>;
+
+  /**
+   * Gets all products from the top-level collection
+   * @param options - Query options
+   */
+  getAllTopLevel(options: {
+    rowsPerPage: number;
+    lastVisible?: any;
+    brandId?: string;
+    category?: string;
+  }): Promise<{ products: Product[]; lastVisible: any }>;
+
+  /**
+   * Gets a product by ID from the top-level collection
+   * @param productId - ID of the product
+   */
+  getByIdTopLevel(productId: string): Promise<Product | null>;
+
+  /**
+   * Updates a product in the top-level collection
+   * @param productId - ID of the product to update
+   * @param product - Updated product data
+   */
+  updateTopLevel(
+    productId: string,
+    product: Partial<Omit<Product, 'id' | 'createdAt'>>,
+  ): Promise<Product | null>;
+
+  /**
+   * Deletes a product from the top-level collection (soft delete)
+   * @param productId - ID of the product to delete
+   */
+  deleteTopLevel(productId: string): Promise<void>;
+
+  /**
+   * Assigns a product to a technology
+   * @param productId - ID of the product
+   * @param technologyId - ID of the technology
+   */
+  assignToTechnology(productId: string, technologyId: string): Promise<void>;
+
+  /**
+   * Unassigns a product from a technology
+   * @param productId - ID of the product
+   * @param technologyId - ID of the technology
+   */
+  unassignFromTechnology(productId: string, technologyId: string): Promise<void>;
+
+  /**
+   * Gets products assigned to a specific technology
+   * @param technologyId - ID of the technology
+   */
+  getAssignedProducts(technologyId: string): Promise<Product[]>;
+
+  /**
+   * Gets products NOT assigned to a specific technology
+   * @param technologyId - ID of the technology
+   */
+  getUnassignedProducts(technologyId: string): Promise<Product[]>;
+
+  /**
+   * Gets all products for a brand
+   * @param brandId - ID of the brand
+   */
+  getByBrand(brandId: string): Promise<Product[]>;
+
+  /**
+   * Exports products to CSV format
+   * @param options - Export options
+   */
+  exportToCsv(options?: {
+    includeInactive?: boolean;
+    includeBom?: boolean;
+  }): Promise<string>;
+
+  // ==========================================
+  // DEPRECATED METHODS: Kept for backward compatibility
+  // ==========================================
+  
+  /**
+   * @deprecated Use createTopLevel instead
+   * Creates a new product
+   * @param technologyId - ID of the technology this product is used with
+   * @param brandId - ID of the brand that manufactures this product
+   * @param product - Product data
+   */
+  create(
+    technologyId: string,
+    brandId: string,
+    product: Omit<Product, 'id' | 'createdAt' | 'updatedAt' | 'brandId' | 'technologyId'>,
+  ): Promise<Product>;
+
+  /**
+   * @deprecated Use getAllTopLevel instead
+   * Gets a paginated list of all products, with optional filters.
+   */
+  getAll(options: {
+    rowsPerPage: number;
+    lastVisible?: any;
+    categoryId?: string;
+    subcategoryId?: string;
+    technologyId?: string;
+  }): Promise<{ products: Product[]; lastVisible: any }>;
+
+  /**
+   * @deprecated Use alternative counting methods
+   * Gets the total count of active products, with optional filters.
+   */
+  getProductsCount(options: {
+    categoryId?: string;
+    subcategoryId?: string;
+    technologyId?: string;
+  }): Promise<number>;
+
+  /**
+   * @deprecated Use alternative counting methods
+   * Gets counts of active products grouped by category, subcategory, and technology.
+   */
+  getProductCounts(): Promise<{
+    byCategory: Record<string, number>;
+    bySubcategory: Record<string, number>;
+    byTechnology: Record<string, number>;
+  }>;
+
+  /**
+   * @deprecated Use getAssignedProducts instead
+   * Gets all products for a specific technology (non-paginated, for filters/dropdowns)
+   * @param technologyId - ID of the technology
+   */
+  getAllByTechnology(technologyId: string): Promise<Product[]>;
+
+  /**
+   * @deprecated Use getByBrand instead
+   * Gets all products for a brand
+   * @param brandId - ID of the brand
+   */
+  getAllByBrand(brandId: string): Promise<Product[]>;
+
+  /**
+   * @deprecated Use updateTopLevel instead
+   * Updates a product
+   * @param technologyId - ID of the technology
+   * @param productId - ID of the product to update
+   * @param product - Updated product data
+   */
+  update(
+    technologyId: string,
+    productId: string,
+    product: Partial<Omit<Product, 'id' | 'createdAt' | 'brandId' | 'technologyId'>>,
+  ): Promise<Product | null>;
+
+  /**
+   * @deprecated Use deleteTopLevel instead
+   * Deletes a product (soft delete)
+   * @param technologyId - ID of the technology
+   * @param productId - ID of the product to delete
+   */
+  delete(technologyId: string, productId: string): Promise<void>;
+
+  /**
+   * @deprecated Use getByIdTopLevel instead
+   * Gets a product by ID
+   * @param technologyId - ID of the technology
+   * @param productId - ID of the product
+   */
+  getById(technologyId: string, productId: string): Promise<Product | null>;
+}

package/src/backoffice/types/requirement.types.ts

@@ -1,63 +1,63 @@
-/**
- * Jedinica mere za vremenski period
- */
-export enum TimeUnit {
-  HOURS = "hours",
-  DAYS = "days",
-}
-
-/**
- * Tip zahteva - da li se odnosi na period pre ili posle procedure
- */
-export enum RequirementType {
-  PRE = "pre",
-  POST = "post",
-}
-
-/**
- * Nivo važnosti zahteva
- */
-export type RequirementImportance = "low" | "medium" | "high";
-
-/**
- * Vremenski okvir za zahtev
- * @property duration - Trajanje u odabranoj jedinici vremena
- * @property unit - Jedinica vremena (sati ili dani)
- * @property notifyAt - Lista trenutaka kada treba poslati obaveštenje (u istoj jedinici)
- */
-export interface TimeFrame {
-  duration: number;
-  unit: TimeUnit;
-  notifyAt: number[];
-}
-
-/**
- * Zahtev koji se može povezati sa tehnologijom
- * Može biti zahtev pre procedure (pre) ili posle procedure (post)
- *
- * @property id - Jedinstveni identifikator zahteva
- * @property type - Tip zahteva (pre/post)
- * @property name - Naziv zahteva
- * @property description - Detaljan opis zahteva
- * @property timeframe - Vremenski okvir za zahtev
- * @property importance - Nivo važnosti zahteva
- * @property isActive - Da li je zahtev aktivan u sistemu
- * @property createdAt - Datum kreiranja
- * @property updatedAt - Datum poslednjeg ažuriranja
- */
-export interface Requirement {
-  id: string;
-  type: RequirementType;
-  name: string;
-  description: string;
-  timeframe: TimeFrame;
-  importance: RequirementImportance;
-  isActive: boolean;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-/**
- * Kolekcija u Firestore bazi gde se čuvaju globalni zahtevi
- */
-export const REQUIREMENTS_COLLECTION = "backoffice_requirements";
+/**
+ * Jedinica mere za vremenski period
+ */
+export enum TimeUnit {
+  HOURS = "hours",
+  DAYS = "days",
+}
+
+/**
+ * Tip zahteva - da li se odnosi na period pre ili posle procedure
+ */
+export enum RequirementType {
+  PRE = "pre",
+  POST = "post",
+}
+
+/**
+ * Nivo važnosti zahteva
+ */
+export type RequirementImportance = "low" | "medium" | "high";
+
+/**
+ * Vremenski okvir za zahtev
+ * @property duration - Trajanje u odabranoj jedinici vremena
+ * @property unit - Jedinica vremena (sati ili dani)
+ * @property notifyAt - Lista trenutaka kada treba poslati obaveštenje (u istoj jedinici)
+ */
+export interface TimeFrame {
+  duration: number;
+  unit: TimeUnit;
+  notifyAt: number[];
+}
+
+/**
+ * Zahtev koji se može povezati sa tehnologijom
+ * Može biti zahtev pre procedure (pre) ili posle procedure (post)
+ *
+ * @property id - Jedinstveni identifikator zahteva
+ * @property type - Tip zahteva (pre/post)
+ * @property name - Naziv zahteva
+ * @property description - Detaljan opis zahteva
+ * @property timeframe - Vremenski okvir za zahtev
+ * @property importance - Nivo važnosti zahteva
+ * @property isActive - Da li je zahtev aktivan u sistemu
+ * @property createdAt - Datum kreiranja
+ * @property updatedAt - Datum poslednjeg ažuriranja
+ */
+export interface Requirement {
+  id: string;
+  type: RequirementType;
+  name: string;
+  description: string;
+  timeframe: TimeFrame;
+  importance: RequirementImportance;
+  isActive: boolean;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+/**
+ * Kolekcija u Firestore bazi gde se čuvaju globalni zahtevi
+ */
+export const REQUIREMENTS_COLLECTION = "backoffice_requirements";

package/src/backoffice/types/static/README.md

@@ -1,18 +1,18 @@
-# Static Types
-
-This directory contains all static type definitions used throughout the backoffice application. These types are considered "static" because they represent data that is generally fixed and does not change frequently.
-
-## Available Types
-
-The following static types are available for import:
-
-- `BlockingCondition`: Defines conditions that may prevent a procedure.
-- `Certification`: Represents professional certifications.
-- `Contraindication`: Specifies conditions or factors that serve as a reason to withhold a certain medical treatment.
-- `Pricing`: Defines the structure for pricing information.
-- `ProcedureFamily`: Groups related medical procedures.
-- `TreatmentBenefit`: Describes the benefits of a treatment.
-
-## Usage
-
-All types in this directory are exported from the main `index.ts` file. You can import them directly from this module.
+# Static Types
+
+This directory contains all static type definitions used throughout the backoffice application. These types are considered "static" because they represent data that is generally fixed and does not change frequently.
+
+## Available Types
+
+The following static types are available for import:
+
+- `BlockingCondition`: Defines conditions that may prevent a procedure.
+- `Certification`: Represents professional certifications.
+- `Contraindication`: Specifies conditions or factors that serve as a reason to withhold a certain medical treatment.
+- `Pricing`: Defines the structure for pricing information.
+- `ProcedureFamily`: Groups related medical procedures.
+- `TreatmentBenefit`: Describes the benefits of a treatment.
+
+## Usage
+
+All types in this directory are exported from the main `index.ts` file. You can import them directly from this module.