SuperAPI AI 工具集

fondo-local-dev-loop

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:为 Fondo 创业税务与记账集成提供本地开发工作流,用 CSV 导出和模拟财务数据构建快速反馈循环,无需等待实时 Fondo 报告即可开发仪表盘、研发抵免计算器和烧钱率工具。

主要能力:支持模拟模式与真实导出解析切换;提供交易、损益、研发汇总等模拟接口;可解析 Fondo CSV 导出并校验字段映射。

使用方式:复制 .env.example 为 .env 并设置 FONDO_API_KEY、FONDO_EXPORT_DIR、MOCK_MODE;安装 express、csv-parse、dotenv、tsx、typescript、@types/node 及 vitest、supertest;创建 exports 目录。开发服务器监听 3002 端口,按 MOCK_MODE 挂载模拟路由或导出解析路由。测试命令包括 npm run dev:mock、npm run test、npm run test -- --watch、MOCK_MODE=false npm run test:integration。

适用场景:本地开发与测试财务相关工具,验证 CSV 列头(Date、Description、Amount、Category、Account、R&D Qualified)与解析逻辑。

限制:仅使用虚构夹具,本地目录需排除版本控制,默认不得访问生产财务数据;密钥来自批准的管理器;需脱敏日志、避免提交导出文件并按保留流程删除临时产物。输出验证回执不得包含交易、账户、薪资/税务数据或凭据。常见问题包括 CSV 解析错误、金额 NaN、缺少研发列、目录缺失和空数据集。