unis-oa/sql/upgrade/20261117_done_cc_split.sql

72 lines
5.5 KiB
SQL
Raw Permalink 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-11-17 生产库说明:办完的抄送归「已办」,看过的才算「已阅」——读侧分家,结构一个字节都没动
--
-- 症状:抄送 / 转发「需处理」的那几条,本人处理完之后出现在**已阅**里,已办那一屏看不见。
-- 同一屏混着两种收尾:已办看不出「这张单我也表过态」,已阅里夹着一堆带处理时间的行。
-- 用户口径(原话):「抄送、转发需处理的消息处理后才已办中。抄送、转发无需处理的消息
-- 处理后才会到已阅里面」,并特别要求「顺便考虑历史处理的处理」。
-- 原因:写侧本来就把两种收尾都落在同一张 ``oa_read_completed`` 上,行上也一直带着判据
-- (``requires_action`` / ``handle_time``),坏的只是**读侧没拿它分家**——
-- ``GET /read/completed`` 整表回,``GET /task/completed`` 只读 ``oa_task_completed``。
-- 于是需处理那几条从改版之前就一路摆在已阅里。这是读法问题,不是数据问题。
-- 范围:**零 DDL、零回填、零 UPDATE**。不加列、不在两张表之间搬行、不往审批流水里插行。
-- 改的只有读法:``backend/app/service/completed.py``(已办读两本账 + 按「单 × 来源」折叠)、
-- ``api/runtime.py``(``list_completed`` / ``list_read_completed`` / ``_done_filters``)、
-- ``serializers.read_completed_as_done``(把归档行翻成已办那一份形状)、
-- ``api/export.py``(已办导出多一列「类型」)、``api/portal.py`` 与 ``api/support.py``
-- (首页与工作台那两个数跟着换成组数)。
-- 历史行因此**自动归位**:改版之前办完、一直躺在已阅里的那几条(``requires_action=1``
-- 且 ``handle_time`` 非空),今天打开已办就在,同时从已阅消失,一条都不用刷。
-- 也不准备回滚脚本——真要退回旧口径,改回读法就行,数据没动过。
-- 为什么**不**往 ``oa_task_completed`` 插一行:那张表是审批流水,「他签过没」
-- (``engine._approved_persons``)、按比例会签数票(``engine._ratio_votes``)、
-- 撤回已办按行号定点撤(``engine.reset_task``)三套判据都按行算。抄送处理没走环节、
-- 没有出口、没填过表单,插一行进去会让这三处一起说谎(凭空多一个"批过"的人、
-- 多一票、多一个能撤的步)。行仍留在 ``oa_read_completed``,读的时候翻译成人话。
-- 之后(口径写在这儿,免得下一次被当 bug 改回去):
-- 已办 = ``oa_task_completed``(环节上的表态,按「单 × 来源」折叠)
-- + ``oa_read_completed`` 且 ``requires_action=1``(办完的抄送 / 转发需处理;
-- 出参 ``done_source="cc"``、``processing_type="cc"``,没有出口、撤不回)
-- 已阅 = ``oa_read_completed`` 且 ``requires_action=0``(点开单据 / 标记已读那几条)
-- 两边各认一半,加起来才是归档行的全量。``GET /read/completed`` 不再收 ``action``
-- 参数(那一格从前是用来在已阅里挑需处理的,现在需处理的压根不在这屏)。
-- 顺带同批的另一条口径:抄送需处理那句**处理意见改成选填**——必填的是「本人按下了
-- 处理」这一颗钮,不是那几个字;意见留空(含只有空格)照旧落 ``handle_time``,
-- 也不覆盖抄送时对方写的那句来意。
-- 判据:backend/scripts/check_done_cc_split.py(分家 + 历史行归位 + 折叠 + 意见选填)、
-- check_inbox_read.py、check_cc_entries_to_read.py、check_action_surface.py。
--
-- 下面全是只读核账语句,跑一遍不改一个字节。
-- 1) 归档行按判据分档:=1 归已办、=0 归已阅。两档之和就是这张表的全量,
-- 不该有第三种值(这一列是 NOT NULL Boolean)。
SELECT `requires_action`, COUNT(*) AS `rows_`
FROM `oa_read_completed`
GROUP BY `requires_action`
ORDER BY `requires_action` DESC;
-- 2) 需处理那几条确实表过态:办完必经「处理」,``handle_time`` 一定非空。
-- 这一条报出行来,就是有一条绕过了那颗钮被记成"办完"(正常应为 0 行)。
SELECT `id`, `read`, `job`, `title`, `view_time`
FROM `oa_read_completed`
WHERE `requires_action` = 1 AND `handle_time` IS NULL;
-- 3) 用户要的"历史处理的处理"就在这一条:改版之前办完、一直躺在已阅里的那几条,
-- 今天起在已办里看得见。抽 20 条到界面上对一眼(无需任何 UPDATE)。
SELECT `id`, `job`, `title`, `identity_name`, `read_type`, `forwarded`,
`view_time`, `handle_time`
FROM `oa_read_completed`
WHERE `requires_action` = 1
ORDER BY `handle_time` DESC
LIMIT 20;
-- 4) 抄送处理没被塞进审批流水:这张表的行数只随环节表态增长。
-- 改版前后各跑一次,两个数该一样(这一版没有任何路径往里写)。
SELECT COUNT(*) AS `task_completed_rows`, MAX(`completed_time`) AS `last_approval_time`
FROM `oa_task_completed`;
-- 5) 两个人各归各的老账顺带看一眼:需处理那档的发起人快照也该整行带进已办出参
-- (见 sql/upgrade/20261117_read_creator_snapshot.sql),空着的是单据已被物理删除的孤儿行。
SELECT COUNT(*) AS `action_rows_without_creator`
FROM `oa_read_completed`
WHERE `requires_action` = 1 AND `creator_person` = '';