# NAC 知识引擎管理系统 — 文档中心

## 项目概述

NAC 知识引擎管理系统（nac-admin-system）是 NewAssetChain 公链的核心后台管理平台，负责：

- **合规规则知识库管理**：覆盖 57 个司法辖区、129 条规则
- **AI 智能体服务**：知识库问答、合规分析、翻译、审批辅助（全部自研，零外部 AI 依赖）
- **NAC 自研 BM25 向量引擎**：中英文混合检索，RWA/合规领域优化
- **监管动态爬虫**：覆盖 SEC/SFC/MAS/DFSA/ESMA/FCA/ASIC/FINMA/CSRC/HKEX
- **七层合规验证框架（L1→L7）**

## 技术栈

| 组件 | 技术 |
|------|------|
| 前端 | React 19 + Tailwind 4 + shadcn/ui |
| 后端 | Express 4 + tRPC 11 |
| 数据库 | MySQL（结构化）+ MongoDB（知识库/日志）|
| 向量检索 | NAC 自研 BM25 引擎（nacVectorEngine.ts）|
| 认证 | NAC 原生 JWT（nacAuth.ts）|

## 目录结构

```
docs/nac-admin-system/
├── README.md          ← 本文件
└── worklogs/          ← 每期工单运维日志
    ├── WORKLOG_20260301_全栈自研向量引擎_辖区扩展_爬虫验证.md
    ├── WORKLOG_20260301_爬虫体系升级_向量检索_NaN修复.md
    └── WORKLOG_20260301_贸易规则爬虫与智能体升级.md
```

## 版本历史

| 版本 | 日期 | 主要变更 |
|------|------|----------|
| v24 | 2026-02-26 | nacAuth.ts v2.0 双层适配器 + NacUser 完整契约 |
| v25 | 2026-03-01 | NAC 自研 BM25 向量引擎 + 57 辖区 129 条规则 + 爬虫 cron |

## 生产服务器

- **服务地址**：https://admin.newassetchain.io
- **服务路径**：/opt/nac/services/nac-admin/
- **日志目录**：/opt/nac/services/nac-admin/logs/
- **代码仓库**：https://git.newassetchain.io/nacadmin/nac-admin-system