nex_docus/docs/sdd/product/vision.md

产品愿景（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 无阻断。