Add Phase 5: link-card fragments, oEmbed endpoints, OG meta

- fetch_fragment_batch() for N+1 avoidance with per-key Redis cache - link-card fragment handlers in blog, market, events, federation (single + batch mode) - link_card.html templates per app with content-specific previews - shared/infrastructure/oembed.py: build_oembed_response, build_og_meta, build_oembed_link_tag - GET /oembed routes on blog, market, events - og_meta + oembed_link rendering in base template <head> - INTERNAL_URL_ARTDAG in docker-compose.yml for cross-stack fragment fetches Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 21:44:11 +00:00
parent 4d7f8cfea2
commit b3d853ad35
15 changed files with 601 additions and 0 deletions
--- a/blog/app.py
+++ b/blog/app.py
@@ -119,6 +119,36 @@ def create_app() -> "Quart":
            obj.value = val
        return {"ok": True, "key": key, "value": val}

+    # --- oEmbed endpoint ---
+    @app.get("/oembed")
+    async def oembed():
+        from urllib.parse import urlparse
+        from quart import jsonify
+        from shared.services.registry import services
+        from shared.infrastructure.urls import blog_url
+        from shared.infrastructure.oembed import build_oembed_response
+
+        url = request.args.get("url", "")
+        if not url:
+            return jsonify({"error": "url parameter required"}), 400
+
+        parsed = urlparse(url)
+        slug = parsed.path.strip("/").split("/")[-1] if parsed.path else ""
+        if not slug:
+            return jsonify({"error": "could not extract slug"}), 404
+
+        post = await services.blog.get_post_by_slug(g.s, slug)
+        if not post:
+            return jsonify({"error": "not found"}), 404
+
+        resp = build_oembed_response(
+            title=post.title,
+            oembed_type="link",
+            thumbnail_url=post.feature_image,
+            url=blog_url(f"/{post.slug}"),
+        )
+        return jsonify(resp)
+
    # --- debug: url rules ---
    @app.get("/__rules")
    async def dump_rules():
--- a/blog/bp/fragments/routes.py
+++ b/blog/bp/fragments/routes.py
@@ -46,6 +46,49 @@ def register():

    _handlers["nav-tree"] = _nav_tree_handler

+    # --- link-card fragment ---
+    async def _link_card_handler():
+        from shared.services.registry import services
+        from shared.infrastructure.urls import blog_url
+
+        slug = request.args.get("slug", "")
+        keys_raw = request.args.get("keys", "")
+
+        # Batch mode
+        if keys_raw:
+            slugs = [k.strip() for k in keys_raw.split(",") if k.strip()]
+            parts = []
+            for s in slugs:
+                parts.append(f"<!-- fragment:{s} -->")
+                post = await services.blog.get_post_by_slug(g.s, s)
+                if post:
+                    parts.append(await render_template(
+                        "fragments/link_card.html",
+                        title=post.title,
+                        feature_image=post.feature_image,
+                        excerpt=post.custom_excerpt or post.excerpt,
+                        published_at=post.published_at,
+                        link=blog_url(f"/{post.slug}"),
+                    ))
+            return "\n".join(parts)
+
+        # Single mode
+        if not slug:
+            return ""
+        post = await services.blog.get_post_by_slug(g.s, slug)
+        if not post:
+            return ""
+        return await render_template(
+            "fragments/link_card.html",
+            title=post.title,
+            feature_image=post.feature_image,
+            excerpt=post.custom_excerpt or post.excerpt,
+            published_at=post.published_at,
+            link=blog_url(f"/{post.slug}"),
+        )
+
+    _handlers["link-card"] = _link_card_handler
+
    # Store handlers dict on blueprint so app code can register handlers
    bp._fragment_handlers = _handlers

--- a/blog/templates/fragments/link_card.html
+++ b/blog/templates/fragments/link_card.html
@@ -0,0 +1,20 @@
+<a href="{{ link }}" class="block rounded border border-stone-200 bg-white hover:bg-stone-50 transition-colors no-underline" data-fragment="link-card" data-app="blog" data-hx-disable>
+  <div class="flex flex-row items-start gap-3 p-3">
+    {% if feature_image %}
+      <img src="{{ feature_image }}" alt="" class="flex-shrink-0 w-16 h-16 rounded object-cover">
+    {% else %}
+      <div class="flex-shrink-0 w-16 h-16 rounded bg-stone-100 flex items-center justify-center text-stone-400">
+        <i class="fas fa-file-alt text-lg"></i>
+      </div>
+    {% endif %}
+    <div class="flex-1 min-w-0">
+      <div class="font-medium text-stone-900 text-sm clamp-2">{{ title }}</div>
+      {% if excerpt %}
+        <div class="text-xs text-stone-500 mt-1 clamp-2">{{ excerpt }}</div>
+      {% endif %}
+      {% if published_at %}
+        <div class="text-xs text-stone-400 mt-1">{{ published_at.strftime('%d %b %Y') }}</div>
+      {% endif %}
+    </div>
+  </div>
+</a>