ARP Backend

• This repository consists of the codes for backend of Academic Resource Portal

Schema

All API access is over HTTPS, and accessed from the <https://arpbackend-df561.firebaseapp.com>. All data is sent as JSON.

{
  'author' : 'Neuromancers, IIT Bhubaneswar',
  'endpoint' : '',
  'project_name' : 'ARP_Backend',
  'project_url' : 'https://github.com/NeuromancersIITBBS/ARP_Backend'
}

Endpoints

GET: /admin/flagged

Result: Returns json data of all flagged files.

[
  {
    "flags": 2,
    "subjectName": "PDS",
    "review": true,
    "subjectCode": "CS1L001"
  },
  {
    "semester": "autumn",
    "year": 2018,
    "flags": "2",
    "subjectName": "Data Structures",
    "review": true,
    "downloadLink": "https://google.com",
    "flagReason": ["duplicate", "irrelevant"],
    "type": "endsem",
    "resourceId": "PQvrbm2KP9MjuyKQktn7",
    "emailId": "asdf123@gmail.com",
    "subjectCode": "CS2L003"
  },
  {
    "review": false,
    "subjectCode": "code",
    "downloadLink": "cgfvhbjn",
    "flags": 3
  },
  {
    "subjectName": "Signal & System",
    "review": true,
    "subjectCode": "EC1L001",
    "flags": 1
  }
]

GET: /admin/unreviewed

Result: Returns json data of all unreviewed files.

[
  {
    "subjectName": "Advanced PDS",
    "review": false,
    "downloadLink": "https://fibasestorage.googleapis.com/v0/b/arpbackend-7b652.appspot.com/o/3.%20Gene%20Mutation.pdf?alt=media&token=78e20a31-3daa-4924-9ea7-3293513cad97",
    "flagReason": [],
    "type": "endsem",
    "resourceId": "VHnJ6T2joP50mNX3Hqwf",
    "emailId": "r22@gmail.com",
    "subjectCode": "CE645",
    "semester": "autumn",
    "year": "2018",
    "flags": 0
  },
  {
    "downloadLink": "cgfvhbjn",
    "flags": 3,
    "review": false,
    "subjectCode": "code"
  }
]

POST: /review/accept-resources

req body: accepts a list against key validResourceList containing the resource ids of accepted resources

{
  "validResourceList": ["4bZaf1", "54ceq1A", "UYtca241"]
}

Result: Marks the resoruces in the list as reviewed and are available for consumption by public

"Resource Accepted as Valid"

GET: /search

Result: Returns json data containing subjectName and subjectCode for all reviewed files.

[
  {
    "subjectName": "PDS",
    "subjectCode": "CS1L001"
  },
  {
    "subjectName": "Advanced PDS",
    "subjectCode": "CS1L004"
  },
  {
    "subjectName": "Data Structures",
    "subjectCode": "CS2L003"
  },
  {
    "subjectName": "Signal & System",
    "subjectCode": "EC1L001"
  },
  {
    "subjectName": "ET-2",
    "subjectCode": "EE3L004"
  }
]

POST: /studyResources/branches/{branch}/subjects/{subjectCode}

Result: Upload a resource of a subject code.

GET: /studyResources/branches/{branch}/subjects/{subjectCode}

Result for subjectCode : CS2L003 :

[
  {
    "downloadLink": "https://firebasestorage.googleapis.com/v0/b/arpbackend-7b652.appspot.com/o/3.%20Gene%20Mutation.pdf?alt=media&token=78e20a31-3daa-4924-9ea7-3293513cad97",
    "flagReason": [],
    "type": "tutorial",
    "resourceId": "MrZpAehPuOZQKNnJUqxQ",
    "emailId": "random@gmail.com",
    "subjectCode": "CS2L003",
    "semester": "spring",
    "year": "2019",
    "flags": 0,
    "subjectName": "Data Structures",
    "review": true
  },
  {
    "subjectName": "Data Structures",
    "review": true,
    "downloadLink": "https://google.com",
    "flagReason": ["duplicate", "irrelevant"],
    "type": "endsem",
    "resourceId": "PQvrbm2KP9MjuyKQktn7",
    "emailId": "asdf123@gmail.com",
    "subjectCode": "CS2L003",
    "semester": "autumn",
    "year": 2018,
    "flags": "2"
  }
]

GET: /studyResources/branches/{branch}

Result: Returns json data containing subjectName and subjectCode of all reviewed files for a specific branch.

[
  {
    "subjectName": "PDS",
    "subjectCode": "CS1L001"
  },
  {
    "subjectName": "Advanced PDS",
    "subjectCode": "CS1L004"
  },
  {
    "subjectName": "Data Structures",
    "subjectCode": "CS2L003"
  }
]

Deployment

Currently deployed on firebase <https://arpbackend-df561.firebaseapp.com>.

Built With

• Nodejs - The web framework used
• Firebase - Database, Storage and Deployment.

Contributing

• Fork the repository https://github.com/NeuromancersIITBBS/ARP_Backend.git and download the code to your local system using git clone.
• Install the npm modules

 npm install

• Start the server using command

 nodemon index.js

• A new function can be written in controllers/studyResources.js using appropriate endpoints.
• After verifying the working of the function using postman app https://www.getpostman.com/, push the changes to the forked repository.
• Create a pull request, explaining the details of the changes made.

Contributors

• Rishabh Gupta (Project Leads)
• Aashay Palliwar
• Pradyuman Agrawal
• Sreekanth Vadigi
• Anuj Gupta

Contact us at secyprogsoc.sg@iitbbs.ac.in

License

Built with ♥ by Neuromancers, IIT Bhubaneswar.