docs: Align price lists OpenAPI and architecture with API

[bacciotti]

Summary

Aligns OpenAPI (docs/specs/openapi.json) and architecture (docs/architecture/price-lists/api-and-lifecycle.md) with the current Price Lists API: Settings-style filter / order_by, strict list query validation, POST .../duplicate/, and inline assigned_cost_models / assigned_cost_model_count on list/detail responses.

Verification

• python3 -m json.tool docs/specs/openapi.json — valid JSON.
• pipenv run tox -e py311 -- cost_models.test.test_price_list_view — OK (with Postgres on localhost:15432).

Changes

Area	Update
OpenAPI — GET /price-lists/	Replaced flat name / uuid / enabled / ordering params with PriceListQueryFilter + PriceListQueryOrderBy (deepObject), QueryOffset / QueryLimit; documented top-level param restriction; added 400 response.
OpenAPI — duplicate	New POST /price-lists/{price_list_uuid}/duplicate/ (duplicatePriceList).
OpenAPI — schemas	PriceListOut: assigned_cost_model_count, assigned_cost_models (items → PriceListAffectedCostModel).
Architecture doc	Expanded lifecycle table; list query contract; duplicate action; inline assignment fields; @never_cache on duplicate.

Release notes

• N/A (documentation only)

[gemini-code-assist]

Code Review

This pull request updates the Price List API documentation and OpenAPI specification to include a new duplication endpoint and enhanced filtering and ordering capabilities. The response schema for price lists now includes cost model assignment details. Feedback was provided regarding a potential naming mismatch for the path parameter price_list_uuid compared to the backend's expected lookup field.

[bacciotti]

/retest

[koku-ci-triager-bot]

🤖 CI Triager — Diagnosis

Check: Red Hat Konflux / koku-ci / koku
PipelineRun: koku-ci-ht8kc
Root cause: The init-pipeline-context task failed because the PR has the smokes-required label but no specific smoke-test label. This PR only changes documentation files and does not modify any Docker image content, so smoke tests should not be required.
Evidence:

[INFO] Checking labels for PR: 6031
[INFO] PR Labels: smokes-required
[INFO] Missing required smoke test label with smokes-required.

Changed files: docs/architecture/price-lists/api-and-lifecycle.md, docs/specs/openapi.json — documentation only, not part of the Docker image.

Action: Add the ok-to-skip-smokes label to this PR. The PR Labeler will automatically remove smokes-required when it sees ok-to-skip-smokes.

Generated automatically. Review before applying.