fix: URL persistence in export + cache-busting v4.8.0

- getDocument() now explicitly lists all block fields including url
- loadDocument() initializes url/series_id for backward compat with older JSONs
- Cache-busting query params (?v=4.8) on all static assets
- PDF generator uses block.url directly (proper model field)
- Added 7 new URL tests (model, API, PDF link annotations)
- Version bumped to 4.8.0

tests/test_api.py

@@ -185,3 +185,23 @@ def test_backward_compat_date_field(client):
     r = client.post("/api/validate", json=doc)
     assert r.status_code == 200
     assert r.json()["valid"] is True
+
+
+def test_generate_pdf_with_url_block(client):
+    """PDF generation should succeed when blocks contain url field."""
+    doc = make_valid_doc()
+    doc["blocks"][0]["url"] = "https://example.com/linked"
+    r = client.post("/api/generate-pdf", json=doc)
+    assert r.status_code == 200
+    assert r.content[:5] == b'%PDF-'
+    # Verify link annotation is present in the PDF
+    assert b'example.com/linked' in r.content
+
+
+def test_validate_accepts_url_field(client):
+    """Blocks with or without url should both validate successfully."""
+    doc = make_valid_doc()
+    doc["blocks"][0]["url"] = "https://example.com"
+    r = client.post("/api/validate", json=doc)
+    assert r.status_code == 200
+    assert r.json()["valid"] is True

tests/test_core.py

@@ -22,6 +22,7 @@ def test_block_optional_fields():
     b = Block(date="2026-03-01", start="09:00", end="10:00", title="Test", type_id="ws")
     assert b.responsible is None
     assert b.notes is None
+    assert b.url is None
     assert b.series_id is None
 
 
@@ -31,6 +32,26 @@ def test_block_series_id():
     assert b.series_id == "s_abc123"
 
 
+def test_block_with_url():
+    b = Block(date="2026-03-01", start="09:00", end="10:00", title="Test", type_id="ws",
+              url="https://example.com/test")
+    assert b.url == "https://example.com/test"
+
+
+def test_block_url_in_serialization():
+    """url field must appear in serialized JSON even when None."""
+    b = Block(id="b1", date="2026-03-01", start="09:00", end="10:00",
+              title="Test", type_id="ws")
+    data = b.model_dump(mode="json")
+    assert "url" in data
+    assert data["url"] is None
+
+    b2 = Block(id="b2", date="2026-03-01", start="09:00", end="10:00",
+               title="Test", type_id="ws", url="https://example.com")
+    data2 = b2.model_dump(mode="json")
+    assert data2["url"] == "https://example.com"
+
+
 def test_block_with_all_fields():
     b = Block(
         id="custom-id", date="2026-03-01", start="09:00", end="10:00",

tests/test_pdf.py

@@ -173,3 +173,60 @@ def test_generate_pdf_no_notes_single_page():
     pdf_bytes = generate_pdf(doc)
     pages = len(re.findall(rb'/Type\s*/Page[^s]', pdf_bytes))
     assert pages == 1, f"Expected 1 page, got {pages}"
+
+
+def test_generate_pdf_block_with_url_creates_link():
+    """Block with url should produce a clickable link annotation in PDF."""
+    import re
+    doc = make_doc(
+        blocks=[
+            Block(id="b1", date="2026-03-01", start="09:00", end="10:00",
+                  title="Linked Block", type_id="ws",
+                  url="https://example.com/test"),
+        ]
+    )
+    pdf_bytes = generate_pdf(doc)
+    assert pdf_bytes[:5] == b'%PDF-'
+    # Must contain a /URI annotation with the URL
+    uris = re.findall(rb'/URI\s*\(([^)]+)\)', pdf_bytes)
+    assert len(uris) == 1, f"Expected 1 URI annotation, got {len(uris)}"
+    assert uris[0] == b'https://example.com/test'
+    # Must have a Link subtype annotation
+    assert re.search(rb'/Subtype\s*/Link', pdf_bytes), "Missing /Subtype /Link annotation"
+
+
+def test_generate_pdf_block_without_url_no_link():
+    """Blocks without url should NOT produce link annotations."""
+    import re
+    doc = make_doc(
+        blocks=[
+            Block(id="b1", date="2026-03-01", start="09:00", end="10:00",
+                  title="No Link", type_id="ws"),
+        ]
+    )
+    pdf_bytes = generate_pdf(doc)
+    assert pdf_bytes[:5] == b'%PDF-'
+    uris = re.findall(rb'/URI\s*\(([^)]+)\)', pdf_bytes)
+    assert len(uris) == 0, f"Expected 0 URI annotations, got {len(uris)}"
+
+
+def test_generate_pdf_mixed_url_blocks():
+    """Only blocks with url should produce link annotations."""
+    import re
+    doc = make_doc(
+        blocks=[
+            Block(id="b1", date="2026-03-01", start="09:00", end="10:00",
+                  title="Has Link", type_id="ws",
+                  url="https://example.com/one"),
+            Block(id="b2", date="2026-03-01", start="10:00", end="11:00",
+                  title="No Link", type_id="ws"),
+            Block(id="b3", date="2026-03-01", start="11:00", end="12:00",
+                  title="Also Linked", type_id="ws",
+                  url="https://example.com/two"),
+        ]
+    )
+    pdf_bytes = generate_pdf(doc)
+    uris = re.findall(rb'/URI\s*\(([^)]+)\)', pdf_bytes)
+    assert len(uris) == 2, f"Expected 2 URI annotations, got {len(uris)}"
+    urls = sorted(u.decode() for u in uris)
+    assert urls == ['https://example.com/one', 'https://example.com/two']