财务经理

今天要做什么

财务经理是管理层，不做凭证录入、不跑网银付款：每天两次过审批队列（报销单、付款申请），每周复盘预算差异，每月月结后出三大报表并正式关账。凭证录入 / 过账 / 月结执行都归会计（accountant），网银打款归出纳（cashier）。

每日

1. 上午 9:30 过一遍报销审批队列：处理昨晚到队的「待财务审批」单（status='pending_finance'），逐单看金额 / 附件 / 事由，放行或驳回。
2. 下午 17:00 再扫一遍队列，防止单据压过夜影响员工报销时效。
3. 扫付款进度看板：看「已批待付」/「处理中」金额，提醒出纳排期；经理只看不点付款。
4. 现金流量表（CF）仪表盘粗扫：「经营活动净额」异常立刻找会计核查。

每周

• 周一翻预算执行：进预算详情页看「预算 vs 实际」差异表，标红的超支科目（预算字段 isOverBudget=true）联系部门经理问原因。
• 周四批量审批日：对小额 < ¥5000 的单子批量放行，减少逐单切换。
• 周五扫自定义报表，出周报给老板。

每月

• 月初 1–3 日：等会计发出「月结完成」信号后，先做试算平衡核平，再出利润表 / 资产负债表 / 现金流量表（IS / BS / CF）三表交老板。
• 月初 5–10 日：上月会计期间正式「关账」（会计期间状态从「开启 open」→「已关账 closed」）；关账前必须确认会计已把所有草稿凭证过完账。
• 月末 25–30 日：启动下月 / 下季 / 下年预算——审批起草人提交的 budget、复核 12 列月度表后放行。

权限红线（先看这 5 条）

• 不能直接执行付款——网银 / 银企互联归出纳。经理的动作止于「审批通过」（状态变「已审批 approved」），后续「标为已付 paid」由出纳点。
• 不能关有未过账凭证的期间——「草稿态」/「待过账」凭证不进利润表 / 资产负债表，硬关会让报表失真；关账前先让会计批量过账。
• 不能在 UI 绕过审批直接改数据库状态——审批链一断，合规性丢失且无留痕，审计出问题无法追溯。
• 审批阈值 5000 / 50000 / 200000 当前版本写死在代码里——超 5 万走总监、超 20 万走总经理，经理一个人无法最终拍板；后台改不了，要改需发版（代码里标注了 TODO: Move to organization_settings）。阈值按基础币种（人民币）比较，外币报销需先按当日汇率折算。
• 不能开采购单 / 录凭证 / 过账 / 批量付款——采购 / 会计 / 出纳的事，经理是只读或不可见；需要协作时找对应角色。

Quickstart — 日常核心任务

2.1 审批报销（单笔）

员工已提交报销单且金额介于 ¥5000–50000 之间，状态为「待财务审批 pending_finance」，队列里出现该单。

1. 点左侧导航「费用 → 审批队列」进入 /dashboard/expenses/approvals。（见图 ①）
2. 逐行看列表字段：金额、币种、申请人、部门、事由、附件数。附件数为 0 直接驳回。
3. 要看细节点单号进详情：看费用项明细、审批历史时间线、是否已过部门经理节点（状态 pending_manager 已走完）。
4. 放行：回队列点该行「通过」按钮（绿色对勾）。（见图 ① 圈 ①）
5. 驳回：点红色叉按钮，弹窗里填「驳回原因」——必填，留给员工改单参考。（见图 ②）
6. 放行后若金额 > ¥50000：状态推进到「待总监审批 pending_director」而非「已审批 approved」——经理这里到此为止，总监接力。

何时不该做：单据来源是「企微来源」（source='wecom'）时队列里根本不会出现——企微提交的报销走企微内审批，经理在 DaoSales 看不到，需要打开企微审批后台处理；误以为"没单积压"会让员工报销被压一周以上。金额超 ¥50000 放行时不要以为"一通了之"——界面上看似成功但实际会推总监节点，总监不在场会卡住；超额的先线下和申请人对工作量，再决定放行时机。

观测信号：

1. 列表行从队列消失，转到「已处理」Tab。
2. 单据详情「审批历史」时间线新增一行（操作人 = 你，动作 = 「通过 approved」或「驳回 rejected」）。
3. 申请人企微收到「审批通过 / 驳回」卡片；驳回卡片含你填的原因。

