59 lines
5.4 KiB
SQL
59 lines
5.4 KiB
SQL
-- 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`;
|