[graduta]

I have a JIRA ticket

• branch and/or PR name(s) include(s) JIRA ID
• issue has "Fix version" assigned
• issue "Status" is set to "In review"
• PR labels are selected

Part of a stack of PRs documenting the HTTP API (O2B-1623), each PR builds on the previous one: see the stack on GitHub. The first PR of the stack is #2261, which adds the generator and the /api-docs page.

Notable changes for users:

• The LHC periods statistics endpoints are now documented at /api-docs, with parameters, responses and curl examples:
  • GET /api/lhcPeriodsStatistics: paginated list with filters (ids, names, years, PDP beam types) and sorting
  • GET /api/lhcPeriodsStatistics/{lhcPeriodId}: statistics of one LHC period

Notable changes for developers:

• lib/server/api-docs/openapi.yaml is updated by hand, API.md and index.html are regenerated with npm run docs:api (separate commit).
• Statistics are computed on the physics runs of each period.

Changes made to the database:

• None

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 46.41%. Comparing base (56653ef) to head (c43d848).

Additional details and impacted files

@@                                Coverage Diff                                 @@
##           feature/O2B-1623/docs-simulation-passes-endpoints    #2271   +/-   ##
==================================================================================
  Coverage                                              46.41%   46.41%           
==================================================================================
  Files                                                   1053     1053           
  Lines                                                  17359    17359           
  Branches                                                3162     3162           
==================================================================================
  Hits                                                    8057     8057           
  Misses                                                  9302     9302           

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.