（3214期）Invoice – GitHub 原生发票自动化管家

GitHub 原生发票自动化管家 通过 GitHub 私有仓库管理发票与报价单的自动化工具，支持序列号生成、预览计算及 JSON 格式存储，适合德奥地区小微企业与自由职业者。 使用说明 核心功能 Invoice Manager 是一款面向德奥德语区市场的发票自动化工具，通过命令行交互将发票（RE）与报价单（AN）以结构化 JSON 格式存储于 GitHub 私有仓库。核心工作流包括：自动序列号生成（RE-6007 格式）、基于脚本的金额计算预览、以及用户确认后的安全上传。 显著优点 自动化编号与防冲突：通过 ./scripts/get-next-number.sh 自动确定下一个发票号，消除人工编号错误与重复风险 计算一致性保障：强制使用 ./scripts/calc-preview.sh 生成预览，确保 Telegram 显示金额与最终 PDF 渲染结果完全一致 GitHub 原生版本控制：所有发票以 JSON 文件形式存储，天然具备审计追踪、分支管理与灾难恢复能力 客户数据复用：支持通过 customerId 引用 Kunden/ 目录下的客户档案，减少重复录入 德奥税务合规内置：预设 Kleinunternehmerregelung（小规模企业免税条款）模板，符合奥地利 UStG 1994 要求 潜在局限 地域限制：界面与法律条款针对奥地利/德国市场设计，其他地区用户需自行调整模板 PDF 生成外置：JSON 仅为数据层，实际 PDF 渲染依赖外部的 invoice.sty（LaTeX），需额外配置构建环境 单仓库架构：所有数据集中于单一 GitHub 仓库，大规模企业可能需要分仓策略 实时协作限制：无并发编辑锁机制，多用户同时操作可能导致编号冲突（依赖脚本原子性） 适合人群 德奥地区自由职业者（Freiberufler）与小微企业主 已使用 GitHub 进行代码管理的开发者型用户 需要 7 年税务存档（GoBD 合规）的增值税免税企业 常规风险 凭证泄露风险：GITHUB_TOKEN 若使用经典 PAT 可能权限过宽；建议使用 fine-grained token 并限制 contents:write 单一权限 数据驻留问题：GitHub 服务器位于美国，虽提供私有仓库，但涉及 GDPR 第 44 条跨境传输合规考量 序列号跳跃风险：若 push-invoice.sh 执行失败但编号已占用，可能导致空号；需监控上传状态 客户数据误关联：customerId 引用错误会导致发票地址错配，建议在上传前通过预览二次确认 安全建议 强制启用分支保护规则，禁止直接推送至主分支 定期轮换 GitHub Token（建议 90 天周期） 对 INVOICE_REPO 启用 Dependabot 与 Secret scanning 防止敏感信息意外提交 原始说明 Creates and manages invoices as JSON files on GitHub with sequential numbering, preview, and upload.