迪诺学堂标识

14-财务业财中心详细PRD

FIN · 连接合同订单、收款监管、预收、课消收入、退费、发票、内置报销、票据 OCR、多账套记账报税、利润和凭证。

系统 迪诺学堂
版本 v1.0
日期 2026-06-23
阶段 模块详细 PRD

01 · 模块定位

财务业财中心

一笔合同收款可形成预收，课消后确认收入，最终生成凭证和校区利润数据。

业务目标

连接合同订单、收款监管、预收、课消收入、退费、发票、内置报销、票据 OCR、多账套记账报税、利润和凭证。

使用终端

PC Web 财务工作台，内置总账、内置报销、监管平台和国税发票核验接口。

验收主线

一笔合同收款可形成预收，课消后确认收入，最终生成凭证和校区利润数据。

02 · 范围边界

明确本模块负责什么、依赖什么、不负责什么

边界清晰后，原型、接口和数据库设计才能避免重复建设。

模块内范围

  • 收款台
  • 监管账户
  • 预收收入
  • 退费测算
  • 内置报销
  • 发票核验
  • 多账套
  • 税务申报
  • 凭证入账
  • 报销付款台账
  • 付款批次
  • 付款失败处理
  • 付款撤销
  • 采购付款凭证
  • 薪资凭证
  • 统一付款补偿
  • 国税调用日志
  • 库存成本凭证

上游依赖

  • 组织校区与账号权限
  • 课程/客户/合同等主数据
  • 审批流、消息模板、文件中心
  • 必要的第三方接口密钥

下游输出

  • 业务状态和待办
  • 消息通知和审批记录
  • 报表指标和数据快照
  • 审计日志和接口回执

03 · 确认口径、后台配置与默认实施规则

财务业财中心必须承接的已确认规则

本章节来自待决策与澄清清单的收口结果，已经转为本模块 PRD 的正式需求、配置项或默认实施规则。
分类事项本模块落地要求责任方
已确认口径国税官方发票核验接口确认具备官方发票核验接入能力；迪诺学堂按校区维护调用主体、纳税人识别号、官方接口编码/授权凭证、核验额度、接口地址、启用状态和审计留痕。产品/财务/技术
已确认口径金蝶云星空功能参考不对接外部金蝶云星空系统；第一批在迪诺学堂内复刻常用核心记账能力，覆盖校区独立账套、科目、辅助核算、凭证生成、过账、红冲、结账、总账查询、报表和报税资料生成。产品/财务/研发
已确认口径合思功能参考不对接外部合思平台；第一批在迪诺学堂内复刻企业报销必备能力，覆盖单据填写、费用明细、票据上传、OCR 识别、发票核验、查重防重报、审批、付款归档和凭证生成。产品/财务/人事/研发
后台配置项校区税务主体配置按校区配置 taxpayerName、taxpayerNo、officialAppCode、authCertificateId、verifyEndpoint、quotaPolicy、enabled、effectiveDate 和负责人。财务管理员/系统管理员
后台配置项内置财务账套配置按校区配置 accountSetCode、fiscalCalendar、subjectTemplate、auxAccountingRules、voucherWords、taxRules、closePeriodRules 和总部可见范围。总部财务/校区财务
后台配置项内置报销规则配置配置 expenseType、budgetRule、approvalFlowCode、ocrProvider、duplicateKey、invoiceRiskPolicy、paymentRule、voucherGenerateRule 和消息模板。财务/人事/系统管理员
默认实施规则接口设计说明书组织方式采用单独 HTML 文件集中管理接口协议；模块 PRD 保留模块级接口摘要，避免每个模块重复写通用协议。产品/研发
默认实施规则接口错误码与重试中间件所有外部接口和内部异步任务统一错误码、幂等键、重试次数、告警阈值和回执归档策略。后端/测试/运维

04 · 业务流程

财务业财中心主流程

流程用于指导原型图的页面顺序、按钮状态和异常分支。
01收款台

合同收款、缴费收款、欠费收款进入统一订单和应收

02监管账户

收款入资金监管账户并支持流水对账、合同备案、课消报送和退费报送

03预收收入

按课消确认收入并计算递延收入，联动账套、凭证和经营利润

04退费测算

退费测算联动未消课时、赠课、教材、手续费和收入冲减

05内置报销

参考合思常用报销能力，在迪诺学堂内实现单据填写、票据上传、OCR 识别、发票核验、查重防重报、审批和付款归档

06发票核验

发票 OCR 识别、真伪核验、抬头税号校验和历史报销查重联动

07多账套

每个校区独立账套，总部财务可跨账套管理科目、凭证、结账和汇总报表

08税务申报

支持增值税、附加税、企业所得税、个税相关申报资料归集、税额测算、申报表生成和归档

05 · 功能清单

按子模块拆到可设计、可开发、可测试的颗粒度

每一行功能都需要在原型中体现入口、状态、按钮、字段和反馈。
一级功能二级功能功能说明规则/验收
收款台基础维护收款台支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
收款台业务处理合同收款、缴费收款、欠费收款进入统一订单和应收必须联动状态、权限、消息、审批和指标
收款台异常闭环流水不匹配处理失败原因可见、可重试、可转人工、可追溯
监管账户基础维护监管账户支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
监管账户业务处理收款入资金监管账户并支持流水对账、合同备案、课消报送和退费报送必须联动状态、权限、消息、审批和指标
监管账户异常闭环监管回执失败处理失败原因可见、可重试、可转人工、可追溯
预收收入基础维护预收收入支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
预收收入业务处理按课消确认收入并计算递延收入，联动账套、凭证和经营利润必须联动状态、权限、消息、审批和指标
预收收入异常闭环课消数据缺失处理失败原因可见、可重试、可转人工、可追溯
退费测算基础维护退费测算支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
退费测算业务处理退费测算联动未消课时、赠课、教材、手续费和收入冲减必须联动状态、权限、消息、审批和指标
退费测算异常闭环退费金额异常处理失败原因可见、可重试、可转人工、可追溯
内置报销基础维护内置报销支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
内置报销业务处理参考合思常用报销能力，在迪诺学堂内实现单据填写、票据上传、OCR 识别、发票核验、查重防重报、审批和付款归档必须联动状态、权限、消息、审批和指标
内置报销异常闭环发票重复报销处理失败原因可见、可重试、可转人工、可追溯
发票核验基础维护发票核验支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
发票核验业务处理发票 OCR 识别、真伪核验、抬头税号校验和历史报销查重联动必须联动状态、权限、消息、审批和指标
发票核验异常闭环发票核验失败处理失败原因可见、可重试、可转人工、可追溯
多账套基础维护多账套支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
多账套业务处理每个校区独立账套，总部财务可跨账套管理科目、凭证、结账和汇总报表必须联动状态、权限、消息、审批和指标
多账套异常闭环账套期间未开启处理失败原因可见、可重试、可转人工、可追溯
税务申报基础维护税务申报支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
税务申报业务处理支持增值税、附加税、企业所得税、个税相关申报资料归集、税额测算、申报表生成和归档必须联动状态、权限、消息、审批和指标
税务申报异常闭环申报数据不平处理失败原因可见、可重试、可转人工、可追溯
凭证入账基础维护凭证入账支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
凭证入账业务处理参考金蝶云星空常用总账能力，在迪诺学堂内完成收款、课消、退费、报销、采购、库存、薪资凭证生成、过账、红冲和追溯必须联动状态、权限、消息、审批和指标
凭证入账异常闭环凭证生成失败处理失败原因可见、可重试、可转人工、可追溯
报销付款台账基础维护报销付款台账支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
报销付款台账业务处理管理报销付款申请、付款批次、出纳处理、付款凭证、失败重试和付款归档。必须联动状态、权限、消息、审批和指标
报销付款台账异常闭环付款账户缺失处理失败原因可见、可重试、可转人工、可追溯
付款批次基础维护付款批次支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
付款批次业务处理按校区、账套、付款类型和付款账户生成批次，支持拆分、合并、撤销和状态追踪。必须联动状态、权限、消息、审批和指标
付款批次异常闭环批次金额不平处理失败原因可见、可重试、可转人工、可追溯
付款失败处理基础维护付款失败处理支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
付款失败处理业务处理支付、退款、采购付款、报销付款和工资发放失败后进入统一补偿模型。必须联动状态、权限、消息、审批和指标
付款失败处理异常闭环付款二次失败处理失败原因可见、可重试、可转人工、可追溯
付款撤销基础维护付款撤销支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
付款撤销业务处理付款错误、账号异常或重复付款风险时发起撤销审批，并保留原付款流水和原因。必须联动状态、权限、消息、审批和指标
付款撤销异常闭环付款撤销待审处理失败原因可见、可重试、可转人工、可追溯
采购付款凭证基础维护采购付款凭证支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
采购付款凭证业务处理采购对账完成后生成采购付款凭证，联动供应商、入库单、发票和付款状态。必须联动状态、权限、消息、审批和指标
采购付款凭证异常闭环采购对账不平处理失败原因可见、可重试、可转人工、可追溯
薪资凭证基础维护薪资凭证支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
薪资凭证业务处理工资条确认和薪资批次通过后生成薪资凭证，联动工资发放、社保公积金显示配置和员工确认状态。必须联动状态、权限、消息、审批和指标
薪资凭证异常闭环工资条未确认处理失败原因可见、可重试、可转人工、可追溯
统一付款补偿基础维护统一付款补偿支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
统一付款补偿业务处理报销、采购、退款和工资发放统一处理失败重试、撤销、换账户、拆分付款、线下付款登记和人工介入。必须联动状态、权限、消息、审批和指标
统一付款补偿异常闭环付款补偿超时处理失败原因可见、可重试、可转人工、可追溯
国税调用日志基础维护国税调用日志支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
国税调用日志业务处理记录发票核验的校区主体、接口编码、请求参数、官方回执、频控、失败重试和人工复核。必须联动状态、权限、消息、审批和指标
国税调用日志异常闭环国税接口异常处理失败原因可见、可重试、可转人工、可追溯
库存成本凭证基础维护库存成本凭证支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
库存成本凭证业务处理库存入库、出库、调拨、报损、报废、盘盈盘亏和礼品兑换出库按成本策略生成凭证。必须联动状态、权限、消息、审批和指标
库存成本凭证异常闭环成本口径缺失处理失败原因可见、可重试、可转人工、可追溯

功能到数据对象/接口/表映射

功能域承接对象核心表代表接口状态机/状态字段研发落地校验
收款台AccountSet、FinanceSubject、FinanceVoucher、FinanceVoucherEntryfin_account_set、fin_subject、fin_voucher、fin_voucher_entry接口资源组 /api/v1/fin/features/01subject_type、source_biz_type、voucher_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
监管账户AccountSet、FinanceSubject、FinanceVoucher、FinanceVoucherEntryfin_account_set、fin_subject、fin_voucher、fin_voucher_entry接口资源组 /api/v1/fin/features/02subject_type、source_biz_type、voucher_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
预收收入AccountSet、FinanceSubject、FinanceVoucher、FinanceVoucherEntryfin_account_set、fin_subject、fin_voucher、fin_voucher_entry接口资源组 /api/v1/fin/features/03subject_type、source_biz_type、voucher_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
退费测算AccountSet、FinanceSubject、FinanceVoucher、FinanceVoucherEntryfin_account_set、fin_subject、fin_voucher、fin_voucher_entry接口资源组 /api/v1/fin/features/04subject_type、source_biz_type、voucher_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
内置报销ExpenseReport、Invoice、InvoiceVerification、ExpensePaymentApplyexp_report、exp_invoice、exp_invoice_verification、exp_payment_apply建议接口资源组 /api/v1/expenses/reportsexpense_type、expense_status、approval_status、invoice_type、duplicate_status、verification_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
发票核验Invoice、InvoiceVerificationexp_invoice、exp_invoice_verificationPOST /api/v1/tax/invoices/verifyinvoice_type、duplicate_status、verification_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
多账套AccountSet、FinanceSubject、FinanceVoucherfin_account_set、fin_subject、fin_voucher建议接口资源组 /api/v1/finance/account-setssubject_type、source_biz_type、voucher_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
税务申报FinanceVoucher、InvoiceVerification、TaxReportfin_voucher、exp_invoice_verification、tax_declaration建议接口资源组 /api/v1/tax/reportssource_biz_type、voucher_status、approval_status、verification_status、tax_type、declaration_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
凭证入账AccountSet、FinanceSubject、FinanceVoucher、FinanceVoucherEntryfin_account_set、fin_subject、fin_voucher、fin_voucher_entry建议接口资源组 /api/v1/finance/voucherssubject_type、source_biz_type、voucher_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
报销付款台账ExpenseReport、Invoice、InvoiceVerification、ExpensePaymentApplyexp_report、exp_invoice、exp_invoice_verification、exp_payment_apply建议接口资源组 /api/v1/expenses/reportsexpense_type、expense_status、approval_status、invoice_type、duplicate_status、verification_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
付款批次FinanceVoucher、FinanceVoucherEntry、ExpensePaymentApplyfin_voucher、fin_voucher_entry、exp_payment_apply建议接口资源组 /api/v1/finance/payment-ledgerssource_biz_type、voucher_status、approval_status、payment_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
付款失败处理FinanceVoucher、FinanceVoucherEntry、ExpensePaymentApplyfin_voucher、fin_voucher_entry、exp_payment_apply建议接口资源组 /api/v1/finance/payment-ledgerssource_biz_type、voucher_status、approval_status、payment_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
付款撤销FinanceVoucher、FinanceVoucherEntry、ExpensePaymentApplyfin_voucher、fin_voucher_entry、exp_payment_apply建议接口资源组 /api/v1/finance/payment-ledgerssource_biz_type、voucher_status、approval_status、payment_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
采购付款凭证FinanceVoucher、FinanceVoucherEntry、ExpensePaymentApplyfin_voucher、fin_voucher_entry、exp_payment_apply建议接口资源组 /api/v1/finance/payment-ledgerssource_biz_type、voucher_status、approval_status、payment_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
薪资凭证AccountSet、FinanceSubject、FinanceVoucher、FinanceVoucherEntryfin_account_set、fin_subject、fin_voucher、fin_voucher_entry建议接口资源组 /api/v1/finance/voucherssubject_type、source_biz_type、voucher_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
统一付款补偿FinanceVoucher、FinanceVoucherEntry、ExpensePaymentApplyfin_voucher、fin_voucher_entry、exp_payment_apply建议接口资源组 /api/v1/finance/payment-ledgerssource_biz_type、voucher_status、approval_status、payment_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
国税调用日志Invoice、InvoiceVerificationexp_invoice、exp_invoice_verificationPOST /api/v1/tax/invoices/verifyinvoice_type、duplicate_status、verification_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
库存成本凭证AccountSet、FinanceSubject、FinanceVoucher、FinanceVoucherEntryfin_account_set、fin_subject、fin_voucher、fin_voucher_entry建议接口资源组 /api/v1/finance/voucherssubject_type、source_biz_type、voucher_status、approval_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计

06 · 原子级功能需求

用于研发任务拆分和测试用例追踪

