# ldesign-approval

**Repository Path**: ldesign-v1/ldesign-approval

## Basic Information

- **Project Name**: ldesign-approval
- **Description**: ?????UI?? - ??????????????
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# @ldesign/approval

审批运行时 UI 组件库，提供审批流程中的意见填写、历史记录、节点状态等交互组件。

## ✨ 特性

- 💬 **审批意见面板** - 结构化审批意见填写（同意/驳回/转办/加签/委托），支持富文本
- 📜 **审批历史时间线** - 完整审批流转记录，按时间线展示每个节点的处理情况
- 🔵 **流程状态图** - 审批节点状态可视化（待处理/已通过/已驳回/进行中）
- 👥 **会签面板** - 多人会签/或签场景的投票进度展示与操作
- 🔀 **转办/委托** - 转办选人器、委托设置面板
- ➕ **加签组件** - 前加签/后加签/并行加签操作面板
- ⏱️ **催办功能** - 催办按钮与催办记录展示
- 📊 **审批统计** - 平均审批时长、各节点耗时统计、超时预警
- 📋 **审批单据** - 通用审批表单渲染（标题/摘要/正文/附件/关联单据）
- 🔔 **消息提醒** - 审批待办/已办/抄送分类面板
- ✍️ **手写签批** - 与 @ldesign/signature 集成，支持手写批注
- 🖋️ **批注标记** - 文档内联批注（针对公文/合同具体段落标注意见）
- 📱 **移动端适配** - 移动端审批卡片、滑动操作
- 🌓 **主题切换** - 亮色/暗色主题

---

## 📦 安装

```bash
pnpm add @ldesign/approval
```

## 🚀 快速开始

```typescript
import { ApprovalPanel, ApprovalTimeline } from '@ldesign/approval';

const panel = new ApprovalPanel({
  container: '#approval-container',
  actions: ['approve', 'reject', 'transfer', 'countersign'],
  currentNode: {
    id: 'node-3',
    name: '部门经理审批',
    assignee: '张三',
  },
});
```

---

## 📁 项目结构

```
approval/
├── packages/
│   ├── core/          # 核心库 @ldesign/approval
│   │   └── src/
│   │       ├── core/       # 审批引擎
│   │       ├── components/ # UI 组件（意见面板/时间线/状态图）
│   │       ├── actions/    # 审批动作（同意/驳回/转办/加签）
│   │       ├── utils/      # 工具函数
│   │       └── types/      # TypeScript 类型
│   └── vue/           # Vue 组件 @ldesign/approval-vue
├── playground/        # 演示应用
└── README.md
```

## 📄 License

MIT