feat: implement added to cart worksheet functionality

[kallilsouza]

What

Adds a new ADDED_TO_CART section to the Conversations report. When this section is selected, the report builder generates an "Added to cart" worksheet containing each product-added-to-cart event with its URN, date, and product value, sourced from the datalake. The change introduces:

• New ADDED_TO_CART value in ConversationsReportSections.
• New abstract method get_added_to_cart_worksheet in BaseConversationsReportService and its concrete implementation in ConversationsReportService.
• Two new settings: CONVERSATIONS_METRICS_ADDED_TO_CART_AGENT_UUID (required) and CONVERSATIONS_METRICS_ADDED_TO_CART_KEY (event key used to filter datalake events).
• A new exception AddedToCartAgentUUIDNotConfiguredError raised when the agent UUID is missing.
• Wiring of the new section into the worksheet mapping and the available widgets list.
• Translations for "Added to cart" and "Product" (PT-BR / ES).
• Tests for the serializer, the worksheet generation (with data, empty data, and missing-configuration error), and the worksheets dispatcher.

Why

Customers need visibility into the products added to cart so they can analyze data directly from the Conversations Report. Exposing this data as an additional worksheet inside the existing report keeps the flow consistent with the other sections (CSAT, NPS, Tool Results, etc.) and reuses the datalake integration already in place.

Sequence diagram

sequenceDiagram
    participant Client
    participant Serializer as RequestConversationsReportGenerationSerializer
    participant Service as ConversationsReportService
    participant Settings as Django settings
    participant Datalake as Datalake events source
    participant Worksheet as ConversationsReportWorksheet

    Client->>Serializer: POST report request (sections=[ADDED_TO_CART])
    Serializer-->>Service: validated_data (project, dates, sections)
    Service->>Service: _get_worksheets(report, start_date, end_date)
    Service->>Service: dispatch ADDED_TO_CART -> get_added_to_cart_worksheet
    Service->>Settings: read CONVERSATIONS_METRICS_ADDED_TO_CART_AGENT_UUID
    alt agent_uuid not configured
        Settings-->>Service: empty value
        Service-->>Client: raise AddedToCartAgentUUIDNotConfiguredError
    else agent_uuid configured
        Settings-->>Service: agent_uuid, key
        Service->>Datalake: get_datalake_events(event_name="weni_nexus_data", key, metadata=agent_uuid, date range)
        Datalake-->>Service: events [{contact_urn, date, value}, ...]
        Service->>Service: translate headers (URN, Date, Product) for requester language
        Service->>Service: build rows (empty placeholder row when no events)
        Service->>Worksheet: ConversationsReportWorksheet(name="Added to cart", data)
        Worksheet-->>Service: worksheet
        Service-->>Client: report including Added to cart worksheet
    end

Loading

[graphite-app]

References undefined variable mock_get_search_term_widget which is not declared in the function parameters or decorators. This will cause a NameError: name 'mock_get_search_term_widget' is not defined at runtime.

# Line 5190 should be removed as it references a non-existent mock
# mock_get_search_term_widget.return_value = True  # DELETE THIS LINE

The test decorators only include mocks for get_added_to_cart_widget, get_csat_ai_widget, get_nps_ai_widget, get_csat_human_widget, get_nps_human_widget, get_custom_widgets, and get_crosstab_widgets. There is no get_search_term_widget function being patched.

Spotted by Graphite



Is this helpful? React 👍 or 👎 to let us know.