export type MetricDomain = 'mileage' | 'hydrogen' | 'electric' | 'etc';
export type MetricUnit = 'km' | 'kg' | 'kwh' | 'cny' | 'cny-per-kwh' | 'percent' | 'vehicle' | 'station' | 'order' | 'passage' | 'timestamp';
export type MetricAggregation = 'sum' | 'count' | 'derived' | 'weighted-ratio' | 'distinct-count' | 'latest';
export type MetricTimeSemantics = 'flow' | 'snapshot' | 'freshness';

export interface MetricDefinition {
  id: string;
  domain: MetricDomain;
  label: string;
  description: string;
  unit: MetricUnit;
  aggregation: MetricAggregation;
  timeSemantics: MetricTimeSemantics;
  formula: string;
  sources: readonly string[];
  dimensions: readonly string[];
  drillEntity: 'vehicle' | 'assessment-target' | 'hydrogen-station' | 'hydrogen-customer' | 'hydrogen-order' | 'electric-charge-order' | 'etc-toll-record' | 'etc-bill';
}

export const METRIC_CATALOG_VERSION = 5;

const MILEAGE_METRICS: readonly MetricDefinition[] = [
  {
    id: 'mileage.daily_total',
    domain: 'mileage',
    label: '当日总里程',
    description: '所选自然日内有效车辆日里程之和。',
    unit: 'km',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: 'SUM(vehicle_daily_mileage_km)',
    sources: ['OneOS mileage API'],
    dimensions: ['date', 'department', 'region', 'customer', 'vehicle-model', 'plate'],
    drillEntity: 'vehicle',
  },
  {
    id: 'mileage.period_total',
    domain: 'mileage',
    label: '区间总里程',
    description: '所选自然日区间内有效车辆日里程之和。',
    unit: 'km',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: 'SUM(vehicle_daily_mileage_km) OVER selected_date_range',
    sources: ['OneOS mileage range API'],
    dimensions: ['date', 'department', 'region', 'customer', 'vehicle-model', 'plate'],
    drillEntity: 'vehicle',
  },
  {
    id: 'mileage.vehicle_count',
    domain: 'mileage',
    label: '监控车辆数',
    description: '当前权限和筛选范围内的去重车辆数量。',
    unit: 'vehicle',
    aggregation: 'distinct-count',
    timeSemantics: 'snapshot',
    formula: 'COUNT(DISTINCT vehicle_id)',
    sources: ['Asset database'],
    dimensions: ['department', 'region', 'customer', 'vehicle-model'],
    drillEntity: 'vehicle',
  },
  {
    id: 'mileage.assessment_completion_rate',
    domain: 'mileage',
    label: '考核完成率',
    description: '按目标里程加权汇总，不平均车辆或考核组的完成率。',
    unit: 'percent',
    aggregation: 'weighted-ratio',
    timeSemantics: 'snapshot',
    formula: 'SUM(completed_mileage_km) / NULLIF(SUM(target_mileage_km), 0) * 100',
    sources: ['Mileage assessment database'],
    dimensions: ['assessment-year', 'assessment-target', 'department', 'customer', 'plate'],
    drillEntity: 'assessment-target',
  },
  {
    id: 'mileage.data_freshness',
    domain: 'mileage',
    label: '数据统计时间',
    description: '当前选源协议最后一条有效里程数据的业务时间。',
    unit: 'timestamp',
    aggregation: 'latest',
    timeSemantics: 'freshness',
    formula: 'COALESCE(data_time, updated_at, calculated_at)',
    sources: ['OneOS mileage API'],
    dimensions: ['source-protocol', 'plate'],
    drillEntity: 'vehicle',
  },
];

