重构:统一商品渠道投影并收敛权威文档

This commit is contained in:
yml2213
2026-11-08 19:44:27 +08:00
parent 0a595acfa9
commit 1634502363
67 changed files with 2147 additions and 444 deletions
@@ -0,0 +1,426 @@
-- 154_internal_sku_registry_and_routes.sql
--
-- 统一内部 SKU 身份与履约路由:
-- 1. internal_skus 成为内部 SKU 的稳定身份;
-- 2. sku_channel_routes 成为主渠道/兜底渠道的唯一结构化表达;
-- 3. 兼容期由旧 internal_sku_channels 通过触发器同步;
-- 4. product_catalog 增加 source_kind 与 internal_sku_id,不再依赖前缀判断业务来源。
CREATE TABLE internal_skus (
id BIGSERIAL PRIMARY KEY,
internal_sku_key TEXT NOT NULL,
display_name TEXT NOT NULL DEFAULT '',
status TEXT NOT NULL DEFAULT 'active',
merged_into_id BIGINT REFERENCES internal_skus(id) ON DELETE SET NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
CONSTRAINT internal_skus_key_not_blank CHECK (BTRIM(internal_sku_key) <> ''),
CONSTRAINT internal_skus_status_check CHECK (status IN ('active', 'disabled', 'merged'))
);
CREATE UNIQUE INDEX uq_internal_skus_key
ON internal_skus(internal_sku_key);
COMMENT ON TABLE internal_skus IS
'中文内部 SKU 稳定身份;所有路由、配置和商品关联最终通过 internal_sku_id 引用';
COMMENT ON COLUMN internal_skus.internal_sku_key IS
'NFKC、去空白、转小写后的稳定键';
WITH source_rows AS (
SELECT internal_sku AS raw_value, updated_at FROM internal_sku_channels
UNION ALL
SELECT internal_sku AS raw_value, updated_at FROM internal_sku_mappings
UNION ALL
SELECT sku_key AS raw_value, updated_at FROM manual_fulfillment_configs
UNION ALL
SELECT sku_key AS raw_value, updated_at FROM manual_sku_registry
UNION ALL
SELECT canonical_name AS raw_value, updated_at FROM product_catalog
),
normalized AS (
SELECT
canonicalize_internal_sku(raw_value) AS internal_sku_key,
BTRIM(raw_value) AS display_name,
updated_at
FROM source_rows
WHERE canonicalize_internal_sku(raw_value) <> ''
),
picked AS (
SELECT DISTINCT ON (internal_sku_key)
internal_sku_key,
display_name,
updated_at
FROM normalized
ORDER BY internal_sku_key, updated_at DESC NULLS LAST, display_name
)
INSERT INTO internal_skus (
internal_sku_key,
display_name,
status,
created_at,
updated_at
)
SELECT
internal_sku_key,
display_name,
'active',
COALESCE(updated_at, NOW()),
COALESCE(updated_at, NOW())
FROM picked
ON CONFLICT (internal_sku_key) DO UPDATE SET
display_name = CASE
WHEN internal_skus.display_name = '' THEN EXCLUDED.display_name
ELSE internal_skus.display_name
END,
updated_at = GREATEST(internal_skus.updated_at, EXCLUDED.updated_at);
ALTER TABLE internal_sku_mappings
ADD COLUMN internal_sku_id BIGINT REFERENCES internal_skus(id) ON DELETE SET NULL;
ALTER TABLE manual_fulfillment_configs
ADD COLUMN internal_sku_id BIGINT REFERENCES internal_skus(id) ON DELETE SET NULL;
ALTER TABLE product_catalog
ADD COLUMN internal_sku_id BIGINT REFERENCES internal_skus(id) ON DELETE SET NULL,
ADD COLUMN source_kind TEXT;
UPDATE internal_sku_mappings mapping
SET internal_sku_id = sku.id
FROM internal_skus sku
WHERE sku.internal_sku_key = canonicalize_internal_sku(mapping.internal_sku);
UPDATE manual_fulfillment_configs config
SET internal_sku_id = sku.id
FROM internal_skus sku
WHERE sku.internal_sku_key = canonicalize_internal_sku(config.sku_key);
UPDATE product_catalog product
SET source_kind = CASE
WHEN product.canonical_sku LIKE 'aff:%' THEN 'affiliate_dash'
WHEN product.canonical_sku LIKE 'tpl:%' OR product.canonical_sku LIKE 'wo:%' THEN 'work_order'
WHEN product.canonical_sku LIKE 'tpv:%' THEN 'third_party_voucher'
WHEN product.canonical_sku LIKE 'man:%' THEN 'manual'
ELSE 'unclassified'
END;
UPDATE product_catalog product
SET internal_sku_id = sku.id
FROM internal_skus sku
WHERE sku.internal_sku_key = canonicalize_internal_sku(
CASE
WHEN product.canonical_sku LIKE 'man:%' THEN substring(product.canonical_sku from 5)
WHEN product.canonical_sku LIKE 'tpv:%' THEN substring(product.canonical_sku from 5)
ELSE NULL
END
);
ALTER TABLE product_catalog
ALTER COLUMN source_kind SET DEFAULT 'unclassified',
ALTER COLUMN source_kind SET NOT NULL;
CREATE INDEX idx_product_catalog_internal_sku
ON product_catalog(internal_sku_id)
WHERE internal_sku_id IS NOT NULL;
CREATE INDEX idx_product_catalog_source_kind
ON product_catalog(source_kind, status);
CREATE INDEX idx_internal_sku_mappings_internal_sku
ON internal_sku_mappings(internal_sku_id)
WHERE internal_sku_id IS NOT NULL;
CREATE INDEX idx_manual_configs_internal_sku
ON manual_fulfillment_configs(internal_sku_id)
WHERE internal_sku_id IS NOT NULL;
CREATE TABLE sku_channel_routes (
id BIGSERIAL PRIMARY KEY,
internal_sku_id BIGINT NOT NULL REFERENCES internal_skus(id) ON DELETE CASCADE,
channel TEXT NOT NULL,
route_role TEXT NOT NULL DEFAULT 'fallback',
priority INTEGER NOT NULL DEFAULT 100,
enabled BOOLEAN NOT NULL DEFAULT TRUE,
canonical_product_id BIGINT REFERENCES product_catalog(id) ON DELETE SET NULL,
carrier_config_json JSONB NOT NULL DEFAULT '{}'::jsonb,
source TEXT NOT NULL DEFAULT 'legacy_sync',
note TEXT NOT NULL DEFAULT '',
created_by_admin_user_id BIGINT REFERENCES admin_users(id) ON DELETE SET NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
CONSTRAINT sku_channel_routes_channel_check
CHECK (channel IN ('work_order', 'affiliate_dash', 'third_party_voucher', 'manual', 'on_account')),
CONSTRAINT sku_channel_routes_role_check
CHECK (route_role IN ('primary', 'fallback')),
CONSTRAINT sku_channel_routes_priority_check
CHECK (priority >= 0)
);
CREATE UNIQUE INDEX uq_sku_channel_routes_channel
ON sku_channel_routes(internal_sku_id, channel);
CREATE UNIQUE INDEX uq_sku_channel_routes_primary
ON sku_channel_routes(internal_sku_id)
WHERE enabled = TRUE AND route_role = 'primary';
CREATE INDEX idx_sku_channel_routes_lookup
ON sku_channel_routes(channel, enabled, priority)
WHERE enabled = TRUE;
COMMENT ON TABLE sku_channel_routes IS
'内部 SKU 履约路由:一个主渠道加若干显式兜底渠道';
COMMENT ON COLUMN sku_channel_routes.carrier_config_json IS
'渠道载体参数,例如 workRuleKey / affiliateSku / manualConfigId / voucherSku';
WITH legacy_rows AS (
SELECT
sku.id AS internal_sku_id,
channel.channel,
channel.priority,
channel.is_fallback,
channel.enabled,
channel.canonical_product_id,
channel.config_json,
channel.source,
channel.note,
channel.created_by_admin_user_id,
channel.created_at,
channel.updated_at,
ROW_NUMBER() OVER (
PARTITION BY sku.id, channel.channel
ORDER BY channel.is_fallback, channel.priority, channel.id
) AS channel_rank
FROM internal_sku_channels channel
JOIN internal_skus sku
ON sku.internal_sku_key = canonicalize_internal_sku(channel.internal_sku)
WHERE channel.enabled = TRUE
),
deduplicated AS (
SELECT * FROM legacy_rows WHERE channel_rank = 1
),
ranked AS (
SELECT
*,
ROW_NUMBER() OVER (
PARTITION BY internal_sku_id
ORDER BY is_fallback, priority, channel
) AS overall_rank
FROM deduplicated
)
INSERT INTO sku_channel_routes (
internal_sku_id,
channel,
route_role,
priority,
enabled,
canonical_product_id,
carrier_config_json,
source,
note,
created_by_admin_user_id,
created_at,
updated_at
)
SELECT
internal_sku_id,
channel,
CASE WHEN overall_rank = 1 THEN 'primary' ELSE 'fallback' END,
CASE WHEN overall_rank = 1 THEN priority ELSE GREATEST(priority, 90) END,
TRUE,
canonical_product_id,
COALESCE(config_json, '{}'::jsonb),
COALESCE(NULLIF(source, ''), 'legacy_sync'),
COALESCE(note, ''),
created_by_admin_user_id,
COALESCE(created_at, NOW()),
COALESCE(updated_at, NOW())
FROM ranked
ON CONFLICT (internal_sku_id, channel) DO NOTHING;
CREATE OR REPLACE FUNCTION ensure_canonical_internal_sku(p_raw TEXT)
RETURNS BIGINT
LANGUAGE plpgsql
AS $$
DECLARE
v_key TEXT := canonicalize_internal_sku(p_raw);
v_display_name TEXT := BTRIM(COALESCE(p_raw, ''));
v_id BIGINT;
BEGIN
IF v_key = '' THEN
RETURN NULL;
END IF;
INSERT INTO internal_skus (internal_sku_key, display_name, status, created_at, updated_at)
VALUES (v_key, v_display_name, 'active', NOW(), NOW())
ON CONFLICT (internal_sku_key) DO UPDATE SET
display_name = CASE
WHEN internal_skus.display_name = '' THEN EXCLUDED.display_name
ELSE internal_skus.display_name
END,
updated_at = GREATEST(internal_skus.updated_at, EXCLUDED.updated_at)
RETURNING id INTO v_id;
RETURN v_id;
END;
$$;
CREATE OR REPLACE FUNCTION sync_sku_channel_routes_for_key(p_raw TEXT)
RETURNS VOID
LANGUAGE plpgsql
AS $$
DECLARE
v_sku_id BIGINT;
BEGIN
SELECT id INTO v_sku_id
FROM internal_skus
WHERE internal_sku_key = canonicalize_internal_sku(p_raw)
LIMIT 1;
IF v_sku_id IS NULL THEN
RETURN;
END IF;
DELETE FROM sku_channel_routes WHERE internal_sku_id = v_sku_id;
WITH legacy_rows AS (
SELECT
channel.channel,
channel.priority,
channel.is_fallback,
channel.canonical_product_id,
channel.config_json,
channel.source,
channel.note,
channel.created_by_admin_user_id,
channel.created_at,
channel.updated_at,
ROW_NUMBER() OVER (
PARTITION BY channel.channel
ORDER BY channel.is_fallback, channel.priority, channel.id
) AS channel_rank
FROM internal_sku_channels channel
WHERE channel.enabled = TRUE
AND canonicalize_internal_sku(channel.internal_sku)
= canonicalize_internal_sku(p_raw)
),
ranked AS (
SELECT
*,
ROW_NUMBER() OVER (
ORDER BY is_fallback, priority, channel
) AS overall_rank
FROM legacy_rows
WHERE channel_rank = 1
)
INSERT INTO sku_channel_routes (
internal_sku_id,
channel,
route_role,
priority,
enabled,
canonical_product_id,
carrier_config_json,
source,
note,
created_by_admin_user_id,
created_at,
updated_at
)
SELECT
v_sku_id,
channel,
CASE WHEN overall_rank = 1 THEN 'primary' ELSE 'fallback' END,
CASE WHEN overall_rank = 1 THEN priority ELSE GREATEST(priority, 90) END,
TRUE,
canonical_product_id,
COALESCE(config_json, '{}'::jsonb),
COALESCE(NULLIF(source, ''), 'legacy_sync'),
COALESCE(note, ''),
created_by_admin_user_id,
COALESCE(created_at, NOW()),
COALESCE(updated_at, NOW())
FROM ranked;
END;
$$;
CREATE OR REPLACE FUNCTION sync_sku_channel_routes_trigger()
RETURNS TRIGGER
LANGUAGE plpgsql
AS $$
BEGIN
IF TG_OP <> 'INSERT' THEN
PERFORM sync_sku_channel_routes_for_key(OLD.internal_sku);
END IF;
IF TG_OP <> 'DELETE' THEN
PERFORM ensure_canonical_internal_sku(NEW.internal_sku);
PERFORM sync_sku_channel_routes_for_key(NEW.internal_sku);
END IF;
RETURN COALESCE(NEW, OLD);
END;
$$;
CREATE TRIGGER trg_sync_sku_channel_routes
AFTER INSERT OR UPDATE OR DELETE ON internal_sku_channels
FOR EACH ROW
EXECUTE FUNCTION sync_sku_channel_routes_trigger();
CREATE OR REPLACE FUNCTION set_internal_sku_id_from_text()
RETURNS TRIGGER
LANGUAGE plpgsql
AS $$
BEGIN
NEW.internal_sku_id := ensure_canonical_internal_sku(NEW.internal_sku);
RETURN NEW;
END;
$$;
CREATE TRIGGER trg_internal_sku_mapping_identity
BEFORE INSERT OR UPDATE OF internal_sku ON internal_sku_mappings
FOR EACH ROW
EXECUTE FUNCTION set_internal_sku_id_from_text();
CREATE OR REPLACE FUNCTION set_manual_config_internal_sku_id()
RETURNS TRIGGER
LANGUAGE plpgsql
AS $$
BEGIN
NEW.internal_sku_id := ensure_canonical_internal_sku(NEW.sku_key);
RETURN NEW;
END;
$$;
CREATE TRIGGER trg_manual_config_internal_sku_identity
BEFORE INSERT OR UPDATE OF sku_key ON manual_fulfillment_configs
FOR EACH ROW
EXECUTE FUNCTION set_manual_config_internal_sku_id();
CREATE OR REPLACE FUNCTION normalize_product_identity()
RETURNS TRIGGER
LANGUAGE plpgsql
AS $$
BEGIN
NEW.source_kind := COALESCE(
NULLIF(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 'unclassified'
END
);
IF NEW.internal_sku_id IS NULL THEN
SELECT sku.id INTO NEW.internal_sku_id
FROM internal_skus sku
WHERE sku.internal_sku_key = canonicalize_internal_sku(
CASE
WHEN NEW.canonical_sku LIKE 'man:%' THEN substring(NEW.canonical_sku from 5)
WHEN NEW.canonical_sku LIKE 'tpv:%' THEN substring(NEW.canonical_sku from 5)
ELSE NULL
END
)
LIMIT 1;
END IF;
RETURN NEW;
END;
$$;
CREATE TRIGGER trg_normalize_product_identity
BEFORE INSERT OR UPDATE OF canonical_sku, canonical_name, source_kind, internal_sku_id
ON product_catalog
FOR EACH ROW
EXECUTE FUNCTION normalize_product_identity();
@@ -0,0 +1,96 @@
-- 155_product_current_projection.sql
--
-- 统一商品当前渠道投影,并清理已被其他渠道接管且没有人工兜底配置的旧 man 商品。
UPDATE sku_channel_routes route
SET canonical_product_id = product.id,
updated_at = NOW()
FROM product_catalog product
WHERE route.channel = 'work_order'
AND route.canonical_product_id IS NULL
AND product.status = 'active'
AND product.canonical_sku = 'tpl:' || COALESCE(route.carrier_config_json->>'workRuleKey', '');
CREATE OR REPLACE VIEW v_product_current AS
SELECT
product.*,
sku.internal_sku_key,
COALESCE(
primary_route.channel,
CASE product.source_kind
WHEN 'affiliate_dash' THEN 'affiliate_dash'
WHEN 'work_order' THEN 'work_order'
WHEN 'third_party_voucher' THEN 'third_party_voucher'
WHEN 'manual' THEN 'manual'
ELSE NULL
END
) 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
'标准商品统一投影:来源、当前主渠道、兜底渠道和人工配置状态同源输出';
WITH candidates AS (
SELECT product.id
FROM v_product_current product
WHERE product.status = 'active'
AND product.canonical_sku LIKE 'man:%'
AND product.active_primary_channel IS NOT NULL
AND product.active_primary_channel <> 'manual'
AND product.has_active_manual_config = FALSE
AND EXISTS (
SELECT 1
FROM sku_channel_routes route
WHERE route.internal_sku_id = product.internal_sku_id
AND route.enabled = TRUE
AND route.route_role = 'primary'
AND route.channel <> 'manual'
)
)
UPDATE product_catalog product
SET status = 'archived',
attributes_json = COALESCE(product.attributes_json, '{}'::jsonb) || jsonb_build_object(
'legacyManualArchived', TRUE,
'legacyManualArchiveReason', 'superseded_by_current_primary_channel',
'legacyManualArchivedAt', NOW()
),
updated_at = NOW()
FROM candidates
WHERE product.id = candidates.id;
COMMENT ON COLUMN product_catalog.source_kind IS
'标准商品来源类型;来源不等于当前履约渠道,当前渠道统一读取 v_product_current';
@@ -0,0 +1,53 @@
-- 156_fix_product_source_kind_default.sql
--
-- source_kind 的列默认值会让 BEFORE INSERT 触发器看到“非空但未分类”,
-- 从而跳过前缀回填。这里保留默认值兼容直接写入,同时让已知前缀始终覆盖
-- unclassified,并修复兼容期内已经写入的误判行。
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
SELECT sku.id INTO NEW.internal_sku_id
FROM internal_skus sku
WHERE sku.internal_sku_key = canonicalize_internal_sku(
CASE
WHEN NEW.canonical_sku LIKE 'man:%' THEN substring(NEW.canonical_sku from 5)
WHEN NEW.canonical_sku LIKE 'tpv:%' THEN substring(NEW.canonical_sku from 5)
ELSE NULL
END
)
LIMIT 1;
END IF;
RETURN NEW;
END;
$$;
UPDATE product_catalog
SET source_kind = CASE
WHEN canonical_sku LIKE 'aff:%' THEN 'affiliate_dash'
WHEN canonical_sku LIKE 'tpl:%' OR canonical_sku LIKE 'wo:%' THEN 'work_order'
WHEN canonical_sku LIKE 'tpv:%' THEN 'third_party_voucher'
WHEN canonical_sku LIKE 'man:%' THEN 'manual'
ELSE source_kind
END,
updated_at = NOW()
WHERE source_kind = 'unclassified'
AND (
canonical_sku LIKE 'aff:%'
OR canonical_sku LIKE 'tpl:%'
OR canonical_sku LIKE 'wo:%'
OR canonical_sku LIKE 'tpv:%'
OR canonical_sku LIKE 'man:%'
);
@@ -0,0 +1,105 @@
-- 157_preserve_fallback_only_routes.sql
--
-- 兼容同步不能把“只有兜底渠道”的旧配置自动升级成主渠道。
-- 只有旧表中明确 is_fallback = FALSE 的渠道才允许竞争 primary;
-- 如果某个内部 SKU 没有主渠道,则所有启用路由都保持 fallback。
CREATE OR REPLACE FUNCTION sync_sku_channel_routes_for_key(p_raw TEXT)
RETURNS VOID
LANGUAGE plpgsql
AS $$
DECLARE
v_sku_id BIGINT;
BEGIN
SELECT id INTO v_sku_id
FROM internal_skus
WHERE internal_sku_key = canonicalize_internal_sku(p_raw)
LIMIT 1;
IF v_sku_id IS NULL THEN
RETURN;
END IF;
DELETE FROM sku_channel_routes WHERE internal_sku_id = v_sku_id;
WITH legacy_rows AS (
SELECT
channel.channel,
channel.priority,
channel.is_fallback,
channel.canonical_product_id,
channel.config_json,
channel.source,
channel.note,
channel.created_by_admin_user_id,
channel.created_at,
channel.updated_at,
ROW_NUMBER() OVER (
PARTITION BY channel.channel
ORDER BY channel.priority, channel.id
) AS channel_rank
FROM internal_sku_channels channel
WHERE channel.enabled = TRUE
AND canonicalize_internal_sku(channel.internal_sku)
= canonicalize_internal_sku(p_raw)
),
ranked AS (
SELECT
*,
ROW_NUMBER() OVER (
PARTITION BY is_fallback
ORDER BY priority, channel
) AS role_rank
FROM legacy_rows
WHERE channel_rank = 1
)
INSERT INTO sku_channel_routes (
internal_sku_id,
channel,
route_role,
priority,
enabled,
canonical_product_id,
carrier_config_json,
source,
note,
created_by_admin_user_id,
created_at,
updated_at
)
SELECT
v_sku_id,
channel,
CASE
WHEN is_fallback = FALSE AND role_rank = 1 THEN 'primary'
ELSE 'fallback'
END,
CASE
WHEN is_fallback = FALSE AND role_rank = 1 THEN priority
ELSE GREATEST(priority, 90)
END,
TRUE,
canonical_product_id,
COALESCE(config_json, '{}'::jsonb),
COALESCE(NULLIF(source, ''), 'legacy_sync'),
COALESCE(note, ''),
created_by_admin_user_id,
COALESCE(created_at, NOW()),
COALESCE(updated_at, NOW())
FROM ranked;
END;
$$;
DO $$
DECLARE
v_internal_sku TEXT;
BEGIN
FOR v_internal_sku IN
SELECT DISTINCT internal_sku
FROM internal_sku_channels
WHERE enabled = TRUE
LOOP
PERFORM sync_sku_channel_routes_for_key(v_internal_sku);
END LOOP;
END;
$$;
@@ -0,0 +1,57 @@
-- 158_manual_source_is_not_manual_route.sql
--
-- man: 只表示商品来源,不能证明当前由人工履约。
-- 兼容期内,自动发货 / 接单平台 / 第三方卡券这类直连来源允许暂时由 source_kind
-- 推导当前渠道;人工客服必须有真实启用的 primary route,否则就是“未路由”。
CREATE OR REPLACE VIEW v_product_current AS
SELECT
product.*,
sku.internal_sku_key,
COALESCE(
primary_route.channel,
CASE product.source_kind
WHEN 'affiliate_dash' THEN 'affiliate_dash'
WHEN 'work_order' THEN 'work_order'
WHEN 'third_party_voucher' THEN 'third_party_voucher'
ELSE NULL
END
) 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
'标准商品统一投影:来源不等于当前渠道;manual 必须有真实主路由,直连来源兼容期允许回退 source_kind';