技术追溯：expense_claims.status 变 approved（≤¥50000）或 pending_director（>¥50000）；approved_by_finance / approved_by_finance_at 回填；expense_approvals 新增 approver_role='finance' 行。

系统动作：approveClaimAction、rejectClaimAction、getPendingApprovalsForUser（查队列）

2.2 批量审批（小额单子）

队列里积压 20+ 笔小额 < ¥5000 的出差 / 样品快递报销；逐单点效率太低，一次性放行。

1. 进 /dashboard/expenses/approvals，用金额筛选器过滤 < ¥5000。（见图 ①）
2. 勾选表头全选，或按 Shift 多选相邻行。
3. 顶部动作条点「批量通过」或「批量驳回」；批量驳回会弹窗让填统一原因。
4. 等提示 toast：「已处理 N 笔」；失败的单子会在错误列表提示单号和原因——单独再处理。

何时不该做：别对金额分布不均的队列批量放行——把 > ¥50000 的混进去会都被推「待总监审批 pending_director」，总监一次性收到一堆会退回重来。月底 25 号之后别批量处理——临近月结的票据要逐单核对日期，避免跨期（会影响当月利润表）。

观测信号：

1. 队列一次性少掉 N 行，「已处理」Tab 增 N 行。
2. 付款看板「已批待付」金额合计上升 ΣN。

技术追溯：批量事务 batchApproveClaimsAction(claimIds[]) 返回 { success, errors[] }；每笔独立走 expense_claims.status 状态转换。

系统动作：batchApproveClaimsAction、batchRejectClaimsAction

2.3 查预算执行（预算 vs 实际）

月中 / 月末想知道哪个部门 / 哪个科目超支，哪个科目还有闲置额度可重分配。

1. 进 /dashboard/accounting/budgets 看预算列表，按状态筛「已审批 approved」的当期预算。（见图 ①）
2. 右上角「新建预算」按钮走创建流程：填名称、预算类型（年 / 季 / 月 / 项目）、财年、币种，保存后在 12 列月度表里录数字。（见图 ②）
3. 点某行「查看」进详情页——上半部 12 列月度录入表，下半部「预算 vs 实际」差异表。
4. 看差异表：每行一个「科目 + 成本中心」组合。重点看「差异 variance」列（负数 = 超支）和红色「超支 isOverBudget」标记。
5. 超支科目点展开看明细：按已过账凭证（会计已走 postJournalEntry）按月聚合。
6. 超支严重的科目联系部门经理了解原因；若预算整体失效（行情剧变），让起草人撤回或驳回后走新版。

已知 gap：预算明细表（budget_items）的数据库迁移（迁移文件 20251223_budgets.sql / 20260226_budget_items_private.sql）在当前 SaaS 或私有环境可能尚未应用——打开详情页会看到 404 或查询报错；遇到此情况先联系 IT 应用迁移（部署备忘录有说明），不要自己改前端降级。另外，「实际 actual」数据只统计已过账凭证，草稿 / 待过账凭证看不到，月中看会显著偏小——问会计「还有多少凭证未过账」后再下结论。

观测信号：

1. 差异表每行显示「预算金额 budgetAmount」/「实际金额 actualAmount」/「差异 variance」/「差异率 variancePercent」。
2. 实际 > 预算的行整行染红。
3. 底部合计 = Σ各行 variance。

技术追溯：getBudgetVsActualData(budgetId) 返回 { rows[], totals }；每行按 account_id + cost_center_id 聚合 journal_entries + journal_entry_lines。

系统动作：getBudgetsData、getBudgetDetailData、getBudgetVsActualData

2.4 审批 / 驳回预算

部门预算员起草完下年度 / 下季度预算并点「提交审批」，状态从「草稿 draft」变「待审批 pending_approval」，经理收到待审。

1. 进 /dashboard/accounting/budgets，按状态筛「待审批」。
2. 点「查看」进详情，复核 12 列月度表：科目 / 成本中心 / 每月金额是否合理。（见图 ①）
3. 和历史期间「实际」对比（用 2.3 差异表反推）——偏差超 ±20% 要求起草人说明。
4. 合理：点顶部「通过」按钮（状态变「已审批 approved」）。
5. 不合理：点「驳回」，状态变「已驳回 rejected」，起草人需新建 v2 版本（「已审批」的不可直接改）。

