# 指摘管理系统（IMS）技术构成简要说明

> **版本**：V4.1 | **日期**：2026-07-20
> 
> AI驱动的指摘（缺陷/问题）全生命周期管理系统，以 Agent（智能体）为核心，实现"人机协同"的自动化管理。

---

## 一、整体架构

```
┌─────────────┐     ┌─────────────┐     ┌─────────────────────────┐
│   前端层    │────▶│  后端业务层  │────▶│    Agent决策编排层       │
│  React SPA  │     │ Spring Boot │     │ ReAct循环 + 工具调用     │
└─────────────┘     └─────────────┘     └─────────────────────────┘
                                                │
                    ┌───────────────────────────┼───────────────────┐
                    ▼                           ▼                   ▼
              ┌──────────┐              ┌────────────┐      ┌────────────┐
              │本地数据层 │              │ 本地向量库  │      │ 外接AI算力 │
              │PostgreSQL│              │  pgvector  │      │ DeepSeek   │
              │+ Redis   │              │  (1536维)  │      │ API        │
              └──────────┘              └────────────┘      └────────────┘
```

---

## 二、核心技术栈

| 层级 | 技术选型 | 作用 |
|:---|:---|:---|
| **前端** | React 19 + TypeScript + Vite + Ant Design 6 | 单页应用，工作台/指摘管理/Agent驾驶舱 |
| **后端** | Java 17/21 + Spring Boot 3.5 + Spring Security | RESTful API、RBAC权限、数据访问（JPA） |
| **Agent引擎** | Spring AI / 自定义ReAct框架 + DeepSeek API | 自然语言理解、任务规划、工具调用、思考链 |
| **向量检索** | PostgreSQL 16 + **pgvector** 插件 | 本地存储文档向量（1536维），余弦相似度检索 |
| **缓存/消息** | Redis 7.4 | 热点缓存、会话管理、异步通知 |
| **对象存储** | MinIO（本地部署） | 知识库文档、附件文件存储 |
| **AI算力** | DeepSeek API（deepseek-v4-pro + text-embedding-3-small） | **仅提供推理与向量化算力，不留存数据** |

---

## 三、核心创新点

### 1. Agent驱动的业务闭环
- 内置 **ReAct循环**（推理→行动→观察）
- 用户自然语言指令（如"催办逾期指摘分配给张三"）→ Agent自动规划 → 调用工具执行
- 高风险操作（删除/跨部门分配）自动触发人工审批

### 2. 本地知识库 + 外接算力
- 所有文档原文和向量索引 **存储于本地**（PostgreSQL pgvector）
- 仅将待向量化的文本片段通过API发送至DeepSeek
- **数据不出内网**，兼顾智能化与数据安全

### 3. 人机协同审批机制
- Agent执行敏感操作前自动触发 `request_human_approval`
- 详情页"Agent驾驶舱"实时展示思考链：`[思考]` → `[行动]` → `[观察]`
- 用户可实时批准/拒绝/修改建议

### 4. 长期记忆能力
- 成功的Agent处理经验自动沉淀为向量记忆（`agent_memories`表）
- 后续遇到相似问题时优先检索历史方案，持续优化决策质量

---

## 四、关键数据流示例

**用户输入**："这个4K屏幕适配问题怎么处理？"

```
Agent接收目标
    │
    ▼
检索本地知识库（search_knowledge）
    │
    ▼
匹配历史案例 #KB-042（Flex容器4K适配方案）
    │
    ▼
生成行动方案 → 调用 send_reminder 给担当者
    │
    ▼
触发人工审批闸门（request_human_approval）
    │
    ▼
用户批准 → 发送通知并附解决方案 → 记录成功经验到记忆库
```

---

## 五、部署特点

| 特性 | 说明 |
|:---|:---|
| **全栈容器化** | Docker Compose 一键启动所有服务 |
| **数据本地化** | 知识库文档、向量索引、业务数据全部本地存储 |
| **算力外包化** | 仅DeepSeek API为外部依赖，传输内容可控、不留存 |
| **可观测性** | Prometheus + Grafana 监控Agent任务指标；ELK审计思考链日志 |
| **安全策略** | JWT认证 + RBAC权限 + 单用户Agent调用限流（10次/分钟） |

---

## 六、一句话概括

> 用 **Spring Boot + React** 构建、以 **DeepSeek AI** 为大脑、以 **本地pgvector** 为记忆、以 **Agent** 为执行中枢的智能化缺陷管理系统——让AI自动处理80%的常规指摘流转，人工只介入关键决策。