GeezerVison

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). This PR is stacked on the previous one of the stack (its base is the branch of that PR): GitHub retargets it to main once the PRs below are merged.

Notable changes for users:

• The four GET /api/dpl-process/* endpoints (detectors, processes, hosts, executions) are now documented at /api-docs.
• The ids of these endpoints (run number, detector id, process id, host id) are validated as positive integers: 0, negative numbers and decimals are rejected with a 400 instead of ending as a 404.
• The detectors, processes (and their type), hosts and executions no longer contain createdAt and updatedAt (nothing used them; breaking for any external client reading them).

Notable changes for developers:

• Checked the chain of the endpoints: all 38 files of the chain have their license header, no use case is involved and the router references existing handlers. The frontend (run details page) only reads names, ids, the process type label, the host name and the arguments.
• The four read methods of DplProcessService queried the repositories directly while the creation of an execution already relies on small functions: they now use getDplDetectorIdsWithExecutedProcessesInRun, getAllDplDetectors, getDplProcessIdsExecutedInRunByDetector, getAllDplProcesses, getHostIdsWithExecutedDplProcess, getAllHosts and getAllDplProcessExecutions, each with a test. The two steps of the queries (ids first, then sorted entities) are kept. Checked against the previous service with the SQL layer stubbed: same queries (up to redundant parentheses) and same results.
• The adapters of the DPL detectors, processes, process types, process executions and hosts (only used by these endpoints and by the gRPC creation of an execution, whose response is only the id) stop returning createdAt / updatedAt, and their typedefs are updated. The always empty relations (processesExecutions, and detector, host, process, run set to null) are left as they are: the tests check them.
• The controller disabled the JSDoc rules for the whole file: the handlers are documented. The DplProcessExecution typedef declared strings for processId and hostId (integers) and for args (nullable).

Changes made to the database:

• None

🤖 Generated with Claude Code