何时不该做：「已审批 approved」状态后系统会拒绝修改（返回错误 CANNOT_MODIFY_APPROVED）——审批前务必核对，审批后只能走驳回 + 新建版本，不能直接改金额。同一「年度预算」+ 同一财年通常只保留一份生效——重复放行会让差异表口径混乱。

观测信号：

1. 预算列表行状态徽标从「待审批」变「已审批」（绿徽标）。
2. 详情页顶部动作条按钮消失（「已审批」状态不再显示通过 / 驳回按钮）。
3. 其他角色建凭证时系统可按该预算查余额（checkBudgetAvailability）。

技术追溯：budgets.status 变 approved 或 rejected；budgets.approved_by / approved_at 回填；乐观锁 version+1。

系统动作：approveBudgetAction、rejectBudgetAction、submitForApprovalAction（起草人用）

2.5 出三大报表（资产负债表 / 利润表 / 现金流量表）+ 试算平衡

月初 1–3 日会计完成月结后立刻出一套报表交老板；老板要求看昨日 / 本周瞬态数据时随时可出。

1. 进 /dashboard/reports，看顶部 4 个 Tab：试算平衡 / 利润表（IS）/ 资产负债表（BS）/ 现金流量表（CF）。（见图 ①）
2. 先试算平衡：切「试算平衡」Tab，选截止日 asOfDate（默认今天），点「生成」——Σ借方必须 = Σ贷方，差额非零说明分录不平衡，把差额截图发给会计排查（经理不手动改分录）。（见图 ②）
3. 利润表：切「利润表」Tab，选期间起止（当月 1 号 → 今天），点「生成」——看营收、成本、毛利、净利润。（见图 ③）
4. 资产负债表：切「资产负债表」Tab，选截止日，点「生成」——三段式（资产 / 负债 / 所有者权益），「资产合计」= 「负债 + 权益合计」。（见图 ④）
5. 现金流量表：切「现金流量表」Tab，选期间起止，点「生成」——三段（经营 / 投资 / 筹资）净流。（见图 ⑤）
6. 四张表相互勾稽：利润表的净利润 → 资产负债表的未分配利润变动；现金流量表的期末现金 → 资产负债表的货币资金。
7. 右上角「导出 PDF / Excel」给老板。

何时不该做：当前版本三大报表只按「租户 organizationId」取数、不接收「账套 bookId」参数——多账套场景下需和会计先确认口径（否则跨账套金额会被一起算进去）。关账日期晚于截止日时利润表 / 现金流量表数据可能不稳（当期正在结账）——尽量在会计确认「月结完成」后再出报表。

观测信号：

1. 报表表头显示所选期间 + 基础币种（来自账套配置 accounting_books.base_currency）。
2. 试算平衡底部 Σ 差额 = 0；有差额会高亮红色。
3. 利润表底部「净利润」= 营收 − 成本 − 费用；资产负债表「资产合计」= 「负债 + 所有者权益合计」。

技术追溯：fetchTrialBalance({ asOfDate, includeZeroBalances })、fetchIncomeStatement({ periodStart, periodEnd })、fetchBalanceSheet({ asOfDate })、fetchCashFlowStatement({ periodStart, periodEnd })；数据源限定 journal_entries.status='posted'。

系统动作：fetchTrialBalance、fetchIncomeStatement、fetchBalanceSheet、fetchCashFlowStatement

2.6 关会计期间 / 重开期间

上月 1–3 日会计执行完月结结转后，经理正式把该期间置「已关账 closed」，锁定历史数据不让再改。

1. 进 /dashboard/accounting/fiscal-periods，找到要关的年度卡片展开 12 个期间。（见图 ①）
2. 确认待关期间状态是「开启 open」，且未来期（序号更大）没有「开启」期——系统规则要求按顺序关账。
3. 点该期行尾「关期」按钮——系统按乐观锁校验后把期间置「已关账 closed」。（见图 ②）
4. toast 提示「已关闭」；徽标变灰色「已关账」。
5. 发现错关要重开：同一行点「重开」按钮（仅「已关账」期显示），让会计补录凭证；重开后必须再关一次。
6. 并发冲突提示「CONFLICT 数据已被其他用户修改」：刷新页面重试，不要多 tab 切换。

