# 产品愿景（Vision）

## 一句话愿景

**NEX Docus 是一款面向团队协作的轻量级文档管理平台**，以「数据库管理权限 + 文件系统存储内容」的混合架构，让团队在获得可控权限管理的同时，拥有文件级的数据透明性、可迁移性与可理解性（可检索、可问答、可溯源）。

## 产品价值主张（PO）

| 编号 | 价值主张 | 说明 |
| --- | --- | --- |
| PO-1 | **文件即真理（File as Truth）** | 文档内容、图片、附件以原生文件存于服务器磁盘，不落数据库 BLOB；便于备份、迁移与 Git 版本控制。 |
| PO-2 | **三级模型** | 用户（User）→ 项目（Project）→ 文档/文件夹（File/Folder）的分层组织。 |
| PO-3 | **严格隔离与权限** | 基于项目的物理磁盘隔离 + 数据库 RBAC 权限的双重控制。 |
| PO-4 | **可理解内容库** | 文档可向量化构建知识库，支持基于 RAG 的问答，且答案可溯源（引用支撑句）。 |
| PO-5 | **开放接入** | 通过 MCP (Model Context Protocol) Streamable HTTP 让外部 Agent 访问项目/文档能力。 |

## 目标用户与角色

- **系统管理员（super_admin）**：全量菜单与权限，管理用户、角色、模型配置、日志。
- **管理员（admin）**：系统级管理人员。
- **普通用户（user）**：创建/参与项目、编辑文档、使用知识库对话。
- **访客（匿名分享访问者）**：通过公开分享链接访问项目/文件预览（受限）。

## 边界（Scope）

### 范围内（In Scope）
用户认证与 RBAC、项目管理与协作、文档/文件系统管理、全文检索、ZVec 向量化知识库、RAG 对话、分享/预览、Git 仓库集成、通知、系统日志、LLM 模型配置、后台导出/向量化任务、MCP 接入。

### 范围外（Out of Scope）
- 不做数据库内大文件二进制 BLOB 存储（文件一律落盘）。
- 不内置完整 Alembic 迁移链（见 ADR；采用幂等 ALTER）。
- 不承诺 docker-compose v1 兼容（依赖 Compose v2 / Engine ≥ 25）。
- 不做实时多人协同编辑（当前为「保存即落盘 + 后台索引同步」，无 OT/CRDT）。

## 成功度量（建议）
- MVP 链路通：创建项目 → 编辑 MD → 保存 → 检索命中 → 向量化 → RAG 问答可溯源。
- 知识库引用准确率：答案中的 [n] 引用均可回填到原文支撑句（引用对齐覆盖率）。
- 部署/升级成功率：Compose v2 一键 init/upgrade 无阻断。