tango-app-api-audio-analytics 1.0.31 → 1.0.32

package/COHORT_API_EXAMPLES.sh

@@ -1,235 +1,235 @@
-#!/bin/bash
-
-# Cohort API Test Examples
-# This file contains curl commands to test all cohort API endpoints
-
-BASE_URL="https://testtangoretail-api.tangoeye.ai/v3/audio-analitics"
-COHORT_ID="cohort_photochromatic_001"
-CLIENT_ID="11"
-
-# ==================== Helper Function ====================
-print_section() {
-  echo ""
-  echo "=================================="
-  echo "$1"
-  echo "=================================="
-}
-
-# ==================== 1. CREATE COHORT ====================
-print_section "1. CREATE COHORT"
-
-curl -X POST "$BASE_URL/cohorts" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "clientId": "11",
-    "cohortId": "cohort_photochromatic_001",
-    "cohortName": "Photochromatic",
-    "cohortDescription": "A strict evaluation of the photochromatic sales journey, focusing on pitch quality, technical accuracy, and customer sentiment",
-    "metrics": [
-      {
-        "metricId": "pitch_quality_001",
-        "metricName": "Standard Pitch Quality",
-        "metricDescription": "Identify which specific value propositions were explicitly used by the staff",
-        "hasContext": true,
-        "isNumneric": false,
-        "contexts": [
-          {
-            "contextName": "ONE_GLASS_ALL_NEEDS",
-            "priority": 2,
-            "description": "Convenience of one pair for all lighting"
-          },
-          {
-            "contextName": "TRAVEL_CONVENIENCE",
-            "priority": 2,
-            "description": "Specific benefits for bikers/commuters"
-          },
-          {
-            "contextName": "LIGHT_ADAPTATION",
-            "priority": 2,
-            "description": "Technical explanation of UV reaction"
-          },
-          {
-            "contextName": "REDUCES_EYE_STRAIN",
-            "priority": 2,
-            "description": "Glare and fatigue protection"
-          }
-        ]
-      },
-      {
-        "metricId": "technical_depth_score_001",
-        "metricName": "Technical Depth Score",
-        "metricDescription": "A numeric evaluation of the staff'\''s product knowledge during the pitch",
-        "hasContext": true,
-        "isNumneric": true,
-        "contexts": [
-          {
-            "minValue": 0,
-            "maxValue": 100
-          }
-        ]
-      },
-      {
-        "metricId": "customer_sentiment_001",
-        "metricName": "Initial Customer Sentiment",
-        "metricDescription": "The immediate reaction of the customer when the lens was introduced",
-        "hasContext": true,
-        "isNumneric": false,
-        "contexts": [
-          {
-            "contextName": "POSITIVE",
-            "priority": 2,
-            "description": "High interest or curiosity"
-          },
-          {
-            "contextName": "NEUTRAL",
-            "priority": 1,
-            "description": "Acknowledgment or price-focused only"
-          },
-          {
-            "contextName": "NEGATIVE",
-            "priority": 0,
-            "description": "Dismissive or disinterested"
-          }
-        ]
-      },
-      {
-        "metricId": "staff_responsiveness_001",
-        "metricName": "Staff Responsiveness",
-        "metricDescription": "How effectively were customer doubts addressed?",
-        "hasContext": true,
-        "isNumneric": false,
-        "contexts": [
-          {
-            "contextName": "FULLY_RESPONSIVE",
-            "priority": 2,
-            "description": "All doubts cleared with evidence"
-          },
-          {
-            "contextName": "PARTIALLY_RESPONSIVE",
-            "priority": 1,
-            "description": "Some doubts addressed, others ignored"
-          },
-          {
-            "contextName": "UNRESPONSIVE",
-            "priority": 0,
-            "description": "Customer doubts were dismissed"
-          }
-        ]
-      },
-      {
-        "metricId": "sales_outcome_001",
-        "metricName": "Final Sales Outcome",
-        "metricDescription": "The final commitment level reached at the end of the conversation",
-        "hasContext": true,
-        "isNumneric": false,
-        "contexts": [
-          {
-            "contextName": "BOUGHT_PHOTOCHROMATIC",
-            "priority": 2,
-            "description": "Customer agreed to the upgrade"
-          },
-          {
-            "contextName": "BOUGHT_SOMETHING_ELSE",
-            "priority": 0,
-            "description": "Bought standard lenses/frames only"
-          },
-          {
-            "contextName": "NO_SALE",
-            "priority": 0,
-            "description": "No purchase commitment"
-          }
-        ]
-      },
-      {
-        "metricId": "pitch_timing_summary_001",
-        "metricName": "Pitch Timing & Context",
-        "metricDescription": "Narrative summary of when and how the pitch was introduced",
-        "hasContext": false,
-        "isNumneric": false
-      }
-    ]
-  }'
-
-# ==================== 2. GET COHORT BY ID ====================
-print_section "2. GET COHORT BY ID"
-
-curl -X GET "$BASE_URL/cohorts/$COHORT_ID" \
-  -H "Content-Type: application/json"
-
-# ==================== 3. GET COHORTS BY CLIENT ====================
-print_section "3. GET COHORTS BY CLIENT"
-
-curl -X GET "$BASE_URL/cohorts/client/$CLIENT_ID?limit=10&offset=0" \
-  -H "Content-Type: application/json"
-
-# ==================== 4. SEARCH COHORTS ====================
-print_section "4. SEARCH COHORTS"
-
-curl -X POST "$BASE_URL/cohorts/search" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "clientId": "11",
-    "cohortName": "Photochrom",
-    "limit": 10,
-    "offset": 0
-  }'
-
-# ==================== 5. UPDATE COHORT ====================
-print_section "5. UPDATE COHORT"
-
-# Note: Replace DOCUMENT_ID with actual ID returned from create
-DOCUMENT_ID="550e8400-e29b-41d4-a716-446655440000"
-
-curl -X PUT "$BASE_URL/cohorts/$DOCUMENT_ID" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "cohortName": "Updated Photochromatic",
-    "cohortDescription": "Updated description for photochromatic cohort"
-  }'
-
-# ==================== 6. GET COHORT ANALYTICS ====================
-print_section "6. GET COHORT ANALYTICS"
-
-curl -X GET "$BASE_URL/cohorts/$COHORT_ID/analytics" \
-  -H "Content-Type: application/json"
-
-# ==================== 7. DELETE COHORT ====================
-print_section "7. DELETE COHORT"
-
-# Note: Replace DOCUMENT_ID with actual ID
-curl -X DELETE "$BASE_URL/cohorts/$DOCUMENT_ID" \
-  -H "Content-Type: application/json"
-
-# ==================== VALIDATION TESTS ====================
-print_section "VALIDATION TESTS"
-
-echo "Testing invalid cohort name (too short):"
-curl -X POST "$BASE_URL/cohorts" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "clientId": "11",
-    "cohortId": "invalid_test",
-    "cohortName": "AB",
-    "cohortDescription": "This should fail because name is too short"
-  }'
-
-echo ""
-echo "Testing missing required field:"
-curl -X POST "$BASE_URL/cohorts" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "clientId": "11",
-    "cohortId": "invalid_test",
-    "cohortName": "Valid Name"
-  }'
-
-echo ""
-echo "Testing invalid cohortId (special characters):"
-curl -X POST "$BASE_URL/cohorts" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "clientId": "11",
-    "cohortId": "invalid@test",
-    "cohortName": "Valid Name",
-    "cohortDescription": "This should fail because cohortId has invalid characters"
-  }'
+#!/bin/bash
+
+# Cohort API Test Examples
+# This file contains curl commands to test all cohort API endpoints
+
+BASE_URL="https://testtangoretail-api.tangoeye.ai/v3/audio-analitics"
+COHORT_ID="cohort_photochromatic_001"
+CLIENT_ID="11"
+
+# ==================== Helper Function ====================
+print_section() {
+  echo ""
+  echo "=================================="
+  echo "$1"
+  echo "=================================="
+}
+
+# ==================== 1. CREATE COHORT ====================
+print_section "1. CREATE COHORT"
+
+curl -X POST "$BASE_URL/cohorts" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "clientId": "11",
+    "cohortId": "cohort_photochromatic_001",
+    "cohortName": "Photochromatic",
+    "cohortDescription": "A strict evaluation of the photochromatic sales journey, focusing on pitch quality, technical accuracy, and customer sentiment",
+    "metrics": [
+      {
+        "metricId": "pitch_quality_001",
+        "metricName": "Standard Pitch Quality",
+        "metricDescription": "Identify which specific value propositions were explicitly used by the staff",
+        "hasContext": true,
+        "isNumneric": false,
+        "contexts": [
+          {
+            "contextName": "ONE_GLASS_ALL_NEEDS",
+            "priority": 2,
+            "description": "Convenience of one pair for all lighting"
+          },
+          {
+            "contextName": "TRAVEL_CONVENIENCE",
+            "priority": 2,
+            "description": "Specific benefits for bikers/commuters"
+          },
+          {
+            "contextName": "LIGHT_ADAPTATION",
+            "priority": 2,
+            "description": "Technical explanation of UV reaction"
+          },
+          {
+            "contextName": "REDUCES_EYE_STRAIN",
+            "priority": 2,
+            "description": "Glare and fatigue protection"
+          }
+        ]
+      },
+      {
+        "metricId": "technical_depth_score_001",
+        "metricName": "Technical Depth Score",
+        "metricDescription": "A numeric evaluation of the staff'\''s product knowledge during the pitch",
+        "hasContext": true,
+        "isNumneric": true,
+        "contexts": [
+          {
+            "minValue": 0,
+            "maxValue": 100
+          }
+        ]
+      },
+      {
+        "metricId": "customer_sentiment_001",
+        "metricName": "Initial Customer Sentiment",
+        "metricDescription": "The immediate reaction of the customer when the lens was introduced",
+        "hasContext": true,
+        "isNumneric": false,
+        "contexts": [
+          {
+            "contextName": "POSITIVE",
+            "priority": 2,
+            "description": "High interest or curiosity"
+          },
+          {
+            "contextName": "NEUTRAL",
+            "priority": 1,
+            "description": "Acknowledgment or price-focused only"
+          },
+          {
+            "contextName": "NEGATIVE",
+            "priority": 0,
+            "description": "Dismissive or disinterested"
+          }
+        ]
+      },
+      {
+        "metricId": "staff_responsiveness_001",
+        "metricName": "Staff Responsiveness",
+        "metricDescription": "How effectively were customer doubts addressed?",
+        "hasContext": true,
+        "isNumneric": false,
+        "contexts": [
+          {
+            "contextName": "FULLY_RESPONSIVE",
+            "priority": 2,
+            "description": "All doubts cleared with evidence"
+          },
+          {
+            "contextName": "PARTIALLY_RESPONSIVE",
+            "priority": 1,
+            "description": "Some doubts addressed, others ignored"
+          },
+          {
+            "contextName": "UNRESPONSIVE",
+            "priority": 0,
+            "description": "Customer doubts were dismissed"
+          }
+        ]
+      },
+      {
+        "metricId": "sales_outcome_001",
+        "metricName": "Final Sales Outcome",
+        "metricDescription": "The final commitment level reached at the end of the conversation",
+        "hasContext": true,
+        "isNumneric": false,
+        "contexts": [
+          {
+            "contextName": "BOUGHT_PHOTOCHROMATIC",
+            "priority": 2,
+            "description": "Customer agreed to the upgrade"
+          },
+          {
+            "contextName": "BOUGHT_SOMETHING_ELSE",
+            "priority": 0,
+            "description": "Bought standard lenses/frames only"
+          },
+          {
+            "contextName": "NO_SALE",
+            "priority": 0,
+            "description": "No purchase commitment"
+          }
+        ]
+      },
+      {
+        "metricId": "pitch_timing_summary_001",
+        "metricName": "Pitch Timing & Context",
+        "metricDescription": "Narrative summary of when and how the pitch was introduced",
+        "hasContext": false,
+        "isNumneric": false
+      }
+    ]
+  }'
+
+# ==================== 2. GET COHORT BY ID ====================
+print_section "2. GET COHORT BY ID"
+
+curl -X GET "$BASE_URL/cohorts/$COHORT_ID" \
+  -H "Content-Type: application/json"
+
+# ==================== 3. GET COHORTS BY CLIENT ====================
+print_section "3. GET COHORTS BY CLIENT"
+
+curl -X GET "$BASE_URL/cohorts/client/$CLIENT_ID?limit=10&offset=0" \
+  -H "Content-Type: application/json"
+
+# ==================== 4. SEARCH COHORTS ====================
+print_section "4. SEARCH COHORTS"
+
+curl -X POST "$BASE_URL/cohorts/search" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "clientId": "11",
+    "cohortName": "Photochrom",
+    "limit": 10,
+    "offset": 0
+  }'
+
+# ==================== 5. UPDATE COHORT ====================
+print_section "5. UPDATE COHORT"
+
+# Note: Replace DOCUMENT_ID with actual ID returned from create
+DOCUMENT_ID="550e8400-e29b-41d4-a716-446655440000"
+
+curl -X PUT "$BASE_URL/cohorts/$DOCUMENT_ID" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "cohortName": "Updated Photochromatic",
+    "cohortDescription": "Updated description for photochromatic cohort"
+  }'
+
+# ==================== 6. GET COHORT ANALYTICS ====================
+print_section "6. GET COHORT ANALYTICS"
+
+curl -X GET "$BASE_URL/cohorts/$COHORT_ID/analytics" \
+  -H "Content-Type: application/json"
+
+# ==================== 7. DELETE COHORT ====================
+print_section "7. DELETE COHORT"
+
+# Note: Replace DOCUMENT_ID with actual ID
+curl -X DELETE "$BASE_URL/cohorts/$DOCUMENT_ID" \
+  -H "Content-Type: application/json"
+
+# ==================== VALIDATION TESTS ====================
+print_section "VALIDATION TESTS"
+
+echo "Testing invalid cohort name (too short):"
+curl -X POST "$BASE_URL/cohorts" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "clientId": "11",
+    "cohortId": "invalid_test",
+    "cohortName": "AB",
+    "cohortDescription": "This should fail because name is too short"
+  }'
+
+echo ""
+echo "Testing missing required field:"
+curl -X POST "$BASE_URL/cohorts" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "clientId": "11",
+    "cohortId": "invalid_test",
+    "cohortName": "Valid Name"
+  }'
+
+echo ""
+echo "Testing invalid cohortId (special characters):"
+curl -X POST "$BASE_URL/cohorts" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "clientId": "11",
+    "cohortId": "invalid@test",
+    "cohortName": "Valid Name",
+    "cohortDescription": "This should fail because cohortId has invalid characters"
+  }'

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tango-app-api-audio-analytics",
-    "version": "1.0.31",
+    "version": "1.0.32",
     "description": "audioAnalytics",
     "main": "index.js",
     "type": "module",