需求编号可直接进入项目管理工具。
编号需求描述入口页面关键动作输入校验输出结果异常处理验收标准
FR-FIN-001合同收款、分期收款、欠费收款进入统一订单和应收合同收款台收款对账校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务支付流水与合同金额不一致时进入财务复核主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-002收款入资金监管账户并支持流水对账监管账户台监管报送校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务监管平台回执失败时自动重试并提醒人工处理主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-003按课消确认收入并计算递延收入多账套总账凭证记账校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务课消数据缺失或账期未开启时阻断入账主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-004退费测算联动未消课时、赠课、教材、手续费和收入冲减退费与冲销台退费测算校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务退费金额异常或监管资金不足时进入审批主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-005员工报销支持单据填写、票据上传、OCR 识别、发票核验、查重防重报、审批和付款归档内置报销台报销核验校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务OCR 低置信度、发票重复或核验失败时退回补充主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-006每个校区可配置独立账套、科目、辅助核算、会计期间、凭证字和税务参数多账套总账账套配置校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务校区账套未启用时禁止生成凭证主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-007总部财务账号可管理全部分校区账套，支持账套切换、凭证复核、结账检查和汇总报表总部账套管理账套切换校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务越权访问其他校区账套时阻断并审计主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-008参考金蝶云星空核心总账能力，在迪诺学堂内置实现凭证录入、审核、过账、结账、反结账、账簿查询和凭证入账。多账套总账凭证记账校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务借贷不平或会计期间关闭时禁止过账主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-009支持增值税、附加税、企业所得税、个税相关申报资料归集、税额测算、申报表生成和归档税务申报台税务申报校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务申报数据不平或缺少票据附件时进入异常队列主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-010收款、课消、退费、报销、采购、库存、薪资自动生成凭证并写入迪诺学堂内置总账。凭证入账台凭证入账校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务凭证生成失败、借贷不平或期间关闭时保留重试任务和错误回执主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-011报销审批通过后需进入付款台账，支持付款申请、付款批次、付款状态、付款失败、付款撤销、付款凭证上传和凭证生成。采购对账付款采购对账、采购付款或凭证归档校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务对账不平、付款失败或凭证缺失主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-012采购付款、报销付款、薪资发放和退款打款均需进入财务付款台账，按校区账套、付款账户和来源单据追踪。电子工资条/薪资核算薪资核算、工资条发布或员工确认校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务工资条未发布、显示配置缺失或员工异议超期主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-013库存成本、积分礼品出库、采购退货、报损报废和盘盈盘亏需按校区账套生成凭证，并明确成本归属科目。积分商城/兑换售后积分兑换、取消、核销或库存释放校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务积分不足、库存释放失败或核销码失效主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-014报销、采购、退款和工资发放统一进入付款补偿模型，支持失败重试、撤销、换账户、拆分付款、线下付款登记、凭证阻断和人工介入。电子工资条/薪资核算薪资核算、工资条发布或员工确认校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务工资条未发布、显示配置缺失或员工异议超期主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FIN-015国税发票核验需提供校区税务主体配置、调用日志、频控额度、失败重试、OCR 与官方结果差异复核和主体停用影响提示。账套管理税务申报校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务付款失败主流程、异常流、权限流、接口失败和数据一致性均可通过测试

07 · 关联闭环补充需求

财务业财中心在跨模块闭环中的责任边界

本章节承接最终闭环核对清单，明确本模块需要补齐的页面、接口对象、异常兜底和验收口径。
闭环项本模块责任关键场景页面/功能补充关联对象/接口验收口径
国税主体配置负责校区税务主体、授权编码、票种、地区和发票核验接口凭证各校区独立报销、发票核验、账套核算和总部汇总税务主体配置、发票 OCR、国税核验、核验日志、校区账套映射ExpenseReport/InvoiceVerification、AccountSet/TaxReport、/api/v1/finance/invoices/verify每次核验必须绑定校区主体、接口凭证和国税回执
统一付款补偿负责支付、退款、采购付款、报销付款、工资发放的幂等、对账和补偿支付回调超时、重复付款风险、退款失败、报销付款失败付款单、付款回调、对账差异、补偿任务、人工处理Contract/Order/Payment、PurchaseReconciliation/Payment、PayrollPayslip/SalaryItem付款异常可查询、可重试、可关闭、可生成会计凭证或冲正
库存成本策略承接物料资产出入库成本、固定资产折旧或摊销和凭证联动采购入库、调拨、报损、礼品兑换、图书出入库成本口径、凭证生成、库存金额报表Material/Inventory/Asset/Book、FinanceVoucher库存成本与财务报表口径一致
合同补充协议补充协议引起的收款、退款、收入确认和凭证调整由财务承接合同变更、补差、退费、转课和权益调整合同财务明细、凭证调整、红冲、退款审批Contract/Order/Payment、FinanceVoucher补充协议生效后财务数据必须同步更新

08 · 页面与原型设计说明

页面清单、布局要求、按钮字段和状态

原型图设计需要覆盖列表、详情、表单、弹窗、空状态、异常状态和权限状态。
终端页面用户页面目标布局结构关键按钮关键字段异常状态原型备注
PC Web监管账户财务查看收款流水、释放资金、对账和异常处理监管资金页以流水台账、合同备案、课消释放、退款监管和异常回执组成，右侧展示监管回执和重报记录。查看流水、资金对账、合同备案、课消释放、退款报送、失败重报、异常处理监管账户、合同编号、收款流水、释放金额、课消批次、退款单号、回执状态、失败原因、校区账套、会计期间监管回执失败、流水不匹配、合同未备案、课消释放失败、退款报送失败需覆盖监管账户流水、合同备案、资金释放、退款监管、失败重报和人工处理。 建议 Figma Frame：FIN-监管账户；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web内置报销员工/审批人/财务填写报销单、OCR 识别票据、发票核验、查重、审批和付款单据页采用步骤式表单，票据区支持 OCR 识别与核验结果；付款台账以批次、状态、异常原因和补偿入口组织。新增报销单、OCR 识别、国税核验、发票查重、提交审批、生成付款批次、失败重试报销人、费用类型、发票号码、校区税务主体、核验编码、重复结果、付款账户、补偿状态、校区账套、会计期间OCR 低置信度、发票核验失败、重复报销、付款失败、付款撤销待审、接口频控需绘制票据识别、人工修正、国税主体选择、查重拦截、审批流、付款失败补偿和日志详情。 建议 Figma Frame：FIN-内置报销；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web多账套总账总部财务/校区财务切换校区账套、录入审核凭证、结账、反结账和账簿查询财务工作台左侧账套/期间切换，中部为凭证或报表列表，右侧展示借贷分录、附件、来源单据和回执。切换账套、生成凭证、审核凭证、红冲、期间结账、生成申报表、归档回执校区账套、会计期间、凭证字号、借方金额、贷方金额、来源单据、审核人、回执状态、单据编号、发票号码借贷不平、期间关闭、来源单据缺失、监管回执失败、申报数据不平、成本口径缺失需覆盖总部跨账套视角、校区独立账套、凭证来源追溯、红冲、反结账限制和监管/税务回执。 建议 Figma Frame：FIN-多账套总账；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web税务申报总部财务/校区财务归集税务资料、测算税额、生成申报表和归档回执财务工作台左侧账套/期间切换，中部为凭证或报表列表，右侧展示借贷分录、附件、来源单据和回执。切换账套、生成凭证、审核凭证、红冲、期间结账、生成申报表、归档回执校区账套、会计期间、凭证字号、借方金额、贷方金额、来源单据、审核人、回执状态、单据编号、发票号码借贷不平、期间关闭、来源单据缺失、监管回执失败、申报数据不平、成本口径缺失需覆盖总部跨账套视角、校区独立账套、凭证来源追溯、红冲、反结账限制和监管/税务回执。 建议 Figma Frame：FIN-税务申报；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web凭证入账财务生成凭证、写入内置总账、处理失败重推财务工作台左侧账套/期间切换，中部为凭证或报表列表，右侧展示借贷分录、附件、来源单据和回执。切换账套、生成凭证、审核凭证、红冲、期间结账、生成申报表、归档回执校区账套、会计期间、凭证字号、借方金额、贷方金额、来源单据、审核人、回执状态、单据编号、发票号码借贷不平、期间关闭、来源单据缺失、监管回执失败、申报数据不平、成本口径缺失需覆盖总部跨账套视角、校区独立账套、凭证来源追溯、红冲、反结账限制和监管/税务回执。 建议 Figma Frame：FIN-凭证入账；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web报销付款台账财务/出纳管理报销付款、付款批次、付款失败、付款撤销、付款凭证和凭证生成单据页采用步骤式表单，票据区支持 OCR 识别与核验结果；付款台账以批次、状态、异常原因和补偿入口组织。新增报销单、OCR 识别、国税核验、发票查重、提交审批、生成付款批次、失败重试报销人、费用类型、发票号码、校区税务主体、核验编码、重复结果、付款账户、补偿状态、校区账套、会计期间OCR 低置信度、发票核验失败、重复报销、付款失败、付款撤销待审、接口频控需绘制票据识别、人工修正、国税主体选择、查重拦截、审批流、付款失败补偿和日志详情。 建议 Figma Frame：FIN-报销付款台账；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web库存成本凭证财务审核库存出入库、报损报废、盘盈盘亏、礼品出库和成本凭证财务工作台左侧账套/期间切换，中部为凭证或报表列表，右侧展示借贷分录、附件、来源单据和回执。切换账套、生成凭证、审核凭证、红冲、期间结账、生成申报表、归档回执校区账套、会计期间、凭证字号、借方金额、贷方金额、来源单据、审核人、回执状态、单据编号、发票号码借贷不平、期间关闭、来源单据缺失、监管回执失败、申报数据不平、成本口径缺失需覆盖总部跨账套视角、校区独立账套、凭证来源追溯、红冲、反结账限制和监管/税务回执。 建议 Figma Frame：FIN-库存成本凭证；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web国税主体配置财务/系统管理员按校区配置税务主体、接口编码、授权凭证、额度、启用状态和负责人国税配置页按校区税务主体、接口编码、授权凭证和启用状态管理；日志页展示请求、响应、频控、失败重试和人工复核。新增主体、配置编码、启用停用、测试连接、查看日志、失败重试、人工复核校区、纳税人识别号、接口编码、授权凭证、票种、额度、请求耗时、官方回执、校区账套、会计期间主体未配置、授权凭证失效、接口频控、国税核验失败、回执解析失败、人工复核超时需覆盖每校区可配置主体、编码、凭证、额度、启用状态、调用日志、失败重试和人工复核。 建议 Figma Frame：FIN-国税主体配置；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web国税调用日志财务/技术运营查看国税核验请求、响应、频控、失败重试、人工复核和主体变更影响国税配置页按校区税务主体、接口编码、授权凭证和启用状态管理；日志页展示请求、响应、频控、失败重试和人工复核。新增主体、配置编码、启用停用、测试连接、查看日志、失败重试、人工复核校区、纳税人识别号、接口编码、授权凭证、票种、额度、请求耗时、官方回执、校区账套、会计期间主体未配置、授权凭证失效、接口频控、国税核验失败、回执解析失败、人工复核超时需覆盖每校区可配置主体、编码、凭证、额度、启用状态、调用日志、失败重试和人工复核。 建议 Figma Frame：FIN-国税调用日志；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web统一付款补偿财务/出纳处理报销、采购、退款、工资付款失败后的重试、撤销、换账户、拆分和线下付款单据页采用步骤式表单，票据区支持 OCR 识别与核验结果；付款台账以批次、状态、异常原因和补偿入口组织。新增报销单、OCR 识别、国税核验、发票查重、提交审批、生成付款批次、失败重试报销人、费用类型、发票号码、校区税务主体、核验编码、重复结果、付款账户、补偿状态、校区账套、会计期间OCR 低置信度、发票核验失败、重复报销、付款失败、付款撤销待审、接口频控需绘制票据识别、人工修正、国税主体选择、查重拦截、审批流、付款失败补偿和日志详情。 建议 Figma Frame：FIN-统一付款补偿；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web报销单授权用户围绕报销复刻完善报销单的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、收款对账、监管报送校区账套、会计期间、单据编号、发票号码、核验状态、凭证字号、付款状态、监管回执空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FIN-报销单；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web发票识别授权用户围绕报销复刻完善发票识别的入口、字段、状态、异常提示、处理进度和验收反馈单据页采用步骤式表单，票据区支持 OCR 识别与核验结果；付款台账以批次、状态、异常原因和补偿入口组织。新增报销单、OCR 识别、国税核验、发票查重、提交审批、生成付款批次、失败重试报销人、费用类型、发票号码、校区税务主体、核验编码、重复结果、付款账户、补偿状态、校区账套、会计期间OCR 低置信度、发票核验失败、重复报销、付款失败、付款撤销待审、接口频控需绘制票据识别、人工修正、国税主体选择、查重拦截、审批流、付款失败补偿和日志详情。 建议 Figma Frame：FIN-发票识别；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web发票核验授权用户围绕报销复刻完善发票核验的入口、字段、状态、异常提示、处理进度和验收反馈单据页采用步骤式表单，票据区支持 OCR 识别与核验结果；付款台账以批次、状态、异常原因和补偿入口组织。新增报销单、OCR 识别、国税核验、发票查重、提交审批、生成付款批次、失败重试报销人、费用类型、发票号码、校区税务主体、核验编码、重复结果、付款账户、补偿状态、校区账套、会计期间OCR 低置信度、发票核验失败、重复报销、付款失败、付款撤销待审、接口频控需绘制票据识别、人工修正、国税主体选择、查重拦截、审批流、付款失败补偿和日志详情。 建议 Figma Frame：FIN-发票核验；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web付款单授权用户围绕报销复刻完善付款单的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、收款对账、监管报送校区账套、会计期间、单据编号、发票号码、核验状态、凭证字号、付款状态、监管回执空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FIN-付款单；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web账套管理授权用户围绕账套税务完善账套管理的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、收款对账、监管报送校区账套、会计期间、单据编号、发票号码、核验状态、凭证字号、付款状态、监管回执空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FIN-账套管理；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web凭证录入授权用户围绕账套税务完善凭证录入的入口、字段、状态、异常提示、处理进度和验收反馈财务工作台左侧账套/期间切换，中部为凭证或报表列表，右侧展示借贷分录、附件、来源单据和回执。切换账套、生成凭证、审核凭证、红冲、期间结账、生成申报表、归档回执校区账套、会计期间、凭证字号、借方金额、贷方金额、来源单据、审核人、回执状态、单据编号、发票号码借贷不平、期间关闭、来源单据缺失、监管回执失败、申报数据不平、成本口径缺失需覆盖总部跨账套视角、校区独立账套、凭证来源追溯、红冲、反结账限制和监管/税务回执。 建议 Figma Frame：FIN-凭证录入；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web期间结账授权用户围绕账套税务完善期间结账的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、收款对账、监管报送校区账套、会计期间、单据编号、发票号码、核验状态、凭证字号、付款状态、监管回执空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FIN-期间结账；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web纳税申报授权用户围绕账套税务完善纳税申报的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、收款对账、监管报送校区账套、会计期间、单据编号、发票号码、核验状态、凭证字号、付款状态、监管回执空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FIN-纳税申报；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web付款台账授权用户围绕资金闭环完善付款台账的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、收款对账、监管报送校区账套、会计期间、单据编号、发票号码、核验状态、凭证字号、付款状态、监管回执空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FIN-付款台账；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web对账差异授权用户围绕资金闭环完善对账差异的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、收款对账、监管报送校区账套、会计期间、单据编号、发票号码、核验状态、凭证字号、付款状态、监管回执空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FIN-对账差异；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web监管报送授权用户围绕资金闭环完善监管报送的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、收款对账、监管报送校区账套、会计期间、单据编号、发票号码、核验状态、凭证字号、付款状态、监管回执空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FIN-监管报送；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。

09 · 页面到接口的前后端闭环矩阵

把原型页面、后端接口、数据对象、状态和消息审批绑定到一起

设计原型时，每个关键页面必须能解释前端展示什么、后端提交什么、状态怎么变、异常怎么处理。
原型页面关键接口关联对象状态流审批/权限触发消息/待办触达原型验收要求
监管账户POST /api/v1/tax/invoices/verifyAccountSet草稿 -> 待学管确认 -> 待校长审批 -> 待财务复核 -> 监管退款中 -> 已退款 -> 已驳回 -> 已取消无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
内置报销POST /api/v1/tax/invoices/verifyFinanceSubject草稿 -> 待 OCR -> 待核验 -> 待审批 -> 已通过 -> 待付款 -> 已付款 -> 已驳回 -> 已作废无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
多账套总账POST /api/v1/tax/invoices/verifyFinanceVoucher草稿 -> 待学管确认 -> 待校长审批 -> 待财务复核 -> 监管退款中 -> 已退款 -> 已驳回 -> 已取消无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
税务申报POST /api/v1/tax/invoices/verifyFinanceVoucherEntry草稿 -> 待 OCR -> 待核验 -> 待审批 -> 已通过 -> 待付款 -> 已付款 -> 已驳回 -> 已作废无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
凭证入账POST /api/v1/tax/invoices/verifyExpenseReport草稿 -> 待学管确认 -> 待校长审批 -> 待财务复核 -> 监管退款中 -> 已退款 -> 已驳回 -> 已取消无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
报销付款台账POST /api/v1/tax/invoices/verifyInvoice草稿 -> 待 OCR -> 待核验 -> 待审批 -> 已通过 -> 待付款 -> 已付款 -> 已驳回 -> 已作废无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
库存成本凭证POST /api/v1/tax/invoices/verifyInvoiceVerification草稿 -> 待学管确认 -> 待校长审批 -> 待财务复核 -> 监管退款中 -> 已退款 -> 已驳回 -> 已取消无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
国税主体配置POST /api/v1/tax/invoices/verifyExpensePaymentApply草稿 -> 待 OCR -> 待核验 -> 待审批 -> 已通过 -> 待付款 -> 已付款 -> 已驳回 -> 已作废无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
国税调用日志POST /api/v1/tax/invoices/verifyTaxReport草稿 -> 待学管确认 -> 待校长审批 -> 待财务复核 -> 监管退款中 -> 已退款 -> 已驳回 -> 已取消无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
统一付款补偿POST /api/v1/tax/invoices/verifyAccountSet草稿 -> 待 OCR -> 待核验 -> 待审批 -> 已通过 -> 待付款 -> 已付款 -> 已驳回 -> 已作废无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
报销单POST /api/v1/tax/invoices/verifyFinanceSubject草稿 -> 待学管确认 -> 待校长审批 -> 待财务复核 -> 监管退款中 -> 已退款 -> 已驳回 -> 已取消无审批时仍需写操作审计，敏感操作按安全中心规则触发审批报销审批提醒 -> 审批人/财务原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
发票识别POST /api/v1/tax/invoices/verifyFinanceVoucher草稿 -> 待 OCR -> 待核验 -> 待审批 -> 已通过 -> 待付款 -> 已付款 -> 已驳回 -> 已作废无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口