何时不该做：期间内仍有「草稿 / 待过账」凭证时不要关——关账后该期日期的新凭证会被拒绝写入（系统调用 isDateInOpenPeriod 校验），会计再补时会被拦；关账前让会计先把所有凭证过账完（经理不代劳过账）。跨年度关账要先确认新年度已生成（createFiscalYearAction）——否则新年度没有「开启」期间会阻塞业务。

观测信号：

1. 期间行徽标从「开启 open」变「已关账 closed」灰色。
2. 统计卡片「已关账期间数」+1、「开启中期间数」−1。
3. 该期日期范围内不再允许新建凭证——会计过账会报「Period is closed」。

技术追溯：accounting_periods.status='closed'，closed_by / closed_at 回填；乐观锁 version+1。

系统动作：updatePeriodStatusAction、getClosingPreviewAction（预览结转数）

2.7 对比历史期间（利润表 / 现金流量表多期横向）

老板问「本月营收和上月 / 去年同期比如何」——生成两份不同期间的利润表对比。

1. 进 /dashboard/reports 切「利润表」Tab。
2. 先生成本月：期间起 2026-04-01 止 2026-04-30，点「生成」并导出 PDF。
3. 再生成上月：改为 2026-03-01 到 2026-03-31，导出 PDF。
4. 去年同期：改为 2025-04-01 到 2025-04-30，导出。
5. 用 Excel / 自定义报表把三份横向拼表交老板。
6. 现金流量表同理，三段净流横向比。

何时不该做：期间跨了「未关账」+ 「已关账」时数据会部分已过账、部分漏——尽量对齐到已关账区间比较，避免把未结转数据错认为对比基础。

观测信号：

1. 切换期间参数后点「生成」，表头期间显示更新。
2. 数字行随期间变动，「净利润」行数值不同。

技术追溯：重复调 fetchIncomeStatement({ periodStart, periodEnd })；每次独立查询，无缓存叠加。

系统动作：fetchIncomeStatement、fetchCashFlowStatement

2.8 自定义报表与导出（审计清单 / 月度看板）

审计人员要一份「本月所有 > ¥10000 报销明细」；老板要按部门看费用分布——标准三表不够用时走自定义报表。

1. 进 /dashboard/reports/custom 看已有报表列表；想复用别人的报表看「公开」标记（isPublic=true）的公开模板。（见图 ①）
2. 点「新建报表」弹窗：填名称、选类型（销售 / 库存 / 客户 / 财务）、公开与否。
3. 提交后进报表详情页——拖拽实体 / 列 / 筛选 / 分组 / 聚合 / 排序。（见图 ②）
4. 筛选条件写法参考已有公开模板的 config——常用 { 字段, 运算符, 值 } 三元组。
5. 点「生成」预览；满意点「导出 Excel」。
6. 导出审计清单示例：报表类型「财务」、实体「报销单 expense_claims」、筛选「金额 > 10000」、列选「申请人 / 金额 / 日期 / 审批人」。

何时不该做：删除报表不可撤销——常用模板打「公开」标记让队友能复用；别随意删他人报表。聚合 / 筛选写错不会实时报错（前端宽松校验），等「生成」时才 500——每改一次先小范围试跑。

观测信号：

1. 报表列表出现新行，名称 + 类型 + 创建人。
2. 详情页「预览」按钮点后表格刷新数据。
3. 导出 Excel 后浏览器下载区出现 .xlsx 文件。

技术追溯：reports.id、reports.config JSON；生命周期 createReport → updateReport → deleteReport。

系统动作：createReport、updateReport、deleteReport

上下游交接契约

经理处于「审批 + 复核」节点——上游出纳 / 员工 / 会计把动作推上来，下游老板 / 会计按结论继续。字段缺失会卡住整条链路。

异常回滚

审批 / 关账类动作误操作不要直接改数据库。按下表选对应入口按业务规则回滚。

进阶功能

新建下一年度（会计年度 Fiscal Year） ▸

年末必须提前建下年度：按账套「财年起始月」生成 12 个会计期间。非历年财年（如 4 月 1 日 – 次年 3 月 31 日）靠「起始月」参数控制。

入口：/dashboard/accounting/fiscal-periods 右上「创建年度」按钮；系统动作 createFiscalYearAction(year, startMonth?)。

月结结转预览（关账前先试跑） ▸

关账前会计先跑「结转预览」看本期「总收入 / 总费用 / 净利润」；经理也能看预览对比自己的利润表，差额异常时提前发现。在结账对话框里展开。

系统动作：getClosingPreviewAction、executeClosingAction。

费用科目维护（启停开关） ▸

老科目 / 停用科目：/dashboard/expenses/categories 用开关启停「有效」标记——停用后员工报销下拉不再出现，但历史单据不变。不要直接删，会影响历史报表。

系统动作：toggleCategoryStatusAction、createExpenseCategoryAction、updateExpenseCategoryAction、deleteExpenseCategoryAction。

费用分类分析 / 月度趋势 ▸

/dashboard/expenses/reports 按费用科目聚合本月 / 历史费用，带月度趋势折线。每周看一次趋势异常（某科目突增 50%）。

入口：/dashboard/expenses/reports；服务层 expense-claims 聚合查询。

付款进度监控（只读） ▸

/dashboard/expenses/payments 看四个数字：「已批待付 / 已付 / 处理中 / 总批准」。经理只看不执行——出纳点「标为已付」完成闭环；若看板长期「已批待付」偏高，催出纳。

系统动作：getPaymentPageData（读）；markClaimAsPaidAction / batchMarkClaimsAsPaidAction（出纳写）。

相关业务场景

1. 标准成单流（询盘 → 报价 → 订单 → 发货 → 开票）： 财务经理不参与销售侧执行；仅在利润表 / 现金流量表里看营收数据、AR 账龄由会计维护经理复核。 → 场景（了解即可）
2. 定制家具项目流： 财务经理在「项目预算」审批时参与，核算项目成本对比预算；日常生产 / 交付不参与。 → 场景详解
3. 回款流： 财务经理监控应收账龄（由会计在 /dashboard/accounting/ar-aging 产出），异常时找出纳追款；不直接录收款。 → 场景详解
4. 采购付款流： 财务经理审批大额「付款申请 payment_requests」 / 供应商付款（触动预算时走审批）；出纳执行付款，会计入账。 → 场景详解
5. 月结流： 财务经理的核心场景——会计月结后经理做试算平衡、出三表、正式关账；发现错走「冲销月结」。 → 场景详解
6. 报销审批流： 财务经理是 finance 节点——> ¥5000 经部门经理后到经理，> ¥50000 经理过后推总监；批量放行 / 驳回是日常主要工作量。 → 场景详解

外部协作入口

• /dashboard/wecom — 企微推送 / 企微报销映射规则；企微来源报销走企微内审批，经理在 DaoSales 看不到（已知 gap）。
• /dashboard/accounting/ar-aging — 应收账龄看板（会计产出、经理复核）。
• /dashboard/accounting/ap-aging — 应付账龄看板。
• /dashboard/accounting/cash-flow-forecast — 未来 30 / 60 / 90 天现金流预测（滚动预测基础）。
• /dashboard/accounting/profit-analysis — 盈利分析（会计做，经理验收）。
• /dashboard/reports/custom — 自定义报表生态（公开模板共享）。
• /dashboard/settings/email — 邮件网关（报表 PDF 导出后发老板用）。

权限与范围

看得到什么（RLS 边界）

• 当前「租户 organization_id」下的所有报销单（expense_claims）/ 付款申请（payment_requests）/ 预算（budgets）/ 预算明细（budget_items）/ 会计期间（fiscal_periods / accounting_periods）/ 期末结转（period_closings）/ 自定义报表（reports）。
• 三大报表（资产负债表 / 利润表 / 现金流量表）按「租户」查询——当前版本未接受「账套 bookId」参数，多账套场景需要和会计确认聚合口径。
• 报销队列只显示「手工来源」（source='manual'）——企微来源（source='wecom'）的报销走企微内审批，队列里看不到（已知 gap，培训要记住两套并行）。
• 预算执行（budget_items）：迁移未应用时查询会报错——先和 IT 确认迁移文件 20251223_budgets.sql / 20260226_budget_items_private.sql 已执行。

