ODS 完成

etl_billiards/tasks/refunds_task.py

@@ -3,7 +3,7 @@
 
 import json
 
-from .base_task import BaseTask
+from .base_task import BaseTask, TaskContext
 from loaders.facts.refund import RefundLoader
 from models.parsers import TypeParser
 
@@ -14,54 +14,53 @@ class RefundsTask(BaseTask):
     def get_task_code(self) -> str:
         return "REFUNDS"
 
-    def execute(self) -> dict:
-        self.logger.info("开始执行 REFUNDS 任务")
-        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="/Order/GetRefundPayLogList",
+            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_refund(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="/Pay/RefundList",
-                params=params,
-                page_size=self.config.get("api.page_size", 200),
-                data_path=(),
-            )
+    def load(self, transformed: dict, context: TaskContext) -> dict:
+        loader = RefundLoader(self.db)
+        inserted, updated, loader_skipped = loader.upsert_refunds(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_refund(raw)
-                if mapped:
-                    parsed.append(mapped)
-
-            loader = RefundLoader(self.db)
-            inserted, updated, skipped = loader.upsert_refunds(parsed)
-
-            self.db.commit()
-            counts = {
-                "fetched": len(records),
-                "inserted": inserted,
-                "updated": updated,
-                "skipped": skipped,
-                "errors": 0,
-            }
-            self.logger.info(f"REFUNDS 完成: {counts}")
-            return self._build_result("SUCCESS", counts)
-        except Exception:
-            self.db.rollback()
-            self.logger.error("REFUNDS 失败", exc_info=True)
-            raise
-
-    def _parse_refund(self, raw: dict) -> dict | None:
+    def _parse_refund(self, raw: dict, store_id: int) -> dict | None:
         refund_id = TypeParser.parse_int(raw.get("id"))
         if not refund_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,
             "refund_id": refund_id,