{% extends "documentation/base.html" %}

{% block doc_content %}
<h1>Maintenance</h1>

<p class="lead">
  Use Maintenance tools for data migration, cleanup, test data generation, and emergency reset actions.
</p>

<div class="doc-callout doc-callout-warning">
  <strong>Admin only:</strong><br>
  Several actions on this page are destructive and cannot be undone.
</div>

<div class="doc-callout doc-callout-info">
  <strong>Where:</strong><br>
  Open <a href="{{ url_for('main.settings', section='maintenance') }}"><strong>Settings -> Maintenance</strong></a>.
</div>

<h2>Approved Jobs Export / Import</h2>

<ul>
  <li><strong>Download export (JSON):</strong> exports customers/jobs for migration or restore scenarios.</li>
  <li><strong>Import jobs:</strong> updates existing jobs by key (Customer + Backup + Type + Job name) or creates missing jobs.</li>
  <li><strong>Include Autotask IDs:</strong> keep disabled when importing into environments with different Autotask datasets.</li>
</ul>

<h2>Object Maintenance</h2>

<ul>
  <li><strong>Backfill objects:</strong> rebuilds missing object link data for existing approved runs to repair reporting relationships.</li>
</ul>

<h2>Cleanup Orphaned Jobs</h2>

<ul>
  <li><strong>Preview orphaned jobs:</strong> shows jobs without a valid customer link.</li>
  <li><strong>Delete orphaned:</strong> removes orphaned jobs and related run/email data.</li>
</ul>

<h2>Generate Test Run</h2>

<p>Creates a single <code>JobRun</code> with three persisted run objects, attached to a fixed
  test job (<code>__test-override-job__</code>) and customer that are auto-created on first use.
  Designed for exercising the Smart Override flow in Run Checks without needing a live backup.</p>

<ul>
  <li>Choose a <strong>status</strong>: Success, Warning, or Failed.</li>
  <li>Choose an <strong>error scenario</strong>: VSS, connection timeout, disk space, license,
    network, permissions, or a custom free-text message.</li>
  <li><strong>Delete all test runs</strong> removes all generated test data (runs and objects).</li>
</ul>

<h2>Generate Test Emails</h2>

<ul>
  <li>Generates one Veeam test email in the inbox per selected status: Success, Warning, or Error.</li>
  <li>Useful for parser testing and inbox-flow validation.</li>
</ul>

<h2>Jobs Maintenance</h2>

<ul>
  <li><strong>Delete all jobs:</strong> removes all jobs and job runs.</li>
  <li>Related mails are moved back to Inbox (job link removed).</li>
</ul>

<h2>Danger Zone</h2>

<ul>
  <li><strong>Reset application:</strong> permanently clears application data and users.</li>
  <li>Requires explicit confirmation value <code>RESET</code>.</li>
  <li>After reset, application returns to initial setup flow.</li>
</ul>

<h2>Best Practices</h2>

<ul>
  <li>Always export before destructive operations.</li>
  <li>Use orphaned-job preview before deletion.</li>
  <li>Run destructive actions in maintenance windows.</li>
</ul>
{% endblock %}