核心概念

• organization_id — 租户隔离键，所有财务表都带；RLS 按该键过滤。
• book_id — 账套隔离键（会计 / 出纳的主键）；经理的报表层当前不接该键，多账套需线下对齐。
• 乐观锁 version — 期间 / 预算并发写入的保护机制；UI 保持最新 version，冲突返「CONFLICT 数据已被其他用户修改」，刷新后重试。
• 工作流引擎（src/services/workflow-engine.ts）——报销、预算、期间等状态机由该引擎驱动；经理的审批动作都是其 transition 的一种。
• 审批阈值 5000 / 50000 / 200000——硬编码在 src/services/expense-approvals.ts:125-131，文件头注释 TODO: Move to organization_settings；当前版本后台改不了，要靠发版。
• 财务经理 vs 会计 职责边界：会计（accountant）是执行层——录凭证、过账、月结结转、账龄维护、银行对账；财务经理是管理层——审批（报销 / 预算 / 大额付款）、复核（试算平衡 + 三大报表）、关账、异常回滚。经理不录凭证、不过账、不跑月结执行，遇到这些动作找会计。

术语表

报销单 expense_claims

expense_claims { claim_number, total_amount, currency, status, source }

付款申请 payment_requests

payment_requests（供应商付款 / 大额资金动用，需审批）

会计期间 fiscal_periods

accounting_periods { period_number, period_name, start_date, end_date, status: open | closed, version }

会计年度 fiscal_year

fiscal_years + accounting_books.fiscal_year_start_month（支持非历年财年）

期末结转 period_closing

period_closings { closing_type: monthly | yearly, status: completed | reversed, net_profit }

资产负债表 BS

Balance Sheet — fetchBalanceSheet({ asOfDate })（瞬态，看某一天）

利润表 IS

Income Statement — fetchIncomeStatement({ periodStart, periodEnd })（区间）

现金流量表 CF

Cash Flow — fetchCashFlowStatement({ periodStart, periodEnd })（经营 / 投资 / 筹资三段）

试算平衡 Trial Balance

fetchTrialBalance({ asOfDate, includeZeroBalances })（Σ借方 = Σ贷方）

预算 budgets

budgets.id、budget_type ∈ annual | quarterly | monthly | project

预算明细 budget_items

budget_items.janAmount … decAmount（12 列月度）——迁移未应用时不存在

预算差异 variance

variance = budgetAmount - actualAmount；isOverBudget: actualAmount > budgetAmount

滚动预测 rolling forecast

/dashboard/accounting/cash-flow-forecast（基于应收 / 应付预计日期）

报销阈值 approval_threshold

> ¥5000 → 「待财务审批 pending_finance」；> ¥50000 → 「待总监审批 pending_director」；> ¥200000 → 「待总经理审批 pending_ceo」（硬编码）

报销状态链

draft → pending_manager → pending_finance → pending_director → pending_ceo → approved → processing → paid + rejected | cancelled

报销状态中文

草稿 / 待部门经理审批 / 待财务审批 / 待总监审批 / 待总经理审批 / 已审批 / 处理中 / 已付 + 已驳回 / 已作废

报销来源 source

source='manual'（手工来源，DaoSales 队列可见） / source='wecom'（企微来源，企微内审，队列不可见）

期间状态

open（开启） / closed（已关账） / locked（已锁定）

审批阶段 approval_step

expense_approvals.approver_role ∈ manager | finance | director | ceo | cashier、approval_step 1..4

审批动作 action

approveClaimAction（通过） / rejectClaimAction（驳回） / executeExpenseClaimTransitionAction（退回修改）

乐观锁 version

accounting_periods.version / budgets.version（并发防护）

关账 close period

updatePeriodStatusAction(periodId, 'closed', version)

冲销月结 reverse closing

reverseClosingAction(closingId, reason) → 凭证号「原号-R」反向凭证

自定义报表 reports

reports { id, reportType, config: JSON, isPublic }；reportType ∈ sales | inventory | customers | financial

常见问题