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

{% block doc_content %}
<h1>Veeam Cloud Connect</h1>

<p class="lead">
  Review and link Cloud Connect tenant rows from shared report emails to Backupchecks jobs.
</p>

<div class="doc-callout doc-callout-info">
  <strong>Scope:</strong><br>
  Cloud Connect imports from report emails, stages accounts, then creates runs only for linked accounts.
</div>

<h2>How the Cloud Connect Flow Works</h2>

<ol>
  <li>Cloud Connect report emails are parsed from Inbox mail storage.</li>
  <li>Per-tenant rows are upserted into <strong>Cloud Connect Accounts</strong>.</li>
  <li>Unlinked rows are reviewed and linked to jobs.</li>
  <li>On link, historical report mails are re-processed for that account/job mapping.</li>
</ol>

<h2>Open Cloud Connect Accounts</h2>

<ol>
  <li>Open <a href="{{ url_for('main.cloud_connect_accounts') }}"><strong>Cloud Connect Accounts</strong></a>.</li>
  <li>Use <strong>Scan inbox</strong> to re-process stored Cloud Connect report mails.</li>
  <li>Link each account row to an existing job or create a new one.</li>
</ol>

<h2>Important Mapping Notes</h2>

<ul>
  <li>Rows are account-level; one user can have multiple repositories.</li>
  <li>Repository-level linking is supported (separate rows/jobs where needed).</li>
  <li>Unlinking removes mapping only; historical runs remain as records.</li>
</ul>

<h2>Run Visibility</h2>

<ul>
  <li>Cloud Connect runs are stored with <code>source_type = cloud_connect</code>.</li>
  <li>Run Checks and Job Detail show structured Cloud Connect summaries.</li>
  <li>Shared source report email can still be inspected from detail UI.</li>
</ul>

<h2>Troubleshooting</h2>

<ul>
  <li>If expected rows are missing, run <strong>Scan inbox</strong> and verify report mail type.</li>
  <li>If runs are missing after link, re-link check + scan inbox again.</li>
  <li>If one tenant has multiple repos, verify each repo row is linked as intended.</li>
</ul>

<h2>See Also</h2>

<ul>
  <li><a href="{{ url_for('documentation.page', section='mail-import', page='inbox-management') }}">Inbox Management</a></li>
  <li><a href="{{ url_for('documentation.page', section='backup-review', page='run-checks-modal') }}">Run Checks Modal</a></li>
  <li><a href="{{ url_for('documentation.page', section='customers-jobs', page='approved-jobs') }}">Approved Jobs</a></li>
</ul>
{% endblock %}