10 · 原型、UI、研发、测试交付补充

把关键闭环补强为下一阶段可执行任务

本章节为正式 PRD 的交付要求，面向原型图、UI、开发、联调和测试分工。
能力域功能补充要求原型交付要求UI 交互要求研发实现要求测试验收要求
报销复刻补齐报销单、OCR、国税核验、发票查重、防重复报销、审批和付款归档。报销单、发票识别、发票核验、付款单 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；发票核验结果、查重结果、审批和付款状态完整可见。
账套税务补齐每校区独立账套、总部统管、凭证、科目、结账、反结账、报税和财务报表。账套管理、凭证录入、期间结账、纳税申报 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；总部财务能查看和管理所有校区账套。
资金闭环补齐付款失败重试、对账差异、人工关闭、凭证冲正和监管报送。付款台账、对账差异、监管报送 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；每笔资金动作都可查状态、凭证、回执和补偿记录。

11 · 数据对象与字段字典

明确页面、接口、数据库共同使用的数据语言

字段涉及敏感、人脸、财务、绩效时，原型需体现脱敏、授权和审计。

核心对象

对象说明
AccountSet每校区独立账套；落地表：fin_account_set
FinanceSubject会计科目和辅助核算；落地表：fin_subject
FinanceVoucher会计凭证；落地表：fin_voucher
FinanceVoucherEntry凭证明细分录；落地表：fin_voucher_entry
ExpenseReport合思式报销单；落地表：exp_report
Invoice报销发票与 OCR 结果；落地表：exp_invoice
InvoiceVerification国税官方发票核验；落地表：exp_invoice_verification
ExpensePaymentApply报销付款申请；落地表：exp_payment_apply
TaxReport纳税申报资料和报表；落地表：tax_declaration

关联引用对象

对象说明
Organization集团、区域、校区、部门组织树；引用来源：FND / sys_organization
User/Employee统一登录账号；引用来源：FND / sys_user
Employee员工基础档案；引用来源：FND / sys_employee
Role角色定义；引用来源：FND / sys_role
ApprovalFlow审批流配置；引用来源：FND / sys_approval_flow
MessageTemplate消息模板与多端触达配置；引用来源：FND / sys_message_template
AuditLog全平台操作审计日志；引用来源：FND / sys_audit_log
IntegrationLog接口调用日志；引用来源：OPEN / int_integration_log
SensitiveFieldPolicy敏感字段脱敏策略；引用来源：SEC / sec_sensitive_field_policy
LegalEntity法人主体、税务主体和收款主体；引用来源：FND / sys_legal_entity
Contract合同主表；引用来源：CON / con_contract
Order订单和应收；引用来源：CON / ord_order
Payment收款单；引用来源：CON / ord_payment
Consumption课消记录；引用来源：EDU / edu_consumption
StockIn采购入库/退货入库；引用来源：MAT / mat_stock_in
StockOut领用出库/核销出库；引用来源：MAT / mat_stock_out
PayrollPayslip电子工资条；引用来源：HR / hr_payslip

完整字段字典

对象字段类型必填规则数据级别
AccountSetidBIGINT是主键，雪花或号段生成，禁止复用普通
AccountSettenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
AccountSetorg_idBIGINT否所属组织，集团级或公共配置为空普通
AccountSetcampus_idBIGINT是所属校区，跨校区或总部级数据为空；本表业务要求必填普通
AccountSetcreated_byBIGINT是创建人账号 ID普通
AccountSetcreated_atDATETIME是创建时间普通
AccountSetupdated_byBIGINT否最后更新人账号 ID普通
AccountSetupdated_atDATETIME否最后更新时间普通
AccountSetis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
AccountSetdeleted_atDATETIME否删除时间，未删除为空普通
AccountSetdeleted_byBIGINT否删除人账号 ID，未删除为空普通
AccountSetversionINT是乐观锁版本号，写操作必须校验普通
AccountSetaccount_set_codeVARCHAR(64)是账套编码，唯一普通
AccountSetaccount_set_nameVARCHAR(128)是账套名称普通
AccountSetfiscal_calendarJSON是会计期间配置普通
AccountSettax_subject_idBIGINT是税务主体 ID普通
AccountSetenabledTINYINT是是否启用普通
FinanceSubjectidBIGINT是主键，雪花或号段生成，禁止复用普通
FinanceSubjecttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
FinanceSubjectorg_idBIGINT否所属组织，集团级或公共配置为空普通
FinanceSubjectcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
FinanceSubjectcreated_byBIGINT是创建人账号 ID普通
FinanceSubjectcreated_atDATETIME是创建时间普通
FinanceSubjectupdated_byBIGINT否最后更新人账号 ID普通
FinanceSubjectupdated_atDATETIME否最后更新时间普通
FinanceSubjectis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
FinanceSubjectdeleted_atDATETIME否删除时间，未删除为空普通
FinanceSubjectdeleted_byBIGINT否删除人账号 ID，未删除为空普通
FinanceSubjectversionINT是乐观锁版本号，写操作必须校验普通
FinanceSubjectaccount_set_idBIGINT是账套 ID普通
FinanceSubjectsubject_codeVARCHAR(64)是科目编码普通
FinanceSubjectsubject_nameVARCHAR(128)是科目名称普通
FinanceSubjectsubject_typeVARCHAR(32)是资产/负债/收入/成本/费用/权益普通
FinanceSubjectassist_ruleJSON否辅助核算规则普通
FinanceSubjectenabledTINYINT是是否启用普通
FinanceVoucheridBIGINT是主键，雪花或号段生成，禁止复用普通
FinanceVouchertenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
FinanceVoucherorg_idBIGINT否所属组织，集团级或公共配置为空普通
FinanceVouchercampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
FinanceVouchercreated_byBIGINT是创建人账号 ID普通
FinanceVouchercreated_atDATETIME是创建时间普通
FinanceVoucherupdated_byBIGINT否最后更新人账号 ID普通
FinanceVoucherupdated_atDATETIME否最后更新时间普通
FinanceVoucheris_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
FinanceVoucherdeleted_atDATETIME否删除时间，未删除为空普通
FinanceVoucherdeleted_byBIGINT否删除人账号 ID，未删除为空普通
FinanceVoucherversionINT是乐观锁版本号，写操作必须校验普通
FinanceVouchervoucher_noVARCHAR(64)是凭证编号，账套期间内唯一普通
FinanceVoucheraccount_set_idBIGINT是账套 ID普通
FinanceVoucherperiod_codeVARCHAR(32)是会计期间普通
FinanceVouchersource_biz_typeVARCHAR(64)否来源业务类型普通
FinanceVouchersource_biz_noVARCHAR(64)否来源业务编号普通
FinanceVouchervoucher_statusVARCHAR(32)是草稿/待审核/已审核/已过账/已红冲普通
FinanceVoucherapproval_statusVARCHAR(32)否审批状态，未发起为空普通
FinanceVoucherapproval_instance_idBIGINT否关联审批实例 ID普通
FinanceVoucherEntryidBIGINT是主键，雪花或号段生成，禁止复用普通
FinanceVoucherEntrytenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
FinanceVoucherEntryorg_idBIGINT否所属组织，集团级或公共配置为空普通
FinanceVoucherEntrycampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
FinanceVoucherEntrycreated_byBIGINT是创建人账号 ID普通
FinanceVoucherEntrycreated_atDATETIME是创建时间普通
FinanceVoucherEntryupdated_byBIGINT否最后更新人账号 ID普通
FinanceVoucherEntryupdated_atDATETIME否最后更新时间普通
FinanceVoucherEntryis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
FinanceVoucherEntrydeleted_atDATETIME否删除时间，未删除为空普通
FinanceVoucherEntrydeleted_byBIGINT否删除人账号 ID，未删除为空普通
FinanceVoucherEntryversionINT是乐观锁版本号，写操作必须校验普通
FinanceVoucherEntryvoucher_idBIGINT是凭证 ID普通
FinanceVoucherEntryentry_noINT是分录行号普通
FinanceVoucherEntrysubject_idBIGINT是会计科目 ID普通
FinanceVoucherEntryassist_payloadJSON否辅助核算信息普通
FinanceVoucherEntrydebit_amountDECIMAL(18,2)是借方金额普通
FinanceVoucherEntrycredit_amountDECIMAL(18,2)是贷方金额普通
FinanceVoucherEntrysummaryVARCHAR(255)是摘要普通
ExpenseReportidBIGINT是主键，雪花或号段生成，禁止复用普通
ExpenseReporttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
ExpenseReportorg_idBIGINT否所属组织，集团级或公共配置为空普通
ExpenseReportcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
ExpenseReportcreated_byBIGINT是创建人账号 ID普通
ExpenseReportcreated_atDATETIME是创建时间普通
ExpenseReportupdated_byBIGINT否最后更新人账号 ID普通
ExpenseReportupdated_atDATETIME否最后更新时间普通
ExpenseReportis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
ExpenseReportdeleted_atDATETIME否删除时间，未删除为空普通
ExpenseReportdeleted_byBIGINT否删除人账号 ID，未删除为空普通
ExpenseReportversionINT是乐观锁版本号，写操作必须校验普通
ExpenseReportexpense_noVARCHAR(64)是报销单编号，唯一普通
ExpenseReportapplicant_idBIGINT是申请人 ID普通
ExpenseReportexpense_typeVARCHAR(32)是差旅/办公/采购/市场/其他普通
ExpenseReporttotal_amountDECIMAL(18,2)是报销总额普通
ExpenseReportexpense_statusVARCHAR(32)是草稿/待审批/待付款/已付款/已驳回普通
ExpenseReportapproval_statusVARCHAR(32)否审批状态，未发起为空普通
ExpenseReportapproval_instance_idBIGINT否关联审批实例 ID普通
InvoiceidBIGINT是主键，雪花或号段生成，禁止复用普通
Invoicetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
Invoiceorg_idBIGINT否所属组织，集团级或公共配置为空普通
Invoicecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
Invoicecreated_byBIGINT是创建人账号 ID普通
Invoicecreated_atDATETIME是创建时间普通
Invoiceupdated_byBIGINT否最后更新人账号 ID普通
Invoiceupdated_atDATETIME否最后更新时间普通
Invoiceis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
Invoicedeleted_atDATETIME否删除时间，未删除为空普通
Invoicedeleted_byBIGINT否删除人账号 ID，未删除为空普通
InvoiceversionINT是乐观锁版本号，写操作必须校验普通
Invoiceinvoice_noVARCHAR(64)是发票号码普通
Invoiceinvoice_codeVARCHAR(64)否发票代码普通
Invoiceinvoice_typeVARCHAR(32)是专票/普票/电子票/其他普通
Invoiceseller_tax_noVARCHAR(64)否销售方税号敏感
Invoicebuyer_tax_noVARCHAR(64)否购买方税号敏感
Invoiceocr_resultJSON否OCR 识别结果普通
Invoiceduplicate_statusVARCHAR(32)是未查重/重复/未重复普通
InvoiceVerificationidBIGINT是主键，雪花或号段生成，禁止复用普通
InvoiceVerificationtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
InvoiceVerificationorg_idBIGINT否所属组织，集团级或公共配置为空普通
InvoiceVerificationcampus_idBIGINT是所属校区，跨校区或总部级数据为空；本表业务要求必填普通
InvoiceVerificationcreated_byBIGINT是创建人账号 ID普通
InvoiceVerificationcreated_atDATETIME是创建时间普通
InvoiceVerificationupdated_byBIGINT否最后更新人账号 ID普通
InvoiceVerificationupdated_atDATETIME否最后更新时间普通
InvoiceVerificationis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
InvoiceVerificationdeleted_atDATETIME否删除时间，未删除为空普通
InvoiceVerificationdeleted_byBIGINT否删除人账号 ID，未删除为空普通
InvoiceVerificationversionINT是乐观锁版本号，写操作必须校验普通
InvoiceVerificationverification_noVARCHAR(64)是核验编号，唯一普通
InvoiceVerificationtax_subject_idBIGINT是税务主体配置 ID普通
InvoiceVerificationofficial_app_codeVARCHAR(128)是国税接口主体/编码配置普通
InvoiceVerificationinvoice_idBIGINT是发票 ID普通
InvoiceVerificationofficial_payloadJSON是官方请求参数普通
InvoiceVerificationofficial_receiptJSON否官方核验回执普通
InvoiceVerificationverification_statusVARCHAR(32)是待核验/通过/不通过/异常/重试中普通
ExpensePaymentApplyidBIGINT是主键，雪花或号段生成，禁止复用普通
ExpensePaymentApplytenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
ExpensePaymentApplyorg_idBIGINT否所属组织，集团级或公共配置为空普通
ExpensePaymentApplycampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
ExpensePaymentApplycreated_byBIGINT是创建人账号 ID普通
ExpensePaymentApplycreated_atDATETIME是创建时间普通
ExpensePaymentApplyupdated_byBIGINT否最后更新人账号 ID普通
ExpensePaymentApplyupdated_atDATETIME否最后更新时间普通
ExpensePaymentApplyis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
ExpensePaymentApplydeleted_atDATETIME否删除时间，未删除为空普通
ExpensePaymentApplydeleted_byBIGINT否删除人账号 ID，未删除为空普通
ExpensePaymentApplyversionINT是乐观锁版本号，写操作必须校验普通
ExpensePaymentApplypayment_apply_noVARCHAR(64)是付款申请编号，唯一普通
ExpensePaymentApplyexpense_report_idBIGINT是报销单 ID普通
ExpensePaymentApplypayee_idBIGINT是收款人 ID普通
ExpensePaymentApplypayee_accountVARCHAR(128)是收款账号，敏感敏感
ExpensePaymentApplypay_amountDECIMAL(18,2)是付款金额普通
ExpensePaymentApplypayment_statusVARCHAR(32)是待付款/付款中/成功/失败普通
TaxReportidBIGINT是主键，雪花或号段生成，禁止复用普通
TaxReporttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
TaxReportorg_idBIGINT否所属组织，集团级或公共配置为空普通
TaxReportcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
TaxReportcreated_byBIGINT是创建人账号 ID普通
TaxReportcreated_atDATETIME是创建时间普通
TaxReportupdated_byBIGINT否最后更新人账号 ID普通
TaxReportupdated_atDATETIME否最后更新时间普通
TaxReportis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
TaxReportdeleted_atDATETIME否删除时间，未删除为空普通
TaxReportdeleted_byBIGINT否删除人账号 ID，未删除为空普通
TaxReportversionINT是乐观锁版本号，写操作必须校验普通
TaxReportdeclaration_noVARCHAR(64)是申报编号，唯一普通
TaxReportaccount_set_idBIGINT是账套 ID普通
TaxReporttax_periodVARCHAR(32)是税期普通
TaxReporttax_typeVARCHAR(32)是增值税/所得税/附加税/其他普通
TaxReportdeclaration_payloadJSON是申报资料普通
TaxReportdeclaration_statusVARCHAR(32)是草稿/待申报/已申报/失败普通

引用对象字段字典

