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

{% block doc_content %}
<h1>Mail Configuration</h1>

<p class="lead">
  Configure Microsoft Graph access and import behavior for backup report emails.
</p>

<div class="doc-callout doc-callout-info">
  <strong>Where:</strong><br>
  Credentials and folders are in <a href="{{ url_for('main.settings', section='general') }}"><strong>Settings -> General</strong></a>.<br>
  Import behavior is in <a href="{{ url_for('main.settings', section='imports') }}"><strong>Settings -> Imports</strong></a>.
</div>

<h2>Graph Connection (General tab)</h2>

<ul>
  <li><strong>Tenant ID</strong></li>
  <li><strong>Client ID</strong></li>
  <li><strong>Client secret</strong> (leave empty to keep stored secret)</li>
  <li><strong>Mailbox address</strong></li>
</ul>

<h2>Folder Selection (General tab)</h2>

<ul>
  <li><strong>Incoming folder:</strong> source folder read by import.</li>
  <li><strong>Processed folder:</strong> destination after processing.</li>
  <li>Use <strong>Browse...</strong> to load folder tree via Graph and select the exact path.</li>
</ul>

<h2>Automatic Import (Imports tab)</h2>

<ul>
  <li><strong>Enable automatic mail import</strong></li>
  <li><strong>Interval (minutes)</strong></li>
  <li><strong>Automatic importer cutoff date:</strong> older messages are ignored.</li>
  <li><strong>Manual import batch size:</strong> configurable between 1 and 50.</li>
</ul>

<h2>EML Retention (Imports tab)</h2>

<ul>
  <li><strong>Store EML for debugging:</strong> Off, 7 days, or 14 days.</li>
  <li>When set to <strong>Off</strong>, stored EML blobs are cleared.</li>
</ul>

<h2>Manual Import</h2>

<ul>
  <li>Use <strong>Run import</strong> in Settings -> Imports for one-time import.</li>
  <li>Manual import is blocked when free disk space is below 2 GB.</li>
  <li>Results and errors are shown via notifications and logged in Logging.</li>
</ul>

<h2>Operational Notes</h2>

<ul>
  <li>Automatic importer batch size is fixed to 50 items internally.</li>
  <li>Secret fields are write-only in the UI.</li>
  <li>Mail/import setting changes are audit logged.</li>
</ul>

<h2>Related Pages</h2>

<ul>
  <li><a href="{{ url_for('documentation.page', section='mail-import', page='setup') }}">Mail Import Setup</a></li>
  <li><a href="{{ url_for('documentation.page', section='mail-import', page='auto-import') }}">Auto-Import Configuration</a></li>
</ul>
{% endblock %}