Commit Graph

2 Commits

Author SHA1 Message Date
4d6e944220 feat(webui): 打开即已读 + 回复即已读
用户:「现在邮件需要完全手动标记是否已读而不支持点进去自动已读或者回复自动已读」。

## 改法

- **打开即已读**:MailView 里加一个 effect —— 当前邮件是 unread 且**真正可见**时
  调 `markRead`。两个刻意的细节:
  1. 窄屏下 MailView 可能已经渲染但被列表覆盖层盖住(NarrowStack)⇒ 必须等到
     `narrowPane === 'detail'` 才标,否则"滑过去但没看"的邮件也会被标已读;
  2. 只对 `unread` 发请求(已读的再标一次是白跑,还会让接口日志一直响)。
- **回复即已读**:ReplyBar 发送**成功之后**才标(发送失败不该把"我处理过了"记下来)。
- 手动标记按钮保留(显式动作仍然有用)。

## 端到端验证(真浏览器 + 真库)

造一封未读 → 浏览器里展开会话分组、点开那封邮件 →

    POST /read → 200
    mail_reads 里出现 (reader=gui-lab)
    冗余列 mails.status: unread → read

即"打开即已读"确实生效,而且是记在**读者维度**上(不会像旧的邮件级已读那样
被别人一标就没了)。

## 一个过程记录

前两次验证都"没有发出 /read 请求",我一度以为代码没生效。其实是**点错了对象**:
会话分组默认折叠,`button:has-text(主题)` 匹配到的是**分组那颗**,点它只展开、
不选中邮件(所以不触发已读 —— 这恰恰是正确行为)。展开后再点具体邮件行才触发。
判据必须点"用户真正会点的那一层",这句话这次又应验了。

套件:vitest 15 文件 / 258 用例全绿。
2026-09-14 13:12:36 +08:00
5ce25f6fdb fix(webui): 修侧栏点击无法翻页 + 回信 UI 统一成一个组件
用户两句:「侧边导航栏完全不可用,点击无法翻页,而且窄屏显示不全」、
「按顺序做吧」(= 做回信 UI 统一)。

## ① 侧栏点击无法翻页(严重,我的错)

导航合并时我把点击目标写成:

    onClick={() => setViewMode(target || commTab || modes[0])}

只有「通信」有意回上次的子页签,而**日历/联系人没有 target** ⇒ 点它们会跳到
`commTab`(收件箱)⇒ 表现为"点了没反应/不翻页"。

修成 `setViewMode(target ?? (isComm ? commTab : modes[0]))`。

**为什么没被拦住**:我的验证全在看**结构与样式**(导航项数、徽标、圆角、玻璃、
对比度),**一次都没点过**。所以补了 `test/components/Sidebar.test.tsx`:点每一项,
断言落到它自己那一项,并带一条反向对照。真浏览器点击也复验:日历→日历页、
联系→联系人、通信→回通信页。

## ② 回信 UI 统一(用户点名的欠账)

新增 `src/components/Composer.tsx`:**形状**(输入区 / 动作行 / 提示)只有一处定义,
**差异**用 `header`(选项胶囊)、`footerExtra`、`submit.tone`、`density`
(compact=批注、roomy=回信正文)条件渲染 —— 差异是数据,不是又一套 UI。

三处各写一套的地方现在都走它:提问型授权表单、审批型(同意/拒绝)、ReplyBar 回信。
输入框的边框/圆角/聚焦环/禁用态从"抄了三遍"变成一处。

**重构时我引入过一个危险的错**:给审批型加了个"提交备注"按钮,兜底用 `options[0]`
(= 同意)⇒ 点一下就**默认批准**。被既有判据当场抓住(`PermissionPanel` 两条红),
已改成"点选项即提交"(`submit` 现在是可选的),并用 `variant="action"`
把同意/拒绝的颜色语义恢复成原来的实心绿 / 浅红。

## ③ 我自己的流程问题(写下来)

- 结构类改动必须配一条"**点它**"的判据 —— 这次就是缺了它。
- 单测里改 store 后必须 `rerender` 再点:否则闭包里是旧值(我第一版因此误判代码有问题)。
- 窄屏"显示不全"**没能复现**:390×844 与 320×568 都量了 —— 无横向溢出、
  内容面板完整落在悬浮导航之上、最后一行完整可见。需要用户指出具体页面。

判据:vitest **15 文件 / 258 用例全绿**(含新增 Sidebar 点击 4 条)。
2026-09-14 12:26:06 +08:00