重构:硬切履约路由唯一真源
This commit is contained in:
@@ -0,0 +1,433 @@
|
||||
-- 160_switch_fulfillment_routing_to_routes.sql
|
||||
--
|
||||
-- 硬切换履约路由真源:
|
||||
-- 1. 所有标准商品补齐 internal_sku_id;
|
||||
-- 2. 运行时唯一路由真源改为 sku_channel_routes;
|
||||
-- 3. 商品当前渠道不再回退 source_kind;
|
||||
-- 4. 履约读模型不再读取 internal_sku_channels;
|
||||
-- 5. 停止旧表触发同步,不再双写。
|
||||
|
||||
UPDATE product_catalog product
|
||||
SET internal_sku_id = ensure_canonical_internal_sku(product.canonical_name),
|
||||
updated_at = NOW()
|
||||
WHERE product.internal_sku_id IS NULL
|
||||
AND canonicalize_internal_sku(product.canonical_name) <> '';
|
||||
|
||||
CREATE OR REPLACE FUNCTION normalize_product_identity()
|
||||
RETURNS TRIGGER
|
||||
LANGUAGE plpgsql
|
||||
AS $$
|
||||
BEGIN
|
||||
NEW.source_kind := CASE
|
||||
WHEN NEW.canonical_sku LIKE 'aff:%' THEN 'affiliate_dash'
|
||||
WHEN NEW.canonical_sku LIKE 'tpl:%' OR NEW.canonical_sku LIKE 'wo:%' THEN 'work_order'
|
||||
WHEN NEW.canonical_sku LIKE 'tpv:%' THEN 'third_party_voucher'
|
||||
WHEN NEW.canonical_sku LIKE 'man:%' THEN 'manual'
|
||||
ELSE COALESCE(NULLIF(NEW.source_kind, ''), 'unclassified')
|
||||
END;
|
||||
|
||||
IF NEW.internal_sku_id IS NULL THEN
|
||||
NEW.internal_sku_id := ensure_canonical_internal_sku(NEW.canonical_name);
|
||||
END IF;
|
||||
|
||||
RETURN NEW;
|
||||
END;
|
||||
$$;
|
||||
|
||||
DROP TRIGGER IF EXISTS trg_sync_sku_channel_routes ON internal_sku_channels;
|
||||
DROP FUNCTION IF EXISTS sync_sku_channel_routes_trigger();
|
||||
DROP FUNCTION IF EXISTS sync_sku_channel_routes_for_key(TEXT);
|
||||
|
||||
COMMENT ON TABLE internal_sku_channels IS
|
||||
'冻结的旧路由输入表;迁移 160 后运行时不读不写,仅保留历史数据供追溯';
|
||||
|
||||
CREATE OR REPLACE VIEW v_product_current AS
|
||||
SELECT
|
||||
product.*,
|
||||
sku.internal_sku_key,
|
||||
primary_route.channel AS active_primary_channel,
|
||||
COALESCE(fallback_routes.channels, ARRAY[]::text[]) AS fallback_channels,
|
||||
manual_config.id AS manual_config_id,
|
||||
(manual_config.id IS NOT NULL) AS has_active_manual_config
|
||||
FROM product_catalog product
|
||||
LEFT JOIN internal_skus sku ON sku.id = product.internal_sku_id
|
||||
LEFT JOIN LATERAL (
|
||||
SELECT route.channel
|
||||
FROM sku_channel_routes route
|
||||
WHERE route.internal_sku_id = product.internal_sku_id
|
||||
AND route.enabled = TRUE
|
||||
AND route.route_role = 'primary'
|
||||
ORDER BY route.priority, route.channel
|
||||
LIMIT 1
|
||||
) primary_route ON TRUE
|
||||
LEFT JOIN LATERAL (
|
||||
SELECT ARRAY_AGG(route.channel ORDER BY route.priority, route.channel) AS channels
|
||||
FROM sku_channel_routes route
|
||||
WHERE route.internal_sku_id = product.internal_sku_id
|
||||
AND route.enabled = TRUE
|
||||
AND route.route_role = 'fallback'
|
||||
) fallback_routes ON TRUE
|
||||
LEFT JOIN LATERAL (
|
||||
SELECT config.id
|
||||
FROM manual_fulfillment_configs config
|
||||
WHERE config.enabled = TRUE
|
||||
AND (
|
||||
config.canonical_product_id = product.id
|
||||
OR (
|
||||
sku.internal_sku_key IS NOT NULL
|
||||
AND canonicalize_internal_sku(config.sku_key) = sku.internal_sku_key
|
||||
)
|
||||
)
|
||||
ORDER BY config.id
|
||||
LIMIT 1
|
||||
) manual_config ON TRUE;
|
||||
|
||||
COMMENT ON VIEW v_product_current IS
|
||||
'标准商品统一投影:来源与当前渠道分离,当前渠道只来自 sku_channel_routes';
|
||||
|
||||
CREATE OR REPLACE VIEW v_fulfillment_item_state AS
|
||||
WITH active_items AS (
|
||||
SELECT
|
||||
oi.*,
|
||||
resolve_internal_sku(oi.manual_sku_key, oi.sku_name, oi.sku_code) AS internal_sku
|
||||
FROM order_items oi
|
||||
WHERE oi.fulfillment_status IN ('pending', 'assigned')
|
||||
),
|
||||
base AS (
|
||||
SELECT
|
||||
oi.id AS order_item_id,
|
||||
oi.order_id,
|
||||
o.id AS local_order_id,
|
||||
o.provider,
|
||||
o.platform,
|
||||
o.shop_id,
|
||||
o.shop_name,
|
||||
o.platform_order_id,
|
||||
o.pay_status,
|
||||
o.order_status,
|
||||
oi.fulfillment_status AS item_fulfillment_status,
|
||||
oi.fulfillment_channel AS stored_channel,
|
||||
oi.fulfillment_source,
|
||||
oi.fulfillment_locked,
|
||||
oi.fulfillment_pending_reason,
|
||||
oi.fulfillment_pending_detail,
|
||||
oi.sku_code,
|
||||
oi.sku_name,
|
||||
oi.quantity,
|
||||
oi.revenue_amount_fen,
|
||||
oi.created_at,
|
||||
oi.updated_at,
|
||||
oi.internal_sku,
|
||||
channel_plan.channel AS configured_channel,
|
||||
channel_plan.config_json AS configured_channel_config,
|
||||
COALESCE(channel_stats.channel_count, 0) AS channel_count,
|
||||
COALESCE(latest_task.task_id, 0) AS latest_task_id,
|
||||
latest_task.executor_key AS latest_task_executor_key,
|
||||
latest_task.task_status AS latest_task_status,
|
||||
latest_task.result_code AS latest_task_result_code,
|
||||
latest_task.result_message AS latest_task_result_message,
|
||||
latest_task.updated_at AS latest_task_updated_at,
|
||||
COALESCE(latest_work_order.work_order_id, 0) AS latest_work_order_id,
|
||||
latest_work_order.status AS latest_work_order_status,
|
||||
latest_work_order.result_code AS latest_work_order_result_code,
|
||||
latest_work_order.updated_at AS latest_work_order_updated_at,
|
||||
EXISTS (
|
||||
SELECT 1
|
||||
FROM fulfillment_tasks active_task
|
||||
WHERE active_task.order_item_id = oi.id
|
||||
AND active_task.executor_key IN ('affiliate_dash', 'manual_dispatch')
|
||||
AND active_task.task_status NOT IN (
|
||||
'closed', 'expired', 'failed', 'manual_review', 'retry_pending', 'cancelled'
|
||||
)
|
||||
) AS has_active_task,
|
||||
EXISTS (
|
||||
SELECT 1
|
||||
FROM work_orders active_work_order
|
||||
WHERE active_work_order.order_item_id = oi.id
|
||||
AND active_work_order.status <> 'cancelled'
|
||||
) AS has_active_work_order,
|
||||
EXISTS (
|
||||
SELECT 1
|
||||
FROM manual_fulfillment_configs cfg
|
||||
WHERE cfg.enabled = TRUE
|
||||
AND canonicalize_internal_sku(cfg.sku_key) = oi.internal_sku
|
||||
) AS has_manual_config
|
||||
FROM active_items oi
|
||||
JOIN orders o ON o.id = oi.order_id
|
||||
LEFT JOIN LATERAL (
|
||||
SELECT route.channel, route.carrier_config_json AS config_json
|
||||
FROM sku_channel_routes route
|
||||
JOIN internal_skus sku ON sku.id = route.internal_sku_id
|
||||
WHERE route.enabled = TRUE
|
||||
AND sku.internal_sku_key = oi.internal_sku
|
||||
ORDER BY
|
||||
(route.route_role = 'fallback'),
|
||||
route.priority,
|
||||
route.channel,
|
||||
route.id
|
||||
LIMIT 1
|
||||
) channel_plan ON TRUE
|
||||
LEFT JOIN LATERAL (
|
||||
SELECT COUNT(*)::int AS channel_count
|
||||
FROM sku_channel_routes route
|
||||
JOIN internal_skus sku ON sku.id = route.internal_sku_id
|
||||
WHERE route.enabled = TRUE
|
||||
AND sku.internal_sku_key = oi.internal_sku
|
||||
) channel_stats ON TRUE
|
||||
LEFT JOIN LATERAL (
|
||||
SELECT
|
||||
task.id AS task_id,
|
||||
task.executor_key,
|
||||
task.task_status,
|
||||
task.result_code,
|
||||
task.result_message,
|
||||
task.updated_at
|
||||
FROM fulfillment_tasks task
|
||||
WHERE task.order_item_id = oi.id
|
||||
ORDER BY task.id DESC
|
||||
LIMIT 1
|
||||
) latest_task ON TRUE
|
||||
LEFT JOIN LATERAL (
|
||||
SELECT
|
||||
work_order.id AS work_order_id,
|
||||
work_order.status,
|
||||
''::text AS result_code,
|
||||
work_order.updated_at
|
||||
FROM work_orders work_order
|
||||
WHERE work_order.order_item_id = oi.id
|
||||
ORDER BY work_order.id DESC
|
||||
LIMIT 1
|
||||
) latest_work_order ON TRUE
|
||||
),
|
||||
classified AS (
|
||||
SELECT
|
||||
base.*,
|
||||
COALESCE(base.stored_channel, base.configured_channel) AS intended_channel,
|
||||
CASE
|
||||
WHEN base.pay_status = 'refunded'
|
||||
OR base.order_status IN ('refunded', 'cancelled')
|
||||
OR base.latest_task_result_code = 'USER_APPLY_REFUND'
|
||||
THEN TRUE
|
||||
ELSE FALSE
|
||||
END AS is_user_refund,
|
||||
CASE
|
||||
WHEN base.pay_status = 'cancelled'
|
||||
OR base.order_status = 'cancelled'
|
||||
OR base.latest_task_result_code = 'affiliate_dash_cancelled'
|
||||
THEN TRUE
|
||||
ELSE FALSE
|
||||
END AS is_platform_cancelled
|
||||
FROM base
|
||||
),
|
||||
current_attempt AS (
|
||||
SELECT
|
||||
classified.*,
|
||||
CASE
|
||||
WHEN classified.latest_task_id > 0
|
||||
AND (
|
||||
classified.latest_work_order_id = 0
|
||||
OR classified.latest_task_updated_at >= classified.latest_work_order_updated_at
|
||||
)
|
||||
THEN 'task'
|
||||
WHEN classified.latest_work_order_id > 0 THEN 'work_order'
|
||||
ELSE ''
|
||||
END AS current_attempt_type,
|
||||
CASE
|
||||
WHEN classified.latest_task_id > 0
|
||||
AND (
|
||||
classified.latest_work_order_id = 0
|
||||
OR classified.latest_task_updated_at >= classified.latest_work_order_updated_at
|
||||
)
|
||||
THEN classified.latest_task_id
|
||||
WHEN classified.latest_work_order_id > 0 THEN classified.latest_work_order_id
|
||||
ELSE 0
|
||||
END AS current_attempt_id,
|
||||
CASE
|
||||
WHEN classified.latest_task_id > 0
|
||||
AND (
|
||||
classified.latest_work_order_id = 0
|
||||
OR classified.latest_task_updated_at >= classified.latest_work_order_updated_at
|
||||
)
|
||||
THEN classified.latest_task_status
|
||||
WHEN classified.latest_work_order_id > 0 THEN classified.latest_work_order_status
|
||||
ELSE ''
|
||||
END AS current_attempt_status,
|
||||
CASE
|
||||
WHEN classified.latest_task_id > 0
|
||||
AND (
|
||||
classified.latest_work_order_id = 0
|
||||
OR classified.latest_task_updated_at >= classified.latest_work_order_updated_at
|
||||
)
|
||||
THEN classified.latest_task_result_code
|
||||
WHEN classified.latest_work_order_id > 0 THEN classified.latest_work_order_result_code
|
||||
ELSE ''
|
||||
END AS current_attempt_result_code
|
||||
FROM classified
|
||||
),
|
||||
state_classified AS (
|
||||
SELECT
|
||||
current_attempt.*,
|
||||
CASE
|
||||
WHEN current_attempt.intended_channel IN ('third_party_voucher', 'on_account')
|
||||
THEN 'not_required'
|
||||
WHEN current_attempt.intended_channel = 'manual'
|
||||
AND current_attempt.has_manual_config
|
||||
THEN 'ready'
|
||||
WHEN current_attempt.has_active_task OR current_attempt.has_active_work_order
|
||||
THEN 'ready'
|
||||
WHEN current_attempt.latest_task_status IN (
|
||||
'closed', 'expired', 'failed', 'manual_review', 'retry_pending', 'cancelled'
|
||||
)
|
||||
THEN 'terminal'
|
||||
WHEN current_attempt.latest_work_order_status = 'cancelled'
|
||||
THEN 'terminal'
|
||||
WHEN current_attempt.intended_channel IS NOT NULL
|
||||
THEN 'missing'
|
||||
ELSE 'missing'
|
||||
END AS carrier_status,
|
||||
CASE
|
||||
WHEN COALESCE(current_attempt.internal_sku, '') = ''
|
||||
THEN 'missing_internal_sku'
|
||||
WHEN current_attempt.channel_count = 0
|
||||
THEN 'missing_channel'
|
||||
ELSE 'configured'
|
||||
END AS route_status
|
||||
FROM current_attempt
|
||||
),
|
||||
issue_classified AS (
|
||||
SELECT
|
||||
state_classified.*,
|
||||
CASE
|
||||
WHEN state_classified.is_user_refund THEN 'user_refund'
|
||||
WHEN state_classified.is_platform_cancelled THEN 'platform_cancelled'
|
||||
WHEN state_classified.route_status = 'missing_internal_sku' THEN 'missing_internal_sku'
|
||||
WHEN state_classified.route_status = 'missing_channel' THEN 'missing_channel'
|
||||
WHEN state_classified.intended_channel = 'manual'
|
||||
AND NOT state_classified.has_manual_config
|
||||
THEN 'manual_config_missing'
|
||||
WHEN state_classified.intended_channel = 'work_order'
|
||||
AND BTRIM(COALESCE(
|
||||
state_classified.configured_channel_config->>'workRuleKey',
|
||||
''
|
||||
)) = ''
|
||||
THEN 'work_rule_missing'
|
||||
WHEN state_classified.intended_channel = 'affiliate_dash'
|
||||
AND BTRIM(COALESCE(
|
||||
state_classified.configured_channel_config->>'affiliateSku',
|
||||
''
|
||||
)) = ''
|
||||
THEN 'affiliate_mapping_missing'
|
||||
WHEN state_classified.carrier_status IN ('ready', 'not_required') THEN ''
|
||||
WHEN state_classified.latest_task_status = 'manual_review'
|
||||
THEN 'carrier_manual_review'
|
||||
WHEN state_classified.latest_task_status IN ('failed', 'retry_pending')
|
||||
THEN 'carrier_retry_pending'
|
||||
WHEN state_classified.latest_task_status = 'expired' THEN 'carrier_expired'
|
||||
WHEN state_classified.latest_task_status = 'closed'
|
||||
OR state_classified.latest_work_order_status = 'cancelled'
|
||||
THEN 'carrier_closed'
|
||||
WHEN state_classified.item_fulfillment_status = 'assigned'
|
||||
THEN 'state_inconsistent'
|
||||
WHEN state_classified.intended_channel IN (
|
||||
'affiliate_dash', 'work_order', 'manual'
|
||||
)
|
||||
THEN 'carrier_missing'
|
||||
ELSE 'state_inconsistent'
|
||||
END AS issue_code
|
||||
FROM state_classified
|
||||
),
|
||||
categorized AS (
|
||||
SELECT
|
||||
issue_classified.*,
|
||||
CASE
|
||||
WHEN issue_code = '' THEN ''
|
||||
WHEN issue_code IN ('user_refund', 'platform_cancelled') THEN 'after_sales'
|
||||
WHEN issue_code = 'carrier_manual_review' THEN 'manual_review'
|
||||
WHEN issue_code IN ('missing_internal_sku', 'missing_channel') THEN 'classification'
|
||||
WHEN issue_code IN (
|
||||
'manual_config_missing', 'work_rule_missing', 'affiliate_mapping_missing'
|
||||
) THEN 'configuration'
|
||||
WHEN issue_code = 'state_inconsistent' THEN 'system'
|
||||
ELSE 'carrier'
|
||||
END AS issue_category
|
||||
FROM issue_classified
|
||||
)
|
||||
SELECT
|
||||
order_item_id,
|
||||
order_id,
|
||||
local_order_id,
|
||||
provider,
|
||||
platform,
|
||||
shop_id,
|
||||
shop_name,
|
||||
platform_order_id,
|
||||
pay_status,
|
||||
order_status,
|
||||
item_fulfillment_status AS fulfillment_status,
|
||||
internal_sku,
|
||||
intended_channel,
|
||||
stored_channel,
|
||||
configured_channel,
|
||||
route_status,
|
||||
carrier_status,
|
||||
current_attempt_type,
|
||||
current_attempt_id,
|
||||
current_attempt_status,
|
||||
current_attempt_result_code,
|
||||
latest_task_id,
|
||||
latest_task_executor_key,
|
||||
latest_task_status,
|
||||
latest_task_result_code,
|
||||
latest_work_order_id,
|
||||
latest_work_order_status,
|
||||
issue_code,
|
||||
issue_category,
|
||||
CASE
|
||||
WHEN issue_code = '' THEN FALSE
|
||||
WHEN issue_code IN (
|
||||
'user_refund', 'platform_cancelled', 'carrier_manual_review',
|
||||
'manual_config_missing', 'work_rule_missing', 'affiliate_mapping_missing',
|
||||
'missing_internal_sku', 'missing_channel'
|
||||
) THEN FALSE
|
||||
ELSE TRUE
|
||||
END AS retryable,
|
||||
CASE
|
||||
WHEN issue_code IN ('carrier_missing', 'state_inconsistent') THEN TRUE
|
||||
ELSE FALSE
|
||||
END AS auto_retryable,
|
||||
CASE
|
||||
WHEN issue_code IN ('user_refund', 'platform_cancelled', 'carrier_manual_review')
|
||||
THEN 'support'
|
||||
WHEN issue_code IN (
|
||||
'missing_internal_sku', 'missing_channel', 'manual_config_missing',
|
||||
'work_rule_missing', 'affiliate_mapping_missing'
|
||||
) THEN 'operator'
|
||||
WHEN issue_code = '' THEN ''
|
||||
ELSE 'system'
|
||||
END AS owner_role,
|
||||
fulfillment_locked,
|
||||
CASE
|
||||
WHEN NOT fulfillment_locked THEN ''
|
||||
ELSE COALESCE(
|
||||
NULLIF(fulfillment_pending_detail->>'carrierIssue', ''),
|
||||
NULLIF(fulfillment_pending_detail->>'reason', ''),
|
||||
'operator_assigned'
|
||||
)
|
||||
END AS lock_reason,
|
||||
fulfillment_pending_reason,
|
||||
fulfillment_pending_detail,
|
||||
fulfillment_source,
|
||||
sku_code,
|
||||
sku_name,
|
||||
quantity,
|
||||
revenue_amount_fen,
|
||||
created_at,
|
||||
updated_at,
|
||||
GREATEST(
|
||||
0,
|
||||
FLOOR(EXTRACT(EPOCH FROM (NOW() - created_at)) / 60)
|
||||
)::bigint AS age_minutes
|
||||
FROM categorized;
|
||||
|
||||
COMMENT ON VIEW v_fulfillment_item_state IS
|
||||
'履约统一读模型:每个订单项一行,仅读取 sku_channel_routes 的当前路由';
|
||||
@@ -0,0 +1,46 @@
|
||||
-- 161_move_shadow_sync_to_sku_routes.sql
|
||||
--
|
||||
-- 路由唯一真源已经切换到 sku_channel_routes。
|
||||
-- 履约影子模型必须跟随新表变化,旧表不再拥有任何同步触发器。
|
||||
|
||||
DROP TRIGGER IF EXISTS trg_internal_sku_channel_shadow ON internal_sku_channels;
|
||||
DROP FUNCTION IF EXISTS sync_fulfillment_shadow_for_internal_channel();
|
||||
|
||||
CREATE OR REPLACE FUNCTION sync_fulfillment_shadow_for_sku_route()
|
||||
RETURNS TRIGGER
|
||||
LANGUAGE plpgsql
|
||||
AS $$
|
||||
DECLARE
|
||||
old_key TEXT;
|
||||
new_key TEXT;
|
||||
BEGIN
|
||||
IF TG_OP <> 'INSERT' THEN
|
||||
SELECT internal_sku_key INTO old_key
|
||||
FROM internal_skus
|
||||
WHERE id = OLD.internal_sku_id;
|
||||
END IF;
|
||||
IF TG_OP <> 'DELETE' THEN
|
||||
SELECT internal_sku_key INTO new_key
|
||||
FROM internal_skus
|
||||
WHERE id = NEW.internal_sku_id;
|
||||
END IF;
|
||||
|
||||
PERFORM sync_fulfillment_shadow(item.id)
|
||||
FROM order_items item
|
||||
WHERE item.fulfillment_status IN ('pending', 'assigned')
|
||||
AND canonicalize_internal_sku(
|
||||
resolve_internal_sku(item.manual_sku_key, item.sku_name, item.sku_code)
|
||||
) IN (old_key, new_key);
|
||||
|
||||
RETURN COALESCE(NEW, OLD);
|
||||
END;
|
||||
$$;
|
||||
|
||||
DROP TRIGGER IF EXISTS trg_sku_route_fulfillment_shadow ON sku_channel_routes;
|
||||
CREATE TRIGGER trg_sku_route_fulfillment_shadow
|
||||
AFTER INSERT OR UPDATE OR DELETE ON sku_channel_routes
|
||||
FOR EACH ROW
|
||||
EXECUTE FUNCTION sync_fulfillment_shadow_for_sku_route();
|
||||
|
||||
COMMENT ON FUNCTION sync_fulfillment_shadow_for_sku_route() IS
|
||||
'sku_channel_routes 变化后刷新同内部 SKU 的履约影子';
|
||||
@@ -0,0 +1,12 @@
|
||||
-- 162_drop_legacy_routing_read_surfaces.sql
|
||||
--
|
||||
-- 160/161 已把业务读模型和影子同步切到 sku_channel_routes。
|
||||
-- 这里删除最后一个旧表只读视图,以及旧表最后一个规范化触发器。
|
||||
|
||||
DROP VIEW IF EXISTS v_fulfillment_item_state_raw;
|
||||
|
||||
DROP TRIGGER IF EXISTS trg_normalize_internal_sku_channel_key ON internal_sku_channels;
|
||||
DROP FUNCTION IF EXISTS normalize_internal_sku_channel_key();
|
||||
|
||||
COMMENT ON TABLE internal_sku_channels IS
|
||||
'冻结的历史路由输入;无触发器、无运行时读取、无运行时写入';
|
||||
Reference in New Issue
Block a user