---
name: huanxi-admin-report
description: "寰汐管理端汇报盘点：谁没交日报、跨用户查汇报内容、团队负载看板。当用户说「全公司谁没交」「盘点汇报」「谁比较闲」「看看某人这周报了什么」时使用。"
---

# 寰汐管理端 · 汇报盘点

**前置：先读 `huanxi-admin-shared`。**

管理端最高频的场景。个人端只能看自己和自己负责的模块，这里是全量视角。

---

## 谁还没交（最常被问）

```
report_pending(module_ids?, date?)
```

只返回**存在未提交人员**的模块——交齐的模块不占篇幅。不传 `module_ids` 则盘点全部。

**统计口径含两条容易忽略的规则，不要自己重算**：

- 模块杂记不计入分母（那是零散工作的承载容器，不代表当天有汇报义务）
- 当日免报的人**整体排除**——既不算未提交也不算已提交，不是「视为已提交」。
  这个区别很重要：算成已提交会污染「已交人数」，算成未提交会一直催不该催的人

回答用户时直接给名单和模块，不要把原始结构丢回去让他自己数。

---

## 查汇报内容

```
report_query(user_id?, module_id?, date_from?, date_to?)          员工日报条目
leader_report_query(user_id?, module_id?, date_from?, date_to?)   负责人日报
```

三个维度可任意组合，都不传即查今天全部。典型用法：

- 「张三这周报了什么」→ `report_query(user_id=..., date_from=周一, date_to=今天)`
- 「智能诊断模块上周的汇报」→ `report_query(module_id=..., date_from=..., date_to=...)`

**只读**。管理端不能替别人写或提交日报——那会让汇报失去「本人确认」的意义。

---

## 负载看板

```
people_board()
```

按人聚合的跨模块任务负载，**含 0 任务的人**。回答「谁比较闲」「谁扛得太多」时用它，
比逐个 `task_query` 快得多。含 0 任务的人是有意的——那正是「谁完全没有负载」的答案。

---

## 组合用法

「这周谁又没交日报、手上还压着多少活」这类问题，是 `report_pending` + `people_board`
两个结果的交叉，不需要额外工具：先拿未提交名单，再从看板里查这些人的任务数。

⏸ 涉及要不要点名、要不要发提醒时，先把名单给用户确认再说下一步——
盘点的产出是信息，催办是另一个决定。