引用表对象字段类型必填规则数据级别
sys_organizationOrganizationidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_organizationOrganizationtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_organizationOrganizationorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_organizationOrganizationcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_organizationOrganizationcreated_byBIGINT是创建人账号 ID普通
sys_organizationOrganizationcreated_atDATETIME是创建时间普通
sys_organizationOrganizationupdated_byBIGINT否最后更新人账号 ID普通
sys_organizationOrganizationupdated_atDATETIME否最后更新时间普通
sys_organizationOrganizationis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_organizationOrganizationdeleted_atDATETIME否删除时间，未删除为空普通
sys_organizationOrganizationdeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_organizationOrganizationversionINT是乐观锁版本号，写操作必须校验普通
sys_organizationOrganizationorg_codeVARCHAR(64)是组织编码，租户内唯一普通
sys_organizationOrganizationorg_nameVARCHAR(128)是组织名称普通
sys_organizationOrganizationorg_typeVARCHAR(32)是集团/区域/校区/部门/法人主体普通
sys_organizationOrganizationparent_idBIGINT否上级组织 ID，根节点为空普通
sys_organizationOrganizationsort_noINT否同级排序普通
sys_organizationOrganizationenabledTINYINT是是否启用普通
sys_userUser/EmployeeidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_userUser/Employeetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_userUser/Employeeorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_userUser/Employeecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_userUser/Employeecreated_byBIGINT是创建人账号 ID普通
sys_userUser/Employeecreated_atDATETIME是创建时间普通
sys_userUser/Employeeupdated_byBIGINT否最后更新人账号 ID普通
sys_userUser/Employeeupdated_atDATETIME否最后更新时间普通
sys_userUser/Employeeis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_userUser/Employeedeleted_atDATETIME否删除时间，未删除为空普通
sys_userUser/Employeedeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_userUser/EmployeeversionINT是乐观锁版本号，写操作必须校验普通
sys_userUser/Employeeuser_noVARCHAR(64)是账号编号，唯一普通
sys_userUser/Employeelogin_nameVARCHAR(64)是登录名，唯一普通
sys_userUser/EmployeemobileVARCHAR(32)否手机号，敏感脱敏展示敏感
sys_userUser/Employeepassword_hashVARCHAR(255)否密码哈希，禁止前端返回高敏
sys_userUser/Employeeuser_typeVARCHAR(32)是员工/学员/家长/外部账号普通
sys_userUser/Employeelogin_statusVARCHAR(32)是正常/锁定/停用/待激活普通
sys_employeeEmployeeidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_employeeEmployeetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_employeeEmployeeorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_employeeEmployeecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_employeeEmployeecreated_byBIGINT是创建人账号 ID普通
sys_employeeEmployeecreated_atDATETIME是创建时间普通
sys_employeeEmployeeupdated_byBIGINT否最后更新人账号 ID普通
sys_employeeEmployeeupdated_atDATETIME否最后更新时间普通
sys_employeeEmployeeis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_employeeEmployeedeleted_atDATETIME否删除时间，未删除为空普通
sys_employeeEmployeedeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_employeeEmployeeversionINT是乐观锁版本号，写操作必须校验普通
sys_employeeEmployeeemployee_noVARCHAR(64)是工号，唯一普通
sys_employeeEmployeeuser_idBIGINT否关联账号 ID普通
sys_employeeEmployeeemployee_nameVARCHAR(64)是员工姓名普通
sys_employeeEmployeeprimary_campus_idBIGINT否主校区 ID普通
sys_employeeEmployeejob_titleVARCHAR(64)否岗位名称普通
sys_employeeEmployeehire_statusVARCHAR(32)是在职/试用/离职/停用普通
sys_roleRoleidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_roleRoletenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_roleRoleorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_roleRolecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_roleRolecreated_byBIGINT是创建人账号 ID普通
sys_roleRolecreated_atDATETIME是创建时间普通
sys_roleRoleupdated_byBIGINT否最后更新人账号 ID普通
sys_roleRoleupdated_atDATETIME否最后更新时间普通
sys_roleRoleis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_roleRoledeleted_atDATETIME否删除时间，未删除为空普通
sys_roleRoledeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_roleRoleversionINT是乐观锁版本号，写操作必须校验普通
sys_roleRolerole_codeVARCHAR(64)是角色编码，唯一普通
sys_roleRolerole_nameVARCHAR(128)是角色名称普通
sys_roleRolerole_levelVARCHAR(32)是总部/区域/校区/个人普通
sys_roleRoledata_scope_typeVARCHAR(32)是数据范围类型普通
sys_roleRoleenabledTINYINT是是否启用普通
sys_approval_flowApprovalFlowidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_approval_flowApprovalFlowtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_approval_flowApprovalFloworg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_approval_flowApprovalFlowcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_approval_flowApprovalFlowcreated_byBIGINT是创建人账号 ID普通
sys_approval_flowApprovalFlowcreated_atDATETIME是创建时间普通
sys_approval_flowApprovalFlowupdated_byBIGINT否最后更新人账号 ID普通
sys_approval_flowApprovalFlowupdated_atDATETIME否最后更新时间普通
sys_approval_flowApprovalFlowis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_approval_flowApprovalFlowdeleted_atDATETIME否删除时间，未删除为空普通
sys_approval_flowApprovalFlowdeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_approval_flowApprovalFlowversionINT是乐观锁版本号，写操作必须校验普通
sys_approval_flowApprovalFlowflow_codeVARCHAR(64)是审批流编码，唯一普通
sys_approval_flowApprovalFlowbiz_typeVARCHAR(64)是业务类型普通
sys_approval_flowApprovalFlowflow_nameVARCHAR(128)是审批流名称普通
sys_approval_flowApprovalFlowcondition_jsonJSON否触发条件普通
sys_approval_flowApprovalFlownode_jsonJSON是节点、审批人和超时规则普通
sys_approval_flowApprovalFlowversion_noINT是审批流版本号普通
sys_approval_flowApprovalFlowenabledTINYINT是是否启用普通
sys_message_templateMessageTemplateidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_message_templateMessageTemplatetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_message_templateMessageTemplateorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_message_templateMessageTemplatecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_message_templateMessageTemplatecreated_byBIGINT是创建人账号 ID普通
sys_message_templateMessageTemplatecreated_atDATETIME是创建时间普通
sys_message_templateMessageTemplateupdated_byBIGINT否最后更新人账号 ID普通
sys_message_templateMessageTemplateupdated_atDATETIME否最后更新时间普通
sys_message_templateMessageTemplateis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_message_templateMessageTemplatedeleted_atDATETIME否删除时间，未删除为空普通
sys_message_templateMessageTemplatedeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_message_templateMessageTemplateversionINT是乐观锁版本号，写操作必须校验普通
sys_message_templateMessageTemplatetemplate_codeVARCHAR(64)是模板编码，唯一普通
sys_message_templateMessageTemplatetemplate_nameVARCHAR(128)是模板名称普通
sys_message_templateMessageTemplatechannelVARCHAR(32)是站内信/短信/微信小程序/企微/Push普通
sys_message_templateMessageTemplatereceiver_ruleJSON是接收人规则普通
sys_message_templateMessageTemplatecontent_templateTEXT是模板内容普通
sys_message_templateMessageTemplateenabledTINYINT是是否启用普通
sys_audit_logAuditLogidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_audit_logAuditLogtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_audit_logAuditLogorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_audit_logAuditLogcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_audit_logAuditLogcreated_byBIGINT是创建人账号 ID普通
sys_audit_logAuditLogcreated_atDATETIME是创建时间普通
sys_audit_logAuditLogupdated_byBIGINT否最后更新人账号 ID普通
sys_audit_logAuditLogupdated_atDATETIME否最后更新时间普通
sys_audit_logAuditLogis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_audit_logAuditLogdeleted_atDATETIME否删除时间，未删除为空普通
sys_audit_logAuditLogdeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_audit_logAuditLogversionINT是乐观锁版本号，写操作必须校验普通
sys_audit_logAuditLogoperator_idBIGINT是操作人 ID普通
sys_audit_logAuditLogbiz_typeVARCHAR(64)是业务类型普通
sys_audit_logAuditLogbiz_idBIGINT否业务主键 ID普通
sys_audit_logAuditLogaction_codeVARCHAR(64)是操作编码普通
sys_audit_logAuditLogbefore_snapshotJSON否变更前快照普通
sys_audit_logAuditLogafter_snapshotJSON否变更后快照普通
sys_audit_logAuditLogip_addressVARCHAR(64)否操作 IP普通
int_integration_logIntegrationLogidBIGINT是主键，雪花或号段生成，禁止复用普通
int_integration_logIntegrationLogtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
int_integration_logIntegrationLogorg_idBIGINT否所属组织，集团级或公共配置为空普通
int_integration_logIntegrationLogcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
int_integration_logIntegrationLogcreated_byBIGINT是创建人账号 ID普通
int_integration_logIntegrationLogcreated_atDATETIME是创建时间普通
int_integration_logIntegrationLogupdated_byBIGINT否最后更新人账号 ID普通
int_integration_logIntegrationLogupdated_atDATETIME否最后更新时间普通
int_integration_logIntegrationLogis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
int_integration_logIntegrationLogdeleted_atDATETIME否删除时间，未删除为空普通
int_integration_logIntegrationLogdeleted_byBIGINT否删除人账号 ID，未删除为空普通
int_integration_logIntegrationLogversionINT是乐观锁版本号，写操作必须校验普通
int_integration_logIntegrationLogrequest_idVARCHAR(128)是请求 ID，幂等键普通
int_integration_logIntegrationLogsystem_codeVARCHAR(64)是外部系统编码普通
int_integration_logIntegrationLogapi_pathVARCHAR(512)是接口路径普通
int_integration_logIntegrationLogbiz_typeVARCHAR(64)否业务类型普通
int_integration_logIntegrationLogbiz_idBIGINT否业务 ID普通
int_integration_logIntegrationLogrequest_payloadJSON否请求报文，敏感字段脱敏敏感
int_integration_logIntegrationLogresponse_payloadJSON否响应报文普通
int_integration_logIntegrationLogcall_statusVARCHAR(32)是成功/失败/超时/重试中普通
sec_sensitive_field_policySensitiveFieldPolicyidBIGINT是主键，雪花或号段生成，禁止复用普通
sec_sensitive_field_policySensitiveFieldPolicytenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sec_sensitive_field_policySensitiveFieldPolicyorg_idBIGINT否所属组织，集团级或公共配置为空普通
sec_sensitive_field_policySensitiveFieldPolicycampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sec_sensitive_field_policySensitiveFieldPolicycreated_byBIGINT是创建人账号 ID普通
sec_sensitive_field_policySensitiveFieldPolicycreated_atDATETIME是创建时间普通
sec_sensitive_field_policySensitiveFieldPolicyupdated_byBIGINT否最后更新人账号 ID普通
sec_sensitive_field_policySensitiveFieldPolicyupdated_atDATETIME否最后更新时间普通
sec_sensitive_field_policySensitiveFieldPolicyis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sec_sensitive_field_policySensitiveFieldPolicydeleted_atDATETIME否删除时间，未删除为空普通
sec_sensitive_field_policySensitiveFieldPolicydeleted_byBIGINT否删除人账号 ID，未删除为空普通
sec_sensitive_field_policySensitiveFieldPolicyversionINT是乐观锁版本号，写操作必须校验普通
sec_sensitive_field_policySensitiveFieldPolicyfield_codeVARCHAR(128)是字段编码，唯一普通
sec_sensitive_field_policySensitiveFieldPolicybiz_typeVARCHAR(64)是业务类型普通
sec_sensitive_field_policySensitiveFieldPolicymask_ruleVARCHAR(64)是脱敏规则普通
sec_sensitive_field_policySensitiveFieldPolicyview_requires_approvalTINYINT是明文查看是否需审批普通
sec_sensitive_field_policySensitiveFieldPolicywatermark_requiredTINYINT是是否加水印普通
sys_legal_entityLegalEntityidBIGINT是主键，雪花或号段生成，禁止复用普通
sys_legal_entityLegalEntitytenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
sys_legal_entityLegalEntityorg_idBIGINT否所属组织，集团级或公共配置为空普通
sys_legal_entityLegalEntitycampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
sys_legal_entityLegalEntitycreated_byBIGINT是创建人账号 ID普通
sys_legal_entityLegalEntitycreated_atDATETIME是创建时间普通
sys_legal_entityLegalEntityupdated_byBIGINT否最后更新人账号 ID普通
sys_legal_entityLegalEntityupdated_atDATETIME否最后更新时间普通
sys_legal_entityLegalEntityis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
sys_legal_entityLegalEntitydeleted_atDATETIME否删除时间，未删除为空普通
sys_legal_entityLegalEntitydeleted_byBIGINT否删除人账号 ID，未删除为空普通
sys_legal_entityLegalEntityversionINT是乐观锁版本号，写操作必须校验普通
sys_legal_entityLegalEntityentity_codeVARCHAR(64)是主体编码，唯一普通
sys_legal_entityLegalEntityentity_nameVARCHAR(128)是主体名称普通
sys_legal_entityLegalEntitytaxpayer_noVARCHAR(64)是纳税人识别号敏感
sys_legal_entityLegalEntitybank_account_noVARCHAR(64)否银行账号，展示需脱敏敏感
sys_legal_entityLegalEntityinvoice_ruleJSON否开票与核验规则普通
sys_legal_entityLegalEntityenabledTINYINT是是否启用普通
con_contractContractidBIGINT是主键，雪花或号段生成，禁止复用普通
con_contractContracttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
con_contractContractorg_idBIGINT否所属组织，集团级或公共配置为空普通
con_contractContractcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
con_contractContractcreated_byBIGINT是创建人账号 ID普通
con_contractContractcreated_atDATETIME是创建时间普通
con_contractContractupdated_byBIGINT否最后更新人账号 ID普通
con_contractContractupdated_atDATETIME否最后更新时间普通
con_contractContractis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
con_contractContractdeleted_atDATETIME否删除时间，未删除为空普通
con_contractContractdeleted_byBIGINT否删除人账号 ID，未删除为空普通
con_contractContractversionINT是乐观锁版本号，写操作必须校验普通
con_contractContractcontract_noVARCHAR(64)是合同编号，唯一普通
con_contractContractstudent_idBIGINT是学员 ID普通
con_contractContractfamily_idBIGINT否客户家庭 ID普通
con_contractContracttemplate_idBIGINT是合同模板 ID普通
con_contractContractemployee_idBIGINT否创建合同的销售/市场/课程顾问员工 ID普通
con_contractContractsource_terminalVARCHAR(32)是来源终端，教师端 App/小程序或 PC 管理端普通
con_contractContractsimulation_idBIGINT否关联优惠试算 ID普通
con_contractContractextra_discount_apply_idBIGINT否关联额外折扣申请 ID普通
con_contractContracthand_sign_statusVARCHAR(32)是待手写签字/已手写签字/签字作废普通
con_contractContractsign_statusVARCHAR(32)是待家长签署/已手写签字/已作废普通
con_contractContractpayment_statusVARCHAR(32)是待支付/支付中/支付成功/支付失败/已关闭普通
con_contractContractenterprise_seal_statusVARCHAR(32)是未触发/盖章中/已盖章/盖章失败/已归档普通
con_contractContractcontract_statusVARCHAR(32)是草稿/生效/履约中/已终止/已退费普通
con_contractContractsupervision_statusVARCHAR(32)否监管报送状态普通
con_contractContractcurrencyVARCHAR(8)是币种，默认 CNY普通
con_contractContractamountDECIMAL(18,2)是含税金额，必须大于等于 0普通
con_contractContracttax_amountDECIMAL(18,2)否税额，按发票或税率计算普通
con_contractContractapproval_statusVARCHAR(32)否审批状态，未发起为空普通
con_contractContractapproval_instance_idBIGINT否关联审批实例 ID普通
ord_orderOrderidBIGINT是主键，雪花或号段生成，禁止复用普通
ord_orderOrdertenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
ord_orderOrderorg_idBIGINT否所属组织，集团级或公共配置为空普通
ord_orderOrdercampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
ord_orderOrdercreated_byBIGINT是创建人账号 ID普通
ord_orderOrdercreated_atDATETIME是创建时间普通
ord_orderOrderupdated_byBIGINT否最后更新人账号 ID普通
ord_orderOrderupdated_atDATETIME否最后更新时间普通
ord_orderOrderis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
ord_orderOrderdeleted_atDATETIME否删除时间，未删除为空普通
ord_orderOrderdeleted_byBIGINT否删除人账号 ID，未删除为空普通
ord_orderOrderversionINT是乐观锁版本号，写操作必须校验普通
ord_orderOrderorder_noVARCHAR(64)是订单编号，唯一普通
ord_orderOrdercontract_idBIGINT是合同 ID普通
ord_orderOrderstudent_idBIGINT是学员 ID普通
ord_orderOrderreceivable_amountDECIMAL(18,2)是应收金额普通
ord_orderOrderdiscount_amountDECIMAL(18,2)否优惠金额普通
ord_orderOrderpaid_amountDECIMAL(18,2)是已收金额普通
ord_orderOrderorder_statusVARCHAR(32)是待支付/支付中/已支付/已关闭普通
ord_paymentPaymentidBIGINT是主键，雪花或号段生成，禁止复用普通
ord_paymentPaymenttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
ord_paymentPaymentorg_idBIGINT否所属组织，集团级或公共配置为空普通
ord_paymentPaymentcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
ord_paymentPaymentcreated_byBIGINT是创建人账号 ID普通
ord_paymentPaymentcreated_atDATETIME是创建时间普通
ord_paymentPaymentupdated_byBIGINT否最后更新人账号 ID普通
ord_paymentPaymentupdated_atDATETIME否最后更新时间普通
ord_paymentPaymentis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
ord_paymentPaymentdeleted_atDATETIME否删除时间，未删除为空普通
ord_paymentPaymentdeleted_byBIGINT否删除人账号 ID，未删除为空普通
ord_paymentPaymentversionINT是乐观锁版本号，写操作必须校验普通
ord_paymentPaymentpayment_noVARCHAR(64)是收款单号，唯一普通
ord_paymentPaymentorder_idBIGINT是订单 ID普通
ord_paymentPaymentpay_channelVARCHAR(32)是微信/支付宝/银行卡/现金/监管账户普通
ord_paymentPaymentpaid_amountDECIMAL(18,2)是实收金额普通
ord_paymentPaymentpaid_atDATETIME否支付完成时间普通
ord_paymentPaymentchannel_trade_noVARCHAR(128)否渠道流水号普通
ord_paymentPaymentsupervision_account_idBIGINT否资金监管账户 ID普通
ord_paymentPaymentreceipt_statusVARCHAR(32)是待确认/已确认/异常普通
edu_consumptionConsumptionidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_consumptionConsumptiontenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_consumptionConsumptionorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_consumptionConsumptioncampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_consumptionConsumptioncreated_byBIGINT是创建人账号 ID普通
edu_consumptionConsumptioncreated_atDATETIME是创建时间普通
edu_consumptionConsumptionupdated_byBIGINT否最后更新人账号 ID普通
edu_consumptionConsumptionupdated_atDATETIME否最后更新时间普通
edu_consumptionConsumptionis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_consumptionConsumptiondeleted_atDATETIME否删除时间，未删除为空普通
edu_consumptionConsumptiondeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_consumptionConsumptionversionINT是乐观锁版本号，写操作必须校验普通
edu_consumptionConsumptionlesson_idBIGINT是课次 ID普通
edu_consumptionConsumptionstudent_idBIGINT是学员 ID普通
edu_consumptionConsumptioncontract_idBIGINT是合同 ID普通
edu_consumptionConsumptionconsumed_hoursDECIMAL(8,2)是消耗课时普通
edu_consumptionConsumptionconsume_amountDECIMAL(18,2)否课消金额普通
edu_consumptionConsumptionconsume_statusVARCHAR(32)是待确认/已课消/已冲销/异常普通
mat_stock_inStockInidBIGINT是主键，雪花或号段生成，禁止复用普通
mat_stock_inStockIntenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
mat_stock_inStockInorg_idBIGINT否所属组织，集团级或公共配置为空普通
mat_stock_inStockIncampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
mat_stock_inStockIncreated_byBIGINT是创建人账号 ID普通
mat_stock_inStockIncreated_atDATETIME是创建时间普通
mat_stock_inStockInupdated_byBIGINT否最后更新人账号 ID普通
mat_stock_inStockInupdated_atDATETIME否最后更新时间普通
mat_stock_inStockInis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
mat_stock_inStockIndeleted_atDATETIME否删除时间，未删除为空普通
mat_stock_inStockIndeleted_byBIGINT否删除人账号 ID，未删除为空普通
mat_stock_inStockInversionINT是乐观锁版本号，写操作必须校验普通
mat_stock_inStockInstock_in_noVARCHAR(64)是入库单编号，唯一普通
mat_stock_inStockInwarehouse_idBIGINT是入库仓库普通
mat_stock_inStockInsupplier_idBIGINT否供应商 ID普通
mat_stock_inStockInsource_biz_noVARCHAR(64)否来源单号普通
mat_stock_inStockInline_itemsJSON是入库明细普通
mat_stock_inStockInstock_in_statusVARCHAR(32)是草稿/待审核/已入库/已作废普通
mat_stock_inStockInapproval_statusVARCHAR(32)否审批状态，未发起为空普通
mat_stock_inStockInapproval_instance_idBIGINT否关联审批实例 ID普通
mat_stock_outStockOutidBIGINT是主键，雪花或号段生成，禁止复用普通
mat_stock_outStockOuttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
mat_stock_outStockOutorg_idBIGINT否所属组织，集团级或公共配置为空普通
mat_stock_outStockOutcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
mat_stock_outStockOutcreated_byBIGINT是创建人账号 ID普通
mat_stock_outStockOutcreated_atDATETIME是创建时间普通
mat_stock_outStockOutupdated_byBIGINT否最后更新人账号 ID普通
mat_stock_outStockOutupdated_atDATETIME否最后更新时间普通
mat_stock_outStockOutis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
mat_stock_outStockOutdeleted_atDATETIME否删除时间，未删除为空普通
mat_stock_outStockOutdeleted_byBIGINT否删除人账号 ID，未删除为空普通
mat_stock_outStockOutversionINT是乐观锁版本号，写操作必须校验普通
mat_stock_outStockOutstock_out_noVARCHAR(64)是出库单编号，唯一普通
mat_stock_outStockOutwarehouse_idBIGINT是出库仓库普通
mat_stock_outStockOutuse_sceneVARCHAR(32)是教学/办公/积分兑换/报损/调拨普通
mat_stock_outStockOutsource_biz_noVARCHAR(64)否来源单号普通
mat_stock_outStockOutline_itemsJSON是出库明细普通
mat_stock_outStockOutstock_out_statusVARCHAR(32)是草稿/待审核/已出库/已作废普通
mat_stock_outStockOutapproval_statusVARCHAR(32)否审批状态，未发起为空普通
mat_stock_outStockOutapproval_instance_idBIGINT否关联审批实例 ID普通
hr_payslipPayrollPayslipidBIGINT是主键，雪花或号段生成，禁止复用普通
hr_payslipPayrollPaysliptenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
hr_payslipPayrollPaysliporg_idBIGINT否所属组织，集团级或公共配置为空普通
hr_payslipPayrollPayslipcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
hr_payslipPayrollPayslipcreated_byBIGINT是创建人账号 ID普通
hr_payslipPayrollPayslipcreated_atDATETIME是创建时间普通
hr_payslipPayrollPayslipupdated_byBIGINT否最后更新人账号 ID普通
hr_payslipPayrollPayslipupdated_atDATETIME否最后更新时间普通
hr_payslipPayrollPayslipis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
hr_payslipPayrollPayslipdeleted_atDATETIME否删除时间，未删除为空普通
hr_payslipPayrollPayslipdeleted_byBIGINT否删除人账号 ID，未删除为空普通
hr_payslipPayrollPayslipversionINT是乐观锁版本号，写操作必须校验普通
hr_payslipPayrollPayslippayslip_noVARCHAR(64)是工资条编号，唯一普通
hr_payslipPayrollPayslipbatch_idBIGINT是薪酬批次 ID普通
hr_payslipPayrollPayslipemployee_idBIGINT是员工 ID普通
hr_payslipPayrollPayslipgross_salaryDECIMAL(18,2)是应发工资普通
hr_payslipPayrollPayslipnet_salaryDECIMAL(18,2)是实发工资普通
hr_payslipPayrollPayslipshow_social_insuranceTINYINT是是否显示社保信息普通
hr_payslipPayrollPayslipshow_housing_fundTINYINT是是否显示公积金信息普通
hr_payslipPayrollPayslipconfirm_statusVARCHAR(32)是待确认/已确认/有异议普通

