[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M70FZBSNA04F737EBSTCQP8D":3,"skill-same:01M70FZBSNA04F737EBSTCQP8D":63},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":34,"linkOnly":35,"markdownContent":36,"markdownBody":37,"frontMatter":38,"refName":39,"commitSha":40,"skillDirectory":41,"forksCount":42,"repositoryHtmlUrl":43,"repositoryHomepageUrl":44,"ownerHtmlUrl":45,"ownerBlogUrl":46,"ownerDescription":47,"updatedAt":48,"install":49,"resources":62},"01M70FZBSNA04F737EBSTCQP8D","projection-patterns",null,"Build read models and projections from event streams. Use when implementing CQRS read sides, building materialized views, or optimizing query performance in event-sourced systems.","shengdabai\u002FTony-Claude-Code-Skills","shengdabai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F116417419?v=4","01M70F6D2WY5PQV5A92BKYJQEW","Tony Sheng","01M70F6D3GAAAYZ5H4CC1G8VXM",3,"MIT","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Fplugins\u002Fbackend-development\u002Fskills\u002Fprojection-patterns\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33],"projection patterns","patterns","event","performance","projections","implementing","streams","use","when","query","cqrs","build","models","read","systems","2026-11-10 10:12:30",false,"---\nname: projection-patterns\ndescription: Build read models and projections from event streams. Use when implementing CQRS read sides, building materialized views, or optimizing query performance in event-sourced systems.\n---\n\n# Projection Patterns\n\nComprehensive guide to building projections and read models for event-sourced systems.\n\n## When to Use This Skill\n\n- Building CQRS read models\n- Creating materialized views from events\n- Optimizing query performance\n- Implementing real-time dashboards\n- Building search indexes from events\n- Aggregating data across streams\n\n## Core Concepts\n\n### 1. Projection Architecture\n\n```\n┌─────────────┐     ┌─────────────┐     ┌─────────────┐\n│ Event Store │────►│ Projector   │────►│ Read Model  │\n│             │     │             │     │ (Database)  │\n│ ┌─────────┐ │     │ ┌─────────┐ │     │ ┌─────────┐ │\n│ │ Events  │ │     │ │ Handler │ │     │ │ Tables  │ │\n│ └─────────┘ │     │ │ Logic   │ │     │ │ Views   │ │\n│             │     │ └─────────┘ │     │ │ Cache   │ │\n└─────────────┘     └─────────────┘     └─────────────┘\n```\n\n### 2. Projection Types\n\n| Type | Description | Use Case |\n|------|-------------|----------|\n| **Live** | Real-time from subscription | Current state queries |\n| **Catchup** | Process historical events | Rebuilding read models |\n| **Persistent** | Stores checkpoint | Resume after restart |\n| **Inline** | Same transaction as write | Strong consistency |\n\n## Templates\n\n### Template 1: Basic Projector\n\n```python\nfrom abc import ABC, abstractmethod\nfrom dataclasses import dataclass\nfrom typing import Dict, Any, Callable, List\nimport asyncpg\n\n@dataclass\nclass Event:\n    stream_id: str\n    event_type: str\n    data: dict\n    version: int\n    global_position: int\n\n\nclass Projection(ABC):\n    \"\"\"Base class for projections.\"\"\"\n\n    @property\n    @abstractmethod\n    def name(self) -> str:\n        \"\"\"Unique projection name for checkpointing.\"\"\"\n        pass\n\n    @abstractmethod\n    def handles(self) -> List[str]:\n        \"\"\"List of event types this projection handles.\"\"\"\n        pass\n\n    @abstractmethod\n    async def apply(self, event: Event) -> None:\n        \"\"\"Apply event to the read model.\"\"\"\n        pass\n\n\nclass Projector:\n    \"\"\"Runs projections from event store.\"\"\"\n\n    def __init__(self, event_store, checkpoint_store):\n        self.event_store = event_store\n        self.checkpoint_store = checkpoint_store\n        self.projections: List[Projection] = []\n\n    def register(self, projection: Projection):\n        self.projections.append(projection)\n\n    async def run(self, batch_size: int = 100):\n        \"\"\"Run all projections continuously.\"\"\"\n        while True:\n            for projection in self.projections:\n                await self._run_projection(projection, batch_size)\n            await asyncio.sleep(0.1)\n\n    async def _run_projection(self, projection: Projection, batch_size: int):\n        checkpoint = await self.checkpoint_store.get(projection.name)\n        position = checkpoint or 0\n\n        events = await self.event_store.read_all(position, batch_size)\n\n        for event in events:\n            if event.event_type in projection.handles():\n                await projection.apply(event)\n\n            await self.checkpoint_store.save(\n                projection.name,\n                event.global_position\n            )\n\n    async def rebuild(self, projection: Projection):\n        \"\"\"Rebuild a projection from scratch.\"\"\"\n        await self.checkpoint_store.delete(projection.name)\n        # Optionally clear read model tables\n        await self._run_projection(projection, batch_size=1000)\n```\n\n### Template 2: Order Summary Projection\n\n```python\nclass OrderSummaryProjection(Projection):\n    \"\"\"Projects order events to a summary read model.\"\"\"\n\n    def __init__(self, db_pool: asyncpg.Pool):\n        self.pool = db_pool\n\n    @property\n    def name(self) -> str:\n        return \"order_summary\"\n\n    def handles(self) -> List[str]:\n        return [\n            \"OrderCreated\",\n            \"OrderItemAdded\",\n            \"OrderItemRemoved\",\n            \"OrderShipped\",\n            \"OrderCompleted\",\n            \"OrderCancelled\"\n        ]\n\n    async def apply(self, event: Event) -> None:\n        handlers = {\n            \"OrderCreated\": self._handle_created,\n            \"OrderItemAdded\": self._handle_item_added,\n            \"OrderItemRemoved\": self._handle_item_removed,\n            \"OrderShipped\": self._handle_shipped,\n            \"OrderCompleted\": self._handle_completed,\n            \"OrderCancelled\": self._handle_cancelled,\n        }\n\n        handler = handlers.get(event.event_type)\n        if handler:\n            await handler(event)\n\n    async def _handle_created(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                INSERT INTO order_summaries\n                (order_id, customer_id, status, total_amount, item_count, created_at)\n                VALUES ($1, $2, $3, $4, $5, $6)\n                \"\"\",\n                event.data['order_id'],\n                event.data['customer_id'],\n                'pending',\n                0,\n                0,\n                event.data['created_at']\n            )\n\n    async def _handle_item_added(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE order_summaries\n                SET total_amount = total_amount + $2,\n                    item_count = item_count + 1,\n                    updated_at = NOW()\n                WHERE order_id = $1\n                \"\"\",\n                event.data['order_id'],\n                event.data['price'] * event.data['quantity']\n            )\n\n    async def _handle_item_removed(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE order_summaries\n                SET total_amount = total_amount - $2,\n                    item_count = item_count - 1,\n                    updated_at = NOW()\n                WHERE order_id = $1\n                \"\"\",\n                event.data['order_id'],\n                event.data['price'] * event.data['quantity']\n            )\n\n    async def _handle_shipped(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE order_summaries\n                SET status = 'shipped',\n                    shipped_at = $2,\n                    updated_at = NOW()\n                WHERE order_id = $1\n                \"\"\",\n                event.data['order_id'],\n                event.data['shipped_at']\n            )\n\n    async def _handle_completed(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE order_summaries\n                SET status = 'completed',\n                    completed_at = $2,\n                    updated_at = NOW()\n                WHERE order_id = $1\n                \"\"\",\n                event.data['order_id'],\n                event.data['completed_at']\n            )\n\n    async def _handle_cancelled(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE order_summaries\n                SET status = 'cancelled',\n                    cancelled_at = $2,\n                    cancellation_reason = $3,\n                    updated_at = NOW()\n                WHERE order_id = $1\n                \"\"\",\n                event.data['order_id'],\n                event.data['cancelled_at'],\n                event.data.get('reason')\n            )\n```\n\n### Template 3: Elasticsearch Search Projection\n\n```python\nfrom elasticsearch import AsyncElasticsearch\n\nclass ProductSearchProjection(Projection):\n    \"\"\"Projects product events to Elasticsearch for full-text search.\"\"\"\n\n    def __init__(self, es_client: AsyncElasticsearch):\n        self.es = es_client\n        self.index = \"products\"\n\n    @property\n    def name(self) -> str:\n        return \"product_search\"\n\n    def handles(self) -> List[str]:\n        return [\n            \"ProductCreated\",\n            \"ProductUpdated\",\n            \"ProductPriceChanged\",\n            \"ProductDeleted\"\n        ]\n\n    async def apply(self, event: Event) -> None:\n        if event.event_type == \"ProductCreated\":\n            await self.es.index(\n                index=self.index,\n                id=event.data['product_id'],\n                document={\n                    'name': event.data['name'],\n                    'description': event.data['description'],\n                    'category': event.data['category'],\n                    'price': event.data['price'],\n                    'tags': event.data.get('tags', []),\n                    'created_at': event.data['created_at']\n                }\n            )\n\n        elif event.event_type == \"ProductUpdated\":\n            await self.es.update(\n                index=self.index,\n                id=event.data['product_id'],\n                doc={\n                    'name': event.data['name'],\n                    'description': event.data['description'],\n                    'category': event.data['category'],\n                    'tags': event.data.get('tags', []),\n                    'updated_at': event.data['updated_at']\n                }\n            )\n\n        elif event.event_type == \"ProductPriceChanged\":\n            await self.es.update(\n                index=self.index,\n                id=event.data['product_id'],\n                doc={\n                    'price': event.data['new_price'],\n                    'price_updated_at': event.data['changed_at']\n                }\n            )\n\n        elif event.event_type == \"ProductDeleted\":\n            await self.es.delete(\n                index=self.index,\n                id=event.data['product_id']\n            )\n```\n\n### Template 4: Aggregating Projection\n\n```python\nclass DailySalesProjection(Projection):\n    \"\"\"Aggregates sales data by day for reporting.\"\"\"\n\n    def __init__(self, db_pool: asyncpg.Pool):\n        self.pool = db_pool\n\n    @property\n    def name(self) -> str:\n        return \"daily_sales\"\n\n    def handles(self) -> List[str]:\n        return [\"OrderCompleted\", \"OrderRefunded\"]\n\n    async def apply(self, event: Event) -> None:\n        if event.event_type == \"OrderCompleted\":\n            await self._increment_sales(event)\n        elif event.event_type == \"OrderRefunded\":\n            await self._decrement_sales(event)\n\n    async def _increment_sales(self, event: Event):\n        date = event.data['completed_at'][:10]  # YYYY-MM-DD\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                INSERT INTO daily_sales (date, total_orders, total_revenue, total_items)\n                VALUES ($1, 1, $2, $3)\n                ON CONFLICT (date) DO UPDATE SET\n                    total_orders = daily_sales.total_orders + 1,\n                    total_revenue = daily_sales.total_revenue + $2,\n                    total_items = daily_sales.total_items + $3,\n                    updated_at = NOW()\n                \"\"\",\n                date,\n                event.data['total_amount'],\n                event.data['item_count']\n            )\n\n    async def _decrement_sales(self, event: Event):\n        date = event.data['original_completed_at'][:10]\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE daily_sales SET\n                    total_orders = total_orders - 1,\n                    total_revenue = total_revenue - $2,\n                    total_refunds = total_refunds + $2,\n                    updated_at = NOW()\n                WHERE date = $1\n                \"\"\",\n                date,\n                event.data['refund_amount']\n            )\n```\n\n### Template 5: Multi-Table Projection\n\n```python\nclass CustomerActivityProjection(Projection):\n    \"\"\"Projects customer activity across multiple tables.\"\"\"\n\n    def __init__(self, db_pool: asyncpg.Pool):\n        self.pool = db_pool\n\n    @property\n    def name(self) -> str:\n        return \"customer_activity\"\n\n    def handles(self) -> List[str]:\n        return [\n            \"CustomerCreated\",\n            \"OrderCompleted\",\n            \"ReviewSubmitted\",\n            \"CustomerTierChanged\"\n        ]\n\n    async def apply(self, event: Event) -> None:\n        async with self.pool.acquire() as conn:\n            async with conn.transaction():\n                if event.event_type == \"CustomerCreated\":\n                    # Insert into customers table\n                    await conn.execute(\n                        \"\"\"\n                        INSERT INTO customers (customer_id, email, name, tier, created_at)\n                        VALUES ($1, $2, $3, 'bronze', $4)\n                        \"\"\",\n                        event.data['customer_id'],\n                        event.data['email'],\n                        event.data['name'],\n                        event.data['created_at']\n                    )\n                    # Initialize activity summary\n                    await conn.execute(\n                        \"\"\"\n                        INSERT INTO customer_activity_summary\n                        (customer_id, total_orders, total_spent, total_reviews)\n                        VALUES ($1, 0, 0, 0)\n                        \"\"\",\n                        event.data['customer_id']\n                    )\n\n                elif event.event_type == \"OrderCompleted\":\n                    # Update activity summary\n                    await conn.execute(\n                        \"\"\"\n                        UPDATE customer_activity_summary SET\n                            total_orders = total_orders + 1,\n                            total_spent = total_spent + $2,\n                            last_order_at = $3\n                        WHERE customer_id = $1\n                        \"\"\",\n                        event.data['customer_id'],\n                        event.data['total_amount'],\n                        event.data['completed_at']\n                    )\n                    # Insert into order history\n                    await conn.execute(\n                        \"\"\"\n                        INSERT INTO customer_order_history\n                        (customer_id, order_id, amount, completed_at)\n                        VALUES ($1, $2, $3, $4)\n                        \"\"\",\n                        event.data['customer_id'],\n                        event.data['order_id'],\n                        event.data['total_amount'],\n                        event.data['completed_at']\n                    )\n\n                elif event.event_type == \"ReviewSubmitted\":\n                    await conn.execute(\n                        \"\"\"\n                        UPDATE customer_activity_summary SET\n                            total_reviews = total_reviews + 1,\n                            last_review_at = $2\n                        WHERE customer_id = $1\n                        \"\"\",\n                        event.data['customer_id'],\n                        event.data['submitted_at']\n                    )\n\n                elif event.event_type == \"CustomerTierChanged\":\n                    await conn.execute(\n                        \"\"\"\n                        UPDATE customers SET tier = $2, updated_at = NOW()\n                        WHERE customer_id = $1\n                        \"\"\",\n                        event.data['customer_id'],\n                        event.data['new_tier']\n                    )\n```\n\n## Best Practices\n\n### Do's\n- **Make projections idempotent** - Safe to replay\n- **Use transactions** - For multi-table updates\n- **Store checkpoints** - Resume after failures\n- **Monitor lag** - Alert on projection delays\n- **Plan for rebuilds** - Design for reconstruction\n\n### Don'ts\n- **Don't couple projections** - Each is independent\n- **Don't skip error handling** - Log and alert on failures\n- **Don't ignore ordering** - Events must be processed in order\n- **Don't over-normalize** - Denormalize for query patterns\n\n## Resources\n\n- [CQRS Pattern](https:\u002F\u002Fdocs.microsoft.com\u002Fen-us\u002Fazure\u002Farchitecture\u002Fpatterns\u002Fcqrs)\n- [Projection Building Blocks](https:\u002F\u002Fzimarev.com\u002Fblog\u002Fevent-sourcing\u002Fprojections\u002F)\n","# Projection Patterns\n\nComprehensive guide to building projections and read models for event-sourced systems.\n\n## When to Use This Skill\n\n- Building CQRS read models\n- Creating materialized views from events\n- Optimizing query performance\n- Implementing real-time dashboards\n- Building search indexes from events\n- Aggregating data across streams\n\n## Core Concepts\n\n### 1. Projection Architecture\n\n```\n┌─────────────┐     ┌─────────────┐     ┌─────────────┐\n│ Event Store │────►│ Projector   │────►│ Read Model  │\n│             │     │             │     │ (Database)  │\n│ ┌─────────┐ │     │ ┌─────────┐ │     │ ┌─────────┐ │\n│ │ Events  │ │     │ │ Handler │ │     │ │ Tables  │ │\n│ └─────────┘ │     │ │ Logic   │ │     │ │ Views   │ │\n│             │     │ └─────────┘ │     │ │ Cache   │ │\n└─────────────┘     └─────────────┘     └─────────────┘\n```\n\n### 2. Projection Types\n\n| Type | Description | Use Case |\n|------|-------------|----------|\n| **Live** | Real-time from subscription | Current state queries |\n| **Catchup** | Process historical events | Rebuilding read models |\n| **Persistent** | Stores checkpoint | Resume after restart |\n| **Inline** | Same transaction as write | Strong consistency |\n\n## Templates\n\n### Template 1: Basic Projector\n\n```python\nfrom abc import ABC, abstractmethod\nfrom dataclasses import dataclass\nfrom typing import Dict, Any, Callable, List\nimport asyncpg\n\n@dataclass\nclass Event:\n    stream_id: str\n    event_type: str\n    data: dict\n    version: int\n    global_position: int\n\n\nclass Projection(ABC):\n    \"\"\"Base class for projections.\"\"\"\n\n    @property\n    @abstractmethod\n    def name(self) -> str:\n        \"\"\"Unique projection name for checkpointing.\"\"\"\n        pass\n\n    @abstractmethod\n    def handles(self) -> List[str]:\n        \"\"\"List of event types this projection handles.\"\"\"\n        pass\n\n    @abstractmethod\n    async def apply(self, event: Event) -> None:\n        \"\"\"Apply event to the read model.\"\"\"\n        pass\n\n\nclass Projector:\n    \"\"\"Runs projections from event store.\"\"\"\n\n    def __init__(self, event_store, checkpoint_store):\n        self.event_store = event_store\n        self.checkpoint_store = checkpoint_store\n        self.projections: List[Projection] = []\n\n    def register(self, projection: Projection):\n        self.projections.append(projection)\n\n    async def run(self, batch_size: int = 100):\n        \"\"\"Run all projections continuously.\"\"\"\n        while True:\n            for projection in self.projections:\n                await self._run_projection(projection, batch_size)\n            await asyncio.sleep(0.1)\n\n    async def _run_projection(self, projection: Projection, batch_size: int):\n        checkpoint = await self.checkpoint_store.get(projection.name)\n        position = checkpoint or 0\n\n        events = await self.event_store.read_all(position, batch_size)\n\n        for event in events:\n            if event.event_type in projection.handles():\n                await projection.apply(event)\n\n            await self.checkpoint_store.save(\n                projection.name,\n                event.global_position\n            )\n\n    async def rebuild(self, projection: Projection):\n        \"\"\"Rebuild a projection from scratch.\"\"\"\n        await self.checkpoint_store.delete(projection.name)\n        # Optionally clear read model tables\n        await self._run_projection(projection, batch_size=1000)\n```\n\n### Template 2: Order Summary Projection\n\n```python\nclass OrderSummaryProjection(Projection):\n    \"\"\"Projects order events to a summary read model.\"\"\"\n\n    def __init__(self, db_pool: asyncpg.Pool):\n        self.pool = db_pool\n\n    @property\n    def name(self) -> str:\n        return \"order_summary\"\n\n    def handles(self) -> List[str]:\n        return [\n            \"OrderCreated\",\n            \"OrderItemAdded\",\n            \"OrderItemRemoved\",\n            \"OrderShipped\",\n            \"OrderCompleted\",\n            \"OrderCancelled\"\n        ]\n\n    async def apply(self, event: Event) -> None:\n        handlers = {\n            \"OrderCreated\": self._handle_created,\n            \"OrderItemAdded\": self._handle_item_added,\n            \"OrderItemRemoved\": self._handle_item_removed,\n            \"OrderShipped\": self._handle_shipped,\n            \"OrderCompleted\": self._handle_completed,\n            \"OrderCancelled\": self._handle_cancelled,\n        }\n\n        handler = handlers.get(event.event_type)\n        if handler:\n            await handler(event)\n\n    async def _handle_created(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                INSERT INTO order_summaries\n                (order_id, customer_id, status, total_amount, item_count, created_at)\n                VALUES ($1, $2, $3, $4, $5, $6)\n                \"\"\",\n                event.data['order_id'],\n                event.data['customer_id'],\n                'pending',\n                0,\n                0,\n                event.data['created_at']\n            )\n\n    async def _handle_item_added(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE order_summaries\n                SET total_amount = total_amount + $2,\n                    item_count = item_count + 1,\n                    updated_at = NOW()\n                WHERE order_id = $1\n                \"\"\",\n                event.data['order_id'],\n                event.data['price'] * event.data['quantity']\n            )\n\n    async def _handle_item_removed(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE order_summaries\n                SET total_amount = total_amount - $2,\n                    item_count = item_count - 1,\n                    updated_at = NOW()\n                WHERE order_id = $1\n                \"\"\",\n                event.data['order_id'],\n                event.data['price'] * event.data['quantity']\n            )\n\n    async def _handle_shipped(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE order_summaries\n                SET status = 'shipped',\n                    shipped_at = $2,\n                    updated_at = NOW()\n                WHERE order_id = $1\n                \"\"\",\n                event.data['order_id'],\n                event.data['shipped_at']\n            )\n\n    async def _handle_completed(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE order_summaries\n                SET status = 'completed',\n                    completed_at = $2,\n                    updated_at = NOW()\n                WHERE order_id = $1\n                \"\"\",\n                event.data['order_id'],\n                event.data['completed_at']\n            )\n\n    async def _handle_cancelled(self, event: Event):\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE order_summaries\n                SET status = 'cancelled',\n                    cancelled_at = $2,\n                    cancellation_reason = $3,\n                    updated_at = NOW()\n                WHERE order_id = $1\n                \"\"\",\n                event.data['order_id'],\n                event.data['cancelled_at'],\n                event.data.get('reason')\n            )\n```\n\n### Template 3: Elasticsearch Search Projection\n\n```python\nfrom elasticsearch import AsyncElasticsearch\n\nclass ProductSearchProjection(Projection):\n    \"\"\"Projects product events to Elasticsearch for full-text search.\"\"\"\n\n    def __init__(self, es_client: AsyncElasticsearch):\n        self.es = es_client\n        self.index = \"products\"\n\n    @property\n    def name(self) -> str:\n        return \"product_search\"\n\n    def handles(self) -> List[str]:\n        return [\n            \"ProductCreated\",\n            \"ProductUpdated\",\n            \"ProductPriceChanged\",\n            \"ProductDeleted\"\n        ]\n\n    async def apply(self, event: Event) -> None:\n        if event.event_type == \"ProductCreated\":\n            await self.es.index(\n                index=self.index,\n                id=event.data['product_id'],\n                document={\n                    'name': event.data['name'],\n                    'description': event.data['description'],\n                    'category': event.data['category'],\n                    'price': event.data['price'],\n                    'tags': event.data.get('tags', []),\n                    'created_at': event.data['created_at']\n                }\n            )\n\n        elif event.event_type == \"ProductUpdated\":\n            await self.es.update(\n                index=self.index,\n                id=event.data['product_id'],\n                doc={\n                    'name': event.data['name'],\n                    'description': event.data['description'],\n                    'category': event.data['category'],\n                    'tags': event.data.get('tags', []),\n                    'updated_at': event.data['updated_at']\n                }\n            )\n\n        elif event.event_type == \"ProductPriceChanged\":\n            await self.es.update(\n                index=self.index,\n                id=event.data['product_id'],\n                doc={\n                    'price': event.data['new_price'],\n                    'price_updated_at': event.data['changed_at']\n                }\n            )\n\n        elif event.event_type == \"ProductDeleted\":\n            await self.es.delete(\n                index=self.index,\n                id=event.data['product_id']\n            )\n```\n\n### Template 4: Aggregating Projection\n\n```python\nclass DailySalesProjection(Projection):\n    \"\"\"Aggregates sales data by day for reporting.\"\"\"\n\n    def __init__(self, db_pool: asyncpg.Pool):\n        self.pool = db_pool\n\n    @property\n    def name(self) -> str:\n        return \"daily_sales\"\n\n    def handles(self) -> List[str]:\n        return [\"OrderCompleted\", \"OrderRefunded\"]\n\n    async def apply(self, event: Event) -> None:\n        if event.event_type == \"OrderCompleted\":\n            await self._increment_sales(event)\n        elif event.event_type == \"OrderRefunded\":\n            await self._decrement_sales(event)\n\n    async def _increment_sales(self, event: Event):\n        date = event.data['completed_at'][:10]  # YYYY-MM-DD\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                INSERT INTO daily_sales (date, total_orders, total_revenue, total_items)\n                VALUES ($1, 1, $2, $3)\n                ON CONFLICT (date) DO UPDATE SET\n                    total_orders = daily_sales.total_orders + 1,\n                    total_revenue = daily_sales.total_revenue + $2,\n                    total_items = daily_sales.total_items + $3,\n                    updated_at = NOW()\n                \"\"\",\n                date,\n                event.data['total_amount'],\n                event.data['item_count']\n            )\n\n    async def _decrement_sales(self, event: Event):\n        date = event.data['original_completed_at'][:10]\n        async with self.pool.acquire() as conn:\n            await conn.execute(\n                \"\"\"\n                UPDATE daily_sales SET\n                    total_orders = total_orders - 1,\n                    total_revenue = total_revenue - $2,\n                    total_refunds = total_refunds + $2,\n                    updated_at = NOW()\n                WHERE date = $1\n                \"\"\",\n                date,\n                event.data['refund_amount']\n            )\n```\n\n### Template 5: Multi-Table Projection\n\n```python\nclass CustomerActivityProjection(Projection):\n    \"\"\"Projects customer activity across multiple tables.\"\"\"\n\n    def __init__(self, db_pool: asyncpg.Pool):\n        self.pool = db_pool\n\n    @property\n    def name(self) -> str:\n        return \"customer_activity\"\n\n    def handles(self) -> List[str]:\n        return [\n            \"CustomerCreated\",\n            \"OrderCompleted\",\n            \"ReviewSubmitted\",\n            \"CustomerTierChanged\"\n        ]\n\n    async def apply(self, event: Event) -> None:\n        async with self.pool.acquire() as conn:\n            async with conn.transaction():\n                if event.event_type == \"CustomerCreated\":\n                    # Insert into customers table\n                    await conn.execute(\n                        \"\"\"\n                        INSERT INTO customers (customer_id, email, name, tier, created_at)\n                        VALUES ($1, $2, $3, 'bronze', $4)\n                        \"\"\",\n                        event.data['customer_id'],\n                        event.data['email'],\n                        event.data['name'],\n                        event.data['created_at']\n                    )\n                    # Initialize activity summary\n                    await conn.execute(\n                        \"\"\"\n                        INSERT INTO customer_activity_summary\n                        (customer_id, total_orders, total_spent, total_reviews)\n                        VALUES ($1, 0, 0, 0)\n                        \"\"\",\n                        event.data['customer_id']\n                    )\n\n                elif event.event_type == \"OrderCompleted\":\n                    # Update activity summary\n                    await conn.execute(\n                        \"\"\"\n                        UPDATE customer_activity_summary SET\n                            total_orders = total_orders + 1,\n                            total_spent = total_spent + $2,\n                            last_order_at = $3\n                        WHERE customer_id = $1\n                        \"\"\",\n                        event.data['customer_id'],\n                        event.data['total_amount'],\n                        event.data['completed_at']\n                    )\n                    # Insert into order history\n                    await conn.execute(\n                        \"\"\"\n                        INSERT INTO customer_order_history\n                        (customer_id, order_id, amount, completed_at)\n                        VALUES ($1, $2, $3, $4)\n                        \"\"\",\n                        event.data['customer_id'],\n                        event.data['order_id'],\n                        event.data['total_amount'],\n                        event.data['completed_at']\n                    )\n\n                elif event.event_type == \"ReviewSubmitted\":\n                    await conn.execute(\n                        \"\"\"\n                        UPDATE customer_activity_summary SET\n                            total_reviews = total_reviews + 1,\n                            last_review_at = $2\n                        WHERE customer_id = $1\n                        \"\"\",\n                        event.data['customer_id'],\n                        event.data['submitted_at']\n                    )\n\n                elif event.event_type == \"CustomerTierChanged\":\n                    await conn.execute(\n                        \"\"\"\n                        UPDATE customers SET tier = $2, updated_at = NOW()\n                        WHERE customer_id = $1\n                        \"\"\",\n                        event.data['customer_id'],\n                        event.data['new_tier']\n                    )\n```\n\n## Best Practices\n\n### Do's\n- **Make projections idempotent** - Safe to replay\n- **Use transactions** - For multi-table updates\n- **Store checkpoints** - Resume after failures\n- **Monitor lag** - Alert on projection delays\n- **Plan for rebuilds** - Design for reconstruction\n\n### Don'ts\n- **Don't couple projections** - Each is independent\n- **Don't skip error handling** - Log and alert on failures\n- **Don't ignore ordering** - Events must be processed in order\n- **Don't over-normalize** - Denormalize for query patterns\n\n## Resources\n\n- [CQRS Pattern](https:\u002F\u002Fdocs.microsoft.com\u002Fen-us\u002Fazure\u002Farchitecture\u002Fpatterns\u002Fcqrs)\n- [Projection Building Blocks](https:\u002F\u002Fzimarev.com\u002Fblog\u002Fevent-sourcing\u002Fprojections\u002F)\n",{"name":5,"description":7},"main","7850740bd837adb32f0a109ab2af82482196c6f2","skills\u002F_collections\u002Fplugins\u002Fbackend-development\u002Fskills\u002Fprojection-patterns",1,"https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills","https:\u002F\u002Fzturnsgo.com","https:\u002F\u002Fgithub.com\u002Fshengdabai","https:\u002F\u002Fzturnsgo.com\u002F","AI × education creator — producer, not consumer. Taught 6,000+ learners; shipping learning tools & daily essays with Claude Code, practicing @xiaolai's way 🥋","2026-11-01 21:28:23",{"source":8,"skillName":5,"commands":50,"prompt":60,"zipAvailable":61},[51,54,57],{"tool":52,"command":53},"npx","npx skills add shengdabai\u002FTony-Claude-Code-Skills --skill projection-patterns",{"tool":55,"command":56},"bunx","bunx skills add shengdabai\u002FTony-Claude-Code-Skills --skill projection-patterns",{"tool":58,"command":59},"pnpm","pnpm dlx skills add shengdabai\u002FTony-Claude-Code-Skills --skill projection-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Fplugins\u002Fbackend-development\u002Fskills\u002Fprojection-patterns\u002FSKILL.md",true,[],[64,73,81,89,97,105],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":68,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":72},"01M73H7XKBHE1ETQDZT94MF9HH","seedance-prompt-en","Write effective prompts for Jimeng Seedance 2.0 multimodal AI video generation. Use when users want to create video prompts using text, images, videos, and audio inputs with the @ reference system. Covers camera movements, effects replication, video extension, editing, music beat-matching, e-commerce ads, short dramas, and educational content.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fseedance-prompt-en\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fseedance-prompt-en\u002FSKILL.md",[],[],"2026-11-11 15:11:14",{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":77,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":72},"01M73GRE9998Q1DZWC71N41JWG","onepage-pdf","Convert an HTML page into a single continuous-page PDF (one tall page, no pagination breaks), preserving desktop layout, backgrounds and selectable text. Use when the user asks to turn an HTML file\u002Freport\u002Fproposal into a \"single-page PDF\", \"long PDF\", \"不分页 PDF\", \"单页 PDF\", \"长图式 PDF\", or complains that an HTML-to-PDF export breaks into pages or cuts content. Supports optional string redaction with leak verification.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fonepage-pdf\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fonepage-pdf\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":85,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":72},"01M73GQG1KZDADVPV3MHAT1J5A","native-feel-cross-platform-desktop","Use when the user is designing, prototyping, or rewriting a desktop app that must run on multiple OSes (macOS + Windows, optionally Linux) AND feel indistinguishable from a native app to its users — fast launch, native windowing, native input handling, native materials. Trigger words include \"cross-platform desktop\", \"Electron alternative\", \"Tauri vs native\", \"WebView wrapper\", \"near-native performance\", \"Raycast architecture\", \"WebKit\u002FWebView2 quirks\", \"WKWebView\", \"system tray app\", \"global hotkey app\", \"launcher app\". Do NOT trigger this skill for pure web apps, pure mobile apps, or for greenfield projects that have no native-feel requirement.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fnative-feel-cross-platform-desktop\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fnative-feel-cross-platform-desktop\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":93,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":72},"01M73G87PDNSMKG2FHWCYER6N8","gstack","Router for the gstack skill suite. (gstack)","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fgstack\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fgstack\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":101,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":72},"01M73G3EAQWKCM8DB8D0N0QSVG","fireworks-tech-graph","Use when the user wants to create any technical diagram - architecture, data flow, flowchart, sequence, agent\u002Fmemory, or concept map - and export as SVG+PNG. Trigger on: \"画图\" \"帮我画\" \"生成图\" \"做个图\" \"架构图\" \"流程图\" \"可视化一下\" \"出图\" \"generate diagram\" \"draw diagram\" \"visualize\" or any system\u002Fflow description the user wants illustrated.","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Ffireworks-tech-graph\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Ffireworks-tech-graph\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":72},"01M73G086AXAH9DW1H5G5N3CPB","dbs-video-extract","接收抖音、小红书、微信视频号等短视频链接或分享文案，查询作品／账号数据并提取语音文字稿，按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用；运行前检查 TikHub 与轻抖使用凭证，缺少时用新手能理解的方式引导购买和安全配置。","https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002Fdbs-video-extract\u002FSKILL.md",[],[]]