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 ✅

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

Additional details and impacted files

@@            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     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[sonarcloud]

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