JSON 字段结构与校验

表名对象字段结构编码结构定义校验规则示例
fin_account_setAccountSetfiscal_calendarFINANCE_CALENDAR{periods:[{periodCode:string,startDate:string,endDate:string,status:string}], closeRule:object}期间不可重叠；关闭期间禁止新增凭证{"periods":[{"periodCode":"2026-06","status":"OPEN"}]}
fin_subjectFinanceSubjectassist_ruleFINANCE_ASSIST{dimensions:[{code:string, required:boolean, refType:string}], values:object}辅助核算维度必须符合科目规则{"dimensions":[{"code":"CAMPUS","required":true,"refType":"campus"}]}
fin_voucher_entryFinanceVoucherEntryassist_payloadSUPERVISION_PAYLOAD{bizType:string, contractNo:string, amount:number, student:object, attachments:number[]}报送字段必须满足教育局/监管账户配置的必填规则{"bizType":"CONTRACT","contractNo":"DNC20260628001","amount":6800}
exp_invoiceInvoiceocr_resultINVOICE_OCR{invoiceCode:string, invoiceNo:string, issueDate:string, amount:number, taxAmount:number, confidence:number, fields:object}低置信度字段必须进入人工校正{"invoiceNo":"12345678","amount":128.80,"confidence":0.96}
exp_invoice_verificationInvoiceVerificationofficial_payloadSUPERVISION_PAYLOAD{bizType:string, contractNo:string, amount:number, student:object, attachments:number[]}报送字段必须满足教育局/监管账户配置的必填规则{"bizType":"CONTRACT","contractNo":"DNC20260628001","amount":6800}
exp_invoice_verificationInvoiceVerificationofficial_receiptSUPERVISION_RECEIPT{receiptNo:string, status:string, receivedAt:string, rawFileId?:number, errorCode?:string}回执不可覆盖，重报生成新版本{"receiptNo":"REG20260628001","status":"SUCCESS"}
tax_declarationTaxReportdeclaration_payloadSUPERVISION_PAYLOAD{bizType:string, contractNo:string, amount:number, student:object, attachments:number[]}报送字段必须满足教育局/监管账户配置的必填规则{"bizType":"CONTRACT","contractNo":"DNC20260628001","amount":6800}

状态/枚举标准字典

表名对象字段枚举编码取值终态/流转规则字段说明
fin_account_setAccountSettenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
fin_account_setAccountSetis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
fin_account_setAccountSetenabledENABLED_STATUS0 停用、1 启用非终态，可按状态机或字典规则流转是否启用
fin_subjectFinanceSubjecttenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
fin_subjectFinanceSubjectis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
fin_subjectFinanceSubjectsubject_typeSUBJECT_TYPE资产、负债、收入、成本、费用、权益非终态，可按状态机或字典规则流转资产/负债/收入/成本/费用/权益
fin_subjectFinanceSubjectenabledENABLED_STATUS0 停用、1 启用非终态，可按状态机或字典规则流转是否启用
fin_voucherFinanceVouchertenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
fin_voucherFinanceVoucheris_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
fin_voucherFinanceVouchersource_biz_typeSOURCE_BIZ_TYPEMARKETING_FORM 活动表单、LIVE_PUBLIC 公开课直播、CRM_IMPORT CRM导入、PARENT_REFERRAL 家长转介绍、SERVICE_TICKET 服务工单、PAYMENT 支付、DEVICE_EVENT 设备事件、MANUAL 手工录入非终态，可按状态机或字典规则流转来源业务类型
fin_voucherFinanceVouchervoucher_statusVOUCHER_STATUSDRAFT 草稿、PENDING_REVIEW 待审核、APPROVED 已审核、POSTED 已过账、REVERSED 已红冲非终态，可按状态机或字典规则流转草稿/待审核/已审核/已过账/已红冲
fin_voucherFinanceVoucherapproval_statusAPPROVAL_STATUSNOT_STARTED 未发起、PENDING 审批中、APPROVED 已通过、REJECTED 已驳回、REVOKED 已撤回非终态，可按状态机或字典规则流转审批状态，未发起为空
fin_voucher_entryFinanceVoucherEntrytenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
fin_voucher_entryFinanceVoucherEntryis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
exp_reportExpenseReporttenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
exp_reportExpenseReportis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
exp_reportExpenseReportexpense_typeEXPENSE_TYPE差旅、办公、采购、市场、其他非终态，可按状态机或字典规则流转差旅/办公/采购/市场/其他
exp_reportExpenseReportexpense_statusEXPENSE_STATUS草稿、待审批、待付款、已付款、已驳回非终态，可按状态机或字典规则流转草稿/待审批/待付款/已付款/已驳回
exp_reportExpenseReportapproval_statusAPPROVAL_STATUSNOT_STARTED 未发起、PENDING 审批中、APPROVED 已通过、REJECTED 已驳回、REVOKED 已撤回非终态，可按状态机或字典规则流转审批状态，未发起为空
exp_invoiceInvoicetenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
exp_invoiceInvoiceis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
exp_invoiceInvoiceinvoice_typeINVOICE_TYPE专票、普票、电子票、其他非终态，可按状态机或字典规则流转专票/普票/电子票/其他
exp_invoiceInvoiceduplicate_statusDUPLICATE_STATUS未查重、重复、未重复非终态，可按状态机或字典规则流转未查重/重复/未重复
exp_invoice_verificationInvoiceVerificationtenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
exp_invoice_verificationInvoiceVerificationis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
exp_invoice_verificationInvoiceVerificationofficial_app_codeOFFICIAL_APP_CODE国税接口主体、编码配置非终态，可按状态机或字典规则流转国税接口主体/编码配置
exp_invoice_verificationInvoiceVerificationverification_statusVERIFICATION_STATUS待核验、通过、不通过、异常、重试中非终态，可按状态机或字典规则流转待核验/通过/不通过/异常/重试中
exp_payment_applyExpensePaymentApplytenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
exp_payment_applyExpensePaymentApplyis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
exp_payment_applyExpensePaymentApplypayment_statusPAYMENT_STATUSPENDING 待支付/待付款、PROCESSING 处理中、SUCCESS 成功、FAILED 失败、CLOSED 已关闭包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程待付款/付款中/成功/失败
tax_declarationTaxReporttenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
tax_declarationTaxReportis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
tax_declarationTaxReporttax_typeTAX_TYPE增值税、所得税、附加税、其他非终态，可按状态机或字典规则流转增值税/所得税/附加税/其他
tax_declarationTaxReportdeclaration_statusDECLARATION_STATUS草稿、待申报、已申报、失败包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程草稿/待申报/已申报/失败

敏感字段与数据安全策略

