fix(docs-demo): sync admin settings sections with manifest

The demo Settings screen was fed by a frozen snapshot baked into the externally generated demoDataset.js, so it drifted from the real manifest: the Remnawave Panel (plus System and Migrations) sections were missing and trial/checkout/common still showed as top-level sections instead of subsections. Generate frontend/src/lib/webapp/settingsManifest.generated.json from manifest_payload() (the same source the live /admin/settings endpoint uses) via scripts/export_settings_manifest.py, and build the demo section structure from it, overlaying realistic demo values per field key. A pytest drift guard fails if the Python manifest changes without regenerating the snapshot, so the demo stays in sync going forward.
2026-06-02 19:18:11 +03:00
parent 20f1228218
commit 70e6fa382b
4 changed files with 5651 additions and 9 deletions
@@ -0,0 +1,51 @@
+"""Guard that the demo settings manifest snapshot stays in sync with Python.
+
+The Mini App demo feeds its admin Settings screen from
+``frontend/src/lib/webapp/settingsManifest.generated.json``, generated off the
+real :func:`manifest_payload`. If a developer adds or changes a settings field
+in Python without regenerating that snapshot, this test fails and tells them how
+to refresh it — keeping the demo automatically in step with reality.
+"""
+
+from __future__ import annotations
+
+import importlib.util
+import json
+import unittest
+from pathlib import Path
+
+_REPO_ROOT = Path(__file__).resolve().parents[1]
+_GENERATOR_PATH = _REPO_ROOT / "scripts" / "export_settings_manifest.py"
+
+_spec = importlib.util.spec_from_file_location("export_settings_manifest", _GENERATOR_PATH)
+export_settings_manifest = importlib.util.module_from_spec(_spec)
+_spec.loader.exec_module(export_settings_manifest)
+
+OUTPUT_PATH = export_settings_manifest.OUTPUT_PATH
+build_demo_settings_sections = export_settings_manifest.build_demo_settings_sections
+
+
+class SettingsManifestDemoSyncTests(unittest.TestCase):
+    def test_committed_snapshot_matches_manifest(self):
+        self.assertTrue(
+            OUTPUT_PATH.exists(),
+            "Generated settings manifest snapshot is missing; run "
+            "`python scripts/export_settings_manifest.py`.",
+        )
+        committed = json.loads(OUTPUT_PATH.read_text(encoding="utf-8"))
+        expected = build_demo_settings_sections()
+        self.assertEqual(
+            committed,
+            expected,
+            "Demo settings manifest is stale. Regenerate it with "
+            "`python scripts/export_settings_manifest.py` and re-run Prettier.",
+        )
+
+    def test_snapshot_includes_remnawave_section(self):
+        committed = json.loads(OUTPUT_PATH.read_text(encoding="utf-8"))
+        section_ids = {section["id"] for section in committed}
+        self.assertIn("remnawave", section_ids)
+
+
+if __name__ == "__main__":
+    unittest.main()