invoicetronic/desk

Invoicetronic Desk

开源、白标的意大利电子发票（FatturaPA/SDI）Web应用。可通过Docker自托管或使用云版本——几分钟内即可管理发票，无需编写代码。完全支持意大利语和英语本地化。

Desk是invoicetronic API的即用型前端。独立软件开发商（ISV）和开发人员可自托管该应用，应用自有品牌，为客户提供完整的发票管理界面——无需编写任何UI代码。

不想自托管？ 免费试用Desk Cloud——无需Docker、服务器或配置。注册即可立即开始开具发票。

https://raw.githubusercontent.com/invoicetronic/desk/main/assets/screenshot.png

快速开始

独立模式

单API密钥，无需登录——适用于内部网络和快速测试：

yaml
# docker-compose.yml
services:
  desk:
    image: invoicetronic/desk
    ports:
      - "8080:8080"
    environment:
      - Desk__api_key=YOUR_API_KEY

bash
docker compose up -d

打开http://localhost:8080——应用即可使用，无需注册。

多用户模式

每个用户注册并输入自己的API密钥——适用于SaaS和多租户部署：

yaml
# docker-compose.yml
services:
  desk:
    image: invoicetronic/desk
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data    # 持久化用户数据库

bash
docker compose up -d

打开http://localhost:8080，注册并在个人资料页面输入API密钥。

获取API密钥

在dashboard.invoicetronic.com注册以创建API密钥。Desk支持沙盒和生产密钥——环境由使用的密钥决定。测试时使用沙盒密钥，准备就绪后切换到生产密钥。

详见沙盒和API密钥文档。

功能特性

• 发送与接收发票——全文搜索、日期筛选、服务器端分页、XML下载
• 发票详情——元数据和完整的SDI状态时间线
• 上传——拖放多文件上传
• 导出——按月份/季度/日期范围筛选，以ZIP格式下载
• 公司管理——与API密钥关联的公司CRUD操作
• 仪表板——近期发票概览和计数器
• 白标——通过YAML配置或CSS覆盖自定义应用名称、徽标、颜色、页脚
• 两种认证模式——多用户（身份验证+登录）或独立模式（单API密钥，无需登录）
• 本地化——意大利语（默认）和英语

配置

所有配置可通过desk.yml（挂载为/app/desk.yml）或带有Desk__前缀的环境变量进行设置。

品牌定制

yaml
# desk.yml
desk:
  branding:
    app_name: 我的发票应用
    logo_url: https://example.com/logo.svg
    primary_color: "#1A237E"
    accent_color: "#E91E63"

或通过环境变量：

yaml
environment:
  - Desk__branding__app_name=我的发票应用
  - Desk__branding__primary_color=#1A237E

高级CSS主题

挂载自定义CSS文件以完全控制设计系统：

yaml
volumes:
  - ./my-theme.css:/app/wwwroot/custom/theme.css

密码重置（SMTP）

在多用户模式下，启用基于电子邮件的密码重置：

yaml
environment:
  - Desk__smtp__host=smtp.example.com
  - Desk__smtp__port=587
  - Desk__smtp__username=user@example.com
  - Desk__smtp__password=secret
  - Desk__smtp__sender_email=noreply@example.com

健康检查

GET /health → {"status":"healthy"}

支持平台

• linux/amd64 — Intel/AMD（大多数云服务器、带Docker Desktop的Windows）
• linux/arm64 — Apple Silicon、AWS Graviton、树莓派4+

镜像包含内置健康检查，可用于Docker Compose、Kubernetes或Swarm等编排工具。

Dashboard与Desk的区别

Invoicetronic有两个Web应用：

• Dashboard — 面向开发人员：管理API密钥、Webhook、日志、账单、测试/生产环境
• Desk — 面向最终用户、操作员和ISV：日常发送、接收、搜索、上传和导出发票

大多数用户需要同时使用两者：设置时使用Dashboard，日常使用Desk——最终可与自有集成结合使用。

链接

许可证

https://github.com/invoicetronic/desk/blob/main/LICENSE%E2%80%94%E2%80%94%E5%8F%AF%E8%87%AA%E7%94%B1%E4%BD%BF%E7%94%A8%E3%80%81%E4%BF%AE%E6%94%B9%E5%92%8C%E5%86%8D%E5%88%86%E5%8F%91%EF%BC%8C%E5%8C%85%E6%8B%AC%E7%94%A8%E4%BA%8E%E5%95%86%E4%B8%9A%E7%9B%AE%E7%9A%84%E3%80%82