freelance-toolkit-fr

💼 法国自由职业者全能财务管家

法国自由职业者本地财务管家,纯Python零依赖,自动生成合规HTML发票,本地加密存储财务数据,完全符合法国微企税法要求。

收藏
1.2k
安装
414
版本
v2.0.0
CLS 安全性认证2026-05-18
点击查看完整报告 >

使用说明

Freelance Toolkit 是专为法国自由职业者设计的本地化财务管理命令行工具集,通过五个核心Python脚本实现完整的业务管理闭环:config.py 用于配置个人信息与微企参数,clients.py 管理客户数据库,timetrack.py 提供精准的工时追踪,invoice.py 生成符合法国税法(含293B条款)的专业HTML发票,dashboard.py 则提供营收与工时的可视化汇总。

核心优势在于极致的隐私保护与合规性。工具仅依赖Python 3标准库,无需安装任何第三方包,所有数据(客户信息、工时记录、发票数据)均存储在本地~/.freelance/目录,完全杜绝网络传输风险。发票模板内置法国微企(micro-entreprise)法定声明,自动计算TVA(或可设置为零税率),并采用法文金额格式(如"2 900,00 €"),满足本地财务合规要求。

然而,该工具也存在明显局限。作为T3级个人开发者作品,缺乏企业级维护背书。数据以明文JSON形式存储,虽便于查看但缺乏加密保护,需要用户自行设置文件权限(chmod 700)防止未授权访问。此外,工具设计为纯本地单机使用,不支持多设备同步或团队协作,也无法生成官方电子签名(Facture-X),对于需要审计日志或复杂权限控制的企业场景不适用。

目标用户群体明确:在法国注册的独立工作者、微企经营者,特别是注重数据隐私、不需要复杂ERP系统的技术型自由职业者。开发者、咨询师、设计师等需要简单跟踪工时并生成专业发票的个体从业者将最能受益。

使用风险主要包括数据安全与备份。由于所有数据本地存储,硬盘损坏或误操作删除~/.freelance/目录将导致不可恢复的数据丢失,建议配合rsync或time machine定期备份。发票HTML文件通过webbrowser.open()自动唤起默认浏览器,虽然仅限于本地file://协议,但在公共电脑使用时建议添加--no-open参数避免敏感信息意外暴露。

安全解读

核心用法

Freelance Toolkit 是一套专为法国自由职业者/独立工作者设计的本地化 CLI 工具集,包含五个核心模块:

1. config.py — 配置 prestataire 信息(姓名、地址、SIRET、IBAN、默认费率等),支持 micro-entreprise 模式自动处理 TVA 豁免条款
2. clients.py — 客户数据库管理,支持增删改查,可绑定特定费率与备注

3. timetrack.py — 项目时间追踪,支持 start/stop 计时、状态查询、日志导出与月度报告

4. invoice.py — 生成专业 HTML 发票,自动预填客户信息,支持法语金额格式、艺术编号(YYYY-NNN)、法定 micro-entreprise 声明,可直接浏览器打开或禁用

5. dashboard.py — 收入仪表板,聚合发票与时间数据,计算 CA、有效时薪、工作日数、收付款状态

所有数据以 JSON 格式存储于 ~/.freelance/,零外部依赖,支持 --json 机器输出。

显著优点

  • 极致轻量:纯 Python 3 标准库,570 行代码,无 pip 安装烦恼
  • 数据主权:100% 本地存储,无云端、无订阅、无厂商锁定
  • 法规就绪:内置法国 micro-entreprise TVA 豁免(art. 293B CGI)、法定发票要素、30 天付款期限
  • 工作流闭环:从计时 → 开单 → 对账 → 统计,完整覆盖独立工作者日常
  • 透明可审计:MIT 许可开源,结构清晰易于自定义

潜在局限

  • 无多设备同步:纯本地架构意味着跨设备需手动同步 ~/.freelance/ 目录
  • 无协作功能:单用户设计,不支持团队权限管理
  • PDF 导出依赖浏览器:需手动打印为 PDF,无原生 PDF 生成
  • 法国中心化:发票模板、法规模块针对法国税法,国际化需 fork 改造
  • 无自动银行对账paid 标记需手动更新

适合人群

  • 法国 micro-entreprise/自由职业者寻求轻量替代方案(替代 Pennylane/Qonto 等 SaaS)
  • 技术背景用户偏好 CLI 工作流与数据本地控制
  • 需要快速原型或高度定制化发票流程的开发者
  • 对订阅成本敏感、业务规模适中的独立工作者

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据丢失 | 本地 JSON 无自动备份 | 定期备份 `~/.freelance/` 目录 |
| SIRET/IBAN 输入错误 | 无实时格式校验 | 人工复核后再生成发票 |
| 浏览器调用 | `webbrowser.open()` 打开本地 HTML | 使用 `--no-open` 禁用,或检查 file:// 协议 |
| 法规更新 | 法国税法变化可能滞后 | 关注 `references/french-law.md` 更新 |

安全认证摘要

CLS-Certify v2.1.0 全面扫描评定 Grade A / Score 92:静态分析 95 分(无危险函数)、动态行为 90 分(纯本地文件操作)、依赖审计 100 分(零第三方依赖)、网络分析 100 分(零外部请求)。符合 GDPR/CCPA,无遥测追踪,权限最小化设计。

freelance-toolkit-fr 内容

assets文件夹
references文件夹
scripts文件夹
手动下载zip · 16.2 kB
invoice.htmltext/plain
请选择文件