# System Positioning

## 当前项目定位

`memory_gateway` 不是完整的 SOC 记忆系统，而是整套方案里的统一上下文入口层。

它当前承担的职责是：

- 为 AI agent 提供统一的 MCP / REST 访问入口
- 将检索和写入请求转发给 OpenViking
- 提供基础鉴权、协议兼容和网关能力
- 作为多 agent 共享记忆体系的最薄接入层

它不直接承担以下职责：

- 原始知识源的批量导入
- 高价值记忆抽取和筛选
- Obsidian Vault 的人工知识沉淀
- EverMemOS 的长期记忆整理与演化
- 评估数据集与实验流程管理

## 在整套 SOC 记忆系统中的位置

```text
SOC 数据源
KB / Playbook / 月报 / 报告 / Ticket / Intel / 历史 Case
            |
            v
Skills / Pipeline
ingest / extract / classify / summarize / commit / prune
            |
            v
memory_gateway
统一入口层（MCP / REST / Auth / Routing）
            |
            v
OpenViking
统一 context / memory / resource / skill 层
      |                           |
      v                           v
Obsidian Vault               EverMemOS
人工沉淀层                   长期整理层
```

## 下一阶段模块建议

建议把后续 POC 能力分成以下模块：

- `docs/`
  保存系统设计、数据模型、命名空间规范
- `poc/skills/`
  保存检索、抽取、沉淀相关的 skills
- `poc/pipeline/`
  保存接入 ticket、intel、历史 case 的导入流程
- `poc/obsidian-vault/`
  保存人工维护知识和 case note 模板
- `poc/evermemos/`
  保存长期记忆整理逻辑和策略
- `poc/evaluation/`
  保存数据集、评估脚本和结果

## 当前仓库边界建议

建议继续把本仓库控制在“网关项目”边界内：

- 保留：服务入口、OpenViking 接入、配置、协议、测试
- 新增：系统设计文档、POC 骨架目录
- 不建议继续堆积：大量业务规则、海量导入脚本、Vault 内容本体