概念与架构

QuantumAtlas 是一个"分层"系统。理解各层各自的职责和它们之间的数据流，是把这个项目用对的前提。

本节内容

  • 分层架构

    对象存储 / PostgreSQL registry / 搜索引擎各自是什么、谁是 source of truth、谁可以改谁不能改。

  • 数据流

    一篇论文从 arXiv 进来到可被搜索的全链路图，以及每一步的工具。

  • 鉴权模型

    PocketBase 用户、session token、PAT 与 scopes 的关系；read / write 鉴权的边界。

  • 存储架构

    对象存储 (RustFS/S3) + PostgreSQL registry 的切分，以及对象寻址、sha256 dedup、bucket versioning、桶布局与对账等机制。

为什么分层

简单回答：字节和查询是两回事。

  • 对象存储 是证据链 —— 论文 PDF、MinerU 解析出的 Markdown、各种图片。它们存在的目的是「永远可追溯」，所以追加为主、几乎不删改。

  • PostgreSQL 是 registry —— 论文、身份、资产状态、OpenAlex 语料。它回答「有哪些论文、各自什么状态、彼此什么关系」，用纯 SQL 就能查。

  • 搜索引擎 是派生查询层 —— POST /api/search 把查询 fan-out 到 catalog / arXiv / OpenAlex / Qdrant provider。它不是独立事实来源。

这样的边界有两个好处：

  1. 资产可以被人直接取，也能被工具稳定消费。

  2. 集合查询不污染存储层；存储、索引和搜索各在合适的地方发生。

下面的几节会把每一层讲清楚。