How vedantgonbare/researchpulse works
ResearchPulse is an academic-paper tracking API with a React client in the repository. Its main workflow authenticates a user, searches arXiv or accepts a paper ID, saves papers to PostgreSQL, and supports organization, summaries, and unread-paper digests. Separate branches handle file uploads and request throttling. The map follows the excerpted route calls and the README’s documented capabilities; frontend files and several service implementations are only indexed, so their internal wiring is not inferred.
Main entry points: papers.py Paper routes · auth.py Authentication routes · dependencies.py Current-user lookup · main.py FastAPI app
Components 21
API entry
- FastAPI app
app/main.py - File upload route
app/api/files.py - Rate limiting
app/core/limiter.py
Identity and access
- Authentication routes
app/api/auth.py - JWT and passwords
app/core/security.py - Current-user lookup
app/core/dependencies.py - User records
app/models/user.py
Paper management
- Paper routes
app/api/papers.py - Paper records
app/models/paper.py - Unread digest
app/services/digest.py - Database sessions
app/db/session.py
External services
- arXiv search and fetch
app/services/arxiv.py - Query cache
app/services/cache.py - AI summarization
app/services/ai.py - Cloudinary storage
app/services/storage.py
Other components
- API client
- PostgreSQL
- Redis
- arXiv
- Gemini AI
- Cloudinary
Connections 29
- API client → FastAPI app: sends requests
README.md - FastAPI app → Authentication routes: registers router
app/main.py - FastAPI app → Paper routes: registers router
app/main.py - FastAPI app → File upload route: registers router
app/main.py - Authentication routes → JWT and passwords: hashes and signs
app/api/auth.py - Authentication routes → Current-user lookup: requires user
app/api/auth.py - Current-user lookup → JWT and passwords: decodes token
app/core/dependencies.py - Current-user lookup → User records: loads user
app/core/dependencies.py - Authentication routes → User records: creates and queries
app/api/auth.py - Authentication routes → Database sessions: uses session
app/api/auth.py - Paper routes → Current-user lookup: requires user
app/api/papers.py - Paper routes → Database sessions: uses session
app/api/papers.py - Paper routes → Paper records: queries and saves
app/api/papers.py - Paper routes → arXiv search and fetch: searches and fetches
app/api/papers.py - Paper routes → Query cache: checks and updates
app/api/papers.py - Paper routes → Unread digest: requests digest
app/api/papers.py - Paper routes → AI summarization: requests summary
app/api/papers.py - File upload route → Current-user lookup: requires user
app/api/files.py - File upload route → Cloudinary storage: uploads file
app/api/files.py - Paper routes → Rate limiting: applies limits
app/api/papers.py - File upload route → Rate limiting: applies limits
app/api/files.py - Database sessions → PostgreSQL: connects
app/db/session.py - Paper records → PostgreSQL: stores paper data
README.md - User records → PostgreSQL: stores user data
README.md - Query cache → Redis: caches queries
README.md - Rate limiting → Redis: tracks request counts
README.md - arXiv search and fetch → arXiv: searches and fetches
README.md - AI summarization → Gemini AI: summarizes abstracts
README.md - Cloudinary storage → Cloudinary: uploads files
app/services/storage.py