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

{% block doc_content %}
<h1>First Login & Dashboard</h1>

<p class="lead">
  Learn how to log in to BackupChecks and navigate the dashboard interface.
</p>

<div class="doc-callout doc-callout-info">
  <strong>📝 Coming Soon:</strong>
  This page is under construction. Screenshots and additional content will be added in future updates.
</div>

<h2>Logging In</h2>

<p>To access BackupChecks:</p>

<ol>
  <li>Navigate to the BackupChecks URL in your web browser</li>
  <li>Enter your username and password</li>
  <li>Click the "Login" button</li>
</ol>

<h2>Dashboard Overview</h2>

<p>The dashboard is your starting point and provides:</p>

<ul>
  <li><strong>General Introduction:</strong> A brief explanation of what BackupChecks is and how it works</li>
  <li><strong>News & Announcements:</strong> Important updates and notices posted by administrators</li>
  <li><strong>Quick Overview:</strong> Summary of your backup monitoring status</li>
</ul>

<div class="doc-callout doc-callout-info">
  <strong>💡 Note:</strong>
  Administrators can create and manage news items via <strong>Settings</strong> to keep all users informed about system updates, maintenance windows, or important changes.
</div>

<h2>Navigation Bar</h2>

<p>The navigation bar at the top of the page provides access to different sections of BackupChecks. The menu items you see depend on your assigned role.</p>

<h3>Role-Based Menu Visibility</h3>

<p>BackupChecks shows only the menu items relevant to your current role. This keeps the interface clean and focused on your tasks.</p>

<div class="doc-callout doc-callout-tip">
  <strong>Example - Reporter Role:</strong><br>
  If you log in as a Reporter, you will only see:
  <ul style="margin-bottom: 0;">
    <li>Dashboard</li>
    <li>Reports</li>
    <li>Documentation</li>
    <li>Changelog</li>
    <li>Feedback</li>
  </ul>
</div>

<h3>Common Menu Items</h3>

<table>
  <thead>
    <tr>
      <th>Menu Item</th>
      <th>Description</th>
      <th>Available To</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong>Dashboard</strong></td>
      <td>Home page with overview and news</td>
      <td>All roles</td>
    </tr>
    <tr>
      <td><strong>Inbox</strong></td>
      <td>View all imported emails that are NOT yet linked to jobs (either because no parser exists or the job hasn't been created yet)</td>
      <td>Admin, Operator, Viewer</td>
    </tr>
    <tr>
      <td><strong>All Mail</strong></td>
      <td>View all imported emails including linked ones</td>
      <td>Admin only</td>
    </tr>
    <tr>
      <td><strong>Deleted Mails</strong></td>
      <td>View emails that have been deleted</td>
      <td>Admin only</td>
    </tr>
    <tr>
      <td><strong>Customers</strong></td>
      <td>Manage customer accounts</td>
      <td>Admin, Operator, Viewer</td>
    </tr>
    <tr>
      <td><strong>Jobs</strong></td>
      <td>Configure and manage backup jobs</td>
      <td>Admin, Operator, Viewer</td>
    </tr>
    <tr>
      <td><strong>Archived Jobs</strong></td>
      <td>View jobs that have been archived</td>
      <td>Admin only</td>
    </tr>
    <tr>
      <td><strong>Daily Jobs</strong></td>
      <td>View today's expected backup jobs and their status</td>
      <td>Admin, Operator, Viewer</td>
    </tr>
    <tr>
      <td><strong>Run Checks</strong></td>
      <td>Review all backup runs (successful and failed) and mark them as reviewed - the goal is to clear this queue daily</td>
      <td>Admin, Operator</td>
    </tr>
    <tr>
      <td><strong>Tickets</strong></td>
      <td>View and manage Autotask tickets</td>
      <td>Admin, Operator, Viewer</td>
    </tr>
    <tr>
      <td><strong>Overrides</strong></td>
      <td>Configure rules to override backup status for specific cases</td>
      <td>Admin, Operator, Viewer</td>
    </tr>
    <tr>
      <td><strong>Reports</strong></td>
      <td>Generate and view backup status reports</td>
      <td>All roles</td>
    </tr>
    <tr>
      <td><strong>Settings</strong></td>
      <td>Configure system settings, mail import, Autotask integration</td>
      <td>Admin only</td>
    </tr>
    <tr>
      <td><strong>Logging</strong></td>
      <td>View system audit log of important events</td>
      <td>Admin only</td>
    </tr>
    <tr>
      <td><strong>Parsers</strong></td>
      <td>View and test email parsing configurations</td>
      <td>Admin only</td>
    </tr>
    <tr>
      <td><strong>Documentation</strong></td>
      <td>Access this user documentation</td>
      <td>All roles</td>
    </tr>
    <tr>
      <td><strong>Changelog</strong></td>
      <td>View recent changes and updates to BackupChecks</td>
      <td>All roles</td>
    </tr>
    <tr>
      <td><strong>Feedback</strong></td>
      <td>Submit feedback and feature requests</td>
      <td>All roles</td>
    </tr>
  </tbody>
</table>

<h2>User Profile and Role Switching</h2>

<p>In the top-right corner of the navigation bar, you'll see:</p>

<ul>
  <li><strong>Your username and current role:</strong> Click to access your profile settings</li>
  <li><strong>Role selector:</strong> If you have multiple roles assigned, you can switch between them using the dropdown menu</li>
  <li><strong>Theme selector:</strong> Choose between Light, Dark, or Auto theme</li>
  <li><strong>Logout button:</strong> Sign out of BackupChecks</li>
</ul>

<div class="doc-callout doc-callout-info">
  <strong>💡 About Run Checks:</strong>
  The Run Checks page is designed for operators to review all backup runs and mark them as reviewed. This serves as proof that backups have been manually checked. The system records who performed each review and when, creating an audit trail for compliance and quality assurance.
</div>

<h2>Next Steps</h2>

<p>Now that you understand the interface, continue to:</p>

<ul>
  <li><a href="{{ url_for('documentation.page', section='getting-started', page='quick-start') }}">Quick Start Checklist</a> - Set up your first customer and job</li>
  <li><a href="{{ url_for('documentation.page', section='mail-import', page='setup') }}">Mail Import Setup</a> - Configure email integration</li>
</ul>

{% endblock %}