2026Technology-Competition/docs/ims-tech-overview.md

指摘管理系统（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%的常规指摘流转，人工只介入关键决策。