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/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