accounting-workflows

希腊会计文件驱动工作流协调器，定义文档处理流水线、验证规则与日常模板。纯本地运行，无需外部 API，支持发票/收据/对账单校验与 EGLS 科目分类。

## 概述（中文）

希腊会计文件驱动工作流协调器，定义文档处理流水线、验证规则与日常模板。纯本地运行，无需外部 API，支持发票/收据/对账单校验与 EGLS 科目分类。

## 技能正文

# 会计工作流

希腊会计业务的文件驱动工作流协调器。本技能定义处理流水线、验证规则及日常模板，引导 OpenClaw 代理完成标准会计任务。

## 本技能做什么

本技能提供**工作流定义与验证规则**——指导代理如何处理本地文件系统中已有的文档。它**不会**：

- ❌ 执行 OCR（请使用 `greek-document-ocr`）
- ❌ 监控邮箱（请使用 `greek-email-processor`）
- ❌ 连接外部 API 或会计软件
- ❌ 向 AADE/EFKA 提交申报（请使用 `greek-compliance-aade` / `efka-api-integration`）
- ❌ 访问浏览器会话或截图
- ❌ 发送邮件或客户沟通（请使用 `client-communication-engine`）

它会：

- ✅ 定义文档验证规则（发票、收据、对账单字段）
- ✅ 提供工作流模板（日/月/季例行流程）
- ✅ 指定文件路由逻辑（incoming → processing → 客户目录）
- ✅ 设置置信度阈值，标记需人工审核项
- ✅ 定义希腊特定验证（AFM 格式、增值税率、EGLS 科目）

## 安装配置

```bash
# 1. 设置数据目录
export OPENCLAW_DATA_DIR="/data"

# 2. 确保已安装 jq（用于 JSON 处理）
which jq || sudo apt install jq

# 3. 创建目录结构
mkdir -p $OPENCLAW_DATA_DIR/{incoming/{invoices,receipts,statements,government},processing,clients}

# 4. 无需凭证 — 本技能完全本地运行
```

## 核心理念

- **准确优先**：每次提取均含置信度评分与验证
- **审计追踪**：所有自动化操作记录时间戳与来源
- **人工监督**：不确定项标记人工审核，而非猜测
- **文件驱动**：所有数据流经本地文件系统，无隐藏 API 调用
- **流程效率**：将手工录入从数小时缩短至数分钟

## 文档处理流水线

文档在 `OPENCLAW_DATA_DIR` 内经历三个阶段：

```
/data/incoming/           →  /data/processing/        →  /data/clients/{AFM}/
（原始文件放置于此）          （验证与提取）                （最终规范位置）
```

### 阶段 1：接收
1. **来源**：文件放入 `/data/incoming/invoices/`、`/data/incoming/receipts/` 或 `/data/incoming/statements/`
2. **格式识别**：PDF、图片（JPG/PNG）、CSV、Excel
3. **客户分配**：根据内容或文件名约定匹配客户 AFM

### 阶段 2：验证与提取
1. **字段提取**：从文档提取结构化数据（必要时由配套 OCR 技能完成）
2. **验证**：应用下方规则（金额一致性、日期逻辑、AFM 格式）
3. **置信度评分**：低于阈值项标记人工审核
4. **分类**：按文档类型与 EGLS 科目代码分类

### 阶段 3：归档
1. **客户目录**：将验证后的 JSON 写入 `/data/clients/{AFM}/documents/`
2. **合规更新**：更新 `/data/clients/{AFM}/compliance/` 中的申报记录
3. **审计日志**：将处理事件追加到审计追踪

## 文档验证规则

### 发票处理
```yaml
Required Fields:
  - vendor_name: Company issuing the invoice
  - vendor_afm: Supplier AFM (format: ^EL[0-9]{9}$)
  - invoice_number: Unique identifier from vendor
  - invoice_date: Date issued (YYYY-MM-DD)
  - due_date: Payment due date
  - net_amount: Amount before VAT (2 decimal places)
  - vat_amount: VAT charged
  - vat_rate: Must be one of [0.24, 0.13, 0.06, 0.0]
  - total_amount: Final amount due

Validation Rules:
  - total_amount = net_amount + vat_amount (tolerance: 0.01)
  - vat_amount = net_amount * vat_rate (tolerance: 0.01)
  - invoice_date <= due_date
  - vendor_afm matches ^EL[0-9]{9}$
  - Duplicate invoice_number from same vendor flags for review
```

### 收据处理
```yaml
Required Fields:
  - merchant_name: Business name
  - transaction_date: Date of purchase (YYYY-MM-DD)
  - total_amount: Total paid (2 decimal places)
  - payment_method: cash | card | transfer
  - category: EGLS account code

Validation Rules:
  - transaction_date <= current_date
  - total_amount > 0
  - category must be valid EGLS account code
```

### 银行对账单处理
```yaml
Required Fields:
  - bank: alpha | nbg | eurobank | piraeus
  - account_iban: Format ^GR[0-9]{25}$
  - statement_period: YYYY-MM
  - opening_balance: Starting balance
  - closing_balance: Ending balance
  - transactions: List of debits and credits

Validation Rules:
  - closing_balance = opening_balance + sum(all_transactions)
  - All transaction dates within statement period
  - IBAN format validated per ISO 13616
```

## 工作流模板

### 日常例行
```markdown
1. 检查 /data/incoming/ 中自昨日以来新增文档
2. 将每份文档通过处理流水线验证并路由
3. 将置信度 < 90% 的项标记到 /data/processing/flagged/ 待人工审核
4. 更新 /data/clients/{AFM}/compliance/filings.json 中已完成的处理
5. 生成每日摘要报告到 /data/reports/daily/
```

