yumoqing
e3c19bc359
- Updated financial_core.py - Updated models/receivables.json - Added mysql.ddl.sql - Added API files: debug_receivables, receivables CRUD, test_env - Added UI files: financial_vouchers, index, payments, receipts, receivable_edit, receivables
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