来源表名对象字段数据级别脱敏/返回策略明文查看条件导出策略审计要求端侧展示规则
本模块对象fin_voucherFinanceVouchervoucher_no普通BIZ_FIELD_MASK按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行导出时按数据级别触发审批、水印、下载有效期和日志查看、修改、删除、导出、下载和审批均记录操作审计默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
本模块对象fin_voucher_entryFinanceVoucherEntryvoucher_id普通BIZ_FIELD_MASK按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行导出时按数据级别触发审批、水印、下载有效期和日志查看、修改、删除、导出、下载和审批均记录操作审计默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
本模块对象fin_voucher_entryFinanceVoucherEntryassist_payload普通PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
本模块对象exp_invoiceInvoiceinvoice_no普通TAX_INVOICE_MASK默认按税号/发票号局部脱敏；发票原图、OCR 结果和国税回执按财务权限查看财务导出需审批并加水印；国税官方回执随业务单归档OCR、核验、查重、人工校正、导出和付款阻断均留痕移动端可上传和查看本人报销结果，不展示其他人员票据明文
本模块对象exp_invoiceInvoiceinvoice_code普通TAX_INVOICE_MASK默认按税号/发票号局部脱敏；发票原图、OCR 结果和国税回执按财务权限查看财务导出需审批并加水印；国税官方回执随业务单归档OCR、核验、查重、人工校正、导出和付款阻断均留痕移动端可上传和查看本人报销结果，不展示其他人员票据明文
本模块对象exp_invoiceInvoiceinvoice_type普通TAX_INVOICE_MASK默认按税号/发票号局部脱敏；发票原图、OCR 结果和国税回执按财务权限查看财务导出需审批并加水印；国税官方回执随业务单归档OCR、核验、查重、人工校正、导出和付款阻断均留痕移动端可上传和查看本人报销结果，不展示其他人员票据明文
本模块对象exp_invoiceInvoiceseller_tax_no敏感TAX_INVOICE_MASK默认按税号/发票号局部脱敏；发票原图、OCR 结果和国税回执按财务权限查看财务导出需审批并加水印；国税官方回执随业务单归档OCR、核验、查重、人工校正、导出和付款阻断均留痕移动端可上传和查看本人报销结果，不展示其他人员票据明文
本模块对象exp_invoiceInvoicebuyer_tax_no敏感TAX_INVOICE_MASK默认按税号/发票号局部脱敏；发票原图、OCR 结果和国税回执按财务权限查看财务导出需审批并加水印；国税官方回执随业务单归档OCR、核验、查重、人工校正、导出和付款阻断均留痕移动端可上传和查看本人报销结果，不展示其他人员票据明文
本模块对象exp_invoice_verificationInvoiceVerificationinvoice_id普通TAX_INVOICE_MASK默认按税号/发票号局部脱敏；发票原图、OCR 结果和国税回执按财务权限查看财务导出需审批并加水印；国税官方回执随业务单归档OCR、核验、查重、人工校正、导出和付款阻断均留痕移动端可上传和查看本人报销结果，不展示其他人员票据明文
本模块对象exp_invoice_verificationInvoiceVerificationofficial_payload普通PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
本模块对象exp_payment_applyExpensePaymentApplypayee_account敏感BANK_ACCOUNT_MASK默认展示后 4 位；付款、报销、工资发放场景按岗位权限展示导出银行账号必须走财务/安全双审批查看、变更、付款使用、导出均记录业务单号和操作者财务 PC 可按权限明文；员工端和移动端默认脱敏
本模块对象tax_declarationTaxReportdeclaration_payload普通PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
引用对象sys_userUser/Employeemobile敏感MOBILE_MASK默认展示 138****0000；明文查看需字段权限或敏感字段查看审批导出手机号必须触发导出审批、下载水印和有效期控制明文查看、复制、导出和批量下载均写入 SensitiveAccessLogPC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息
引用对象sys_userUser/Employeepassword_hash高敏NEVER_RETURN禁止接口返回明文；仅密钥中心/鉴权服务按服务身份读取密钥引用禁止导出；配置导出只允许导出脱敏引用和启停状态配置新增、修改、启停、轮换和失败读取均记录安全审计前端只展示已配置/未配置、到期时间和连通性状态，不展示密钥值
引用对象int_integration_logIntegrationLogrequest_payload敏感PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
引用对象int_integration_logIntegrationLogresponse_payload普通PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
引用对象sec_sensitive_field_policySensitiveFieldPolicymask_rule普通BIZ_FIELD_MASK按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行导出时按数据级别触发审批、水印、下载有效期和日志查看、修改、删除、导出、下载和审批均记录操作审计默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
引用对象sys_legal_entityLegalEntitytaxpayer_no敏感TAX_INVOICE_MASK默认按税号/发票号局部脱敏；发票原图、OCR 结果和国税回执按财务权限查看财务导出需审批并加水印；国税官方回执随业务单归档OCR、核验、查重、人工校正、导出和付款阻断均留痕移动端可上传和查看本人报销结果，不展示其他人员票据明文
引用对象sys_legal_entityLegalEntitybank_account_no敏感BANK_ACCOUNT_MASK默认展示后 4 位；付款、报销、工资发放场景按岗位权限展示导出银行账号必须走财务/安全双审批查看、变更、付款使用、导出均记录业务单号和操作者财务 PC 可按权限明文；员工端和移动端默认脱敏
引用对象sys_legal_entityLegalEntityinvoice_rule普通TAX_INVOICE_MASK默认按税号/发票号局部脱敏；发票原图、OCR 结果和国税回执按财务权限查看财务导出需审批并加水印；国税官方回执随业务单归档OCR、核验、查重、人工校正、导出和付款阻断均留痕移动端可上传和查看本人报销结果，不展示其他人员票据明文
引用对象con_contractContracttax_amount普通TAX_INVOICE_MASK默认按税号/发票号局部脱敏；发票原图、OCR 结果和国税回执按财务权限查看财务导出需审批并加水印；国税官方回执随业务单归档OCR、核验、查重、人工校正、导出和付款阻断均留痕移动端可上传和查看本人报销结果，不展示其他人员票据明文
引用对象ord_paymentPaymentpay_channel普通BANK_ACCOUNT_MASK默认展示后 4 位；付款、报销、工资发放场景按岗位权限展示导出银行账号必须走财务/安全双审批查看、变更、付款使用、导出均记录业务单号和操作者财务 PC 可按权限明文；员工端和移动端默认脱敏
引用对象hr_payslipPayrollPayslippayslip_no普通PAYROLL_MASK默认仅本人和授权人力/财务可见；社保、公积金字段按后台开关展示工资条批量导出必须走高敏审批并限制下载次数发布、撤回、重发、查看、确认、异议、导出全链路审计教师/员工端仅查看本人电子工资条；PC 按岗位与审批展示
引用对象hr_payslipPayrollPayslipgross_salary普通PAYROLL_MASK默认仅本人和授权人力/财务可见；社保、公积金字段按后台开关展示工资条批量导出必须走高敏审批并限制下载次数发布、撤回、重发、查看、确认、异议、导出全链路审计教师/员工端仅查看本人电子工资条；PC 按岗位与审批展示
引用对象hr_payslipPayrollPayslipnet_salary普通PAYROLL_MASK默认仅本人和授权人力/财务可见；社保、公积金字段按后台开关展示工资条批量导出必须走高敏审批并限制下载次数发布、撤回、重发、查看、确认、异议、导出全链路审计教师/员工端仅查看本人电子工资条；PC 按岗位与审批展示

核心数据表完整字段

表名对象字段类型必填规则数据级别
fin_account_setAccountSetidBIGINT是主键，雪花或号段生成，禁止复用普通
fin_account_setAccountSettenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
fin_account_setAccountSetorg_idBIGINT否所属组织，集团级或公共配置为空普通
fin_account_setAccountSetcampus_idBIGINT是所属校区，跨校区或总部级数据为空；本表业务要求必填普通
fin_account_setAccountSetcreated_byBIGINT是创建人账号 ID普通
fin_account_setAccountSetcreated_atDATETIME是创建时间普通
fin_account_setAccountSetupdated_byBIGINT否最后更新人账号 ID普通
fin_account_setAccountSetupdated_atDATETIME否最后更新时间普通
fin_account_setAccountSetis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
fin_account_setAccountSetdeleted_atDATETIME否删除时间，未删除为空普通
fin_account_setAccountSetdeleted_byBIGINT否删除人账号 ID，未删除为空普通
fin_account_setAccountSetversionINT是乐观锁版本号，写操作必须校验普通
fin_account_setAccountSetaccount_set_codeVARCHAR(64)是账套编码，唯一普通
fin_account_setAccountSetaccount_set_nameVARCHAR(128)是账套名称普通
fin_account_setAccountSetfiscal_calendarJSON是会计期间配置普通
fin_account_setAccountSettax_subject_idBIGINT是税务主体 ID普通
fin_account_setAccountSetenabledTINYINT是是否启用普通
fin_subjectFinanceSubjectidBIGINT是主键，雪花或号段生成，禁止复用普通
fin_subjectFinanceSubjecttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
fin_subjectFinanceSubjectorg_idBIGINT否所属组织，集团级或公共配置为空普通
fin_subjectFinanceSubjectcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
fin_subjectFinanceSubjectcreated_byBIGINT是创建人账号 ID普通
fin_subjectFinanceSubjectcreated_atDATETIME是创建时间普通
fin_subjectFinanceSubjectupdated_byBIGINT否最后更新人账号 ID普通
fin_subjectFinanceSubjectupdated_atDATETIME否最后更新时间普通
fin_subjectFinanceSubjectis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
fin_subjectFinanceSubjectdeleted_atDATETIME否删除时间，未删除为空普通
fin_subjectFinanceSubjectdeleted_byBIGINT否删除人账号 ID，未删除为空普通
fin_subjectFinanceSubjectversionINT是乐观锁版本号，写操作必须校验普通
fin_subjectFinanceSubjectaccount_set_idBIGINT是账套 ID普通
fin_subjectFinanceSubjectsubject_codeVARCHAR(64)是科目编码普通
fin_subjectFinanceSubjectsubject_nameVARCHAR(128)是科目名称普通
fin_subjectFinanceSubjectsubject_typeVARCHAR(32)是资产/负债/收入/成本/费用/权益普通
fin_subjectFinanceSubjectassist_ruleJSON否辅助核算规则普通
fin_subjectFinanceSubjectenabledTINYINT是是否启用普通
fin_voucherFinanceVoucheridBIGINT是主键，雪花或号段生成，禁止复用普通
fin_voucherFinanceVouchertenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
fin_voucherFinanceVoucherorg_idBIGINT否所属组织，集团级或公共配置为空普通
fin_voucherFinanceVouchercampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
fin_voucherFinanceVouchercreated_byBIGINT是创建人账号 ID普通
fin_voucherFinanceVouchercreated_atDATETIME是创建时间普通
fin_voucherFinanceVoucherupdated_byBIGINT否最后更新人账号 ID普通
fin_voucherFinanceVoucherupdated_atDATETIME否最后更新时间普通
fin_voucherFinanceVoucheris_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
fin_voucherFinanceVoucherdeleted_atDATETIME否删除时间，未删除为空普通
fin_voucherFinanceVoucherdeleted_byBIGINT否删除人账号 ID，未删除为空普通
fin_voucherFinanceVoucherversionINT是乐观锁版本号，写操作必须校验普通
fin_voucherFinanceVouchervoucher_noVARCHAR(64)是凭证编号，账套期间内唯一普通
fin_voucherFinanceVoucheraccount_set_idBIGINT是账套 ID普通
fin_voucherFinanceVoucherperiod_codeVARCHAR(32)是会计期间普通
fin_voucherFinanceVouchersource_biz_typeVARCHAR(64)否来源业务类型普通
fin_voucherFinanceVouchersource_biz_noVARCHAR(64)否来源业务编号普通
fin_voucherFinanceVouchervoucher_statusVARCHAR(32)是草稿/待审核/已审核/已过账/已红冲普通
fin_voucherFinanceVoucherapproval_statusVARCHAR(32)否审批状态，未发起为空普通
fin_voucherFinanceVoucherapproval_instance_idBIGINT否关联审批实例 ID普通
fin_voucher_entryFinanceVoucherEntryidBIGINT是主键，雪花或号段生成，禁止复用普通
fin_voucher_entryFinanceVoucherEntrytenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
fin_voucher_entryFinanceVoucherEntryorg_idBIGINT否所属组织，集团级或公共配置为空普通
fin_voucher_entryFinanceVoucherEntrycampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
fin_voucher_entryFinanceVoucherEntrycreated_byBIGINT是创建人账号 ID普通
fin_voucher_entryFinanceVoucherEntrycreated_atDATETIME是创建时间普通
fin_voucher_entryFinanceVoucherEntryupdated_byBIGINT否最后更新人账号 ID普通
fin_voucher_entryFinanceVoucherEntryupdated_atDATETIME否最后更新时间普通
fin_voucher_entryFinanceVoucherEntryis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
fin_voucher_entryFinanceVoucherEntrydeleted_atDATETIME否删除时间，未删除为空普通
fin_voucher_entryFinanceVoucherEntrydeleted_byBIGINT否删除人账号 ID，未删除为空普通
fin_voucher_entryFinanceVoucherEntryversionINT是乐观锁版本号，写操作必须校验普通
fin_voucher_entryFinanceVoucherEntryvoucher_idBIGINT是凭证 ID普通
fin_voucher_entryFinanceVoucherEntryentry_noINT是分录行号普通
fin_voucher_entryFinanceVoucherEntrysubject_idBIGINT是会计科目 ID普通
fin_voucher_entryFinanceVoucherEntryassist_payloadJSON否辅助核算信息普通
fin_voucher_entryFinanceVoucherEntrydebit_amountDECIMAL(18,2)是借方金额普通
fin_voucher_entryFinanceVoucherEntrycredit_amountDECIMAL(18,2)是贷方金额普通
fin_voucher_entryFinanceVoucherEntrysummaryVARCHAR(255)是摘要普通
exp_reportExpenseReportidBIGINT是主键，雪花或号段生成，禁止复用普通
exp_reportExpenseReporttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
exp_reportExpenseReportorg_idBIGINT否所属组织，集团级或公共配置为空普通
exp_reportExpenseReportcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
exp_reportExpenseReportcreated_byBIGINT是创建人账号 ID普通
exp_reportExpenseReportcreated_atDATETIME是创建时间普通
exp_reportExpenseReportupdated_byBIGINT否最后更新人账号 ID普通
exp_reportExpenseReportupdated_atDATETIME否最后更新时间普通
exp_reportExpenseReportis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
exp_reportExpenseReportdeleted_atDATETIME否删除时间，未删除为空普通
exp_reportExpenseReportdeleted_byBIGINT否删除人账号 ID，未删除为空普通
exp_reportExpenseReportversionINT是乐观锁版本号，写操作必须校验普通
exp_reportExpenseReportexpense_noVARCHAR(64)是报销单编号，唯一普通
exp_reportExpenseReportapplicant_idBIGINT是申请人 ID普通
exp_reportExpenseReportexpense_typeVARCHAR(32)是差旅/办公/采购/市场/其他普通
exp_reportExpenseReporttotal_amountDECIMAL(18,2)是报销总额普通
exp_reportExpenseReportexpense_statusVARCHAR(32)是草稿/待审批/待付款/已付款/已驳回普通
exp_reportExpenseReportapproval_statusVARCHAR(32)否审批状态，未发起为空普通
exp_reportExpenseReportapproval_instance_idBIGINT否关联审批实例 ID普通
exp_invoiceInvoiceidBIGINT是主键，雪花或号段生成，禁止复用普通
exp_invoiceInvoicetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
exp_invoiceInvoiceorg_idBIGINT否所属组织，集团级或公共配置为空普通
exp_invoiceInvoicecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
exp_invoiceInvoicecreated_byBIGINT是创建人账号 ID普通
exp_invoiceInvoicecreated_atDATETIME是创建时间普通
exp_invoiceInvoiceupdated_byBIGINT否最后更新人账号 ID普通
exp_invoiceInvoiceupdated_atDATETIME否最后更新时间普通
exp_invoiceInvoiceis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
exp_invoiceInvoicedeleted_atDATETIME否删除时间，未删除为空普通
exp_invoiceInvoicedeleted_byBIGINT否删除人账号 ID，未删除为空普通
exp_invoiceInvoiceversionINT是乐观锁版本号，写操作必须校验普通
exp_invoiceInvoiceinvoice_noVARCHAR(64)是发票号码普通
exp_invoiceInvoiceinvoice_codeVARCHAR(64)否发票代码普通
exp_invoiceInvoiceinvoice_typeVARCHAR(32)是专票/普票/电子票/其他普通
exp_invoiceInvoiceseller_tax_noVARCHAR(64)否销售方税号敏感
exp_invoiceInvoicebuyer_tax_noVARCHAR(64)否购买方税号敏感
exp_invoiceInvoiceocr_resultJSON否OCR 识别结果普通
exp_invoiceInvoiceduplicate_statusVARCHAR(32)是未查重/重复/未重复普通
exp_invoice_verificationInvoiceVerificationidBIGINT是主键，雪花或号段生成，禁止复用普通
exp_invoice_verificationInvoiceVerificationtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
exp_invoice_verificationInvoiceVerificationorg_idBIGINT否所属组织，集团级或公共配置为空普通
exp_invoice_verificationInvoiceVerificationcampus_idBIGINT是所属校区，跨校区或总部级数据为空；本表业务要求必填普通
exp_invoice_verificationInvoiceVerificationcreated_byBIGINT是创建人账号 ID普通
exp_invoice_verificationInvoiceVerificationcreated_atDATETIME是创建时间普通
exp_invoice_verificationInvoiceVerificationupdated_byBIGINT否最后更新人账号 ID普通
exp_invoice_verificationInvoiceVerificationupdated_atDATETIME否最后更新时间普通
exp_invoice_verificationInvoiceVerificationis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
exp_invoice_verificationInvoiceVerificationdeleted_atDATETIME否删除时间，未删除为空普通
exp_invoice_verificationInvoiceVerificationdeleted_byBIGINT否删除人账号 ID，未删除为空普通
exp_invoice_verificationInvoiceVerificationversionINT是乐观锁版本号，写操作必须校验普通
exp_invoice_verificationInvoiceVerificationverification_noVARCHAR(64)是核验编号，唯一普通
exp_invoice_verificationInvoiceVerificationtax_subject_idBIGINT是税务主体配置 ID普通
exp_invoice_verificationInvoiceVerificationofficial_app_codeVARCHAR(128)是国税接口主体/编码配置普通
exp_invoice_verificationInvoiceVerificationinvoice_idBIGINT是发票 ID普通
exp_invoice_verificationInvoiceVerificationofficial_payloadJSON是官方请求参数普通
exp_invoice_verificationInvoiceVerificationofficial_receiptJSON否官方核验回执普通
exp_invoice_verificationInvoiceVerificationverification_statusVARCHAR(32)是待核验/通过/不通过/异常/重试中普通
exp_payment_applyExpensePaymentApplyidBIGINT是主键，雪花或号段生成，禁止复用普通
exp_payment_applyExpensePaymentApplytenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
exp_payment_applyExpensePaymentApplyorg_idBIGINT否所属组织，集团级或公共配置为空普通
exp_payment_applyExpensePaymentApplycampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
exp_payment_applyExpensePaymentApplycreated_byBIGINT是创建人账号 ID普通
exp_payment_applyExpensePaymentApplycreated_atDATETIME是创建时间普通
exp_payment_applyExpensePaymentApplyupdated_byBIGINT否最后更新人账号 ID普通
exp_payment_applyExpensePaymentApplyupdated_atDATETIME否最后更新时间普通
exp_payment_applyExpensePaymentApplyis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
exp_payment_applyExpensePaymentApplydeleted_atDATETIME否删除时间，未删除为空普通
exp_payment_applyExpensePaymentApplydeleted_byBIGINT否删除人账号 ID，未删除为空普通
exp_payment_applyExpensePaymentApplyversionINT是乐观锁版本号，写操作必须校验普通
exp_payment_applyExpensePaymentApplypayment_apply_noVARCHAR(64)是付款申请编号，唯一普通
exp_payment_applyExpensePaymentApplyexpense_report_idBIGINT是报销单 ID普通
exp_payment_applyExpensePaymentApplypayee_idBIGINT是收款人 ID普通
exp_payment_applyExpensePaymentApplypayee_accountVARCHAR(128)是收款账号，敏感敏感
exp_payment_applyExpensePaymentApplypay_amountDECIMAL(18,2)是付款金额普通
exp_payment_applyExpensePaymentApplypayment_statusVARCHAR(32)是待付款/付款中/成功/失败普通
tax_declarationTaxReportidBIGINT是主键，雪花或号段生成，禁止复用普通
tax_declarationTaxReporttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
tax_declarationTaxReportorg_idBIGINT否所属组织，集团级或公共配置为空普通
tax_declarationTaxReportcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
tax_declarationTaxReportcreated_byBIGINT是创建人账号 ID普通
tax_declarationTaxReportcreated_atDATETIME是创建时间普通
tax_declarationTaxReportupdated_byBIGINT否最后更新人账号 ID普通
tax_declarationTaxReportupdated_atDATETIME否最后更新时间普通
tax_declarationTaxReportis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
tax_declarationTaxReportdeleted_atDATETIME否删除时间，未删除为空普通
tax_declarationTaxReportdeleted_byBIGINT否删除人账号 ID，未删除为空普通
tax_declarationTaxReportversionINT是乐观锁版本号，写操作必须校验普通
tax_declarationTaxReportdeclaration_noVARCHAR(64)是申报编号，唯一普通
tax_declarationTaxReportaccount_set_idBIGINT是账套 ID普通
tax_declarationTaxReporttax_periodVARCHAR(32)是税期普通
tax_declarationTaxReporttax_typeVARCHAR(32)是增值税/所得税/附加税/其他普通
tax_declarationTaxReportdeclaration_payloadJSON是申报资料普通
tax_declarationTaxReportdeclaration_statusVARCHAR(32)是草稿/待申报/已申报/失败普通

