---
name: huanxi-leader
description: "寰汐负责人日报：查看下属汇报情况、起草模块汇总、批量提交。当用户说「写负责人日报」「模块汇总」「我下属今天报了什么」「谁还没交」时使用。"
---

# 寰汐负责人日报

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

与员工日报是两件事：员工日报是「我做了什么」的条目列表，负责人日报是「我这个模块
整体怎么样」的一段整体内容，**结构不同、接口不同，不要混用**。

---

## 标准流程

```
Step 1  leader_report_get(date?, module_ids?)
        ↓ 一次拿全每个模块的：进度、我这条汇总的现状、**未提交成员名单**、
          以及成员们当天各自报了什么（member_reports）
        ↓ 起草素材全在这里，不需要再调别的工具取

Step 2  基于 member_reports 归纳，为每个模块起草一段汇总
        ↓ 归纳而非罗列——把「三个人各自做了什么」写成「这个模块本周推进到哪」
        ↓ 有 pending_members 时提醒用户：这几位还没交，汇总可能不完整

Step 3  leader_report_save(entries=[{module_id, content}, ...])

Step 4  ⏸ 展示全部草稿，等待用户明确确认

Step 5  leader_report_submit(module_ids=[...])
        ↓ 不传 module_ids 则提交我负责的全部（自动跳过已提交与内容为空的）
```

---

## 「谁还没交」

这是最高频的单点问题，`leader_report_get` 的 `pending_members` 直接回答，
不需要遍历成员逐个查。

想看全公司范围而不只是我负责的模块，那是管理端的 `report_pending`（见
`huanxi-admin`），个人端拿不到。

---

## 撤回

```
leader_report_withdraw(module_ids=[...])   → 变回草稿，仅当天可撤
```

---

## 几条容易踩的

- **一个模块一条**：`module_id` 是主键的一部分，同一模块当天只有一条汇总，
  重复保存是覆盖不是新增。
- **内容为空不能提交**：批量提交会静默跳过空内容的模块并在返回里说明，
  不要以为「提交成功」就等于每个模块都交了——看返回的 `skipped_empty_count`。
- **不要前置校验下属是否交齐**：负责人日报不依赖员工日报的提交状态，
  下属没交也能交自己的汇总（这是有意设计，避免一个人拖住整条链）。
- 只有 `leader` 角色的模块才会出现在这里；`reviewer` 不写负责人日报。