72 lines
5.5 KiB
SQL
72 lines
5.5 KiB
SQL
-- 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` = '';
|