Release Notes - ms-nodejs-backend and ms-nodejs-api-gateway (match-non-experts branch)

Overview

This release introduces a new feature enabling innovation managers and providers to add structured challenges into team funnel templates by step number. It also enhances AI-driven title generation for challenges by refining prompt syntax and response handling. Additional backend improvements include better filtering of audience data, logging enhancements for debugging, and refactoring of chat completion calls to support conditional JSON responses.

New Features

Added TeamFunnelStepChallenge functionality:
- Innovation managers and providers can now add challenges linked to specific steps of team funnel templates.
- Automatic challenge title generation powered by ChatGPT, creating fitting and potentially catchy titles if none are provided.
- Created new Mongoose model, service, controller, and Express route to support challenge creation, retrieval by step name, and associated validations.
- Implemented strict authorization checks allowing only users with correct roles and ownership of templates to add challenges.

Improvements / Changes

Refined the ChatGPT prompt for generating challenge titles to explicitly require JSON-formatted output, improving parse reliability.
Extracted chat completion request options into a variable and introduced conditional setting of response_format to JSON, making the AI integration more flexible.
Improved filtering of audience levels by including only string-type IDs before fetching providers, ensuring correct provider queries.
Enhanced logging around audience level processing and challenge title generation for better traceability during debugging.
Initialized structures to store AI-generated expert squads and offer currencies, laying groundwork for advanced matching features.
Small code cleanups including consistent use of await and streamlined service calls supporting the overall maintainability.

Bug Fixes

Fixed incorrect use of audience levels when fetching providers by filtering to strings, preventing errors or unintended behavior.
Resolved parsing issues related to challenge title generation prompts by clarifying expected ChatGPT response formats.

Technical / Developer Notes

New TeamFunnelStepChallenge entities are linked by stepNameId and require referencing the existing TeamFunnelStepName model.
When calling the AI chat completions, the options object now conditionally sets response format which must be handled accordingly in consuming code.
Authorization logic enforces that only users with role 'innovation manager' or 'provider' owning the respective template can manipulate challenges.
The AI prompt for title generation must return JSON in the format {title: "Fitting Title"}, which should be parsed safely.

Acknowledgements / Contributors