Simplify setup flow and public API docs

karldns/web/templates_public.py

@@ -1,17 +1,14 @@
 from __future__ import annotations
 
-from ..services.ddns import DdnsService
 from ..settings import DdnsSettings
 from .components import _code_window, _example_update_ips, _message_band
 from .html_utils import escape, trusted
 from .layout import _page, _top_nav
-from .templates_public_sections import _created_hostname_panel, _linux_installer_section
+from .templates_public_sections import _linux_installer_section
 
 
 def _render_public_home(
-    service: DdnsService,
     settings: DdnsSettings,
-    created_account: dict[str, str] | None,
     message: str | None,
     request_ip: str | None = None,
 ) -> str:
@@ -30,7 +27,6 @@ def _render_public_home(
             f"curl -sS '{base_url}/api/v1/router/update/<secret>'",
         ]
     )
-    created_html = _created_hostname_panel(service, created_account, request_ip)
     message_html = _message_band(message) if message else ""
     description = "KarlDNS is a free self-hosted Dynamic DNS service for FRITZ!Box routers, generated KarlDNS hostnames, Linux cron jobs, and home networks."
     return _page(
@@ -55,7 +51,6 @@ def _render_public_home(
             </div>
           </section>
           {message_html}
-          {created_html}
           <section class="section section-compact">
             <div class="container narrow text-center">
               <p class="eyebrow">How it works</p>
@@ -169,8 +164,6 @@ def _render_api_docs_page(settings: DdnsSettings, request_ip: str | None = None)
     status_example = f"curl -sS '{base_url}/api/v1/hostnames/<dashboard-secret>?history_limit=10'"
     rotate_example = f"curl -sS -X POST {base_url}/api/v1/hostnames/<dashboard-secret>/rotate-update-url"
     schema_example = f"curl -sS {base_url}/openapi.json"
-    admin_dashboard_example = f"curl -sS -u admin:<admin-password> {base_url}/api/v1/admin/dashboard"
-    admin_history_example = f"curl -sS -u admin:<admin-password> '{base_url}/api/v1/admin/events?limit=25'"
     description = "Small KarlDNS API guide for creating, activating, updating, reading, and deleting generated Dynamic DNS hostnames."
     return _page(
         "KarlDNS API",
@@ -181,7 +174,7 @@ def _render_api_docs_page(settings: DdnsSettings, request_ip: str | None = None)
             <div class="container text-center d-grid justify-items-center gap-3">
               <p class="eyebrow">API</p>
               <h1>Small API surface.</h1>
-              <p class="lead">Three surfaces: admin API, user dashboard data, and router registration/update calls.</p>
+              <p class="lead">Create a hostname, register it, update it, and read its status.</p>
             </div>
           </section>
           <section class="section section-compact">
@@ -189,14 +182,12 @@ def _render_api_docs_page(settings: DdnsSettings, request_ip: str | None = None)
               <div class="api-endpoints">
                 <h2>Endpoints</h2>
                 <ol class="simple-steps text-start">
-                  <li><strong>POST /api/v1/hostnames.</strong> Create a pending hostname and one-time secrets. The response includes <code>registration_url</code>.</li>
+                  <li><strong>POST /api/v1/hostnames.</strong> Create a pending hostname and private setup values. The response includes <code>registration_url</code>.</li>
                   <li><strong>GET or POST /api/v1/router/register/&lt;secret&gt;.</strong> Register the hostname after secrets are saved. Uses the request IP, or <code>myip</code>/<code>myipv6</code>, for the initial DNS record.</li>
                   <li><strong>GET or POST /api/v1/router/update/&lt;secret&gt;.</strong> Router-friendly update endpoint. Supports <code>myip</code>, <code>ipaddr</code>, <code>myipv6</code>, and <code>ip6addr</code>.</li>
                   <li><strong>GET /api/v1/hostnames/&lt;secret&gt;.</strong> Read hostname status and recent history.</li>
                   <li><strong>POST /api/v1/hostnames/&lt;secret&gt;/rotate-update-url.</strong> Replace the private router update URL.</li>
                   <li><strong>DELETE /api/v1/hostnames/&lt;secret&gt;.</strong> Delete hostname and DNS records.</li>
-                  <li><strong>GET /api/v1/admin/dashboard.</strong> Read operator summary, metrics, recent hostnames, cleanup state, and recent update history with admin Basic auth.</li>
-                  <li><strong>GET /api/v1/admin/events.</strong> Read paginated update history with admin Basic auth. Also available: <code>/api/v1/admin/hostnames</code> and <code>/api/v1/admin/records</code>.</li>
                 </ol>
               </div>
               <div>
@@ -223,15 +214,9 @@ def _render_api_docs_page(settings: DdnsSettings, request_ip: str | None = None)
               </div>
               <div>
                 <h2>Schema</h2>
-                <p class="section-copy">Machine-readable OpenAPI is still available. Operator API routes are included and require admin Basic auth.</p>
+                <p class="section-copy">Machine-readable OpenAPI is available for the public hostname and router endpoints.</p>
                 {_code_window(schema_example, copy_label="schema command", class_name="mt-3")}
               </div>
-              <div>
-                <h2>Operator API</h2>
-                <p class="section-copy">Admin endpoints use the same HTTP Basic auth as the operator console.</p>
-                {_code_window(admin_dashboard_example, copy_label="admin dashboard command", class_name="mt-3")}
-                {_code_window(admin_history_example, copy_label="admin history command", class_name="mt-3")}
-              </div>
             </div>
           </section>
         </main>