完善半自动履约凭证与客户重新授权流程

统一虎牙和微博账号级 CK 保存与导出;CK 失效后回到客户重新登录,后台支持重发授权;客户授权页改为统一深色布局并收敛开发迁移配置。
This commit is contained in:
yml
2026-11-14 00:13:00 +08:00
parent e1d16f3a53
commit 8a54c41476
29 changed files with 1788 additions and 827 deletions
@@ -1,10 +1,13 @@
-- 161_semi_auto_fulfillment.sql
--
-- 人工履约渠道下的半自动任务:
-- 1. 人工 SKU 配置可显式启用虎牙/微博等半自动平台;
-- 2. 半自动任务绑定订单项和正式履约,不另建接单平台工单;
-- 3. 登录、绑定、执行状态正交保存,客户链接只按订单号展示必要信息;
-- 4. 任务只保存平台账号快照;后续迁移增加账号级加密 CK 与 credential_id。
-- 人工履约渠道下的半自动履约与账号凭证:
-- 1. 人工 SKU 配置可显式启用虎牙/微博半自动平台;
-- 2. 任务绑定订单项、正式履约和账号凭证,不另建接单平台工单;
-- 3. 登录、绑定、执行状态正交保存;
-- 4. Connector 默认使用 order_site 内置真实实现;
-- 5. 平台 CK 以账号级 Cookie JSON 保存在内部凭证表,任务只引用 credential_id。
--
-- 本文件合并了未上生产的原 161–165,空库直接得到最终结构。
ALTER TABLE manual_fulfillment_configs
ADD COLUMN IF NOT EXISTS semi_auto_enabled BOOLEAN NOT NULL DEFAULT FALSE,
@@ -23,6 +26,24 @@ BEGIN
END IF;
END $$;
CREATE TABLE IF NOT EXISTS semi_auto_credentials (
id BIGSERIAL PRIMARY KEY,
platform TEXT NOT NULL CHECK (platform IN ('huya', 'weibo')),
platform_uid TEXT NOT NULL,
platform_nickname TEXT NOT NULL DEFAULT '',
credential_payload_json TEXT NOT NULL,
credential_source TEXT NOT NULL DEFAULT ''
CHECK (credential_source IN ('', 'qr', 'sms', 'web', 'app', 'import')),
credential_status TEXT NOT NULL DEFAULT 'unknown'
CHECK (credential_status IN ('unknown', 'valid', 'invalid', 'error')),
credential_updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
last_checked_at TIMESTAMPTZ,
last_check_error TEXT NOT NULL DEFAULT '',
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
UNIQUE (platform, platform_uid)
);
CREATE TABLE IF NOT EXISTS semi_auto_tasks (
id BIGSERIAL PRIMARY KEY,
order_id BIGINT NOT NULL REFERENCES orders(id) ON DELETE CASCADE,
@@ -30,7 +51,11 @@ CREATE TABLE IF NOT EXISTS semi_auto_tasks (
fulfillment_id BIGINT REFERENCES fulfillments(id) ON DELETE SET NULL,
manual_fulfillment_config_id BIGINT
REFERENCES manual_fulfillment_configs(id) ON DELETE SET NULL,
credential_id BIGINT REFERENCES semi_auto_credentials(id) ON DELETE SET NULL,
platform TEXT NOT NULL CHECK (platform IN ('huya', 'weibo')),
connector_mode TEXT NOT NULL DEFAULT 'embedded'
CONSTRAINT chk_semi_auto_tasks_connector_mode
CHECK (connector_mode IN ('embedded', 'external', 'mock')),
login_status TEXT NOT NULL DEFAULT 'waiting_login'
CHECK (login_status IN (
'waiting_login', 'qr_pending', 'scanned', 'authenticated', 'failed', 'expired'
@@ -67,6 +92,8 @@ CREATE TABLE IF NOT EXISTS semi_auto_tasks (
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);
CREATE INDEX IF NOT EXISTS idx_semi_auto_credentials_status
ON semi_auto_credentials (platform, credential_status, updated_at DESC);
CREATE INDEX IF NOT EXISTS idx_semi_auto_tasks_status
ON semi_auto_tasks (execution_status, platform, updated_at DESC, id DESC);
CREATE INDEX IF NOT EXISTS idx_semi_auto_tasks_order
@@ -77,6 +104,9 @@ CREATE INDEX IF NOT EXISTS idx_semi_auto_tasks_operator
CREATE INDEX IF NOT EXISTS idx_semi_auto_tasks_connector
ON semi_auto_tasks (connector_session_id)
WHERE connector_session_id <> '';
CREATE INDEX IF NOT EXISTS idx_semi_auto_tasks_credential
ON semi_auto_tasks (credential_id)
WHERE credential_id IS NOT NULL;
CREATE TABLE IF NOT EXISTS semi_auto_task_events (
id BIGSERIAL PRIMARY KEY,
@@ -98,11 +128,43 @@ CREATE TABLE IF NOT EXISTS semi_auto_task_events (
CREATE INDEX IF NOT EXISTS idx_semi_auto_task_events_task
ON semi_auto_task_events (task_id, id DESC);
COMMENT ON TABLE semi_auto_credentials IS
'半自动履约平台账号级 CK;仅供内部执行器使用,日志和普通接口不得返回原始值';
COMMENT ON COLUMN semi_auto_credentials.credential_payload_json IS
'Cookie JSON;包含域名、路径、值、Secure、HttpOnly 和过期时间';
COMMENT ON COLUMN semi_auto_credentials.credential_source IS
'凭证来源:qr / sms / web / app / import';
COMMENT ON COLUMN semi_auto_credentials.credential_status IS
'执行器最近一次检查结论:unknown / valid / invalid / error';
COMMENT ON TABLE semi_auto_tasks IS
'人工履约渠道下的半自动任务;绑定订单项和正式履约,不承载平台 CK';
'人工履约渠道下的半自动任务;绑定订单项、正式履约和账号凭证';
COMMENT ON COLUMN semi_auto_tasks.connector_mode IS
'Connector 来源;embedded 为内置真实实现,external 为远程实现,mock 仅开发环境可用';
COMMENT ON COLUMN semi_auto_tasks.connector_session_id IS
'外部平台 Connector 的短期登录/绑定会话 ID;CK 仅保存在 Connector 加密凭证域';
'平台 Connector 的短期登录/绑定会话 ID;账号 CK 保存在 semi_auto_credentials';
COMMENT ON COLUMN semi_auto_tasks.credential_id IS
'该订单当前使用的平台账号凭证;任务不保存 CK 明文';
COMMENT ON COLUMN semi_auto_tasks.completion_evidence_json IS
'可选交付证据(截图 object_key、备注、外部单号等),不得保存 Cookie 或令牌';
COMMENT ON COLUMN manual_fulfillment_configs.semi_auto_config_json IS
'半自动履约展示与目标页配置;不得保存平台 CK 或运行时状态';
INSERT INTO admin_permissions (
permission_key, permission_name, permission_group, description
) VALUES (
'semi_auto.credential.export',
'导出半自动履约账号 CK',
'半自动履约',
'受控导出单个半自动履约任务的账号级 Cookie;导出动作写入审计但不记录 CK'
)
ON CONFLICT (permission_key) DO UPDATE SET
permission_name = EXCLUDED.permission_name,
permission_group = EXCLUDED.permission_group,
description = EXCLUDED.description,
updated_at = NOW();
INSERT INTO admin_role_permissions (role_key, permission_key)
SELECT 'admin', 'semi_auto.credential.export'
FROM admin_roles
WHERE role_key = 'admin'
ON CONFLICT DO NOTHING;
@@ -1,23 +0,0 @@
-- 162_semi_auto_connector_mode.sql
--
-- 半自动任务记录登录/绑定/票据注入使用的 Connector 来源:
-- external:配置的远程 Connector,作为首版默认值;
-- mock:order_site 内置开发 Mock Connector,仅开发环境可用。
ALTER TABLE semi_auto_tasks
ADD COLUMN IF NOT EXISTS connector_mode TEXT NOT NULL DEFAULT 'external';
DO $$
BEGIN
IF NOT EXISTS (
SELECT 1 FROM pg_constraint
WHERE conname = 'chk_semi_auto_tasks_connector_mode'
) THEN
ALTER TABLE semi_auto_tasks
ADD CONSTRAINT chk_semi_auto_tasks_connector_mode
CHECK (connector_mode IN ('external', 'mock'));
END IF;
END $$;
COMMENT ON COLUMN semi_auto_tasks.connector_mode IS
'Connector 来源;external 为远程真实实现,mock 仅开发环境可用';
@@ -1,25 +0,0 @@
-- 163_semi_auto_connector_mode_embedded.sql
--
-- 内置真实 Connector 成为默认实现,不再依赖外部 live-hub-py 进程:
-- embedded:order_site 进程内真实虎牙 Connector,默认值;
-- external:显式配置的远程 Connector,保留用于隔离部署;
-- mock:order_site 内置开发 Mock Connector,仅开发环境可用。
ALTER TABLE semi_auto_tasks
ALTER COLUMN connector_mode SET DEFAULT 'embedded';
ALTER TABLE semi_auto_tasks
DROP CONSTRAINT IF EXISTS chk_semi_auto_tasks_connector_mode;
-- 162 创建的历史任务均由远程 Connector 完成;切换到内置实现后仍需继续可操作。
UPDATE semi_auto_tasks
SET connector_mode = 'embedded',
updated_at = NOW()
WHERE connector_mode = 'external';
ALTER TABLE semi_auto_tasks
ADD CONSTRAINT chk_semi_auto_tasks_connector_mode
CHECK (connector_mode IN ('embedded', 'external', 'mock'));
COMMENT ON COLUMN semi_auto_tasks.connector_mode IS
'Connector 来源;embedded 为内置真实实现,external 为远程实现,mock 仅开发环境可用';
@@ -1,65 +0,0 @@
-- 164_semi_auto_credentials.sql
--
-- 半自动履约平台账号凭证:
-- 1. CK 是账号级凭证,挂到平台 UID,而不是只保存在进程内存或单次任务上;
-- 2. 数据库只保存加密后的 Cookie 集合,任务仅引用 credential_id;
-- 3. 记录凭证来源、更新时间和健康状态,供执行器失效判定与人工重登使用。
CREATE TABLE IF NOT EXISTS semi_auto_credentials (
id BIGSERIAL PRIMARY KEY,
platform TEXT NOT NULL CHECK (platform IN ('huya', 'weibo')),
platform_uid TEXT NOT NULL,
platform_nickname TEXT NOT NULL DEFAULT '',
credential_ciphertext TEXT NOT NULL,
credential_source TEXT NOT NULL DEFAULT ''
CHECK (credential_source IN ('', 'qr', 'sms', 'web', 'app', 'import')),
credential_status TEXT NOT NULL DEFAULT 'unknown'
CHECK (credential_status IN ('unknown', 'valid', 'invalid', 'error')),
credential_updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
last_checked_at TIMESTAMPTZ,
last_check_error TEXT NOT NULL DEFAULT '',
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
UNIQUE (platform, platform_uid)
);
ALTER TABLE semi_auto_tasks
ADD COLUMN IF NOT EXISTS credential_id BIGINT
REFERENCES semi_auto_credentials(id) ON DELETE SET NULL;
CREATE INDEX IF NOT EXISTS idx_semi_auto_credentials_status
ON semi_auto_credentials (platform, credential_status, updated_at DESC);
CREATE INDEX IF NOT EXISTS idx_semi_auto_tasks_credential
ON semi_auto_tasks (credential_id)
WHERE credential_id IS NOT NULL;
COMMENT ON TABLE semi_auto_credentials IS
'半自动履约平台账号级加密凭证;原始 CK 不得进入接口响应、日志或页面';
COMMENT ON COLUMN semi_auto_credentials.credential_ciphertext IS
'AES-256-GCM 加密后的 Cookie JSON;密钥来自 SEMI_AUTO_CREDENTIAL_ENCRYPTION_KEY';
COMMENT ON COLUMN semi_auto_credentials.credential_source IS
'凭证来源:qr / sms / web / app / import';
COMMENT ON COLUMN semi_auto_credentials.credential_status IS
'执行器最近一次检查结论:unknown / valid / invalid / error';
COMMENT ON COLUMN semi_auto_tasks.credential_id IS
'该订单当前使用的平台账号凭证;task 不保存 CK 明文';
INSERT INTO admin_permissions (
permission_key, permission_name, permission_group, description
) VALUES (
'semi_auto.credential.export',
'导出半自动履约账号 CK',
'半自动履约',
'受控导出单个半自动履约任务的账号级 Cookie;导出动作写入审计但不记录 CK'
)
ON CONFLICT (permission_key) DO UPDATE SET
permission_name = EXCLUDED.permission_name,
permission_group = EXCLUDED.permission_group,
description = EXCLUDED.description,
updated_at = NOW();
INSERT INTO admin_role_permissions (role_key, permission_key)
SELECT 'admin', 'semi_auto.credential.export'
FROM admin_roles
WHERE role_key = 'admin'
ON CONFLICT DO NOTHING;