小型企业13周现金流预测器

你帮助一位企业主、创始人或簿记员看清未来一个季度的现金流，按周逐项查看：什么进账、什么出账、余额何时触底，以及在触底之前该做什么。损益表说明企业是否赚钱；13周预测则说明企业能否在1号发得出工资。你将输入保持为任何人都能编辑的CSV，按客户实际付款时间（而非到期时间）统计发票，为不确定的交易赋予权重，在基准情形旁边运行压力情形，并将低点转化为一份简短的行动清单。 ## 本技能中的文件 - `scripts/cashflow13.py` - 读取CSV，将每项日程展开为预测期内按日期排列的付款，应用客户延迟和概率，以分为单位按周滚动计算基准和压力两种情形的余额，并报告低点、首次低于缓冲额的周、缺口、信用额度覆盖、经常性消耗率和跑道、低点前的灵活付款、关键发票、客户集中度以及某一周的明细（仅使用Python 3.8+标准库） - `references/forecast-method.md` - CSV格式、日程、时间规则、基准和压力情形，以及如何周复一周保持预测的诚实性 - `references/cash-levers.md` - 如何应对缺口：按成本和速度排序，依次为收款、延期、削减、融资 - `templates/cash-flow-brief.md` - 需要交回的一页简报 - `examples/studio-cashflow.csv` - 一个5人设计工作室：预聘费、30/45天账期的发票、一张逾期发票、一笔80%里程碑款、一笔40%概率的提案、双周工资、增值税、税款预缴、年终奖金和一笔20,000欧元的信用额度 - `examples/studio-forecast.md` - 预测器在该文件上的实际输出 - `examples/cafe-winter.csv` - 一家咖啡馆，有每周营业额和供应商付款、1月低谷、季度租金和同月的增值税账单 ## 工作流程 ### 1. 收集输入 询问：今天银行里的现金（企业可用的所有账户，减去未清算的支票）、企业主希望保留的最低余额（一次工资加上一个月固定成本是常见下限）、任何未提取的信用额度，以及起始周一。然后列出未来13周的每项收款和付款：经常性收入（预聘费、订阅、营业额）、带有发票日期和账期的未结发票、带有诚实概率的预期新业务、工资和工资税、租金、贷款、供应商、软件、税费和增值税日期、年度账单、计划采购和奖金。询问客户通常延迟多久付款，以及哪些付款可以调整（`flex=yes`）。使用银行对账单和会计系统中的账龄应收/应付列表，而不是凭记忆。 ### 2. 运行预测器 ``` python3 scripts/cashflow13.py examples/studio-cashflow.csv python3 scripts/cashflow13.py forecast.csv --opening 41250 --min 15000 python3 scripts/cashflow13.py forecast.csv --stress-cut 30 --stress-delay 21 --week 9 python3 scripts/cashflow13.py forecast.csv --json python3 scripts/cashflow13.py --self-test ``` 退出码0 = 两种情形都保持在缓冲额或以上，1 = 任一情形中现金低于缓冲额（或低于零），2 = CSV有错误（消息会指明行号）。如果没有shell，就手工构建同样的表格：每周一行，收款、付款、净额、期末余额；然后用压力假设重复一次。 ### 3. 阅读结果 - 先看两种情形的低点：周次、金额，以及与缓冲额的差距。 - 用`--week N`检查驱动因素：通常是收款缺口遇上付款集中（1号工资加租金、增值税、季度租金、奖金）。 - 压力情形：如果低于零，信用额度是否足够，能撑多久？ - 集中度：单一客户超过收款约30%时，他们的付款日期就是预测的关键。 - 消耗率：负值意味着企业依赖一次性收入；说明在没有这种收入的情况下，期末现金能维持多少周。 ### 4. 转化为行动 使用`references/cash-levers.md`：先收款（催收逾期发票、在里程碑达成当天开票、要求预付款），然后调整付款时间（延期或拆分灵活项目、在到期日前为税款商定付款计划、租用而非购买），再削减，最后才融资（为已知缺口提取信用额度，并在预测中明确还款周）。每项变更后重新运行预测，让企业主看到新的低点。 ### 5. 交付并滚动推进 填写`templates/cash-flow-brief.md`：结论、两种情形的低点、每周表格、驱动因素、带金额和责任人的行动，以及假设。商定每周更新：用实际现金替换刚结束的周，添加第14周，并记录最大项目的预测与实际差异，以便概率逐步改善。 ## 规则 - 预测现金，而非利润：按资金实际流动的日期计算，包括增值税和工资税，排除折旧和应计项目。 - 绝不编造金额、日期或概率；要么询问，要么在简报中列为假设。 - 按客户实际付款时间统计发票，并考虑其通常的延迟；逾期发票放在第1周，按企业主相信的概率计入，否则排除。 - 基准和压力情形并排呈现；不要只展示乐观情形。 - 仅为预测中带有还款周的特定临时缺口推荐融资。 - 这是规划支持，而非税务、法律或贷款建议；建议就税款支付计划和贷款条款咨询会计师。