### 月末结账（月末后运行）
```bash
openclaw accounting monthly-close --period 2026-01 --client EL123456789

# 协调以下步骤：
# 1. 验证该期间所有 incoming 文档已处理
# 2. 检查银行对账状态（需 greek-banking-integration 技能）
# 3. 验证所有交易已按 EGLS 科目分类
# 4. 将未完成项标记为阻塞项
# 5. 生成财务报表就绪报告
```

### 季度审查
```markdown
1. 对三个月分别运行月末结账
2. 汇总季度增值税总额
3. 准备季度合规报告
4. 生成与上季度对比的方差分析
```

## CLI 命令

```bash
# 处理 incoming 文件夹中的新文档
openclaw accounting process-invoices --input-dir /data/incoming/invoices/ --greek-format

# 验证并分类收据
openclaw accounting extract-receipts --input-dir /data/incoming/receipts/ --auto-classify

# 对已处理数据运行验证检查
openclaw accounting validate-documents --vat-check --greek-standards

# 导出客户与期间的交易
openclaw accounting export-transactions --client EL123456789 --format csv --period 2026-02

# 批量处理所有待处理文档
openclaw accounting batch-process --type invoices --output-format json

# 检查处理状态
openclaw accounting status --show-queue --show-errors
```

## 文件系统布局

```yaml
OPENCLAW_DATA_DIR:
  incoming/                    # 用户或配套技能放置的原始文档
    invoices/
    receipts/
    statements/
    government/

  processing/                  # 临时工作区（流水线完成后清理）
    validated/
    classification/
    flagged/                   # 需人工审核的项

  clients/{AFM}/               # 最终规范位置（由 client-data-management 管理）
    documents/
    compliance/

  reports/                     # 生成的报告
    daily/
    monthly/
```

## 配套技能

本技能与以下配套技能配合效果最佳（需单独安装）：

| Skill | What it adds |
|-------|-------------|
| `greek-document-ocr` | 扫描发票与收据的 OCR（需 `tesseract`） |
| `greek-email-processor` | 邮箱监控与附件提取（需 IMAP 凭证） |
| `greek-banking-integration` | 希腊银行对账单 CSV 解析 |
| `greek-compliance-aade` | 增值税申报准备与 AADE 提交（需 AADE 凭证） |
| `efka-api-integration` | 社保缴费计算 |
| `client-data-management` | 客户记录管理与 GDPR 生命周期 |
| `openclaw-greek-accounting-meta` | 协调所有技能的编排器 |

## 错误处理

```bash
# 重试失败的处理
openclaw accounting retry-failed --batch-id {id}

# 审核已标记项
openclaw accounting manual-review --flagged-documents

# 检查系统健康
openclaw accounting health-check
```

## 安全准则

- 未经明确验证规则不得修改财务记录
- 归档前始终在 `/data/incoming/` 保留原始源文档
- 将所有自动化操作记录到统一审计追踪
- 低于置信度阈值的项必须标记——绝不猜测
- 严格隔离不同客户数据（按 AFM 分目录）

## 希腊监管合规

处理文档时应用希腊特定验证规则：

- **增值税率**：验证 24% 标准、13% 减免、6% 超减免
- **AFM 格式**：所有税号强制执行 `^EL[0-9]{9}$` 模式
- **EGLS 科目**：将交易映射到希腊会计科目表（ΕΛΣΥ）
- **印花税**：标记需计算印花税（χαρτόσημο）的合同与法律文件
- **电子账簿合规**：按希腊法律 4308/2014 维护数字会计记录
- **GDPR**：按欧盟隐私法及希腊 DPA 要求处理数据生命周期
- **地方税**：追踪房产税、垃圾收集费及地方当局要求

> 实际 AADE 提交、EFKA 申报及政府门户交互由配套技能（`greek-compliance-aade`、`efka-api-integration`）处理。

## 邮件与文档流水线（通过配套技能）

安装配套技能后，本技能协调多步骤工作流：

```
邮件到达（greek-email-processor）
  → 附件提取到 /data/incoming/
    → OCR 处理（greek-document-ocr）
      → 按本技能规则验证
        → 归档到 /data/clients/{AFM}/documents/
          → 更新合规（greek-compliance-aade）
```

工作流协调器不直接访问邮件或执行 OCR——它定义配套技能遵循的验证与路由规则。

## 会计软件导出（可选）

已处理数据可导出为与外部会计软件兼容的格式：

```bash
# 标准导出（始终可用）
openclaw accounting export-transactions --client EL123456789 --format csv --period 2026-02
openclaw accounting export-transactions --client EL123456789 --format json --period 2026-02

# 可选：会计软件格式（若已配置配套导出技能）
openclaw accounting export-transactions --client EL123456789 --target quickbooks --period 2026-02
openclaw accounting export-transactions --client EL123456789 --target xero --period 2026-02
```

> CSV 与 JSON 导出开箱即用。QuickBooks/Xero 格式需相应导出配置。

## 性能目标

- **文档处理**：从每份 5 分钟降至 30 秒
- **数据录入**：消除 80% 手工输入
- **月末结账**：通过自动化缩短 60% 时间
- **准确率**：标准商业文档 >95%，发票总额 >98%
- **截止合规**：通过自动提醒实现 100% 按时申报

## 维护计划

- **每周**：审核标记项、更新供应商列表、检查错误日志
- **每月**：性能分析、备份验证、系统更新
- **每季**：全面准确率审计、合规审查、用户培训
- **每年**：完整系统审查、升级规划、灾难恢复测试