const HYDROGEN_METRICS: readonly MetricDefinition[] = [
  {
    id: 'hydrogen.refuel_mass',
    domain: 'hydrogen',
    label: '加氢量',
    description: '有效加氢账本订单的实际加注质量之和。',
    unit: 'kg',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: "SUM(amount_kg) WHERE del_flag = '0'",
    sources: ['hydrogen_fuel_ledger'],
    dimensions: ['date', 'station', 'region', 'customer', 'payer', 'plate'],
    drillEntity: 'hydrogen-order',
  },
  {
    id: 'hydrogen.refuel_cost',
    domain: 'hydrogen',
    label: '加氢成本',
    description: '有效加氢订单记录的站点结算成本之和，不代表客户应收。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: "SUM(cost_total) WHERE del_flag = '0'",
    sources: ['hydrogen_fuel_ledger'],
    dimensions: ['date', 'station', 'region', 'customer', 'payer', 'plate'],
    drillEntity: 'hydrogen-order',
  },
  {
    id: 'hydrogen.customer_revenue',
    domain: 'hydrogen',
    label: '客户收入',
    description: '有效加氢订单账本中客户应收金额 fee_total 之和。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: "SUM(fee_total) WHERE del_flag = '0'",
    sources: ['hydrogen_fuel_ledger'],
    dimensions: ['date', 'station', 'region', 'customer', 'plate'],
    drillEntity: 'hydrogen-customer',
  },
  {
    id: 'hydrogen.customer_order_cost',
    domain: 'hydrogen',
    label: '客户单成本',
    description: '存在客户单价或客户应收金额的订单，其站点结算成本之和。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: "SUM(cost_total) WHERE del_flag = '0' AND (customer_price > 0 OR fee_total > 0)",
    sources: ['hydrogen_fuel_ledger'],
    dimensions: ['date', 'station', 'region', 'customer', 'plate'],
    drillEntity: 'hydrogen-customer',
  },
  {
    id: 'hydrogen.customer_order_gross_profit',
    domain: 'hydrogen',
    label: '客户单毛利',
    description: '客户收入减去客户单对应的站点结算成本，不包含公司承担订单及其他经营费用。',
    unit: 'cny',
    aggregation: 'derived',
    timeSemantics: 'flow',
    formula: 'hydrogen.customer_revenue - hydrogen.customer_order_cost',
    sources: ['hydrogen_fuel_ledger'],
    dimensions: ['date', 'station', 'region', 'customer'],
    drillEntity: 'hydrogen-customer',
  },
  {
    id: 'hydrogen.refuel_order_count',
    domain: 'hydrogen',
    label: '加氢订单数',
    description: '有效加氢账本订单数量。',
    unit: 'order',
    aggregation: 'count',
    timeSemantics: 'flow',
    formula: "COUNT(*) WHERE del_flag = '0'",
    sources: ['hydrogen_fuel_ledger'],
    dimensions: ['date', 'station', 'region', 'customer', 'payer', 'plate'],
    drillEntity: 'hydrogen-order',
  },
  {
    id: 'hydrogen.station_count',
    domain: 'hydrogen',
    label: '有加注站点数',
    description: '所选时间和筛选范围内产生有效加氢订单的去重站点数量。',
    unit: 'station',
    aggregation: 'distinct-count',
    timeSemantics: 'flow',
    formula: "COUNT(DISTINCT station_id) WHERE del_flag = '0'",
    sources: ['hydrogen_fuel_ledger', 'hydrogen_station'],
    dimensions: ['date', 'region', 'payer'],
    drillEntity: 'hydrogen-station',
  },
  {
    id: 'hydrogen.vehicle_count',
    domain: 'hydrogen',
    label: '加氢车辆数',
    description: '所选时间和筛选范围内产生有效加氢订单的去重车牌数量。',
    unit: 'vehicle',
    aggregation: 'distinct-count',
    timeSemantics: 'flow',
    formula: "COUNT(DISTINCT plate_number) WHERE del_flag = '0'",
    sources: ['hydrogen_fuel_ledger'],
    dimensions: ['date', 'station', 'region', 'customer', 'payer'],
    drillEntity: 'vehicle',
  },
];

