Financial Management Module

Overview

This module provides comprehensive financial management capabilities with order-level granularity for receivables and payments. It integrates seamlessly with the existing contract management and order management modules.

Features Implemented

2.4.1 收支管理

应收款管理（订单维度优化）

自动立应收: 按订单生成应收计划，每个订单对应独立应收记录
账期监控: 按订单维度跟踪账期，超期30天自动推送通知，合同详情页汇总展示应收状态

收款管理（新增订单关联）

收款录入: 财务录入收款时关联订单，系统校验收款金额≤订单应收金额
收款分配: 支持同一笔收款覆盖多个订单的批量关联和手动分配比例
凭证生成: 收款凭证同时显示合同编号与订单编号，便于财务对账

订单与合同的财务数据联动

合同层面: 自动汇总所有关联订单的总应收/已收款/剩余应收金额，展示合同收款完成率
订单层面: 完成收款后自动更新订单状态，并同步触发合同履约进度

支出管理

支出关联: 提交支出需关联已核销（确认收款的审批）对应合同的已收款

Database Schema

Core Tables

receivables: 应收记录表（按订单维度）
receipts: 收款记录表
receipt_allocations: 收款分配表（处理多订单分配）
payments: 支出记录表
financial_vouchers: 财务凭证表

Key Relationships

应收记录关联订单和合同
收款记录通过分配表关联多个订单
财务凭证关联合同和订单
支出记录关联已核销收款的合同

Integration Points

Contract Management Module

自动从订单生成应收记录
收款完成后触发合同履约进度更新
合同财务数据汇总展示

Order Management Module

订单状态自动更新为"已收款"
订单财务数据实时同步

RBAC Module

多租户数据隔离（org_id）
用户权限控制

Usage

Initialization

from financial_management import load_financial_management
load_financial_management()

Key Functions

create_receivable_from_order(order_id, org_id): 从订单创建应收记录
create_receipt(receipt_data, user_id, org_id): 创建收款记录
get_contract_financial_summary(contract_id, org_id): 获取合同财务汇总
send_overdue_notifications(org_id, days_overdue=30): 发送逾期通知
create_payment(payment_data, user_id, org_id): 创建支出记录

Scheduled Tasks

Daily Overdue Notification: 每天上午10点检查逾期应收记录并发送通知

Development Standards

Follows module-development-spec directory structure
Uses sqlor-database-module for database operations
Implements bricks-framework for frontend interfaces
Adheres to database-table-definition-spec and crud-definition-spec
Production-ready code with complete error handling and validation

3.0 KiB Raw Blame History Unescape Escape