Introduction: 

This document describes the design for Programs to integrate with Sunbird Portal and also discusses the ability of Programs to support and launch multiple programs for various adopters.

Overview: 

Currently, Programs are used by a single adopter to run a specific activity within a defined scope which uses minimum configuration. It is currently used to create a specific set of content types. (Example: QuestionSet creation). By and large it is used for creation purpose. 

Problem Definition: 

Program portal should be able to support to launch multiple programs configured for various adopters. A program can have more than one activity. Each activity can take its own configuration. An admin of the program adopter should be able to define the scope, actions, tools etc based on the activity/purpose. Programs on the portal should be able to handle multiple active programs at a time. 

Key Area to be analysed:

1. Ability to load components dynamically based on configuration 
2. Ability to load components dynamically on multiple levels based on configuration

Solution: 

Program configurations based on components

Since each tool (comprises of multiple components and tools can share the same components between each other) is going to solve the purpose of each activity in a program, the program can have its configurations based the input that each component in the tool is expecting. 

Say for example, if the purpose of the program is to just see the coverage of textbooks, then the tool that is used in the program would expect a scope to be defined i.e: Board, Class, Medium, Subject, Framework. This can be the program configuration and nothing else would be required by the admin to see the coverage. 

The expected config of a tool will reside as a manifest inside each high level components.

Manifest.json for the above example would be: 

{
  "Configuration": {
    "scope": {
      "classes":"",
      "subject":"",
      "board":"",
      "medium":"",
      "framework":""
    }
  }  
}

Let us take an example of a program whose purpose is to create content for different contentTypes such as PracticeSet, Explanation, Experiential, CuriositySet, etc for each chapter in a given textbook. 

The workflow of the above mentioned program can be split into two parts

1. Creation
2. Review and Publish

Creation: 

In creation, a contributor with creator access visits the program and does the following

1. Chooses a textbook of a particular class and subject
2. Chooses a contentType of a particular chapter that is to be created
3. Chooses a questionCategory if the contentType is either PracticeSets/CuriositySet
4. Creates a content or assessment based on the chosen content type 
5. Previews the created assessment or content and submits for preview

Review

1. Chooses a textbook of a particular class and subject
2. Chooses a content of a chapter that are up for review
3. Sees the preview of the content before doing Accept/Reject and publishing
4. If rejecting, leaves a the reason as a comment to reject. 

The above listed actions can more or less be broken down into the following components. 

1. Collection Component Component
2. ChapterList Component
3. ContentCreation Component
4. ContentUpload Component
5. Preview Component

Each component will take its own configuration.

For example: The Collection component would expect CollectionType, Board, Class, Medium, Subject, Framework to list the textbook.

Similarly, ChapterList component would expect CollectionId and List of content types

If we put together all the component and its required configurations into a module/highlevel component the following would be the overall configuration.

{
  "pageAssemblyId":"",
  "scope": {
    "classes":"",
    "subject":""
  },
  "collectionType":{
    "name": "Collection type",
    "type": "string",
    "enum": "Textbook, Course"  
  },
  "contentTypes": {
    "name": "List of contentTypes",
    "type": "List",
    "enum": ["PracticeQuestionSet", "Lessonplan", "ExperientialResource", "FocusSpot", "CuriosityQuestionSet", "ExplanationResource"]
  },
  "questionCategories":{
    "name": "List of AssessmentItem Categorys",
    "type": "List",
    "enum": ["VSA", "SA", "LA", "MCQ", "CuriosityQuestion"],
    "hints": "When PracticeQuestionSet is set for contentTypes AssessmentItem Categorys must be"
  },
  "ckEditorConfig": {}
}

With this basic set of configurations, a program can be created by an admin of the program. 

{
  "id": "api.program.read",
  "result": {
    "programId": "",
    "description": "",
    "endDate": "",
    "name": "",
    "slug": "",
    "startDate": "",
    "status": "",
    "type": "",
    "tools": {
      "tool1": {
        "name": "",
        "configurationValues": "",
        "actionMappings": {
          "actions": "",
          "role": []
        }
      },
      "tool2": {
        "name": "",
        "configurationValues": "",
        "actionMappings": {
          "actions": "",
          "role": []
        }
      }
    },
    "config": {
      "roles": [
        {
          "role": "CONTRIBUTOR"
        },
        {
          "role": "REVIEWER"
        }
      ],
      "onBoardForm": {
        "templateName": "onBoardingForm",
        "action": "onboard",
        "fields": [
          {
            "code": "class",
            "dataType": "text",
            "name": "Class",
            "label": "Class",
            "description": "Class",
            "inputType": "select",
            "required": false,
            "displayProperty": "Editable",
            "visible": true,
            "range": [
              {
                "identifier": "Class 1",
                "code": "class1",
                "name": "Class 1",
                "description": "Class 1",
                "index": 1,
                "category": "class",
                "status": "Live"
              },
              {
                "identifier": "Class 2",
                "code": "class2",
                "name": "Class 2",
                "description": "Class 2",
                "index": 2,
                "category": "class",
                "status": "Live"
              },
              {
                "identifier": "Class 3",
                "code": "class3",
                "name": "Class 3",
                "description": "Class 3",
                "index": 3,
                "category": "class",
                "status": "Live"
              }
            ],
            "index": 1
          }
        ]
      },
      "scope": {
        "board": [
          "NCERT"
        ],
        "gradeLevel": [
          "Kindergarten",
          "Grade 1",
          "Grade 2",
          "Grade 3",
          "Grade 4"
        ],
        "medium": [
          "English"
        ],
        "subject": [
          "Hindi",
          "Mathematics",
          "English",
          "Telugu"
        ],
        "topics": [
          ""
        ],
        "framework": "",
        "channel": ""
      }
    },
    "defaultRoles": [
      "CONTRIBUTOR"
    ]
  }
}