feat: openApi refactor fields parameter to support multiple values with enum validation (getProductByBarCode/search)

[shinjigi]

What

This PR improves the OpenAPI specification for the fields parameter in the product and search endpoint.

The changes make the API specification more accurate and provide better validation and documentation for the fields parameter, which is critical for controlling response payload size and structure.

Related issue(s) and discussion

• Improves API documentation accuracy and completeness
• Makes the fields parameter behavior more predictable and better documented
• Helps API consumers understand available field options

Implementation details

1. Created new file parameters/product_available-fields.yaml to house fields parameter definition
2. Updated main API spec to reference the new parameter definition
3. Removed redundant fields parameter definition from individual endpoints
4. Added comprehensive enum of available field values
5. Added validation rules and examples

Testing

• Verified that the OpenAPI spec validates correctly
• Checked that the parameter definition matches actual API behavior
• Confirmed that examples are valid and helpful

Note: This change is purely to the API specification and does not affect the actual API implementation.

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 49.03%. Comparing base (dc04d18) to head (0acef3a). Report is 762 commits behind head on main.

Additional details and impacted files

```diff @@ Coverage Diff @@ ## main #11012 +/- ## ========================================== - Coverage 49.54% 49.03% -0.52% ========================================== Files 67 77 +10 Lines 20650 22243 +1593 Branches 4980 5318 +338 ========================================== + Hits 10231 10906 +675 - Misses 9131 10003 +872 - Partials 1288 1334 +46 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

[sonarcloud[bot]]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud