package report

// ============================================================
// 通用报表引擎 - 完整调用示例
// ============================================================
//
// 包名: dataengine/common/report
// 入口: report.GetService() → *ReportService
//
// 接口一览:
//   ┌──────────────┬─────────────────────────────────────────────────┐
//   │  分类         │  接口                                           │
//   ├──────────────┼─────────────────────────────────────────────────┤
//   │  配置 CRUD    │  SaveBusiness / DelBusiness / GetBusiness      │
//   │              │  SaveReport   / DelReport   / GetReport        │
//   │              │  SaveField    / DelField    / GetField         │
//   │              │  SaveExtractConfig / DelExtractConfig / Get..  │
//   ├──────────────┼─────────────────────────────────────────────────┤
//   │  数据抽取     │  ExtractDailyData / AutoCreateStatTable        │
//   ├──────────────┼─────────────────────────────────────────────────┤
//   │  报表查询     │  QueryReportByUserSelect                       │
//   ├──────────────┼─────────────────────────────────────────────────┤
//   │  辅助查询     │  GetAllBusinesses / GetAllReports              │
//   │              │  GetReportFields / GetExtractConfigs           │
//   └──────────────┴─────────────────────────────────────────────────┘
//
// ============================================================

// ============================================================================
// 场景一：新平台零代码接入（快手电商为例）
// ============================================================================
//
// 背景：快手订单数据已通过数据引擎同步到 kuaishou_order_list 表（每条订单一行）。
// 需求：按店铺+天聚合订单数据 → 自动建统计宽表 → 抽取 → 前端自由查询报表。
//
// 全程只调 API 不写 SQL，前端管理后台可直接操作。

