# 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
```python
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