Model Requirements

Overview

This document provides details on how to model the requirements for workflows, user stories and process indicators.

Steps — Model the Service Process Workflow

Given the requirements document from your business analyst, create a process model that captures who (role) performs what (activity) in what sequence to achieve the desired outcome.

Workflow diagram for birth certificate registration

Start by identifying the users. The users could be citizens, vendors or employees. It is essential to identify the roles users play — e.g., in the above example, the citizen is the "Applicant", the vendor is the "Verifier", and the Head of Department is the "Approver".

DIGIT Concepts

Tenant DIGIT is a hierarchical multi-tenant system. The state can be a tenant. Departments can be the next-level tenant. For example, Punjab can be a tenant denoted by pb. The education department can be denoted by pb.education.

Role Role can be configured to provide a set of access to the user. The "Approver" role allows users to approve or reject the application, but does not allow the user to edit the application.

User When a user is created in DIGIT, they are mapped to a tenant and a role. So they have access only to the data that belongs to that tenant and can perform only those activities as defined in the role.

Workflow Workflow is defined as a set of states (e.g., New, Submitted, Verified, Approved). At each stage, different roles can perform different actions — e.g., Verifier can verify an application only when the application is in the "Submitted" state. Abstracting workflows allows DIGIT to configure different workflows for different tenants. For instance, if Jalandhar wants to configure additional roles and steps in the Birth Certificate process (as compared to Amritsar), then it will be possible to do so.

For each role, draw a swim lane (grey horizontal bar in the above diagram) which contains all the activities (boxes and rhombus). The activities should ideally be expressed in a "Verb Noun" pattern (e.g., pay charges, verify application).

Activity Details

Activities can be elaborated in two ways — as a user story or a use case.

  • User Story (informal)

    • Format: “As a [persona], I [want to], [so that].”

    • Example: As an Applicant, I want to be able to enter the form as quickly as possible. I want to know the process and when the certificate will be available to me.

  • Use Case (formal)

    • Captures exact steps and alternate flows.

    • Example: The Applicant logs into the system by entering the user name and password. The applicant then enters the following fields - child's name, mother's name, father's name, date of birth, and place of birth. All these fields are mandatory.

If you are following an agile process, then the user story-based approach works well. Agile also works well when you are not clear about the end outcome and want to iterate. However, if you are clear about what you want and also want to avoid too much back-and-forth communication between the product and engineering team during development with predictable outcomes, then go with the use case-based approach.

Process Performance Indicators

Identify the process performance indicators that an administrator may want to see to monitor and identify areas of improvement. For example, the administrator may want to see the following metrics and compare them over various time periods and administrative hierarchies.

1

Number of applications

Total count of applications received.

2

Number of applications by status

Breakdown of applications by their current workflow status (e.g., New, Submitted, Verified, Approved).

3

Average time to deliver the applications

Mean time from application submission to final delivery.

4

Average time by status

Average time spent by applications in each workflow status.

5

Average feedback

Average user feedback score for the process or service.

6

Number of complaints

Total count of complaints registered.

7

Number of complaints by status

Breakdown of complaints by their current status (e.g., Open, In progress, Resolved).

8

Average time to resolve complaints

Mean time taken to resolve complaints.

9

Number of reopened complaints

Count of complaints that were reopened after being marked resolved.

Last updated

Was this helpful?