const ELECTRIC_METRICS: readonly MetricDefinition[] = [
  {
    id: 'electric.charge_energy',
    domain: 'electric',
    label: '充电量',
    description: '所选时间和车辆归属范围内，去重导入充电订单的电量之和。',
    unit: 'kwh',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: 'SUM(kwh)',
    sources: ['bi_ele_charge_record'],
    dimensions: ['date', 'station', 'region', 'operating-company', 'vehicle-kind', 'customer', 'plate', 'order-status'],
    drillEntity: 'electric-charge-order',
  },
  {
    id: 'electric.charge_total_fee',
    domain: 'electric',
    label: '充电费用',
    description: '导入账单的充电费用之和；当前数据中等于充电电费与充电服务费之和，零费用订单仍参与统计。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: 'SUM(fee)',
    sources: ['bi_ele_charge_record'],
    dimensions: ['date', 'station', 'region', 'operating-company', 'vehicle-kind', 'customer', 'plate', 'order-status'],
    drillEntity: 'electric-charge-order',
  },
  {
    id: 'electric.electricity_fee',
    domain: 'electric',
    label: '充电电费',
    description: '导入账单中充电电费字段 e_fee 之和，不含服务费。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: 'SUM(e_fee)',
    sources: ['bi_ele_charge_record'],
    dimensions: ['date', 'station', 'region', 'operating-company', 'vehicle-kind', 'customer', 'plate'],
    drillEntity: 'electric-charge-order',
  },
  {
    id: 'electric.service_fee',
    domain: 'electric',
    label: '充电服务费',
    description: '导入账单中充电服务费字段 service_fee 之和。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: 'SUM(service_fee)',
    sources: ['bi_ele_charge_record'],
    dimensions: ['date', 'station', 'region', 'operating-company', 'vehicle-kind', 'customer', 'plate'],
    drillEntity: 'electric-charge-order',
  },
  {
    id: 'electric.blended_cost_intensity',
    domain: 'electric',
    label: '综合费用强度',
    description: '充电费用除以充电量；包含零费用订单，用于观察综合支出强度，不等同于合同电价或单笔订单单价。',
    unit: 'cny-per-kwh',
    aggregation: 'weighted-ratio',
    timeSemantics: 'flow',
    formula: 'SUM(fee) / NULLIF(SUM(kwh), 0)',
    sources: ['bi_ele_charge_record'],
    dimensions: ['date', 'station', 'region', 'operating-company', 'vehicle-kind', 'customer'],
    drillEntity: 'electric-charge-order',
  },
  {
    id: 'electric.charge_order_count',
    domain: 'electric',
    label: '充电订单数',
    description: '导入充电账单中按订单编号去重后的订单数量。',
    unit: 'order',
    aggregation: 'distinct-count',
    timeSemantics: 'flow',
    formula: 'COUNT(DISTINCT order_no)',
    sources: ['bi_ele_charge_record'],
    dimensions: ['date', 'station', 'region', 'operating-company', 'vehicle-kind', 'customer', 'plate', 'order-status'],
    drillEntity: 'electric-charge-order',
  },
  {
    id: 'electric.data_freshness',
    domain: 'electric',
    label: '电能数据截至时间',
    description: '已导入充电订单中最后一条订单的业务开始时间，用于区分当期零业务与数据尚未更新。',
    unit: 'timestamp',
    aggregation: 'latest',
    timeSemantics: 'freshness',
    formula: 'MAX(start_time)',
    sources: ['bi_ele_charge_record'],
    dimensions: ['station', 'vehicle-kind'],
    drillEntity: 'electric-charge-order',
  },
];

