How iai-ustc-quantum/quantumatlas works
QuantumAtlas is a paper collection, registry, and multi-paradigm search service, exposed through a Go/PocketBase server and browser UI. The principal flow is arXiv or user-submitted papers entering lazy acquisition, durable asset storage and registry tracking, then becoming searchable across local and external sources. Other documented capabilities include MinerU parsing, OpenAlex corpus mirroring, collaboration, and managed downloader workers. The README supports the broad product flow; source excerpts clarify selected ingestion and search behavior. Several UI and service connections remain unverified because their implementations were not sampled.
Main entry points: routes HTTP API routes · engine.go Search engine · ingester.go Lazy ingestion · store.go Object storage
Components 34
Server and API
- qatlasd service
cmd/qatlasd/main.go - HTTP API routes
internal/routes - OAuth and tokens
internal/auth/oauth.go - Paper discussions
internal/comments/comments.go
Acquisition and parsing
- Lazy ingestion
internal/ingest/ingester.go - PDF acquisition
internal/downloader/downloader.go - Worker fleet
internal/downloadfleet/service.go - MinerU parsing
internal/mineru/client.go - Parse uploads
internal/routes/papers_mineru_ingest.go
Paper data
- Object storage
internal/objstore/store.go - Paper registry
internal/registry/registry.go - Paper assets
internal/paperassets/path.go - OpenAlex corpus
internal/openalexcorpus/ingest.go
Search and discovery
- Search endpoint
internal/routes/search.go - Search engine
internal/search/engine.go - Local catalog
internal/search/catalog.go - arXiv search
internal/search/arxiv.go - OpenAlex search
internal/search/openalex.go - Qdrant retrieval
internal/rag/remote.go
User experience
- Web application
web/src/main.tsx - Search and results
web/src/routes/$lang.papers.search.tsx - Paper reader
web/src/routes/$lang.papers.$paperId.tsx - Discussion view
web/src/routes/$lang.papers.$paperId_.discussions.tsx - Dashboard
web/src/routes/$lang.dashboard.tsx - Device authorization
web/src/routes/$lang.device.tsx - Downloader controls
web/src/routes/$lang.downloader.tsx - Token management
web/src/routes/$lang.pat.tsx - Asset administration
web/src/routes/$lang.admin.assets.tsx - Worker administration
web/src/routes/$lang.admin.downloader-workers.tsx - Admin console
web/src/routes/$lang.admin.index.tsx - Pipeline controls
web/src/routes/$lang.admin.pipelines.tsx - Plugin controls
web/src/routes/$lang.admin.plugins.tsx
Other components
- Researchers
- arXiv and uploads
Connections 36
- Researchers → Web application: uses
README.md - arXiv and uploads → Lazy ingestion: submits papers
README.md - qatlasd service → HTTP API routes: hosts API
README.md - Web application → HTTP API routes: calls
- HTTP API routes → OAuth and tokens: authenticates
- HTTP API routes → Lazy ingestion: requests ingestion
- Lazy ingestion → PDF acquisition: fetches PDFs
internal/ingest/ingester.go - PDF acquisition → Object storage: stores assets
internal/downloader/downloader.go - Lazy ingestion → Paper registry: registers assets
internal/ingest/ingester.go - Lazy ingestion → Object storage: writes PDFs
internal/ingest/ingester.go - Parse uploads → MinerU parsing: parses uploads
internal/routes/papers_mineru_ingest.go - Parse uploads → Object storage: stores parse outputs
internal/routes/papers_mineru_ingest.go - Parse uploads → Paper registry: records revisions
internal/routes/papers_mineru_ingest.go - Worker fleet → PDF acquisition: dispatches downloads
internal/downloadfleet/service.go - HTTP API routes → Worker fleet: manages workers
- HTTP API routes → Search endpoint: serves search
README.md - Search endpoint → Search engine: queries
- Search engine → Local catalog: fans out
- Search engine → arXiv search: fans out
- Search engine → OpenAlex search: fans out
- Search engine → Qdrant retrieval: retrieves vectors
README.md - Search engine → Paper registry: anchors results
internal/search/engine.go - Search and results → Search endpoint: submits queries
- Paper reader → HTTP API routes: loads paper
- Discussion view → Paper discussions: loads discussions
- HTTP API routes → Paper discussions: serves collaboration
- OpenAlex corpus → Object storage: reads corpus
internal/openalexcorpus/ingest.go - Dashboard → HTTP API routes: loads status
- Device authorization → OAuth and tokens: authorizes device
- Downloader controls → HTTP API routes: controls acquisition
- Token management → HTTP API routes: manages tokens
- Asset administration → HTTP API routes: manages assets
- Worker administration → HTTP API routes: manages workers
- Admin console → HTTP API routes: loads administration
- Pipeline controls → HTTP API routes: controls pipelines
- Plugin controls → HTTP API routes: manages plugins