# 模块02：知识库管理 - 运维日志

**模块路径**：`/knowledge-base`  
**前端文件**：`client/src/pages/KnowledgeBase.tsx`  
**后端路由**：`server/routers.ts` → `knowledgeBase.*`  
**数据源**：MongoDB（nac_knowledge_engine.compliance_rules）  

---

## 功能说明

知识库管理模块负责管理 NAC 合规规则数据库，是 AI 审批引擎的核心知识来源。

## 数据模型

```typescript
interface ComplianceRule {
  _id: ObjectId;
  rule_id: string;          // 规则唯一标识，如 "SG-RWA-001"
  jurisdiction: string;     // 司法辖区：SG/HK/CN/AE/EU/US
  asset_type: string;       // 资产类型：real_estate/equity/bond/commodity/fund
  content: string;          // 规则内容（主语言）
  status: "active" | "inactive";
  version: string;          // 版本号，如 "v2.1"
  source: string;           // 来源机构
  effective_date: Date;     // 生效日期
  created_at: Date;
  updated_at: Date;
}
```

## API 端点

| 端点 | 方法 | 说明 |
|------|------|------|
| `knowledgeBase.list` | Query | 获取规则列表（支持辖区/资产类型/状态筛选）|
| `knowledgeBase.create` | Mutation | 创建新规则 |
| `knowledgeBase.update` | Mutation | 更新规则内容 |
| `knowledgeBase.toggle` | Mutation | 切换规则激活/禁用状态 |
| `knowledgeBase.delete` | Mutation | 删除规则（软删除）|

## 初始数据

系统初始化时预置了以下司法辖区的合规规则：

| 辖区 | 规则数 | 说明 |
|------|--------|------|
| SG（新加坡）| 1 | MAS 监管框架 |
| HK（香港）| 1 | SFC 证券及期货条例 |
| CN（中国大陆）| 1 | 中国人民银行监管 |
| AE（阿联酋）| 1 | ADGM/DIFC 框架 |
| EU（欧盟）| 1 | MiCA 法规 |
| US（美国）| 1 | SEC 监管框架 |

## 多语言升级计划（待实施）

计划升级数据模型，为每条规则添加七种语言内容字段：
- `content_zh`：简体中文
- `content_en`：英文
- `content_ar`：阿拉伯文
- `content_ja`：日文
- `content_ko`：韩文
- `content_fr`：法文
- `content_ru`：俄文
- `translation_status`：翻译状态（original/ai_translated/human_reviewed）

## 运维操作

```bash
# 查看知识库数据
mongosh "mongodb://root:idP0ZaRGyLsTUA3a@localhost:27017/nac_knowledge_engine?authSource=admin" \
  --eval "db.compliance_rules.find({}, {rule_id:1, jurisdiction:1, status:1}).pretty()"

# 统计各辖区规则数
mongosh "mongodb://root:idP0ZaRGyLsTUA3a@localhost:27017/nac_knowledge_engine?authSource=admin" \
  --eval "db.compliance_rules.aggregate([{$group:{_id:'$jurisdiction', count:{$sum:1}}}]).pretty()"
```