ODS 完成

etl_billiards/tasks/coupon_usage_task.py

@@ -3,65 +3,66 @@
 
 import json
 
-from .base_task import BaseTask
+from .base_task import BaseTask, TaskContext
 from loaders.facts.coupon_usage import CouponUsageLoader
 from models.parsers import TypeParser
 
 
 class CouponUsageTask(BaseTask):
-    """同步平台券验证/核销记录"""
+    """同步平台券验券/核销记录"""
 
     def get_task_code(self) -> str:
         return "COUPON_USAGE"
 
-    def execute(self) -> dict:
-        self.logger.info("开始执行 COUPON_USAGE 任务")
-        window_start, window_end, _ = self._get_time_window()
-        params = {
-            "storeId": self.config.get("app.store_id"),
-            "startTime": TypeParser.format_timestamp(window_start, self.tz),
-            "endTime": TypeParser.format_timestamp(window_end, self.tz),
+    def extract(self, context: TaskContext) -> dict:
+        params = self._merge_common_params(
+            {
+                "siteId": context.store_id,
+                "startTime": TypeParser.format_timestamp(context.window_start, self.tz),
+                "endTime": TypeParser.format_timestamp(context.window_end, self.tz),
+            }
+        )
+        records, _ = self.api.get_paginated(
+            endpoint="/Promotion/GetOfflineCouponConsumePageList",
+            params=params,
+            page_size=self.config.get("api.page_size", 200),
+            data_path=("data",),
+        )
+        return {"records": records}
+
+    def transform(self, extracted: dict, context: TaskContext) -> dict:
+        parsed, skipped = [], 0
+        for raw in extracted.get("records", []):
+            mapped = self._parse_usage(raw, context.store_id)
+            if mapped:
+                parsed.append(mapped)
+            else:
+                skipped += 1
+        return {
+            "records": parsed,
+            "fetched": len(extracted.get("records", [])),
+            "skipped": skipped,
         }
 
-        try:
-            records, _ = self.api.get_paginated(
-                endpoint="/Coupon/UsageList",
-                params=params,
-                page_size=self.config.get("api.page_size", 200),
-                data_path=(),
-            )
+    def load(self, transformed: dict, context: TaskContext) -> dict:
+        loader = CouponUsageLoader(self.db)
+        inserted, updated, loader_skipped = loader.upsert_coupon_usage(
+            transformed["records"]
+        )
+        return {
+            "fetched": transformed["fetched"],
+            "inserted": inserted,
+            "updated": updated,
+            "skipped": transformed["skipped"] + loader_skipped,
+            "errors": 0,
+        }
 
-            parsed = []
-            for raw in records:
-                mapped = self._parse_usage(raw)
-                if mapped:
-                    parsed.append(mapped)
-
-            loader = CouponUsageLoader(self.db)
-            inserted, updated, skipped = loader.upsert_coupon_usage(parsed)
-
-            self.db.commit()
-            counts = {
-                "fetched": len(records),
-                "inserted": inserted,
-                "updated": updated,
-                "skipped": skipped,
-                "errors": 0,
-            }
-            self.logger.info(f"COUPON_USAGE 完成: {counts}")
-            return self._build_result("SUCCESS", counts)
-        except Exception:
-            self.db.rollback()
-            self.logger.error("COUPON_USAGE 失败", exc_info=True)
-            raise
-
-    def _parse_usage(self, raw: dict) -> dict | None:
+    def _parse_usage(self, raw: dict, store_id: int) -> dict | None:
         usage_id = TypeParser.parse_int(raw.get("id"))
         if not usage_id:
-            self.logger.warning("跳过缺少 id 的券核销记录: %s", raw)
+            self.logger.warning("跳过缺少券核销ID的记录: %s", raw)
             return None
 
-        store_id = self.config.get("app.store_id")
         return {
             "store_id": store_id,
             "usage_id": usage_id,