## 功能特性 - 创建和编辑发票 - 导出符合 XRechnung 3.0 标准的 XML 发票 - WYSIWYG PDF 设计器，支持自定义单页发票布局 - 支持 SVG Logo - 支持自定义字体（TTF/OTF） - 自定义及常用辅助线（信封窗口线、折叠标记、边框等） - 导出符合 ZUGFeRD 2.1 标准的 PDF 发票（内嵌 XML） - 发票复制或从模板创建 - Swagger API 文档（`/api-docs`） - 支持德语和英语界面 - 卖方/买方联系人模板管理 - 发票编号模板（自动递增） - 行项目模板和付款模板 首次进入应用后，可点击左下角设置，把语言选择为“English” ### 第一步：查看示例数据（首次使用） 首次启动后系统会自动填充示例发票数据，验证应用是否正常运行。 | 1 | 打开应用首页 | — | 显示发票列表页面，包含示例发票 | | 2 | 点击列表中的任意发票 | — | 打开发票详情编辑页面 | ### 第二步：创建卖方联系人 在创建发票前，需要先创建卖方（Seller）联系人信息。 | 1 | 点击侧栏「Parties」→「Sellers」 | — | 显示卖方列表 | | 2 | 点击「New Seller」按钮 | — | 打开卖方创建表单 | | 3 | 填写卖方信息 | 见下方测试数据 | 表单字段全部可填写 | | 4 | 点击「Save」保存 | — | 保存成功，列表显示新记录 | **卖方测试数据**： | 字段 | 测试值 | |------|--------| | Name | `测试公司 GmbH` | | Street | `Musterstraße 1` | | City | `Berlin` | | Postal Code | `10115` | | Country | `DE` | | VAT ID | `DE123456789` | | Contact Name | `Max Mustermann` | | Contact Phone | `+49 30 1234567` | | Contact Email | `max@test-company.de` | ### 第三步：创建买方联系人 | 1 | 点击侧栏「Parties」→「Buyers」 | — | 显示买方列表 | | 2 | 点击「New Buyer」按钮 | — | 打开买方创建表单 | | 3 | 填写买方信息 | Name: `Kunde AG`, Street: `Kundenweg 5`, City: `München`, Postal Code: `80331`, Email: `info@kunde.de` | 表单字段全部可填写 | | 4 | 点击「Save」保存 | — | 保存成功，列表显示新记录 | ### 第四步：创建发票 | 1 | 点击侧栏「Invoices」→「New Invoice」 | — | 打开发票创建页面 | | 2 | 填写发票头信息 | Invoice Number: `RE-2024-001`, Date: 今天日期, Buyer Reference: `PO-12345` | 头部信息可编辑 | | 3 | 选择卖方和买方 | 选择上面创建的联系人 | 联系人信息自动填充 | | 4 | 添加行项目 | Item: `测试服务`, Quantity: `10`, Net Price: `100.00`, VAT: `19%` | 金额自动计算 | | 5 | 点击「Save」保存 | — | 发票保存成功 | ### 第五步：导出 XRechnung XML | 1 | 打开刚创建的发票 | — | 显示发票详情 | | 2 | 点击「Export XML」按钮 | — | 下载 XRechnung 3.0 格式的 XML 文件 | | 3 | 用文本编辑器打开导出的 XML | — | 包含 UBL 2.1 格式的发票数据 | ### 第六步：设计 PDF 模板并导出 ZUGFeRD PDF | 1 | 点击侧栏「PDF Templates」 | — | 显示 PDF 模板列表 | | 2 | 点击「New Template」创建模板 | Name: `标准发票模板` | 打开 WYSIWYG PDF 编辑器 | | 3 | 在编辑器中拖拽添加文本块 | 添加公司名称、地址等文本块 | 所见即所得预览 | | 4 | 保存模板后回到发票页面 | — | 模板保存成功 | | 5 | 在发票详情点击「Export ZUGFeRD PDF」 | 选择刚创建的模板 | 下载嵌入 XML 的 ZUGFeRD 2.1 PDF |