Server: no built-in public host, no trusted proxy by default; OpenAPI server variable host (D-123)

KVITT_PUBLIC_URL is required: every command refuses to start without it (compose
always sets it). KVITT_TRUSTED_PROXY defaults to none, which the rate limiter never
resolves. contracts/openapi.yaml and the utoipa document: servers[].url
https://{host}:8443 with variable host (default kvitt.example.invalid). E-7 and E-12
examples on kvitt.example.invalid.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TQd3pEP9UeN2uifbHknQ7B

server/crates/kvitt-server/tests/core_api/cli.rs

@@ -39,6 +39,30 @@ fn printed_code(output: &Output) -> String {
     code.to_owned()
 }
 
+#[test]
+fn every_command_refuses_to_start_without_a_public_url() {
+    // SPEC §10.4: KVITT_PUBLIC_URL has no built-in host; compose always sets it.
+    let dir = TempDir::new();
+    for args in [&["serve"][..], &["bootstrap"], &["migrate"]] {
+        let output = Command::new(env!("CARGO_BIN_EXE_kvitt-server"))
+            .args(args)
+            .env("KVITT_DATA_DIR", &dir.0)
+            .env_remove("KVITT_PUBLIC_URL")
+            .env("RUST_LOG", "warn")
+            .output()
+            .unwrap();
+        assert_eq!(output.status.code(), Some(1), "{args:?}: {output:?}");
+        let stderr = String::from_utf8_lossy(&output.stderr);
+        assert!(
+            stderr.starts_with("configuration: KVITT_PUBLIC_URL is not set"),
+            "{args:?}: {stderr}"
+        );
+        assert!(output.stdout.is_empty(), "{args:?}");
+    }
+    // Nothing was created: the server stopped before opening the database.
+    assert!(!dir.0.join("kvitt.sqlite").exists());
+}
+
 #[tokio::test]
 async fn bootstrap_prints_an_admin_setup_invite_cancels_the_previous_one_then_refuses() {
     let dir = TempDir::new();

server/crates/kvitt-server/tests/core_api/invites.rs

@@ -219,9 +219,7 @@ async fn e12_partner_invite_matches_the_example() {
     assert_eq!(code.len(), 12);
     assert_eq!(
         reply.json["link"],
-        json!(format!(
-            "https://icehack.asuscomm.com:8443/i/{code}?from=Jacob"
-        ))
+        json!(format!("{PUBLIC_URL}/i/{code}?from=Jacob"))
     );
     assert_eq!(reply.json["created_at"], NOW);
     assert_eq!(reply.json["expires_at"], "2026-10-20T12:00:00.000Z");

server/crates/kvitt-server/tests/core_api/landing.rs

@@ -34,9 +34,9 @@ async fn e4_english_by_default_with_both_links_and_the_grouped_code() {
     assert!(html.contains(">Open in Kvitt</a>"));
     assert!(html.contains("7K3M-QX9D-2HPA"));
     assert!(html.contains(
-        "href=\"kvitt://invite?server=https%3A%2F%2Ficehack%2Easuscomm%2Ecom%3A8443&amp;code=7K3MQX9D2HPA\""
+        "href=\"kvitt://invite?server=https%3A%2F%2Fkvitt%2Eexample%2Einvalid%3A8443&amp;code=7K3MQX9D2HPA\""
     ));
-    assert!(html.contains("href=\"https://icehack.asuscomm.com:8443/apk/files/kvitt-412.apk\""));
+    assert!(html.contains("href=\"https://kvitt.example.invalid:8443/apk/files/kvitt-412.apk\""));
 }
 
 #[tokio::test]
@@ -90,7 +90,7 @@ async fn e4_passes_the_admin_name_of_an_e12_link_into_the_app_link_only() {
     assert_eq!(reply.status, 200);
     let html = reply.text();
     assert!(html.contains(
-        "href=\"kvitt://invite?server=https%3A%2F%2Ficehack%2Easuscomm%2Ecom%3A8443&amp;code=7K3MQX9D2HPA&amp;from=%C3%85sa%20Berg\""
+        "href=\"kvitt://invite?server=https%3A%2F%2Fkvitt%2Eexample%2Einvalid%3A8443&amp;code=7K3MQX9D2HPA&amp;from=%C3%85sa%20Berg\""
     ), "{html}");
     // The name is not shown on the page itself.
     assert!(!html.contains("Åsa"));