@@ -8,7 +8,7 @@
         "start": "nodemon --exec \"eslint --fix . && node app.js\""
     },
     "engines": {
-        "node": ">=18.10.0"
+        "node": ">=18.10.0 <25"
     },
     "author": "praveenraj",
     "license": "ISC",

package/src/controllers/conversationAnalytics.controller.js

@@ -5,6 +5,7 @@ import {
   exportConversationsFromLambda,
   getConversationDetailsFromLambda,
   getTranscriptListFromLambda,
+  getCategoryAnalysisCardFromLambda,
   // filterConversationsBySearch,
   // sortConversations,
 } from '../services/conversation.service.js';
@@ -334,3 +335,77 @@ export const getConversationDetails = async ( req, res ) => {
   }
 };
 
+/**
+ * Get Category Analysis Card
+ * POST /category-analysis-card
+ * @param {Object} req - Express request object
+ * @param {Object} req.body - Request body
+ * @param {string} req.body.startDate - Start date (YYYY-MM-DD)
+ * @param {string} req.body.endDate - End date (YYYY-MM-DD)
+ * @param {string[]} req.body.storeId - Array of store IDs
+ * @param {string} req.body.cohortId - Cohort ID
+ * @param {string} req.body.clientId - Client ID
+ * @param {number} req.body.id - Category numeric ID
+ * @param {string} req.body.category - Category name
+ * @param {Object} res - Express response object
+ * @return {void} Returns JSON response with category analysis card data
+ */
+export const getCategoryAnalysisCard = async ( req, res ) => {
+  try {
+    const { startDate, endDate, storeId, cohortId, clientId, id, category } = req.body;
+
+    if ( !startDate || !endDate || !storeId || !cohortId || !clientId || id === undefined || !category ) {
+      return res.status( 400 ).json( {
+        status: 'error',
+        message: 'Missing required parameters: startDate, endDate, storeId, cohortId, clientId, id, category',
+        code: 'MISSING_PARAMETERS',
+        timestamp: new Date().toISOString(),
+      } );
+    }
+
+    logger.info( {
+      message: 'Fetching category analysis card',
+      startDate,
+      endDate,
+      storeId,
+      cohortId,
+      clientId,
+      id,
+      category,
+    } );
+
+    const lambdaResponse = await getCategoryAnalysisCardFromLambda( {
+      startDate,
+      endDate,
+      storeId,
+      cohortId,
+      clientId,
+      id,
+      category,
+    } );
+
+    if ( !lambdaResponse ) {
+      return res.status( 204 ).json( {
+        status: 'error',
+        message: 'No data found for the given parameters',
+        code: 'DATA_NOT_FOUND',
+        timestamp: new Date().toISOString(),
+      } );
+    }
+
+    return res.status( 200 ).json( {
+      status: lambdaResponse?.status || 'success',
+      data: lambdaResponse?.data ?? lambdaResponse,
+      timestamp: new Date().toISOString(),
+    } );
+  } catch ( error ) {
+    logger.error( { error, message: 'Error fetching category analysis card', body: req.body } );
+    return res.status( 500 ).json( {
+      status: 'error',
+      message: error.message || 'Internal server error',
+      code: 'INTERNAL_ERROR',
+      timestamp: new Date().toISOString(),
+    } );
+  }
+};
+

