# 钉钉模块

> **负责人**: FFOA 开发团队  
> **状态**: 🟢 Active  
> **最后更新**: 2026-03-17

---

## 文档摘要

### 最小必填项

| 字段 | 内容 |
|------|------|
| 模块 | 钉钉模块 |
| 文档类型 | Module-README |
| 目标 | 统一维护钉钉同步、员工同步、年假洞察与人工修复能力的事实源文档 |
| 关键入口 | `frontend/src/app/(modules)/organization/dingtalk/` / `backend/src/modules/organization/dingtalk/` / `platform_automation.*` |
| 关键文档 | `01-prd.md` / `07-api.md` / `09-test-scenarios.md` |

### 文档导航

| 文档 | 状态 | 最后更新 |
|------|------|---------|
| [产品需求文档](./01-prd.md) | ✅ | 2026-03-17 |
| [用户场景](./02-user-journey.md) | ✅ | 2026-03-17 |
| [架构设计](./03-architecture.md) | ✅ | 2026-03-17 |
| [状态机](./04-state-machine.md) | ❌ | - |
| [UI 交互规范](./05-ui-interaction-spec.md) | ✅ | 2026-03-17 |
| [数据模型](./06-data-model.md) | ✅ | 2026-03-17 |
| [API 文档](./07-api.md) | ✅ | 2026-03-17 |
| [错误码](./08-error-codes.md) | ✅ | 2026-03-17 |
| [测试场景](./09-test-scenarios.md) | ✅ | 2026-03-17 |
| [E2E 测试规范](./10-e2e-test-spec.md) | ❌ | - |
| [变更日志](./99-changelog.md) | ✅ | 2026-03-17 |

---

## 模块说明

### 模块概述

钉钉模块负责 FFWorkspace 与钉钉之间的同步与运营支持能力，包括同步任务管理、员工信息同步、审批撤销修复、年假余额洞察与年假释放计划。  
当前代码仍位于 `organization` 模块目录下，但文档事实源自 2026-03-17 起独立收口到 `docs/modules/dingtalk/`。

### 代码与数据位置

- **前端**: `frontend/src/app/(modules)/organization/dingtalk/`
- **后端**: `backend/src/modules/organization/dingtalk/`
- **数据库**: `platform_automation.dingtalk_*`

### 主要接口

- `GET /organization/dingtalk/overview` - 获取同步总览
- `GET /organization/dingtalk/tasks` - 获取同步任务列表
- `POST /organization/dingtalk/approval-cancellations` - 审批撤销修复
- `GET /organization/dingtalk/annual-leave/quotas` - 年假余额总览
- `GET /organization/dingtalk/annual-leave/release-plan` - 年假释放计划