Requirement Specifications
Context:
In order to ensure effective scale rollout of ETB and associated programs across states, it is critical to make states self-reliant to execute most of the ETB activities themselves. One of the major activity for which state is dependent on Diksha implementation team is bulk content upload. In this PRD we are going explain process, workflow and upload format for bulk data upload on Diksha by states.
Actor: Content Reviewer
Detailed Process Flow:
- Content reviewer access Diksha link
- Reach out to Workspace. There should be a new option called: "Bulk Resource Upload". Under this, there will be two options:
- Start Bulk Upload: To start bulk upload.
- Bulk Upload Status: This should display the upload status of the last upload. For the first time when there is no previous bulk upload, this button would remain disabled or upon click should display a message "There is no previous bulk upload".
- For new bulk upload, user should click on "Start Bulk Upload"
- Download the sample upload file from the dialogue box appeared. Format of the bulk upload sheet is as follows: https://docs.google.com/spreadsheets/d/1zo_KVAU3y_RR3p4Gpgud-geROZYXv9Efpgwdflszemc/edit#gid=0
- User should be able to access user guide form the dialogue box appeared (Refer wireframes).
- User populates the bulk upload sheet in the required format.
- Again select "Start Bulk Upload".
- Select bulk upload type from the drop down. Permissible values are:
- Create: Content created and sit in draft stage.
- Create & Publish : Content created and published.
- Create, Publish & Link to Textbook: Content created, published and linked to the respective textbooks as provided in bulk upload sheet.
- Browse the populated bulk upload file. Click on "Upload".
- In case file contains validation errors, error dialogue should appear with listed validation errors (Refer wireframes). User should rectify and upload again.
- In case there is no validation error, upload should start and user should be redirected to Workspace screen.
- While upload is in progress, "Start Bulk Upload" should be renamed to "Bulk Upload in Progress" and it should be disabled for next upload.
- At the same time, clicking on "Bulk Upload Status", should take user to bulk upload status dialogue box, where user should see following fields:
- Start Time
- End Time
- Total number of content
- Content successfully processed
- Content failed
- Link to download status report "Download Status Report"
- Status report would have following additional fields (apart from input bulk sheet fields) for each row (representing each content)
- Upload Status: Success, Fail
- Content Do_Id: If success, than do id of the created content
- Reason of Failure: If fail, than reason of failure
- Once upload is complete, "Bulk Upload in Progress" would again change to "Start Bulk Upload". Now user can start a new upload.
- Till the new upload is started, "Bulk Upload Status" will show the status of previous upload.
- User would be required to rectify the reason of failure and upload the failed content again.
Validations at the time of bulk sheet upload (Results in Validation Errors):
- In case any mandatory column is missing, validation error should be thrown
- Although "QR code" & "Textbook id" fields are not mandatory but in case user selects upload type as "Create, Publish & Link to Textbook", than these fields becomes mandatory and validation error should be thrown in case these columns are missing
Validations while processing each row for creating each content (Results in Content Failure):
- Validation regarding mandatory fields should be checked while processing each row, in case cell value is missing fail that content
- Validation regarding size and permissible data format should be checked for each field of each row, if not complied, fail the content creation