package/src/dtos/audioAnalytics.dtos.js

@@ -510,6 +510,19 @@ export const cohortAnalysisCardValid = joi.object( {
   clientId: joi.array().items( joi.string() ).required().min( 1 ).description( 'Array of client IDs' ),
 } ).strict();
 
+/**
+ * Category Analysis Card Schema
+ */
+export const categoryAnalysisCardValid = joi.object( {
+  startDate: joi.string().required().pattern( /^\d{4}-\d{2}-\d{2}$/ ).description( 'Start date in YYYY-MM-DD format' ),
+  endDate: joi.string().required().pattern( /^\d{4}-\d{2}-\d{2}$/ ).description( 'End date in YYYY-MM-DD format' ),
+  storeId: joi.array().items( joi.string() ).required().min( 1 ).description( 'Array of store IDs' ),
+  cohortId: joi.string().required().description( 'Cohort ID' ),
+  clientId: joi.string().required().description( 'Client ID' ),
+  id: joi.number().integer().required().description( 'Category numeric ID' ),
+  category: joi.string().required().description( 'Category name' ),
+} ).strict();
+
 /**
  * Conversations List Schema
  */

package/src/routes/audioAnalytics.routes.js

@@ -2,10 +2,10 @@
 import express from 'express';
 import { validate } from 'tango-app-api-middleware';
 import { createCohortValid, createBulkCohortValid, updateCohortValid, getCohortValid, listCohortsByClientValid, deleteCohortValid } from '../dtos/audioAnalytics.dtos.js';