数据表与对象映射

表名对象用途完整字段索引建议
fin_account_setAccountSet每校区独立账套id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT,必填)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、account_set_code(VARCHAR(64),必填)、account_set_name(VARCHAR(128),必填)、fiscal_calendar(JSON,必填)、tax_subject_id(BIGINT,必填)、enabled(TINYINT,必填)uk_account_set_code、uk_campus
fin_subjectFinanceSubject会计科目和辅助核算id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、account_set_id(BIGINT,必填)、subject_code(VARCHAR(64),必填)、subject_name(VARCHAR(128),必填)、subject_type(VARCHAR(32),必填)、assist_rule(JSON)、enabled(TINYINT,必填)uk_set_subject、idx_type_enabled
fin_voucherFinanceVoucher会计凭证id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、voucher_no(VARCHAR(64),必填)、account_set_id(BIGINT,必填)、period_code(VARCHAR(32),必填)、source_biz_type(VARCHAR(64))、source_biz_no(VARCHAR(64))、voucher_status(VARCHAR(32),必填)、approval_status(VARCHAR(32))、approval_instance_id(BIGINT)uk_set_period_voucher、idx_source、idx_status
fin_voucher_entryFinanceVoucherEntry凭证明细分录id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、voucher_id(BIGINT,必填)、entry_no(INT,必填)、subject_id(BIGINT,必填)、assist_payload(JSON)、debit_amount(DECIMAL(18,2),必填)、credit_amount(DECIMAL(18,2),必填)、summary(VARCHAR(255),必填)uk_voucher_entry、idx_subject
exp_reportExpenseReport合思式报销单id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、expense_no(VARCHAR(64),必填)、applicant_id(BIGINT,必填)、expense_type(VARCHAR(32),必填)、total_amount(DECIMAL(18,2),必填)、expense_status(VARCHAR(32),必填)、approval_status(VARCHAR(32))、approval_instance_id(BIGINT)uk_expense_no、idx_applicant_status
exp_invoiceInvoice报销发票与 OCR 结果id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、invoice_no(VARCHAR(64),必填)、invoice_code(VARCHAR(64))、invoice_type(VARCHAR(32),必填)、seller_tax_no(VARCHAR(64))、buyer_tax_no(VARCHAR(64))、ocr_result(JSON)、duplicate_status(VARCHAR(32),必填)idx_invoice_no、idx_duplicate
exp_invoice_verificationInvoiceVerification国税官方发票核验id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT,必填)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、verification_no(VARCHAR(64),必填)、tax_subject_id(BIGINT,必填)、official_app_code(VARCHAR(128),必填)、invoice_id(BIGINT,必填)、official_payload(JSON,必填)、official_receipt(JSON)、verification_status(VARCHAR(32),必填)uk_verification_no、idx_invoice_status
exp_payment_applyExpensePaymentApply报销付款申请id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、payment_apply_no(VARCHAR(64),必填)、expense_report_id(BIGINT,必填)、payee_id(BIGINT,必填)、payee_account(VARCHAR(128),必填)、pay_amount(DECIMAL(18,2),必填)、payment_status(VARCHAR(32),必填)uk_payment_apply_no、idx_report_status
tax_declarationTaxReport纳税申报资料和报表id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、declaration_no(VARCHAR(64),必填)、account_set_id(BIGINT,必填)、tax_period(VARCHAR(32),必填)、tax_type(VARCHAR(32),必填)、declaration_payload(JSON,必填)、declaration_status(VARCHAR(32),必填)uk_set_period_tax、idx_status

12 · 状态机与业务规则

约束业务对象如何流转、何时可编辑、何时触发审批

原型需要把状态标签、可操作按钮和禁用原因展示清楚。
对象状态触发与说明
合同草稿 -> 待审批 -> 待签署 -> 已签署 -> 已备案 -> 已收款 -> 履约中 -> 已结课 -> 已退费 -> 已作废优惠审批、电子签、监管备案、收款、课消、退费
课次未开始 -> 待签到 -> 已签到 -> 已课消 -> 请假 -> 补课 -> 旷课 -> 异常待确认排课发布、签到、课消、请假、补课和人工确认
监管报送待生成 -> 待报送 -> 报送中 -> 成功 -> 失败 -> 待重报 -> 人工处理合同备案、收款、课消、退费报送与回执
退费单草稿 -> 待学管确认 -> 待校长审批 -> 待财务复核 -> 监管退款中 -> 已退款 -> 已驳回 -> 已取消退费测算、审批、退款回执和凭证冲销
报销单草稿 -> 待 OCR -> 待核验 -> 待审批 -> 已通过 -> 待付款 -> 已付款 -> 已驳回 -> 已作废员工填单、票据识别、发票核验、查重、审批、付款归档
账套期间未开启 -> 记账中 -> 待结账 -> 已结账 -> 反结账中 -> 已锁定凭证录入、审核、过账、结账、反结账和总部复核
物料库存待入库 -> 在库 -> 已锁定 -> 已出库 -> 调拨中 -> 盘点中 -> 已报废采购入库、领用、兑换锁库、调拨、盘点、报废
积分兑换待锁库 -> 已锁库 -> 待核销 -> 已核销 -> 已取消 -> 已退回学员兑换、库存锁定、前台核销、出库、取消和积分退回
工单新建 -> 已分派 -> 处理中 -> 待家长确认 -> 已关闭 -> 已升级 -> 已驳回投诉建议、服务请求、教学反馈和退费咨询
活动页面模板草稿 -> 待审核 -> 已上架 -> 已驳回 -> 已下架 -> 已归档模板创建、转模板提交、审核、上架、下架、归档和复用
请假补课草稿 -> 待审批 -> 已同意 -> 已驳回 -> 已取消 -> 补课待安排 -> 补课待确认 -> 补课已预约 -> 已补课 -> 已关闭家长请假、教务审批、课消冻结或回滚、补课安排、家长确认和补课完成
积分兑换售后待处理 -> 积分退回中 -> 库存释放中 -> 已完成 -> 失败待人工 -> 已关闭兑换取消、过期未核销、核销撤销和库存回滚
采购对账付款询价中 -> 待审批 -> 待下单 -> 待入库 -> 入库差异 -> 待对账 -> 对账不平 -> 待付款 -> 已付款 -> 已退货 -> 已关闭采购申请、入库、对账、付款、退货和凭证归档
电子工资条待生成 -> 待审核 -> 待发布 -> 已发布 -> 员工已查看 -> 异议中 -> 已确认 -> 已归档薪资核算、审批、发布、员工查看确认、异议处理和归档
人脸授权撤回已提交 -> 家长已确认 -> 设备删除中 -> 部分失败 -> 已删除 -> 人工处理 -> 已关闭家长撤回、人脸模板删除任务、设备回执、失败重试和审计
补课改期取消已确认 -> 改期申请中 -> 取消申请中 -> 教务处理中 -> 已重新安排 -> 已拒绝 -> 已关闭 -> 待冲正 -> 已冲正家长发起改期或取消，教务处理候选课次和课消冲正，最终回到补课安排或关闭
回放补传替换录制失败 -> 待补传 -> 审核中 -> 已发布 -> 替换中 -> 已替换 -> 已通知 -> 已驳回 -> 已下架录制失败或回放损坏后人工补传、审核、版本替换、通知和学习记录处理
积分实物售后已领取 -> 售后申请中 -> 待返库 -> 待换新 -> 待报损 -> 积分返还中 -> 已完成 -> 已拒绝礼品领取后退换货、坏损、返库报损、积分返还和库存流水处理
库存成本策略草稿 -> 待审核 -> 已启用 -> 已停用 -> 待重算 -> 重算中 -> 已归档成本计价规则配置、审批、生效、停用和历史成本处理
督课评分规则版本草稿 -> 待审核 -> 已发布 -> 已生效 -> 已停用 -> 已归档评分维度、权重和生效范围配置后审批发布，历史评分按版本追溯
工资条撤回重发已发布 -> 撤回中 -> 已撤回 -> 重发待审核 -> 已重发 -> 待重新确认 -> 已确认 -> 已归档工资条发布错误后撤回、重发、员工重新确认和版本留痕
国税核验配置草稿 -> 启用中 -> 频控中 -> 异常 -> 已停用 -> 已过期校区税务主体、官方接口凭证、额度、启用状态和调用日志
线索客户合并仲裁待识别 -> 撞单待处理 -> 合并中 -> 仲裁中 -> 已合并 -> 已裁定 -> 误合并恢复中线索撞单、客户合并、归属争议仲裁和恢复
付款失败补偿付款失败 -> 待重试 -> 重试中 -> 换账户中 -> 撤销审批中 -> 线下付款登记 -> 已补偿 -> 人工关闭报销、采购、退款、工资付款失败后的统一补偿
教师端工作台任务待处理 -> 处理中 -> 已完成 -> 已驳回 -> 已超时 -> 已取消课程、批改、审批、培训、报销、工资条和直播任务统一进入工作台待办，并按业务模块回写处理状态。
唯一性校验

财务业财中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

跨校区数据隔离

财务业财中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

敏感操作留痕

财务业财中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

外部接口幂等

财务业财中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

批量失败明细

财务业财中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

状态回退审批

财务业财中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

13 · 权限、审批与消息

动作权限、数据范围、审批触发和消息触达必须闭环

权限需要覆盖菜单、按钮、字段、接口和导出。

动作权限

  • 收款对账：需映射菜单、按钮、接口和字段权限
  • 监管报送：需映射菜单、按钮、接口和字段权限
  • 报销核验：需映射菜单、按钮、接口和字段权限
  • 付款台账：需映射菜单、按钮、接口和字段权限
  • 付款重试：需映射菜单、按钮、接口和字段权限
  • 凭证记账：需映射菜单、按钮、接口和字段权限
  • 税务申报：需映射菜单、按钮、接口和字段权限
  • 账套结账：需映射菜单、按钮、接口和字段权限

数据范围

  • 总部全量
  • 区域辖区
  • 校区本地
  • 部门/岗位
  • 本人负责
  • 授权班级/学员

审批配置

审批名称触发条件流程结果留痕
合同优惠审批折扣低于总部配置阈值或赠课超过上限顾问提交 -> 销售主管 -> 校长 -> 财务抄送通过后合同可签署，驳回后返回报价草稿保留优惠前后金额和审批意见
退费审批任意退费或转课产生金额冲减学管师确认 -> 校长审批 -> 财务复核通过后进入监管退款，驳回后关闭退费单保留测算明细、附件和退款回执
报销审批员工提交费用报销或发票查重命中风险员工提交 -> 部门主管 -> 校长/预算负责人 -> 财务复核通过后进入付款，驳回后返回报销人修改保留票据影像、OCR 结果、核验结果、查重结果和审批意见
账套反结账审批已结账期间需要反结账或更正税务资料校区财务提交 -> 总部财务复核 -> 财务负责人终审通过后解锁期间并记录调整原因保留反结账前后凭证、税表和审批说明
物料采购审批采购金额超过阈值、跨校区采购或固定资产采购申请人 -> 校区负责人 -> 采购/财务 -> 总部审批通过后生成采购订单和到货验收任务保留预算、供应商、报价和采购合同附件
合同作废审批已签署或已收款合同作废顾问提交 -> 校长 -> 财务合同作废并回滚相关权益保留作废原因和关联订单
课消撤销审批已确认收入的课消记录撤销教务提交 -> 校长 -> 财务撤销课消、恢复课时、冲回收入记录原课次和撤销原因
人脸授权撤回处理家长撤回人脸授权家长提交 -> 系统确认 -> 设备管理员执行停止识别并下发删除任务保留撤回凭证和删除结果

消息模板

消息接收人触发渠道变量
收款成功通知家长/顾问/财务支付成功小程序、站内信订单金额、课程、支付时间
报销审批提醒审批人/财务报销单提交、超时或驳回后重提站内信、App、企微报销人、费用类型、金额、票据风险、审批入口
发票重复预警报销人/财务发票查重命中疑似重复站内信、App发票号码、金额、历史报销单、风险等级
库存预警库管/校区负责人物料或礼品低于安全库存站内信、App、企微SKU、校区、当前库存、安全库存、补货建议
签到异常提醒教务/前台识别未匹配或低置信度站内信、App设备、时间、候选学员、置信度
课消提醒家长正式课消完成小程序、App课程名称、消课课时、剩余课时
退费审批提醒校长/财务退费单提交站内信、App合同编号、测算金额、申请原因
活动模板审核通知模板创建人/区域市场/总部品牌自建页面转模板提交、审核通过、审核驳回站内信、企微、App模板名称、提交人、审核状态、驳回原因、处理入口

14 · 接口与技术细节

接口需支持幂等、权限、审计、重试和回执

