# AML System Documentation

## 系统概述

AML (Anti-Money Laundering) 系统是一个全面的反洗钱合规管理平台，用于帮助金融机构和企业满足监管要求。系统采用前后端分离架构，后端基于 ASP.NET Core ABP 框架，前端基于 Angular 11。

## 技术架构

### 后端技术栈
- **框架**: ASP.NET Core + ABP (ASP.NET Boilerplate)
- **数据库**: Entity Framework Core
- **认证**: JWT Bearer Token
- **多租户**: 内置支持

### 前端技术栈
- **框架**: Angular 11
- **UI库**: ng-zorro-antd, PrimeNG, Syncfusion ECharts
- **状态管理**: NGXS Store
- **图表**: ECharts

## 目录结构

```
docs/
├── README.md                 # 系统架构总览
├── KYC/                      # KYC身份验证模块
│   └── README.md
├── AML/                      # AML核心模块
│   └── README.md
├── AMLPortal/                # 门户模块
│   └── README.md
├── BASIC/                    # 基础模块
│   └── README.md
└── MediaStore/               # 媒体存储模块
    └── README.md
```

## 核心模块

### 1. iCON.Abp.AML (AML核心模块)

反洗钱核心功能模块，包含KYC、合规检测、STR上报等功能。

**主要功能:**
- KYC身份验证
- 交易监控
- 可疑活动检测
- STR (可疑交易报告)
- 风险评级
- 实时筛查
- 实体管理 (个人/企业)

**子模块路径**: `AML_Backend/modules/iCON.Abp.AML/`

**详细文档**: [AML 模块](./AML/README.md) | [KYC 模块](./KYC/README.md)

---

### 2. iCON.Abp.AMLPortal (门户模块)

消费者和企业用户门户，提供前端用户界面。

**主要功能:**
- 租户配置管理
- 订单管理
- 消费者门户
- 企业信息管理

**子模块路径**: `AML_Backend/modules/iCON.Abp.AMLPortal/`

**详细文档**: [AMLPortal 模块](./AMLPortal/README.md)

---

### 3. iCON.Abp.Basic (基础模块)

提供系统的基础能力和公共服务。

**主要功能:**
- 租户管理
- 配置管理
- 审计日志
- 通知服务
- 文件存储接口

**子模块路径**: `AML_Backend/modules/iCON.Abp.Basic/`

**详细文档**: [BASIC 模块](./BASIC/README.md)

---

### 4. iCON.Abp.MediaStore (媒体存储模块)

文件和媒体资源存储管理。

**主要功能:**
- 文件上传/下载
- 媒体资源管理
- 附件处理

**子模块路径**: `AML_Backend/modules/iCON.Abp.MediaStore/`

**详细文档**: [MediaStore 模块](./MediaStore/README.md)

---

## 前端功能模块

前端模块位于 `AML_Frontend/src/app/modules/`

| 模块 | 说明 |
|------|------|
| `aml-query` | AML查询功能 |
| `agent` | 代理/中介管理 |
| `configuration` | 系统配置 |
| `document` | 文档管理 |
| `form` | 表单处理 |
| `home` | 首页/仪表盘 |
| `investigate-setting` | 调查设置 |
| `llm` | LLM集成 |
| `log` | 日志查看 |
| `operator` | 操作员管理 |
| `plan` | 计划管理 |
| `realtime-screening` | 实时筛查 |
| `report` | 报告生成 |
| `risk-report` | 风险报告 |
| `screen-report` | 筛查报告 |
| `stats` | 统计分析 |
| `str` | STR管理 |
| `tenant-info` | 租户信息 |
| `transaction-report` | 交易报告 |
| `white-list` | 白名单管理 |

## 共享组件

位于 `AML_Frontend/src/app/shared/` 和 `AML_Frontend/src/app/components/`

| 组件 | 说明 |
|------|------|
| `viewer-account-select` | 账户选择器 |
| `viewer-account-form` | 账户表单 |
| `viewer-customer-info` | 客户信息查看器 |
| `viewer-scan-modal` | 扫描弹窗 |
| `viewer-investigate` | 调查查看器 |
| `remark-list` | 备注列表 |
| `pending-icon-list` | 待处理图标列表 |

## 数据库迁移

系统使用 Entity Framework Core 进行数据库管理。

**迁移项目**: `EntityFrameworkCore.DbMigrations`

**创建新迁移**:
```powershell
# 1. 设置 EntityFrameworkCore.DbMigrations 为启动项目
# 2. 在 Package Manager Console:
Add-Migration <MigrationName>
```

## 构建与部署

### 后端构建
```bash
dotnet build AML_Backend/iCON.Abp.AMLSolution.sln
```

### 前端构建
```bash
cd AML_Frontend
npm install --legacy-peer-deps
npm run build:dev    # 开发构建
npm run build:prod   # 生产构建
```

## 外部集成

系统集成了以下外部服务:
- **祥云OCR**: 证件识别服务
- **失信人查询**: 网络黑名单检测
- **征信查询**: 企业和个人征信验证

## 版本信息

**文档版本**: v1.0
**最后更新**: 2026-04-30