const ETC_METRICS: readonly MetricDefinition[] = [
  {
    id: 'etc.toll_amount',
    domain: 'etc',
    label: '通行费',
    description: '有效 ETC 通行记录中的道路通行费之和，不含服务费。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: "SUM(toll_amount) WHERE del_flag = '0'",
    sources: ['etc_toll_record'],
    dimensions: ['date', 'plate', 'customer', 'route', 'cost-type', 'payment-mode', 'contract-match'],
    drillEntity: 'etc-toll-record',
  },
  {
    id: 'etc.service_fee',
    domain: 'etc',
    label: 'ETC 服务费',
    description: '有效 ETC 通行记录中的服务费之和。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: "SUM(service_fee) WHERE del_flag = '0'",
    sources: ['etc_toll_record'],
    dimensions: ['date', 'plate', 'customer', 'route', 'cost-type', 'payment-mode'],
    drillEntity: 'etc-toll-record',
  },
  {
    id: 'etc.total_amount',
    domain: 'etc',
    label: 'ETC 总费用',
    description: '有效 ETC 通行记录的总金额之和，业务定义为通行费加服务费。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: "SUM(total_amount) WHERE del_flag = '0'",
    sources: ['etc_toll_record'],
    dimensions: ['date', 'plate', 'customer', 'route', 'cost-type', 'payment-mode', 'deduction-status'],
    drillEntity: 'etc-toll-record',
  },
  {
    id: 'etc.passage_count',
    domain: 'etc',
    label: '通行次数',
    description: '有效 ETC 通行记录按记录编码去重后的通行次数。',
    unit: 'passage',
    aggregation: 'distinct-count',
    timeSemantics: 'flow',
    formula: "COUNT(DISTINCT record_code) WHERE del_flag = '0'",
    sources: ['etc_toll_record'],
    dimensions: ['date', 'plate', 'customer', 'route', 'cost-type', 'payment-mode'],
    drillEntity: 'etc-toll-record',
  },
  {
    id: 'etc.vehicle_count',
    domain: 'etc',
    label: '通行车辆数',
    description: '所选范围内产生有效 ETC 通行记录的去重车牌数量。',
    unit: 'vehicle',
    aggregation: 'distinct-count',
    timeSemantics: 'flow',
    formula: "COUNT(DISTINCT plate_number) WHERE del_flag = '0'",
    sources: ['etc_toll_record'],
    dimensions: ['date', 'customer', 'route', 'cost-type'],
    drillEntity: 'vehicle',
  },
  {
    id: 'etc.company_borne_amount',
    domain: 'etc',
    label: '我方承担 ETC 费用',
    description: '费用承担方 cost_type=2 的有效 ETC 总费用。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: "SUM(total_amount) WHERE del_flag = '0' AND cost_type = 2",
    sources: ['etc_toll_record'],
    dimensions: ['date', 'plate', 'customer', 'route', 'payment-mode'],
    drillEntity: 'etc-toll-record',
  },
  {
    id: 'etc.customer_borne_amount',
    domain: 'etc',
    label: '客户承担 ETC 费用',
    description: '费用承担方 cost_type=1 的有效 ETC 总费用。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: "SUM(total_amount) WHERE del_flag = '0' AND cost_type = 1",
    sources: ['etc_toll_record'],
    dimensions: ['date', 'plate', 'customer', 'route', 'payment-mode'],
    drillEntity: 'etc-toll-record',
  },
  {
    id: 'etc.bill_receivable',
    domain: 'etc',
    label: 'ETC 账单应收',
    description: '有效 ETC 账单的应收金额之和，与通行记录费用属于不同结算粒度。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: "SUM(receivable_amount) WHERE del_flag = '0'",
    sources: ['energy_etc_bill'],
    dimensions: ['bill-period', 'customer', 'payment-status', 'review-status', 'finance-status'],
    drillEntity: 'etc-bill',
  },
  {
    id: 'etc.bill_paid_amount',
    domain: 'etc',
    label: 'ETC 账单已收',
    description: '有效 ETC 账单的已支付金额之和。',
    unit: 'cny',
    aggregation: 'sum',
    timeSemantics: 'flow',
    formula: "SUM(paid_amount) WHERE del_flag = '0'",
    sources: ['energy_etc_bill'],
    dimensions: ['bill-period', 'customer', 'payment-status', 'review-status', 'finance-status'],
    drillEntity: 'etc-bill',
  },
];

export const METRIC_CATALOG: readonly MetricDefinition[] = [
  ...MILEAGE_METRICS,
  ...HYDROGEN_METRICS,
  ...ELECTRIC_METRICS,
  ...ETC_METRICS,
];

export function isMetricDomain(value: string): value is MetricDomain {
  return METRIC_CATALOG.some(metric => metric.domain === value);
}

export function listMetricDefinitions(domain?: MetricDomain): MetricDefinition[] {
  return METRIC_CATALOG
    .filter(metric => !domain || metric.domain === domain)
    .map(metric => ({ ...metric }));
}