/*
package example

import (
	"context"
	"encoding/json"
	"fmt"
	"time"

	"dataengine/common/report"
	"dataengine/common/report/model"
)

func KuaishouExample() {
	ctx := context.Background()
	svc := report.GetService()

	// ─── Step 1: 注册业务 ───────────────────────────────────────────
	// 一个业务就是一个数据源平台（快手/抖音/淘宝/...）
	_, _ = svc.SaveBusiness(ctx, &model.SaveBusinessReq{
		BusinessCode: "KUAISHOU",  // 唯一标识，后续所有接口都用它
		BusinessName: "快手电商",
		Description:  "快手平台电商业务线",
		Status:       model.StatusActive,
		Operator:     "admin",
	})

	// ─── Step 2: 注册报表 ───────────────────────────────────────────
	// 一个业务可以有多个报表（店铺日报、商品日报、主播日报...）
	_, _ = svc.SaveReport(ctx, &model.SaveReportReq{
		BusinessCode:     "KUAISHOU",
		ReportCode:       "shop_daily_report",            // 报表唯一编码
		ReportName:       "快手店铺日报",
		StatTableName:    "stat_kuaishou_shop_daily",     // 统计宽表名（自动创建）
		DateField:        "stat_date",                    // 日期字段
		ConflictKeys:     []string{"shop_id", "stat_date"}, // 唯一约束（upsert 依据）
		Operator:         "admin",
	})

	// ─── Step 3: 配置字段（前端可选择的所有维度/指标/筛选） ─────────
	// 这是前端"自定义报表"的数据源 —— 前端建好字段后，
	// 用户选择哪些维度、哪些指标、怎么筛选，实时查。

	// 3a. 维度字段：分组依据，不可聚合
	dimensions := []model.SaveFieldReq{
		{BusinessCode: "KUAISHOU", ReportCode: "shop_daily_report",
			FieldCode: "shop_id", FieldName: "店铺ID", FieldType: "STRING",
			FieldRole: "DIMENSION", IsSortable: true, SortOrder: 1, GroupName: "店铺", Operator: "admin"},
		{BusinessCode: "KUAISHOU", ReportCode: "shop_daily_report",
			FieldCode: "shop_name", FieldName: "店铺名称", FieldType: "STRING",
			FieldRole: "DIMENSION", IsSortable: true, SortOrder: 2, GroupName: "店铺", Operator: "admin"},
		{BusinessCode: "KUAISHOU", ReportCode: "shop_daily_report",
			FieldCode: "stat_date", FieldName: "统计日期", FieldType: "DATE",
			FieldRole: "DIMENSION", IsSortable: true, SortOrder: 3, GroupName: "时间", Operator: "admin"},
	}

	// 3b. 指标字段：聚合度量，前端可选 SUM/COUNT/AVG/MAX/MIN
	indicators := []model.SaveFieldReq{
		{BusinessCode: "KUAISHOU", ReportCode: "shop_daily_report",
			FieldCode: "order_count", FieldName: "订单数", FieldType: "INT",
			FieldRole: "INDICATOR", IsAggregatable: true, DefaultAggregate: "SUM",
			ValidAggregates: []string{"SUM", "COUNT", "AVG", "MAX", "MIN"},
			SortOrder: 10, GroupName: "订单", Operator: "admin"},
		{BusinessCode: "KUAISHOU", ReportCode: "shop_daily_report",
			FieldCode: "order_amount", FieldName: "订单金额(元)", FieldType: "FLOAT",
			FieldRole: "INDICATOR", IsAggregatable: true, DefaultAggregate: "SUM",
			ValidAggregates: []string{"SUM", "AVG", "MAX", "MIN"},
			SortOrder: 11, GroupName: "金额", Unit: "元", Operator: "admin"},
		{BusinessCode: "KUAISHOU", ReportCode: "shop_daily_report",
			FieldCode: "paid_amount", FieldName: "实付金额(元)", FieldType: "FLOAT",
			FieldRole: "INDICATOR", IsAggregatable: true, DefaultAggregate: "SUM",
			ValidAggregates: []string{"SUM", "AVG"},
			SortOrder: 12, GroupName: "金额", Unit: "元", Operator: "admin"},
		{BusinessCode: "KUAISHOU", ReportCode: "shop_daily_report",
			FieldCode: "refund_amount", FieldName: "退款金额(元)", FieldType: "FLOAT",
			FieldRole: "INDICATOR", IsAggregatable: true, DefaultAggregate: "SUM",
			ValidAggregates: []string{"SUM", "AVG"},
			SortOrder: 13, GroupName: "退款", Unit: "元", Operator: "admin"},
		{BusinessCode: "KUAISHOU", ReportCode: "shop_daily_report",
			FieldCode: "buyer_count", FieldName: "下单买家数", FieldType: "INT",
			FieldRole: "INDICATOR", IsAggregatable: true, DefaultAggregate: "COUNT",
			ValidAggregates: []string{"COUNT"},
			SortOrder: 14, GroupName: "用户", Operator: "admin"},
		// 衍生指标：退款率 = 退款金额 / 订单金额 * 100
		{BusinessCode: "KUAISHOU", ReportCode: "shop_daily_report",
			FieldCode: "refund_rate", FieldName: "退款率", FieldType: "FLOAT",
			FieldRole: "INDICATOR", IsAggregatable: true, DefaultAggregate: "AVG",
			Expression: "{refund_amount} / NULLIF({order_amount}, 0) * 100",
			ExpressionType: "CALCULATED", FormatPattern: "#,##0.00",
			Unit: "%", SortOrder: 20, GroupName: "退款", Operator: "admin"},
	}

	// 3c. 筛选字段：纯筛选，不出现在 SELECT 中
	filters := []model.SaveFieldReq{
		{BusinessCode: "KUAISHOU", ReportCode: "shop_daily_report",
			FieldCode: "order_status", FieldName: "订单状态", FieldType: "STRING",
			FieldRole: "FILTER", IsFilterable: true,
			FilterOperators: []string{"=", "IN"},
			SortOrder: 30, GroupName: "筛选", Operator: "admin"},
	}

	for _, f := range dimensions {
		_, _ = svc.SaveField(ctx, &f)
	}
	for _, f := range indicators {
		_, _ = svc.SaveField(ctx, &f)
	}
	for _, f := range filters {
		_, _ = svc.SaveField(ctx, &f)
	}

	// ─── Step 4: 配置数据抽取规则 ────────────────────────────────────
	// 关键：AGGREGATE 模式，从源表聚合到统计宽表
	_, _ = svc.SaveExtractConfig(ctx, &model.SaveExtractConfigReq{
		BusinessCode:     "KUAISHOU",
		ReportCode:       "shop_daily_report",
		ExtractCode:      "extract_shop_daily",
		ExtractName:      "快手店铺订单按天聚合",
		SourceTableName:  "kuaishou_order_list",           // ← 源表（订单明细）
		SourceTableAlias: "o",
		TargetTableName:  "stat_kuaishou_shop_daily",      // ← 目标（统计宽表）
		ExtractType:      model.ExtractTypeIncremental,    // 增量抽取
		ExtractMode:      model.ExtractModeAggregate,      // ← 聚合模式
		ExtractKeyField:  "created_at",                    // 增量依据字段
		GroupByFields:    []string{"shop_id"},             // ← GROUP BY
		FilterExpression: "o.order_status != 'CANCELLED'", // 过滤取消订单
		// 字段映射：源表字段 → 目标表字段 + 聚合函数
		FieldMappings: []model.FieldMapping{
			{SourceField: "shop_id",      TargetField: "shop_id",      FieldType: "STRING"},
			{SourceField: "shop_name",    TargetField: "shop_name",    FieldType: "STRING"},
			{SourceField: "id",           TargetField: "order_count",  FieldType: "INT",   AggregateFunction: "COUNT"},
			{SourceField: "order_amount", TargetField: "order_amount", FieldType: "FLOAT", AggregateFunction: "SUM"},
			{SourceField: "paid_amount",  TargetField: "paid_amount",  FieldType: "FLOAT", AggregateFunction: "SUM"},
			{SourceField: "refund_amount",TargetField: "refund_amount",FieldType: "FLOAT", AggregateFunction: "SUM"},
			{SourceField: "buyer_id",     TargetField: "buyer_count",  FieldType: "INT",   AggregateFunction: "COUNT"},
		},
		BatchSize: 1000,
		Operator:  "admin",
	})

	// ─── Step 5: 每天定时抽取（cron/k8s CronJob 中调用） ─────────
	// ExtractDailyData 内部：
	//   1. 检测 stat_kuaishou_shop_daily 表是否存在
	//   2. 不存在 → 根据 FieldConfig 自动 CREATE TABLE
	//   3. 从 kuaishou_order_list 按 AGGREGATE 模式抽取当天数据
	//   4. UPSERT 到统计宽表
	today := time.Now().Format("2006-01-02")
	resp, _ := svc.ExtractDailyData(ctx, "KUAISHOU", "shop_daily_report", today, "cron")
	fmt.Printf("[%s] 抽取完成: 总%d 成功%d 失败%d 耗时%dms\n",
		today, resp.TotalCount, resp.SuccessCount, resp.FailCount, resp.ExecTimeMs)

	// 实际抽取生成的 SQL（AGGREGATE 模式）:
	//
	// INSERT INTO stat_kuaishou_shop_daily (...)
	// SELECT ROW_NUMBER() OVER () AS id,
	//        '2026-06-10' AS stat_date,
	//        o.shop_id, o.shop_name,
	//        COUNT(o.id)    AS order_count,
	//        SUM(o.order_amount) AS order_amount,
	//        SUM(o.paid_amount)  AS paid_amount,
	//        SUM(o.refund_amount) AS refund_amount,
	//        COUNT(o.buyer_id) AS buyer_count
	// FROM kuaishou_order_list o
	// WHERE o.created_at::date = '2026-06-10'
	// GROUP BY o.shop_id

	// ─── Step 6: 前端查询 ──────────────────────────────────────────

	// 6a. 前端先拉取可用字段列表
	fields, _ := svc.GetReportFields(ctx, "KUAISHOU", "shop_daily_report")
	// 返回:
	//   dimensions: [shop_id, shop_name, stat_date]
	//   indicators: [order_count, order_amount, paid_amount, refund_amount, buyer_count, refund_rate]
	//   filters:    [order_status]
	// 前端据此渲染选择器面板

	// 6b. 用户选择: 维度=店铺, 指标=金额+订单数, 时间=近7天, 排名=TOP10
	top10Req := &model.UserSelectQueryReq{
		BusinessCode: "KUAISHOU",
		ReportCode:   "shop_daily_report",
		Dimensions:   []string{"shop_id", "shop_name"},
		Indicators: []model.IndicatorSelect{
			{FieldCode: "order_amount", Aggregate: "SUM", Alias: "total_amount"},
			{FieldCode: "order_count",  Aggregate: "SUM", Alias: "total_orders"},
			{FieldCode: "paid_amount",  Aggregate: "SUM", Alias: "total_paid"},
			{FieldCode: "refund_rate",  Aggregate: "AVG", Alias: "avg_refund_rate"},
		},
		TimeRange: &model.TimeRange{
			StartDate: time.Now().AddDate(0, 0, -7).Format("2006-01-02"),
			EndDate:   today,
		},
		OrderBy:  []model.OrderCondition{{FieldCode: "total_amount", Direction: "DESC"}},
		Page:     1,
		PageSize: 10,
	}
	top10Resp, _ := svc.QueryReportByUserSelect(ctx, top10Req)
	fmt.Printf("TOP10 销售额排行 (总数=%d):\n", top10Resp.Total)
	for i, row := range top10Resp.List {
		b, _ := json.Marshal(row)
		fmt.Printf("  %d. %s\n", i+1, string(b))
	}
	// 实际生成 SQL:
	// SELECT o.shop_id, o.shop_name,
	//        SUM(o.order_amount) AS total_amount,
	//        SUM(o.order_count)  AS total_orders,
	//        SUM(o.paid_amount)  AS total_paid,
	//        AVG(refund_amount / NULLIF(order_amount,0) * 100) AS avg_refund_rate
	// FROM stat_kuaishou_shop_daily o
	// WHERE stat_date BETWEEN '2026-06-03' AND '2026-06-10'
	// GROUP BY o.shop_id, o.shop_name
	// ORDER BY total_amount DESC
	// LIMIT 10 OFFSET 0

	// 6c. 用户切换维度: 每日趋势（聚合所有店铺）
	trendReq := &model.UserSelectQueryReq{
		BusinessCode: "KUAISHOU",
		ReportCode:   "shop_daily_report",
		Dimensions:   []string{"stat_date"},
		Indicators: []model.IndicatorSelect{
			{FieldCode: "order_amount", Aggregate: "SUM", Alias: "daily_amount"},
			{FieldCode: "order_count",  Aggregate: "SUM", Alias: "daily_orders"},
			{FieldCode: "refund_amount",Aggregate: "SUM", Alias: "daily_refund"},
		},
		TimeRange: &model.TimeRange{
			StartDate: time.Now().AddDate(0, 0, -30).Format("2006-01-02"),
			EndDate:   today,
		},
		TimeGroup: "day",
		OrderBy:   []model.OrderCondition{{FieldCode: "stat_date", Direction: "ASC"}},
		PageSize:  100,
	}
	trendResp, _ := svc.QueryReportByUserSelect(ctx, trendReq)
	fmt.Printf("30天趋势 (共%d行):\n", trendResp.Total)

	// 6d. 加筛选条件: 只看活跃订单，金额>10000
	filteredReq := &model.UserSelectQueryReq{
		BusinessCode: "KUAISHOU",
		ReportCode:   "shop_daily_report",
		Dimensions:   []string{"shop_id", "shop_name"},
		Indicators: []model.IndicatorSelect{
			{FieldCode: "order_amount", Aggregate: "SUM", Alias: "total_amount"},
		},
		Filters: []model.FilterCondition{
			{FieldCode: "order_status", Operator: "=", Value: "ACTIVE"},
			{FieldCode: "total_amount", Operator: ">=", Value: 10000}, // 指标别名也可筛选
		},
		OrderBy:  []model.OrderCondition{{FieldCode: "total_amount", Direction: "DESC"}},
		PageSize: 20,
	}
	_ = filteredReq

	// 6e. 按周汇总趋势
	weeklyReq := &model.UserSelectQueryReq{
		BusinessCode: "KUAISHOU",
		ReportCode:   "shop_daily_report",
		Dimensions:   []string{"shop_id"},
		Indicators: []model.IndicatorSelect{
			{FieldCode: "order_amount", Aggregate: "SUM", Alias: "weekly_amount"},
		},
		TimeGroup: "week",
		OrderBy:   []model.OrderCondition{{FieldCode: "weekly_amount", Direction: "DESC"}},
		PageSize:  50,
	}
	_ = weeklyReq
}


// ============================================================================
// 场景二：已有配置管理（CRUD 二次开发参考）
// ============================================================================

func CRUDExample() {
	ctx := context.Background()
	svc := report.GetService()

	// ── 业务 CRUD ────────────────────────────────────────────

	// 新增
	result, _ := svc.SaveBusiness(ctx, &model.SaveBusinessReq{
		BusinessCode: "DOUYIN", BusinessName: "抖音电商",
		Operator: "admin",
	})
	businessId := result.ID

	// 修改（传 ID 即修改）
	result, _ = svc.SaveBusiness(ctx, &model.SaveBusinessReq{
		ID: &businessId, BusinessCode: "DOUYIN",
		BusinessName: "抖音电商（新版）", Operator: "admin",
	})

	// 查询
	biz, _ := svc.GetBusiness(ctx, businessId)
	fmt.Printf("%s: %s\n", biz.BusinessCode, biz.BusinessName)

	// 删除
	svc.DeleteBusiness(ctx, businessId)

	// 全部列表
	allBiz, _ := svc.GetAllBusinesses(ctx)
	for _, b := range allBiz {
		fmt.Printf("- %s (%s)\n", b.BusinessCode, b.BusinessName)
	}

	// ── 报表 CRUD ────────────────────────────────────────────

	reportResult, _ := svc.SaveReport(ctx, &model.SaveReportReq{
		BusinessCode:  "DOUYIN",
		ReportCode:    "shop_daily_report",
		ReportName:    "抖音店铺日报",
		StatTableName: "stat_douyin_shop_daily",
		ConflictKeys:  []string{"shop_id", "stat_date"},
		Operator:      "admin",
	})
	reportId := reportResult.ID

	rpt, _ := svc.GetReport(ctx, reportId)
	svc.DeleteReport(ctx, reportId)
	_ = rpt

	// ── 字段 CRUD ────────────────────────────────────────────

	// 新增字段（id 不传 = 新增）
	fieldResult, _ := svc.SaveField(ctx, &model.SaveFieldReq{
		BusinessCode: "DOUYIN", ReportCode: "shop_daily_report",
		FieldCode: "order_amount", FieldName: "订单金额",
		FieldType: "FLOAT", FieldRole: "INDICATOR",
		IsAggregatable: true, DefaultAggregate: "SUM",
		ValidAggregates: []string{"SUM", "AVG", "MAX", "MIN"},
		SortOrder: 10, GroupName: "金额", Operator: "admin",
	})
	fieldId := fieldResult.ID

	// 修改字段（传 id = 更新）
	svc.SaveField(ctx, &model.SaveFieldReq{
		ID: &fieldId,
		FieldName: "订单金额（元）",
		Operator:  "admin",
		// ... 只传要修改的字段，未传的保持原值
	})

	f, _ := svc.GetField(ctx, fieldId)
	svc.DeleteField(ctx, fieldId)
	_ = f

	// ── 抽取配置 CRUD ────────────────────────────────────────

	ecResult, _ := svc.SaveExtractConfig(ctx, &model.SaveExtractConfigReq{
		BusinessCode:    "DOUYIN", ReportCode: "shop_daily_report",
		ExtractCode:     "extract_daily", ExtractName: "按天聚合抽取",
		SourceTableName: "douyin_order_list", SourceTableAlias: "o",
		TargetTableName: "stat_douyin_shop_daily",
		ExtractMode:     "AGGREGATE",
		ExtractKeyField: "created_at",
		GroupByFields:   []string{"shop_id"},
		FieldMappings: []model.FieldMapping{
			{SourceField: "id", TargetField: "order_count", FieldType: "INT", AggregateFunction: "COUNT"},
			{SourceField: "order_amount", TargetField: "order_amount", FieldType: "FLOAT", AggregateFunction: "SUM"},
		},
		Operator: "admin",
	})
	ecId := ecResult.ID

	ec, _ := svc.GetExtractConfig(ctx, ecId)
	allEc, _ := svc.GetExtractConfigs(ctx, "DOUYIN", "shop_daily_report")
	svc.DeleteExtractConfig(ctx, ecId)
	_, _ = ec, allEc
}


// ============================================================================
// 场景三：任意平台接入的通用模式（零硬编码）
// ============================================================================
//
// 假设要接入淘宝平台，taobao_order_list 表已有数据。
// 全程不写任何代码，只需调 CRUD API。

func GenericPlatformExample() {
	ctx := context.Background()
	svc := report.GetService()

	// 1. 前端注册业务
	svc.SaveBusiness(ctx, &model.SaveBusinessReq{
		BusinessCode: "TAOBAO", BusinessName: "淘宝电商",
		Operator: "admin",
	})

	// 2. 注册报表 + 指定统计宽表名（以后表名不再手工管理）
	svc.SaveReport(ctx, &model.SaveReportReq{
		BusinessCode:  "TAOBAO",
		ReportCode:    "shop_daily_report",
		ReportName:    "淘宝店铺日报",
		StatTableName: "stat_taobao_shop_daily",
		ConflictKeys:  []string{"shop_id", "stat_date"},
		Operator:      "admin",
	})

	// 3. 前端选择统计维度（自由组合，随时增删改）
	svc.SaveField(ctx, &model.SaveFieldReq{
		BusinessCode: "TAOBAO", ReportCode: "shop_daily_report",
		FieldCode: "shop_id", FieldName: "店铺ID",
		FieldType: "STRING", FieldRole: "DIMENSION",
		SortOrder: 1, GroupName: "店铺", Operator: "admin",
	})
	svc.SaveField(ctx, &model.SaveFieldReq{
		BusinessCode: "TAOBAO", ReportCode: "shop_daily_report",
		FieldCode: "shop_name", FieldName: "店铺名称",
		FieldType: "STRING", FieldRole: "DIMENSION",
		SortOrder: 2, GroupName: "店铺", Operator: "admin",
	})
	svc.SaveField(ctx, &model.SaveFieldReq{
		BusinessCode: "TAOBAO", ReportCode: "shop_daily_report",
		FieldCode: "stat_date", FieldName: "统计日期",
		FieldType: "DATE", FieldRole: "DIMENSION",
		SortOrder: 3, GroupName: "时间", Operator: "admin",
	})

	// 4. 前端选择统计指标（自由组合，随时增删改）
	svc.SaveField(ctx, &model.SaveFieldReq{
		BusinessCode: "TAOBAO", ReportCode: "shop_daily_report",
		FieldCode: "order_count", FieldName: "订单数",
		FieldType: "INT", FieldRole: "INDICATOR",
		IsAggregatable: true, DefaultAggregate: "SUM",
		ValidAggregates: []string{"SUM", "COUNT", "AVG"},
		SortOrder: 10, GroupName: "订单", Operator: "admin",
	})
	svc.SaveField(ctx, &model.SaveFieldReq{
		BusinessCode: "TAOBAO", ReportCode: "shop_daily_report",
		FieldCode: "order_amount", FieldName: "订单金额",
		FieldType: "FLOAT", FieldRole: "INDICATOR",
		IsAggregatable: true, DefaultAggregate: "SUM",
		ValidAggregates: []string{"SUM", "AVG", "MAX", "MIN"},
		SortOrder: 11, GroupName: "金额", Unit: "元", Operator: "admin",
	})
	svc.SaveField(ctx, &model.SaveFieldReq{
		BusinessCode: "TAOBAO", ReportCode: "shop_daily_report",
		FieldCode: "buyer_count", FieldName: "下单买家数",
		FieldType: "INT", FieldRole: "INDICATOR",
		IsAggregatable: true, DefaultAggregate: "COUNT",
		ValidAggregates: []string{"COUNT"},
		SortOrder: 12, GroupName: "用户", Operator: "admin",
	})

	// 5. 配置抽取规则
	svc.SaveExtractConfig(ctx, &model.SaveExtractConfigReq{
		BusinessCode:    "TAOBAO", ReportCode: "shop_daily_report",
		ExtractCode:     "extract_daily", ExtractName: "淘宝按天聚合",
		SourceTableName: "taobao_order_list", SourceTableAlias: "o",
		TargetTableName: "stat_taobao_shop_daily",
		ExtractMode:     "AGGREGATE",
		ExtractKeyField: "created_at",
		GroupByFields:   []string{"shop_id"},
		FieldMappings: []model.FieldMapping{
			{SourceField: "shop_id",      TargetField: "shop_id",      FieldType: "STRING"},
			{SourceField: "shop_name",    TargetField: "shop_name",    FieldType: "STRING"},
			{SourceField: "id",           TargetField: "order_count",  FieldType: "INT",   AggregateFunction: "COUNT"},
			{SourceField: "order_amount", TargetField: "order_amount", FieldType: "FLOAT", AggregateFunction: "SUM"},
			{SourceField: "buyer_id",     TargetField: "buyer_count",  FieldType: "INT",   AggregateFunction: "COUNT"},
		},
		BatchSize: 1000,
		Operator:  "admin",
	})

	// 6. 定时任务每天执行
	svc.ExtractDailyData(ctx, "TAOBAO", "shop_daily_report", "2026-06-10", "cron")

	// 7. 前端实时查询
	req := &model.UserSelectQueryReq{
		BusinessCode: "TAOBAO", ReportCode: "shop_daily_report",
		Dimensions: []string{"shop_id", "shop_name"},
		Indicators: []model.IndicatorSelect{
			{FieldCode: "order_amount", Aggregate: "SUM", Alias: "total"},
			{FieldCode: "order_count",  Aggregate: "SUM", Alias: "orders"},
		},
		TimeRange: &model.TimeRange{StartDate: "2026-06-01", EndDate: "2026-06-10"},
		Page: 1, PageSize: 20,
	}
	resp, _ := svc.QueryReportByUserSelect(ctx, req)
	fmt.Printf("查询结果: 共%d条, 耗时%dms\n", resp.Total, resp.ExecTimeMs)

	// 平台接入完毕。全程零代码改动。
}


// ============================================================================
// 场景四：在外部业务服务（如 goview-report）中调用
// ============================================================================

func ExternalServiceExample() {
	ctx := context.Background()
	svc := report.GetService()

	// 直接用，不需要初始化，内部自动懒加载和建表。
	today := time.Now().Format("2006-01-02")

	// 按天抽取
	svc.ExtractDailyData(ctx, "KUAISHOU", "shop_daily_report", today, "cron")

	// 实时查询
	svc.QueryReportByUserSelect(ctx, &model.UserSelectQueryReq{
		BusinessCode: "KUAISHOU", ReportCode: "shop_daily_report",
		Dimensions: []string{"shop_id", "shop_name"},
		Indicators: []model.IndicatorSelect{
			{FieldCode: "order_amount", Aggregate: "SUM", Alias: "total_amount"},
		},
		TimeRange: &model.TimeRange{StartDate: "2026-06-01", EndDate: today},
		Page: 1, PageSize: 20,
	})
}


// ============================================================================
// 场景五：Direct 模式（逐行抽取，不做聚合）
// ============================================================================
//
// 适用于源表已经是一行一条统计记录的场景（如已预聚合的报表源表）。

func DirectModeExample() {
	ctx := context.Background()
	svc := report.GetService()

	svc.SaveBusiness(ctx, &model.SaveBusinessReq{
		BusinessCode: "HDWL", BusinessName: "HDWL业务", Operator: "admin",
	})
	svc.SaveReport(ctx, &model.SaveReportReq{
		BusinessCode:  "HDWL", ReportCode: "shop_daily_stat",
		ReportName:    "HDWL店铺日报", StatTableName: "stat_hdwl_shop_daily",
		ConflictKeys:  []string{"report_date"},
		Operator:      "admin",
	})

	// Direct 模式：不聚合，逐行映射
	svc.SaveExtractConfig(ctx, &model.SaveExtractConfigReq{
		BusinessCode:    "HDWL", ReportCode: "shop_daily_stat",
		ExtractCode:     "extract_direct", ExtractName: "直接逐行抽取",
		SourceTableName: "hdwl_daily_summary", SourceTableAlias: "s",
		TargetTableName: "stat_hdwl_shop_daily",
		ExtractMode:     "DIRECT",                    // ← DIRECT 模式
		ExtractKeyField: "report_date",
		FieldMappings: []model.FieldMapping{
			{SourceField: "shop_id",      TargetField: "shop_id",      FieldType: "STRING"},
			{SourceField: "shop_name",    TargetField: "shop_name",    FieldType: "STRING"},
			{SourceField: "total_sale",   TargetField: "sale_amount",  FieldType: "FLOAT"},
			{SourceField: "total_orders", TargetField: "order_count",  FieldType: "INT"},
		},
		Operator: "admin",
	})

	svc.ExtractDailyData(ctx, "HDWL", "shop_daily_stat", "2026-06-10", "cron")
}


// ============================================================================
// 场景六：前端交互流程参考
// ============================================================================
//
// 前端代码调用示例（伪代码，展示 API 调用顺序）：
//
//   // 1. 页面加载 → 获取业务列表 → 渲染下拉框
//   GET /api/report/businesses
//   返回: [{ businessCode: "KUAISHOU", businessName: "快手电商" }, ...]
//
//   // 2. 用户选择业务 → 获取报表列表
//   GET /api/report/reports?businessCode=KUAISHOU
//   返回: [{ reportCode: "shop_daily_report", reportName: "快手店铺日报" }, ...]
//
//   // 3. 用户选择报表 → 获取可用字段 → 渲染维度/指标/筛选选择器
//   GET /api/report/fields?businessCode=KUAISHOU&reportCode=shop_daily_report
//   返回: { dimensions: [...], indicators: [...], filters: [...] }
//
//   // 4. 用户选好条件 → 查询
//   POST /api/report/query
//   Body: {
//     "businessCode": "KUAISHOU", "reportCode": "shop_daily_report",
//     "dimensions": ["shop_id", "shop_name"],
//     "indicators": [
//       {"fieldCode": "order_amount", "aggregate": "SUM", "alias": "total"},
//       {"fieldCode": "order_count",  "aggregate": "SUM", "alias": "count"}
//     ],
//     "timeRange": {"startDate": "2026-06-01", "endDate": "2026-06-10"},
//     "orderBy": [{"fieldCode": "total", "direction": "DESC"}],
//     "page": 1, "pageSize": 20
//   }
//   返回: { list: [...], total: 152, page: 1, totalPages: 8, execTimeMs: 45 }
//
//   // 5. 翻页/换维度/换指标 → 重新调 Step 4
//
// 管理后台（用户可自行维护配置）：
//
//   // 新增业务
//   POST /api/report/business/save
//   Body: { "businessCode": "TAOBAO", "businessName": "淘宝电商" }
//
//   // 新增/修改字段（用户自定义统计维度）
//   POST /api/report/field/save
//   Body: { "businessCode": "TAOBAO", "reportCode": "shop_daily_report",
//           "fieldCode": "category", "fieldName": "商品类目",
//           "fieldType": "STRING", "fieldRole": "DIMENSION" }
//
//   // 配置抽取规则
//   POST /api/report/extractConfig/save
//   Body: { "businessCode": "TAOBAO", "reportCode": "shop_daily_report",
//           "extractCode": "extract_daily", "sourceTableName": "taobao_order_list",
//           "extractMode": "AGGREGATE", "groupByFields": ["shop_id"],
//           "fieldMappings": [...] }


// ============================================================================
// Direct vs AGGREGATE 模式对比
// ============================================================================
//
// ┌──────────┬──────────────────────────────────────────────┐
// │ 模式      │  行为                                        │
// ├──────────┼──────────────────────────────────────────────┤
// │ DIRECT   │  逐行映射，1:1 从源表复制到目标表             │
// │          │  适用：源表已是一行一统计                     │
// │          │  SQL: SELECT ... FROM source                 │
// ├──────────┼──────────────────────────────────────────────┤
// │ AGGREGATE│  GROUP BY + 聚合函数，N:1 聚合               │
// │          │  适用：源表是明细表（如订单行）               │
// │          │  SQL: SELECT ... SUM() COUNT() ...           │
// │          │       FROM source GROUP BY groupByFields     │
// └──────────┴──────────────────────────────────────────────┘
//
// 可聚合函数: SUM / COUNT / AVG / MAX / MIN
// 字段角色: DIMENSION(维度) / INDICATOR(指标) / FILTER(筛选) / FILTER_ONLY
// 字段类型: STRING / INT / FLOAT / DATE / DATETIME / JSONB
// 操作符: = / != / > / < / >= / <= / IN / LIKE / BETWEEN
// 时间分组: day / week / month / quarter
*/