# Kylin Risk Control

金融风控扩展包 — 风险评估、授信审批、贷后监控、反洗钱。

## 功能特性

- **风险评估**（Risk Assessment）：A/B/C 卡评分模型、风险等级评定、审批建议
- **授信审批**（Credit Approval）：多级审批流程、额度管理、合规审查
- **贷后监控**（Post-Loan Monitoring）：五级分类、预警规则引擎、催收管理
- **反洗钱**（AML）：大额交易识别、可疑交易监测、报告生成

## 安装

```bash
composer require kylin/risk-control
```

## 配置发布

```bash
php artisan vendor:publish --tag=kylin-risk-control-config
```

## 配置说明

```php
// config/kylin-risk-control.php
return [
    'scoring' => [
        'range' => ['min' => 300, 'max' => 850],
        'weights' => [
            'a_card' => 0.50,            // 申请评分卡权重
            'b_card' => 0.30,            // 行为评分卡权重
            'c_card' => 0.20,            // 催收评分卡权重
        ],
    ],
    'approval' => [
        'levels' => [
            'level_1' => 50000,           // 一级审批限额（元）
            'level_2' => 200000,          // 二级审批限额（元）
            'level_3' => 500000,          // 三级审批限额（元）
        ],
    ],
    'classification' => [
        'levels' => ['正常', '关注', '次级', '可疑', '损失'],
        'review_interval_days' => 90,     // 五级分类重审间隔（天）
    ],
    'aml' => [
        'large_threshold' => 50000,       // 大额交易阈值（元）
        'cash_threshold' => 200000,       // 现金交易报告阈值（元）
        'report_interval_hours' => 24,    // 可疑交易报告间隔（小时）
    ],
    'audit' => [
        'enabled' => true,
        'retention_days' => 180,          // 审计日志保留天数
    ],
];
```

## 使用示例

### Facade

```php
use Kylin\RiskControl\Facades\KylinRiskControl;

// 风险评估
$score = KylinRiskControl::evaluate([
    'applicant_id' => 1,
    'income' => 15000,
    'debt' => 3000,
    'credit_history' => 'good',
]);
// 返回：['score' => 720, 'level' => 'A', 'suggestion' => 'approve']

// 授信审批
$approval = KylinRiskControl::approve([
    'applicant_id' => 1,
    'amount' => 100000,
    'term' => 12,
    'purpose' => '消费贷款',
]);

// 五级分类
$classification = KylinRiskControl::classify($loanId);

// 大额交易检测
$suspicious = KylinRiskControl::detectSuspicious([
    'account_id' => 1,
    'amount' => 60000,
    'transaction_type' => 'transfer',
]);
```

### API 路由

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /api/kylin/risk-control/evaluate | 风险评估 |
| POST | /api/kylin/risk-control/approve | 授信审批 |
| GET | /api/kylin/risk-control/loans/{id}/classify | 五级分类 |
| POST | /api/kylin/risk-control/aml/detect | 反洗钱检测 |
| GET | /api/kylin/risk-control/alerts | 预警列表 |

## 法律合规

详见 [LEGAL.md](./LEGAL.md)，涵盖：
- 《中华人民共和国反洗钱法》第十六条：大额交易和可疑交易报告
- 银保监会《贷款风险分类指引》：五级分类制度
- 《中华人民共和国个人信息保护法》：征信数据保护

## 依赖

- PHP ^8.5
- Laravel ^13.0
- kylin/core

## 许可证

私有软件，未经授权禁止使用。