AML/docs/AMLPortal/README.md

144 lines
3.6 KiB
Markdown

# AMLPortal 门户模块
## 模块概述
iCON.Abp.AMLPortal 提供消费者和企业用户的门户功能,包括租户管理、订单管理、客户管理等。
## 目录结构
```
modules/iCON.Abp.AMLPortal/
├── src/
│ ├── iCON.Abp.AMLPortal.Application/ # 应用层实现
│ │ ├── AgentorService.cs # 代理服务
│ │ ├── CustomerService.cs # 客户服务
│ │ ├── OrderService.cs # 订单服务
│ │ ├── PlanService.cs # 计划服务
│ │ ├── CustomerIdentityService.cs # 客户认证
│ │ └── Jobs/ # 后台作业
│ ├── iCON.Abp.AMLPortal.Application.Contracts/ # 应用层接口
│ │ ├── AgentorAppLayer/ # 代理接口
│ │ ├── CustomerAppLayer/ # 客户接口
│ │ ├── OrderAppLayer/ # 订单接口
│ │ ├── PlanAppLayer/ # 计划接口
│ │ └── CustomerIdentityAppLayer/ # 认证接口
│ ├── iCON.Abp.AMLPortal.Domain/ # 领域层
│ │ ├── DbEntity/ # 数据库实体
│ │ │ ├── Agentor.cs
│ │ │ ├── Customer.cs
│ │ │ ├── Order.cs
│ │ │ ├── Plan.cs
│ │ │ ├── TenantProperty.cs
│ │ │ └── ...
│ │ └── Interface/ # 仓储接口
│ ├── iCON.Abp.AMLPortal.Domain.Shared/ # 领域共享
│ └── iCON.Abp.AMLPortal.EntityFrameworkCore/ # EF Core
└── ...
```
## 核心功能
### 1. 代理管理 (Agentor)
代理商/中介机构管理。
**主要接口**: `IAgentorService`
**功能**:
- 代理列表查询
- 代理信息管理
- 租户分配
### 2. 客户管理 (Customer)
终端客户管理。
**主要接口**: `ICustomerService`
**功能**:
- 客户注册/登录
- 客户信息管理
- 客户反馈处理
**相关类**:
- `CustomerLoginParam` - 登录参数
- `CustomerRegisterParam` - 注册参数
- `CreateFeedbackDto` - 反馈创建
### 3. 订单管理 (Order)
租户订单和配额管理。
**主要接口**: `IOrderService`
**功能**:
- 创建订单
- 订单审核
- 租户续期
- 服务信息查询
- 配额使用追踪
**核心实体**:
- `Order` - 订单主表
- `OrderDetail` - 订单明细
- `PaymentInfo` - 支付信息
- `TenantProperty` - 租户属性
### 4. 计划管理 (Plan)
服务计划和配额管理。
**主要接口**: `IPlanService`
**功能**:
- 计划列表查询
- 计划详情管理
- 代理用户计划更新
**核心实体**:
- `Plan` - 计划
- `PlanDetail` - 计划明细
- `AgentUserPlan` - 代理用户计划
### 5. 客户认证 (CustomerIdentity)
客户身份认证和缓存。
**主要接口**:
- `ICustomerIdentityService`
- `ICustomerCacheService`
**功能**:
- 客户Token管理
- 登录验证
- 缓存处理
## 数据库实体
| 实体 | 说明 |
|------|------|
| `Agentor` | 代理商 |
| `AgentUserPlan` | 代理用户计划 |
| `Customer` | 客户 |
| `Feedback` | 客户反馈 |
| `Order` | 订单 |
| `OrderDetail` | 订单明细 |
| `PaymentInfo` | 支付信息 |
| `Plan` | 服务计划 |
| `PlanDetail` | 计划明细 |
| `TenantEventQueue` | 租户事件队列 |
| `TenantProperty` | 租户属性 |
| `VerifyCode` | 验证码 |
## 后台作业
| 作业 | 说明 |
|------|------|
| `ClearExpiredOrderCustomerJob` | 清理过期订单客户 |
| `TenantTobeExpiredRemindJob` | 租户到期提醒 |
## 版本信息
**文档版本**: v1.0
**最后更新**: 2026-04-30