How yggzee/psu-research-publication works
This is a campus research repository and analytics portal: public visitors and institutional users discover researchers and publications, while instructors and administrators manage records; dashboards, impact views, reports, and AI assistance provide analysis. The frontend is routed through role-aware pages and uses an API client plus browser storage. The server API handler coordinates authentication, research data, scraping, AI, email, and safeguards. README content is absent, so capability coverage follows the supplied source index; unsampled implementation details and frontend-to-server URL wiring are not asserted.
Main entry points: routes.tsx Role-aware routes · api.service.ts API client · apiHandler.mjs API handler · AdminPage.tsx Administration
Components 26
Access and navigation
- Application shell
src/app/App.tsx - Role-aware routes
src/app/routes.tsx
Research discovery
- Public repository
src/app/components/PublicRepositoryPortal.tsx - Publication search
src/app/components/SearchEngine.tsx - Researcher directory
src/app/components/ResearchersPage.tsx - Researcher profile
src/app/components/ResearcherProfile.tsx - Publication detail
src/app/components/PublicationDetail.tsx - Scholar scraper
src/server/scholarScraper.mjs
Research management
- Administration
src/app/components/AdminPage.tsx - Instructor publications
src/app/components/InstructorPublicationsPage.tsx
Server and data services
- API client
src/app/services/api.service.ts - Research state
src/app/utils/researchStore.ts - API handler
src/server/apiHandler.mjs - Authentication
src/server/authHelper.mjs - Research database
src/server/db.mjs - Turso replication
src/server/turso.mjs - Email service
src/server/emailService.mjs - Rate limiting
src/server/rateLimiter.mjs
Analysis and assistance
- Research dashboard
src/app/components/Dashboard.tsx - Impact analysis
src/app/components/ImpactAnalysisPage.tsx - SDG impact matrix
src/app/components/SDGImpactMatrix.tsx - Research reports
src/app/components/ReportsPage.tsx - Campus AI chat
src/app/components/AskCampusAI.tsx - AI services
src/server/aiService.mjs
Other components
- Visitor
- Campus user
Connections 35
- Visitor → Public repository: browses
- Campus user → Role-aware routes: opens pages
- Application shell → Role-aware routes: mounts routes
src/app/App.tsx - Role-aware routes → Public repository: routes to
src/app/routes.tsx - Role-aware routes → Research dashboard: routes to
src/app/routes.tsx - Role-aware routes → Publication search: routes to
src/app/routes.tsx - Role-aware routes → Researcher directory: routes to
src/app/routes.tsx - Role-aware routes → Researcher profile: routes to
src/app/routes.tsx - Role-aware routes → Publication detail: routes to
src/app/routes.tsx - Role-aware routes → Impact analysis: routes to
src/app/routes.tsx - Role-aware routes → SDG impact matrix: routes to
src/app/routes.tsx - Role-aware routes → Research reports: routes to
src/app/routes.tsx - Role-aware routes → Administration: guards route
src/app/routes.tsx - Role-aware routes → Instructor publications: routes to
src/app/routes.tsx - Publication search → API client: requests search
src/app/components/SearchEngine.tsx - Public repository → API client: requests repository data
src/app/components/PublicRepositoryPortal.tsx - Research dashboard → API client: requests metrics
src/app/components/Dashboard.tsx - Researcher directory → API client: requests researchers
src/app/components/ResearchersPage.tsx - Researcher profile → API client: requests profile data
src/app/components/ResearcherProfile.tsx - Administration → API client: manages records
src/app/components/AdminPage.tsx - Administration → Research state: reads and updates
src/app/components/AdminPage.tsx - API client → API handler: sends HTTP requests
- Research state → API client: syncs records
src/app/utils/researchStore.ts - API handler → Research database: uses data access
src/server/apiHandler.mjs - API handler → Authentication: uses authentication
src/server/apiHandler.mjs - API handler → Scholar scraper: dispatches scraping
src/server/apiHandler.mjs - API handler → AI services: dispatches AI tasks
src/server/apiHandler.mjs - API handler → Email service: sends email
src/server/apiHandler.mjs - API handler → Rate limiting: applies limits
src/server/apiHandler.mjs - Research database → Turso replication: replicates and rehydrates
src/server/db.mjs - AI services → Scholar scraper: fetches research metadata
src/server/aiService.mjs - Impact analysis → API client: requests analysis data
- SDG impact matrix → API client: requests SDG data
- Research reports → API client: requests report data
- Campus AI chat → API client: requests AI assistance