@extends('layouts.app')

@section('content')
<div class="p-6 space-y-8 max-w-5xl mx-auto">
  <div class="flex items-center justify-between">
    <h1 class="text-2xl font-bold text-gray-800">Help & Guides — Overview</h1>
    <a href="{{ route('help.index') }}" class="text-indigo-600 hover:underline">Back to Help</a>
  </div>

  <!-- Quick Start -->
  <section class="space-y-2">
    <h2 class="text-xl font-semibold">Quick start</h2>
    <ol class="list-decimal list-inside space-y-1 text-gray-800">
      <li>Create your <strong>SIP trunk</strong> (Trunks ? Create).</li>
      <li>Add <strong>extensions</strong> (Extensions ? Create).</li>
      <li>Create an <strong>Inbound Route</strong> for each DID (Trunks ? Inbound ? Create).</li>
      <li>Set <strong>Outbound rules</strong> as needed.</li>
      <li>Use the <strong>Reload</strong> button to apply changes.</li>
      <li>Test: call in from mobile; test ext-to-ext; test outbound.</li>
    </ol>
  </section>

  <!-- How the system fits together -->
  <section class="space-y-2">
    <h2 class="text-xl font-semibold">How it fits together</h2>
    <p class="text-gray-800">
      The GUI writes to the database. Asterisk reads live (realtime) from that database.
    </p>
<pre class="bg-gray-50 border rounded p-3 text-sm overflow-x-auto">
Inbound:  Carrier ? PJSIP trunk ? <trunks-in> ? GUI-defined destination (e.g., from-internal,1000,1)
Outbound: Phone 1000 ? &lt;from-internal&gt; ? Dial() via selected trunk
</pre>
  </section>

  <!-- Realtime mapping (what lives where) -->
  <section class="space-y-2">
    <h2 class="text-xl font-semibold">Realtime mapping</h2>
    <ul class="list-disc list-inside space-y-1 text-gray-800">
      <li><code>ps_endpoints</code>, <code>ps_aors</code>, <code>ps_auths</code>, <code>ps_contacts</code>: PJSIP objects.</li>
      <li><code>extensions</code>: dialplan rows (context, exten, priority, app, appdata).</li>
      <li><code>inbound_routes</code>: GUI model that writes matching rows into <code>extensions</code> under <code>trunks-in</code>.</li>
    </ul>

    <div class="bg-gray-50 border rounded p-3 text-sm space-y-2">
      <div>
        <div class="font-semibold">/etc/asterisk/extconfig.conf</div>
<pre>ps_endpoints => odbc,asterisk
ps_auths     => odbc,asterisk
ps_aors      => odbc,asterisk
ps_contacts  => odbc,asterisk
extensions   => odbc,asterisk,extensions</pre>
      </div>

      <div>
        <div class="font-semibold">/etc/asterisk/extensions.conf</div>
<pre>[from-internal]
switch => Realtime/from-internal@extensions

[trunks-in]
switch => Realtime/trunks-in@extensions</pre>
      </div>
    </div>
  </section>

  <!-- Common tasks -->
  <section class="space-y-2">
    <h2 class="text-xl font-semibold">Common tasks</h2>
    <ul class="list-disc list-inside space-y-1 text-gray-800">
      <li><strong>Add a DID</strong>: Trunks ? Inbound ? Create ? Save ? Reload.</li>
      <li><strong>Forward a DID externally</strong>: Destination type = <em>external</em>, value = <em>+E.164</em>.</li>
      <li><strong>Send to extension/queue/IVR</strong>: Pick the destination type and value; Save ? Reload.</li>
      <li><strong>Test</strong> quickly in CLI: <code>dialplan show &lt;did&gt;@trunks-in</code>.</li>
    </ul>
  </section>

  <!-- Troubleshooting -->
  <section class="space-y-2">
    <h2 class="text-xl font-semibold">Troubleshooting cheatsheet</h2>
    <ul class="list-disc list-inside space-y-1 text-gray-800">
      <li><strong>“extension not found in context 'trunks-in'”</strong>  
        Check the row exists:
        <code>SELECT * FROM extensions WHERE context='trunks-in' AND exten='&lt;DID&gt;';</code>
      </li>
      <li><strong>Realtime switch not active</strong>  
        <code>asterisk -rx "core show switches" | grep -i Realtime</code>
      </li>
      <li><strong>Context not loaded</strong>  
        <code>asterisk -rx "dialplan reload"</code> then
        <code>asterisk -rx "dialplan show trunks-in"</code>
      </li>
      <li><strong>401/404 from trunk</strong>  
        Verify trunk creds, SIP URI, and registration/peer IPs.</li>
      <li><strong>Codec mismatch</strong>  
        Align codecs on phones/trunk (e.g., alaw/ulaw). Avoid g729 unless licensed.</li>
      <li><strong>NAT/audio one way</strong>  
        Set correct external IP / localnets in PJSIP and firewall pinholes (UDP 5060 + RTP range).</li>
      </ul>

      <div class="bg-gray-50 border rounded p-3 text-sm">
        <div class="font-semibold mb-1">Useful CLI</div>
<pre>asterisk -rvvvvv
core set verbose 4
pjsip show endpoints
pjsip show registrations
dialplan show trunks-in
dialplan show &lt;DID&gt;@trunks-in
tail -f /var/log/asterisk/full</pre>
      </div>
  </section>

  <!-- Security & backups -->
  <section class="space-y-2">
    <h2 class="text-xl font-semibold">Security & backups</h2>
    <ul class="list-disc list-inside space-y-1 text-gray-800">
      <li>Use allow-lists and geo rules in Firewall.</li>
      <li>Strong secrets for trunks and endpoints.</li>
      <li>Regular DB backups:
        <code>mysqldump asterisk &gt; backup_$(date +%F).sql</code>
      </li>
    </ul>
  </section>

  <!-- Where to next -->
  <section class="space-y-2">
    <h2 class="text-xl font-semibold">Where to next</h2>
    <ul class="list-disc list-inside space-y-1 text-indigo-700">
      <li><a class="hover:underline" href="{{ route('help.topic', 'extensions') }}">Extensions</a></li>
      <li><a class="hover:underline" href="{{ route('help.topic', 'applications') }}">Applications</a></li>
      <li><a class="hover:underline" href="{{ route('help.topic', 'trunks') }}">Trunks</a></li>
      <li><a class="hover:underline" href="{{ route('help.topic', 'firewall') }}">Firewall</a></li>
      <li><a class="hover:underline" href="{{ route('help.topic', 'cdr') }}">CDR</a></li>
    </ul>
  </section>
</div>
@endsection