Function buildBatchSchemaHint

app/src/API/Handlers/ProjectHandler.cpp:5210–5236

* @brief Runs an array of project mutations sequentially under a suspended autosave. */ * @brief Returns the schema-hint object attached to every project.batch validation error. */

 * @brief Returns the schema-hint object attached to every project.batch validation error.
 */
static QJsonObject buildBatchSchemaHint()
{
  QJsonObject example;
  QJsonArray exampleOps;
  QJsonObject op0;
  op0[QStringLiteral("command")] = QStringLiteral("project.dataset.update");
  QJsonObject p0;
  p0[QStringLiteral("groupId")] = 0;
  p0[Keys::DatasetId]           = 0;
  p0[QStringLiteral("title")]   = QStringLiteral("LED 1");
  p0[QStringLiteral("index")]   = 1;
  op0[QStringLiteral("params")] = p0;
  exampleOps.append(op0);
  example[QStringLiteral("ops")]         = exampleOps;
  example[QStringLiteral("stopOnError")] = false;

  QJsonObject hint;
  hint[QStringLiteral("expected")] =
    QStringLiteral("{ ops: Array<{command: string, params: object}>, stopOnError?: boolean }");
  hint[QStringLiteral("opShape")] =
    QStringLiteral("Each op MUST be {command: '<registered name>', params: {...}}. Per-call "
                   "args go INSIDE params, not at the top of the op object.");
  hint[QStringLiteral("limits")] =
    QStringLiteral("1 <= ops.length <= 1024. Nested project.batch is rejected.");
  hint[QStringLiteral("example")] = example;
  return hint;
}

/**
 * @brief Builds a per-op result entry for a validation failure inside project.batch.