Method templateApply

app/src/API/Handlers/ProjectHandler.cpp:5606–5654

* @brief Loads a template into the project model. */

 * @brief Loads a template into the project model.
 */
API::CommandResponse API::Handlers::ProjectHandler::templateApply(const QString& id,
                                                                  const QJsonObject& params)
{
  if (!params.contains(QStringLiteral("templateId")))
    return CommandResponse::makeError(
      id, ErrorCode::MissingParam, QStringLiteral("Missing required parameter: templateId"));

  const auto templateId = params.value(QStringLiteral("templateId")).toString();
  const auto body       = loadTemplateBodyById(templateId);
  if (body.isNull())
    return CommandResponse::makeError(
      id,
      ErrorCode::InvalidParam,
      QStringLiteral("Template not found: %1. Call project.template.list for the "
                     "available ids.")
        .arg(templateId));

  const bool isDryRun = params.value(QStringLiteral("dryRun")).toBool(false);
  if (isDryRun) {
    QJsonObject result;
    result[QStringLiteral("dryRun")]       = true;
    result[QStringLiteral("templateId")]   = templateId;
    result[QStringLiteral("wouldDiscard")] = summarizeCurrentProject();
    result[QStringLiteral("wouldApply")]   = summarizeProjectJson(body.object());
    result[QStringLiteral("warning")] =
      QStringLiteral("DRY RUN: template not applied. wouldDiscard shows what would be lost; "
                     "wouldApply shows what would replace it. Confirm before re-issuing "
                     "without dryRun:true.");
    return CommandResponse::makeSuccess(id, result);
  }

  auto& project = DataModel::ProjectModel::instance();
  project.setSuppressMessageBoxes(true);
  const bool ok = project.loadFromJsonDocument(body);
  project.setSuppressMessageBoxes(false);

  if (!ok)
    return CommandResponse::makeError(
      id,
      ErrorCode::ExecutionError,
      QStringLiteral("Template applied but project failed to validate"));

  QJsonObject result;
  result[QStringLiteral("templateId")]   = templateId;
  result[QStringLiteral("title")]        = project.title();
  result[QStringLiteral("groupCount")]   = project.groupCount();
  result[QStringLiteral("datasetCount")] = project.datasetCount();
  return CommandResponse::makeSuccess(id, result);
}

//--------------------------------------------------------------------------------------------------
// Project consistency validation