freelance-toolkit-fr

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参数避免敏感信息意外暴露。