Study Material Hub

[redshift-quasar]

Study Material Hub – Real PESU Academy Integration

Summary

Implement the CampusFlow Study Material Hub to fetch, organize, and combine study materials directly from PESU Academy instead of relying on mock/fallback data.

Problem

Currently the Study Material Hub falls back to a mock catalog because real material extraction from PESU Academy is not yet implemented.

The login flow works intermittently, but material discovery is incomplete and the actual material APIs/endpoints have not been mapped.

Goals

Phase 1: Real Material Discovery

• Authenticate with PESU Academy using student credentials.

• Discover actual eLearning/material endpoints.

• Extract:

  • Subjects
  • Units
  • Material titles
  • Material metadata
  • Download links

• Replace fallback catalog with real data.

Phase 2: Material Browser

• Allow students to:

  • Select Subject
  • Select Unit
  • View all available study materials

• Support:

  • PDFs
  • PPTs
  • Notes
  • Assignments
  • Additional uploaded resources

Phase 3: Unit Material Combiner

• Student selects:

  • Subject
  • Unit

• CampusFlow automatically:

  • Downloads all PDFs for that unit
  • Merges them into a single PDF
  • Generates a downloadable combined document

Phase 4: Smart Search

• Search by:

  • Subject
  • Unit
  • Faculty
  • Material title

• Quick filtering and sorting.

Current Findings

Working

• PESU Academy connectivity check
• Session creation
• Partial login flow
• eLearning JavaScript discovery

Discovered Endpoint

GET

https://www.pesuacademy.com/Academy/a/i/groupBasedcategory

Response:

• Status: 200
• Content-Type: application/json
• Length: ~8.7 KB

Issues

• Login success detection is unstable.
• groupBasedcategory response structure not yet decoded.
• Material download endpoints unknown.
• Catalog still falls back to mock data.

Tasks

Backend

• Fix login success detection.
• Decode groupBasedcategory response.
• Map eLearning APIs.
• Extract material metadata.
• Build normalized catalog structure.
• Implement PDF download pipeline.
• Implement PDF merge service.

Frontend

• Subject selector.
• Unit selector.
• Material list view.
• Combined PDF download button.
• Loading and error states.

Testing

• Test with multiple PESU accounts.
• Validate material counts.
• Validate merged PDFs.
• Handle expired sessions.

Acceptance Criteria

• Student logs in successfully.
• Real PESU materials are displayed.
• Subject → Unit navigation works.
• Unit materials can be merged into a single PDF.
• No mock/fallback data is shown when real data is available.
• Downloaded merged PDF is valid and readable.