# ldesign-expense

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

## Basic Information

- **Project Name**: ldesign-expense
- **Description**: ??/????? - ?????????
- **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/expense

费用/报销单组件，支持报销单据可视化、票据管理、OCR识别和预算对比。

## ✨ 特性

- 📋 **报销单模板** - 差旅/办公/招待/培训等分类报销单模板
- 🧾 **费用明细表** - 结构化费用明细填写（日期/类型/金额/说明）
- 📸 **票据管理** - 票据拍照/上传，支持多张票据关联
- 🔍 **OCR 识别** - 与 @ldesign/ocr 集成，自动识别票据金额、日期、商户
- 💰 **金额汇总** - 各类费用自动汇总，大写金额自动转换
- 💱 **多币种** - 多币种填报，自动汇率换算
- 📊 **预算对比** - 费用与部门/项目预算对比，超预算预警
- ✅ **合规校验** - 报销标准校验（单笔上限/日均标准/累计额度）
- 📎 **关联审批** - 关联出差申请/采购申请等前置审批单
- 📈 **费用分析** - 个人/部门费用趋势分析图表
- 📤 **导出功能** - 导出报销明细 Excel 报表
- 📱 **移动端填报** - 移动端拍票据快速填报
- 🌓 **主题切换** - 亮色/暗色主题

---

## 📦 安装

```bash
pnpm add @ldesign/expense
```

## 🚀 快速开始

```typescript
import { ExpenseForm, ReceiptScanner } from '@ldesign/expense';

const form = new ExpenseForm({
  container: '#expense-form',
  type: 'travel',  // 'travel' | 'office' | 'entertainment' | 'training'
  budget: { total: 10000, used: 3500 },
});
```

---

## 📁 项目结构

```
expense/
├── packages/
│   ├── core/          # 核心库 @ldesign/expense
│   │   └── src/
│   │       ├── core/       # 核心引擎
│   │       ├── templates/  # 报销单模板
│   │       ├── validators/ # 合规校验
│   │       ├── utils/      # 工具函数
│   │       └── types/      # TypeScript 类型
│   └── vue/           # Vue 组件 @ldesign/expense-vue
├── playground/        # 演示应用
└── README.md
```

## 📄 License

MIT