每个写接口必须有 requestId 或业务幂等键，外部回调必须验签和去重。
接口方法方向请求字段响应字段幂等/权限
/api/v1/expenses/invoices/ocrPOSTPC Web/移动端到内置票据 OCR 服务fileId, employeeId, expenseTypeinvoiceCode, amount, taxNo, ocrConfidencefileHash 查重
/api/v1/tax/invoices/verifyPOST平台到国税官方发票核验接口campusId, taxSubjectId, invoiceCode, invoiceNo, amount, taxNoverifyStatus, duplicateResult, riskTips校区税务主体配置 + 发票代码 + 号码唯一
/api/v1/account-setsPOST/GETPC Web 到财务campusId, fiscalCalendar, subjectTemplateaccountSetId, currentPeriod, status每校区单账套唯一
/api/v1/finance/payment-ledgersPOST/GETPC Web 到财务sourceBizType, sourceBizNo, payeeInfo, amount, accountSetId, requestIdpaymentLedgerId, paymentStatus, voucherStatussourceBizNo 幂等
/api/v1/finance/vouchersPOST业务到总账sourceBizType, sourceBizNo, entries, requestIdvoucherId, voucherNo, postStatus来源单号幂等
/api/v1/regulator/consumptionsPOST平台到监管lessonId, contractNo, consumedHours, amountreportBatchNo, reportStatuslessonId + contractNo 去重

前端约束

  • 统一登录态和租户校区上下文
  • 列表分页、筛选、排序、列显隐
  • 表单本地校验与服务端错误映射
  • 移动/平板/TV 按终端适配交互

后端约束

  • 领域服务封装业务规则
  • 写操作事务一致性
  • 关键操作审计快照
  • 异步任务失败重试和告警

集成约束

  • 第三方接口统一走开放集成中心
  • 回执文件归档
  • 接口日志可按业务单号追踪
  • 密钥和回调地址按环境隔离

15 · 数据库与存储设计

核心表建议、关键字段和索引方向

详细 DDL 已在平台技术设计文档中统一展开，本处保留模块核心表、关键字段和索引方向。
表名用途核心字段索引建议
fin_account_set每校区独立账套id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、account_set_code、account_set_name、fiscal_calendar、tax_subject_id、enableduk_account_set_code、uk_campus
fin_subject会计科目和辅助核算id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、account_set_id、subject_code、subject_name、subject_type、assist_rule、enableduk_set_subject、idx_type_enabled
fin_voucher会计凭证id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、voucher_no、account_set_id、period_code、source_biz_type、source_biz_no、voucher_status、approval_status、approval_instance_iduk_set_period_voucher、idx_source、idx_status
fin_voucher_entry凭证明细分录id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、voucher_id、entry_no、subject_id、assist_payload、debit_amount、credit_amount、summaryuk_voucher_entry、idx_subject
exp_report合思式报销单id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、expense_no、applicant_id、expense_type、total_amount、expense_status、approval_status、approval_instance_iduk_expense_no、idx_applicant_status
exp_invoice报销发票与 OCR 结果id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、invoice_no、invoice_code、invoice_type、seller_tax_no、buyer_tax_no、ocr_result、duplicate_statusidx_invoice_no、idx_duplicate
exp_invoice_verification国税官方发票核验id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、verification_no、tax_subject_id、official_app_code、invoice_id、official_payload、official_receipt、verification_statusuk_verification_no、idx_invoice_status
exp_payment_apply报销付款申请id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、payment_apply_no、expense_report_id、payee_id、payee_account、pay_amount、payment_statusuk_payment_apply_no、idx_report_status
tax_declaration纳税申报资料和报表id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、declaration_no、account_set_id、tax_period、tax_type、declaration_payload、declaration_statusuk_set_period_tax、idx_status

DDL 草案

fin_account_setAccountSet 
CREATE TABLE `fin_account_set` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NOT NULL COMMENT '所属校区，跨校区或总部级数据为空；本表业务要求必填；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `account_set_code` VARCHAR(64) NOT NULL COMMENT '账套编码，唯一；数据级别：普通',
  `account_set_name` VARCHAR(128) NOT NULL COMMENT '账套名称；数据级别：普通',
  `fiscal_calendar` JSON NOT NULL COMMENT '会计期间配置；数据级别：普通',
  `tax_subject_id` BIGINT NOT NULL COMMENT '税务主体 ID；数据级别：普通',
  `enabled` TINYINT NOT NULL COMMENT '是否启用；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_account_set_code` (`account_set_code`),
  UNIQUE KEY `uk_campus` (`campus_id`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='AccountSet：每校区独立账套';
fin_subjectFinanceSubject 
CREATE TABLE `fin_subject` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `account_set_id` BIGINT NOT NULL COMMENT '账套 ID；数据级别：普通',
  `subject_code` VARCHAR(64) NOT NULL COMMENT '科目编码；数据级别：普通',
  `subject_name` VARCHAR(128) NOT NULL COMMENT '科目名称；数据级别：普通',
  `subject_type` VARCHAR(32) NOT NULL COMMENT '资产/负债/收入/成本/费用/权益；数据级别：普通',
  `assist_rule` JSON NULL COMMENT '辅助核算规则；数据级别：普通',
  `enabled` TINYINT NOT NULL COMMENT '是否启用；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_set_subject` (`account_set_id`, `subject_code`),
  KEY `idx_type_enabled` (`subject_type`, `enabled`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FinanceSubject：会计科目和辅助核算';
fin_voucherFinanceVoucher 
CREATE TABLE `fin_voucher` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `voucher_no` VARCHAR(64) NOT NULL COMMENT '凭证编号，账套期间内唯一；数据级别：普通',
  `account_set_id` BIGINT NOT NULL COMMENT '账套 ID；数据级别：普通',
  `period_code` VARCHAR(32) NOT NULL COMMENT '会计期间；数据级别：普通',
  `source_biz_type` VARCHAR(64) NULL COMMENT '来源业务类型；数据级别：普通',
  `source_biz_no` VARCHAR(64) NULL COMMENT '来源业务编号；数据级别：普通',
  `voucher_status` VARCHAR(32) NOT NULL COMMENT '草稿/待审核/已审核/已过账/已红冲；数据级别：普通',
  `approval_status` VARCHAR(32) NULL COMMENT '审批状态，未发起为空；数据级别：普通',
  `approval_instance_id` BIGINT NULL COMMENT '关联审批实例 ID；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_set_period_voucher` (`account_set_id`, `period_code`, `voucher_no`),
  KEY `idx_source` (`source_biz_type`),
  KEY `idx_status` (`voucher_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FinanceVoucher：会计凭证';
fin_voucher_entryFinanceVoucherEntry 
CREATE TABLE `fin_voucher_entry` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `voucher_id` BIGINT NOT NULL COMMENT '凭证 ID；数据级别：普通',
  `entry_no` INT NOT NULL COMMENT '分录行号；数据级别：普通',
  `subject_id` BIGINT NOT NULL COMMENT '会计科目 ID；数据级别：普通',
  `assist_payload` JSON NULL COMMENT '辅助核算信息；数据级别：普通',
  `debit_amount` DECIMAL(18,2) NOT NULL COMMENT '借方金额；数据级别：普通',
  `credit_amount` DECIMAL(18,2) NOT NULL COMMENT '贷方金额；数据级别：普通',
  `summary` VARCHAR(255) NOT NULL COMMENT '摘要；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_voucher_entry` (`voucher_id`, `entry_no`),
  KEY `idx_subject` (`subject_id`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FinanceVoucherEntry：凭证明细分录';
exp_reportExpenseReport 
CREATE TABLE `exp_report` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `expense_no` VARCHAR(64) NOT NULL COMMENT '报销单编号，唯一；数据级别：普通',
  `applicant_id` BIGINT NOT NULL COMMENT '申请人 ID；数据级别：普通',
  `expense_type` VARCHAR(32) NOT NULL COMMENT '差旅/办公/采购/市场/其他；数据级别：普通',
  `total_amount` DECIMAL(18,2) NOT NULL COMMENT '报销总额；数据级别：普通',
  `expense_status` VARCHAR(32) NOT NULL COMMENT '草稿/待审批/待付款/已付款/已驳回；数据级别：普通',
  `approval_status` VARCHAR(32) NULL COMMENT '审批状态，未发起为空；数据级别：普通',
  `approval_instance_id` BIGINT NULL COMMENT '关联审批实例 ID；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_expense_no` (`expense_no`),
  KEY `idx_applicant_status` (`applicant_id`, `expense_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ExpenseReport：合思式报销单';
exp_invoiceInvoice 
CREATE TABLE `exp_invoice` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `invoice_no` VARCHAR(64) NOT NULL COMMENT '发票号码；数据级别：普通',
  `invoice_code` VARCHAR(64) NULL COMMENT '发票代码；数据级别：普通',
  `invoice_type` VARCHAR(32) NOT NULL COMMENT '专票/普票/电子票/其他；数据级别：普通',
  `seller_tax_no` VARCHAR(64) NULL COMMENT '销售方税号；数据级别：敏感',
  `buyer_tax_no` VARCHAR(64) NULL COMMENT '购买方税号；数据级别：敏感',
  `ocr_result` JSON NULL COMMENT 'OCR 识别结果；数据级别：普通',
  `duplicate_status` VARCHAR(32) NOT NULL COMMENT '未查重/重复/未重复；数据级别：普通',
  PRIMARY KEY (`id`),
  KEY `idx_invoice_no` (`invoice_no`),
  KEY `idx_duplicate` (`duplicate_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Invoice：报销发票与 OCR 结果';
exp_invoice_verificationInvoiceVerification 
CREATE TABLE `exp_invoice_verification` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NOT NULL COMMENT '所属校区，跨校区或总部级数据为空；本表业务要求必填；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `verification_no` VARCHAR(64) NOT NULL COMMENT '核验编号，唯一；数据级别：普通',
  `tax_subject_id` BIGINT NOT NULL COMMENT '税务主体配置 ID；数据级别：普通',
  `official_app_code` VARCHAR(128) NOT NULL COMMENT '国税接口主体/编码配置；数据级别：普通',
  `invoice_id` BIGINT NOT NULL COMMENT '发票 ID；数据级别：普通',
  `official_payload` JSON NOT NULL COMMENT '官方请求参数；数据级别：普通',
  `official_receipt` JSON NULL COMMENT '官方核验回执；数据级别：普通',
  `verification_status` VARCHAR(32) NOT NULL COMMENT '待核验/通过/不通过/异常/重试中；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_verification_no` (`verification_no`),
  KEY `idx_invoice_status` (`invoice_id`, `verification_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='InvoiceVerification：国税官方发票核验';
exp_payment_applyExpensePaymentApply 
CREATE TABLE `exp_payment_apply` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `payment_apply_no` VARCHAR(64) NOT NULL COMMENT '付款申请编号，唯一；数据级别：普通',
  `expense_report_id` BIGINT NOT NULL COMMENT '报销单 ID；数据级别：普通',
  `payee_id` BIGINT NOT NULL COMMENT '收款人 ID；数据级别：普通',
  `payee_account` VARCHAR(128) NOT NULL COMMENT '收款账号，敏感；数据级别：敏感',
  `pay_amount` DECIMAL(18,2) NOT NULL COMMENT '付款金额；数据级别：普通',
  `payment_status` VARCHAR(32) NOT NULL COMMENT '待付款/付款中/成功/失败；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_payment_apply_no` (`payment_apply_no`),
  KEY `idx_report_status` (`expense_report_id`, `payment_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ExpensePaymentApply：报销付款申请';
tax_declarationTaxReport 
CREATE TABLE `tax_declaration` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `declaration_no` VARCHAR(64) NOT NULL COMMENT '申报编号，唯一；数据级别：普通',
  `account_set_id` BIGINT NOT NULL COMMENT '账套 ID；数据级别：普通',
  `tax_period` VARCHAR(32) NOT NULL COMMENT '税期；数据级别：普通',
  `tax_type` VARCHAR(32) NOT NULL COMMENT '增值税/所得税/附加税/其他；数据级别：普通',
  `declaration_payload` JSON NOT NULL COMMENT '申报资料；数据级别：普通',
  `declaration_status` VARCHAR(32) NOT NULL COMMENT '草稿/待申报/已申报/失败；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_set_period_tax` (`account_set_id`, `tax_period`),
  KEY `idx_status` (`declaration_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='TaxReport：纳税申报资料和报表';

16 · 异常、指标、测试与初始化

保证模块上线后可运营、可追踪、可验收

测试要覆盖主流程、异常流、权限流、接口失败和数据一致性。

异常状态

流水不匹配发票重复报销账套期间未结账付款账户缺失付款失败付款撤销待审付款凭证缺失付款二次失败官方核验频控成本科目缺失

指标埋点

收款对账成功率发票核验通过率重复报销拦截率凭证生成成功率税务申报完成率

测试用例

编号场景前置步骤预期优先级
TC-005电子合同签署和收款合同模板启用生成合同、家长签署、支付合同已签署、订单已收款、权益生效高
TC-008人脸签到自动课消学员已授权人脸且课次待签到模拟设备回传识别事件签到成功、课消成功、家长收到通知高
TC-009人脸未匹配异常设备回传未绑定人员提交识别事件进入异常队列，可人工确认或忽略高
TC-010家长撤回人脸授权学员已授权并下发设备家长撤回授权系统停止识别并生成设备删除任务高
TC-015退费审批和监管退款合同有剩余权益提交退费、审批、模拟退款回执退款完成、课时冻结、收入和提成冲回高
TC-016内置凭证入账失败重推科目映射缺失生成凭证失败后补充科目并重推凭证编号回写，失败记录关闭高
TC-017薪资课酬核算教师授课和课消数据完整执行月度薪资核算课酬、提成、冲回金额计算正确中
TC-023按钮权限控制顾问账号无退费审批权限进入退费单详情可查看授权数据但不可审批高
TC-027设备离线补传设备离线后产生识别记录恢复网络并补传事件流水去重后生成签到或异常高
TC-028重复识别时间窗同一学员短时间多次扫脸连续提交识别事件仅生成一次有效签到和课消高
TC-FIN-ENH-001报销复刻交付闭环验收报销单、发票识别、发票核验、付款单相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐报销单、OCR、国税核验、发票查重、防重复报销、审批和付款归档。执行前端提交、后端处理、状态流转、异常重试和消息触达发票核验结果、查重结果、审批和付款状态完整可见。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FIN-ENH-002账套税务交付闭环验收账套管理、凭证录入、期间结账、纳税申报相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐每校区独立账套、总部统管、凭证、科目、结账、反结账、报税和财务报表。执行前端提交、后端处理、状态流转、异常重试和消息触达总部财务能查看和管理所有校区账套。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FIN-ENH-003资金闭环交付闭环验收付款台账、对账差异、监管报送相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐付款失败重试、对账差异、人工关闭、凭证冲正和监管报送。执行前端提交、后端处理、状态流转、异常重试和消息触达每笔资金动作都可查状态、凭证、回执和补偿记录。；同时产生审计日志、指标埋点和必要的补偿任务高

上线初始化

初始化项动作数据验收
课程与价格导入课程、班型、课包、课时、价格、适用校区课程编码、班型、价格表、有效期、赠课规则报价和合同可正确引用价格
审批规则配置优惠、退费、转课、导出、薪资、课消撤销审批流审批对象、条件、节点、超时提醒测试单据可进入正确审批链
财务科目配置收款、预收、课消收入、退费、薪资、报销和内置科目映射科目、辅助核算、校区、项目、部门凭证可生成并写入测试账套
多账套会计按校区初始化独立账套、会计期间、凭证字、科目和税务参数账套编码、法人主体、校区、期间、税种、申报模板校区账套可独立记账，总部可汇总和复核
监管账户维护资金监管账户和教育局监管平台参数账户编号、校区映射、接口地址、证书、回调合同、收款、课消、退费可报送测试
设备参数登记人脸考勤机设备和校区绑定设备编号、位置、API 密钥、心跳阈值、识别阈值设备心跳正常且可接收人员下发
物料资产初始化物料分类、SKU、供应商、仓库、库存、固定资产和图书台账SKU 编码、单位、条码、安全库存、资产编号、库存余额采购、入库、领用、调拨和盘点可正常执行
积分商城配置积分规则、礼品 SKU、兑换积分、核销校区和库存联动积分来源、积分有效期、礼品库存、兑换规则、核销权限学员兑换后可锁库，前台核销后可出库
报销复刻交付配置初始化补齐报销单、OCR、国税核验、发票查重、防重复报销、审批和付款归档。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限报销单、发票识别、发票核验、付款单发票核验结果、查重结果、审批和付款状态完整可见。
账套税务交付配置初始化补齐每校区独立账套、总部统管、凭证、科目、结账、反结账、报税和财务报表。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限账套管理、凭证录入、期间结账、纳税申报总部财务能查看和管理所有校区账套。
资金闭环交付配置初始化补齐付款失败重试、对账差异、人工关闭、凭证冲正和监管报送。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限付款台账、对账差异、监管报送每笔资金动作都可查状态、凭证、回执和补偿记录。