-import { cohortAnalysisCardValid, conversationsListValid, conversationDetailsValid, chatHistoryListValid, getChatValid, getGeminiResponseValid, transcriptListValid } from '../dtos/audioAnalytics.dtos.js';
+import { cohortAnalysisCardValid, categoryAnalysisCardValid, conversationsListValid, conversationDetailsValid, chatHistoryListValid, getChatValid, getGeminiResponseValid, transcriptListValid } from '../dtos/audioAnalytics.dtos.js';
 import { createCohort, createBulkCohort, updateCohort, deleteCohort, getCohort, listCohortsByClient, chatHistoryList, getChat, getGeminiResponse, aiStreamResponse } from '../controllers/audioAnalytics.controller.js';
 import { getCohortAnalysisCard } from '../controllers/cohortAnalytics.controller.js';
-import { getConversationsList, getTranscriptsList, getConversationDetails } from '../controllers/conversationAnalytics.controller.js';
+import { getConversationsList, getTranscriptsList, getConversationDetails, getCategoryAnalysisCard } from '../controllers/conversationAnalytics.controller.js';
 
 export const audioAnalyticsrouter = express.Router(); ;
 
@@ -27,6 +27,7 @@ audioAnalyticsrouter.post( '/chat-history-list', validate( chatHistoryListValid
 audioAnalyticsrouter.post( '/get-chat', validate( getChatValid ), getChat );
 // Cohort Analytics Routes
 audioAnalyticsrouter.post( '/cohort-analysis-card', validate( cohortAnalysisCardValid ), getCohortAnalysisCard );
+audioAnalyticsrouter.post( '/category-analysis-card', validate( categoryAnalysisCardValid ), getCategoryAnalysisCard );
 
 // Conversation Analytics Routes
 audioAnalyticsrouter.post( '/conversations/list', validate( conversationsListValid ), getConversationsList );

package/src/services/conversation.service.js

@@ -289,6 +289,55 @@ export async function getCohortAnalysisSummaryCard( params ) {
   }
 }
 
+/**
+ * Call Lambda to get category analysis card
+ * @param {Object} params - Request parameters
+ * @param {string} params.startDate - Start date (YYYY-MM-DD)
+ * @param {string} params.endDate - End date (YYYY-MM-DD)
+ * @param {string[]} params.storeId - Array of store IDs
+ * @param {string} params.cohortId - Cohort ID
+ * @param {string} params.clientId - Client ID
+ * @param {number} params.id - Category numeric ID
+ * @param {string} params.category - Category name
+ * @return {Promise<Object>} Response from Lambda
+ */
+export async function getCategoryAnalysisCardFromLambda( params ) {
+  try {
+    const LAMBDA_ENDPOINT = JSON.parse( process.env.URL ) || 'http://lambda-api:8000';
+
+    const payload = {
+      startDate: params.startDate,
+      endDate: params.endDate,
+      storeId: Array.isArray( params.storeId ) ? params.storeId : [ params.storeId ],
+      cohortId: params.cohortId,
+      clientId: params.clientId,
+      id: params.id,
+      category: params.category,
+    };
+
+    logger.info( { message: 'Calling Lambda for category analysis card', url: LAMBDA_ENDPOINT.categoryAnalysisCard, payload } );
+
+    const response = await axios.post( `${LAMBDA_ENDPOINT.categoryAnalysisCard}`, payload, {
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      timeout: 30000,
+    } );
+
+    logger.info( { message: 'Lambda response received for category analysis card', status: response.status } );
+    return response.data;
+  } catch ( error ) {
+    logger.error( {
+      error: error.message,
+      status: error.response?.status,
+      data: error.response?.data,
+      message: 'Error calling Lambda for category analysis card',
+      params,
+    } );
+    throw new Error( `Failed to fetch category analysis card: ${error.message}` );
+  }
+}
+
 /**
  * Process and filter conversations based on search criteria
  * @param {Array} conversations - Array of conversation objects