用途:当产品涉及资金、库存价值、薪酬、税务、客户与供应商余额、资产、捐赠、贷款、退款、钱包余额或财务报告,或需要让 SaaS 替代 QuickBooks、Xero、Sage 等外部记账工具时,使用本技能获取架构、表结构、过账规则、测试、文档或评审结论。仅做财务分析预测、或只展示导入报表而不产生业务事件与分录的场景不适用;涉及需持牌会计师专业判断的司法辖区,只设计系统支持,不宣称软件替代该判断。
主要能力:给出规范架构——业务模块发出事件,映射器将事件转为平衡的 JournalEntry 值对象,过账服务校验后原子写入,报表、子账、余额、税务表与看板均为总账的确定性投影。核心表包括 chart_of_accounts、account_mappings、journal_entries、journal_lines、accounting_periods、posting_rule_versions、accounting_integrity_runs、accounting_audit_log,除明确单租户外均须带 tenant_id。
硬性规则:业务模块不得直接写 gl_entries、journal_lines 等总账表,必须经单一服务 LedgerPostingService::post(JournalEntry $entry) 或项目等价服务;已过账分录不得更新、删除或软删除,更正须用关联原分录的红字冲销;不得存储无法由分录重建的权威余额,物化余额仅为缓存并需有重建命令;不得在业务逻辑硬编码科目代码,须在过账时解析科目映射;IFRS 租户不得用 LIFO;映射缺失、停用、跨租户或对源单据无效时须拒绝过账。
使用方式:按过账服务契约实现 JournalEntry、JournalLine 与 LedgerPostingService 接口,服务在插入前校验租户范围、科目状态、期间是否开启、借贷相等、币种策略、幂等键、源单据状态与映射完整性。自第一天起按租户与会计期间运行完整性检查:分录借贷相等、试算平衡、AR/AP 控制科目与客户/供应商标记分录一致、库存控制科目与成本层一致、固定资产控制科目与资产登记一致、薪酬负债与未付扣款一致、锁定期间无未授权分录、总账表无绕过服务的写入、物化余额重建结果与缓存一致。
适用场景与限制:适合多租户 SaaS 与行业系统(学校、诊所、NGO、市场平台等)。非会计用户执行 Record Sale、Receive Payment、Buy Stock、Run Payroll 等业务动作,系统后台过账;会计角色使用日记账、科目表、映射、期间关闭、手工分录与报表导出。配套技能包括 chart-of-accounts-templates、inventory-costing、payroll-postings-uganda、fixed-assets-and-depreciation、multicurrency-and-fx 等。具体价格、平台与效果资料暂未提供。