unis-oa/sql/upgrade/20261027_embed_page.sql

59 lines
5.4 KiB
SQL
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

-- 2026-10-27 生产库结构增量:新增一张表 oa_embed_page(表单嵌页面:这张单在第三方系统里那一页的账)
--
-- 症状:不是报错,是脏数据。生产上那句原话——「我在后面节点打开嵌入页面查看的时候,发现又帮我
-- 新建了一个草稿在第三方系统中。后面的节点难道不应该看的就是第一次返回的那个查看页面么?」
-- 第三方系统(ERP / 财务助手那一类)里按同一张 OA 单躺着一排没人认领、也没人删得掉的草稿。
-- 原因:那几条从对方建页接口取回来的地址,过去只记在 oa_embed_session 上,而会话是**按人**认的
-- (find_open 第一道条件就是 person = 当前这个人)、几个小时就过期。发起人建了第一页,
-- 换到审批环节是另一个人 → 查不到 → 再打一次那个「每调一次建一张页」的接口 → 第二张草稿。
-- 代码这一版把"那一页"改成记在**这张单**上(源 + 格子 + 单,唯一一行,活到单删)。
-- 范围:只有这一张新表,没有 ALTER。其余表结构未动(sql/schema.sql 已随本次改动重新导出,
-- scripts/check_schema_snapshot.py 对账通过)。
-- 执行:DBA 在生产库上整段跑一遍。新表空着不影响任何老数据;不跑这一步的话,后端读写这一张表
-- 会报 (1146, "Table 'unis_oa.oa_embed_page' doesn't exist"),症状是**点开那一格嵌页面就 500**
-- (仅当那条数据源配的是「地址由接口现给」url_mode=api;地址模板那一档不读写这一张表)。
-- 重复跑会报 1050 Duplicate table,那是预期噪音——所以这里用 IF NOT EXISTS,
-- 不要换成 DROP + CREATE:那张表记的是"这张单对应对方哪一页",抹掉它就等于把在途单
-- 在对方系统里那一页的线索一起抹了,下一次打开又会新建一张草稿,正好是这个 bug 本身。
-- 之后:不用重启(ORM 每次现拼语句)。存量在途单第一次点开那一格时会自动补上这一行;
-- 在那之前它们照旧沿用各自会话上那两条地址,行为不比现在差。
-- 口径与判据见 docs/embed-action-design.md §2.1.1,钉它的是
-- backend/scripts/check_embed_shared_page.py(真流程 + 三个真人 + 数建页接口被打几次)。
CREATE TABLE IF NOT EXISTS `oa_embed_page` (
`id` varchar(32) NOT NULL,
`source` varchar(64) NOT NULL COMMENT '哪一条注册记录(oa_data_source.code,provider=embed 那一条)',
`field` varchar(64) NOT NULL COMMENT '表单上哪一格 type=embed 的 key;同一张单上两个格子嵌的是两个页面,各记一行',
`work` varchar(32) NOT NULL COMMENT '这张单(oa_work.id)。发起页上还没单的那一刻没有这一行,认到单据之后才补',
`job` varchar(32) NOT NULL DEFAULT '' COMMENT '给人看的单号,只为排查时一眼认得出(判据一律看 work)',
`serial` varchar(64) NOT NULL DEFAULT '' COMMENT '这张单的流程编号;第三方按号记东西的居多,认到单据之后补上',
`prekey` varchar(32) NOT NULL DEFAULT '' COMMENT '第一次建这一页那一趟的预受理号:对方那张草稿是按它建的',
`person` varchar(32) NOT NULL DEFAULT '' COMMENT '是谁第一次让对面建出这一页的(界面那句灰字与排查都靠它)',
`person_name` varchar(100) NOT NULL DEFAULT '' COMMENT '那个人的姓名,取自打开那一刻的用户行',
`activity` varchar(64) NOT NULL DEFAULT '' COMMENT '在哪个环节建出来的',
`activity_name` varchar(255) NOT NULL DEFAULT '' COMMENT '那个环节的名字,界面上念的是它不是 id',
`url_edit` varchar(2048) NOT NULL DEFAULT '' COMMENT '编辑页地址(**没挂免登短码**那一份;短码 60 秒就废,每次打开现发)',
`url_view` varchar(2048) NOT NULL DEFAULT '' COMMENT '查看页地址;这条源只回一条时留空',
`url_extra` json NOT NULL COMMENT '源上「还有哪几条链接」登记的那几条({"print": "https://..."})',
`link_meta` json NOT NULL COMMENT '同一次调用顺手带回的那几个只读值({"对方单号": "RE-20261027-004"})',
`args_digest` varchar(128) NOT NULL DEFAULT '' COMMENT '建这一页那一刻的参数指纹。只作留痕,不作作废的理由',
`opens` int NOT NULL DEFAULT '0' COMMENT '这一页被沿用过几次(对面那张草稿到底有没有人在看,靠这一列答)',
`last_open` datetime DEFAULT NULL COMMENT '最近一次被沿用的时间',
`create_time` datetime NOT NULL,
`update_time` datetime NOT NULL,
PRIMARY KEY (`id`),
UNIQUE KEY `uq_embed_page_anchor` (`source`,`field`,`work`) COMMENT '一张单、一条源、一个格子 = 对面只有一页,这条约束就是这件事本身',
KEY `idx_embed_page_work` (`work`),
KEY `ix_oa_embed_page_source` (`source`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
-- 核账:这一条应返回 1 行、20 列
SELECT `TABLE_NAME`, COUNT(*) AS `columns`
FROM `information_schema`.`COLUMNS`
WHERE `TABLE_SCHEMA` = DATABASE() AND `TABLE_NAME` = 'oa_embed_page';
-- 这一条应返回 1 行:uq_embed_page_anchor (source, field, work)
SELECT `INDEX_NAME`, GROUP_CONCAT(`COLUMN_NAME` ORDER BY `SEQ_IN_INDEX`) AS `cols`
FROM `information_schema`.`STATISTICS`
WHERE `TABLE_SCHEMA` = DATABASE() AND `TABLE_NAME` = 'oa_embed_page'
GROUP BY `INDEX_NAME`;