Please see http://docs.openlmis.org/en/latest/conventions/nfr.html# for the current status of defining the non-functional requirements for OpenLMIS.


Profiles and Working Data Definitions

OpenLMIS is designed to be used in environments with differing levels of connectivity and by users that will use different sizes of working data. e.g. off-line or in-process stored locally and / or that a user works with at any given time.

The proposed working data is broken up into a proposal for the current system functionality and a long-term proposal that incorporates the needs to adequately test the stock management features. The long-term working data will likely require some significant architectural changes to some of the services, particularly in the UI and Offline areas, which is why it is not being considered for the current working data.

See External User Profiles for more detailsSystem SpecsMozambiqueMalawiTanzaniaZambiaProposedLong-Term ProposalOLMIS UATMalawi DEV

Administrator

(Implementer or overall system admin)

Same as below
  • Facilities: 1,600
  • Programs: EPI, Pharmaceuticals, ARV's, TB, Malaria
  • Full-supply: ≈300
  • Non-full supply: ≈1,300
  • Users: 2,000
  • Facility types: 
    • ≈5 Facilities:
      • Central Hospitals;
      • Province Hospitals;
      • District Hospitals;
      • Rural Hospitals;
      • Health Centers;
      • Community workers (APE's);
    • 4 warehouses:
      • National;
      • Provincial;
      • District;
      • Intermediary (Pilot)
  • Facilities: 900
  • Programs: 6
  • Full-supply: 400
  • Non-full supply: 6000
  • Users: 500
  • Facility types: 13
  • Facilities: 6100
  • Programs: 4 (ARV, ILS, LAB, TB)
  • Full-supply: 1020
  • Non-full supply: 240
  • Users:4913 
  • Facility types: 6
  • Facilities: 2600
  • Programs: 4 (ARV, ILS, LAB, TB)
  • Full-supply: 722
  • Non-full supply: 323
  • Users: 2353 
  • Facility types: 5
  • Facilities: 4,000
  • Programs: 10
  • Full-supply: 500
  • Non-full supply: 3,000
  • Users: 1,000
  • Facility types: 10
  • Facilities: 10,000
  • Programs: 10
  • Full-supply: 2,000
  • Non-full supply: 10,000
  • Users: 5,000
  • Facility types: 15
Facilities: 2729
Programs: 4
Full-supply: 1040
Non-full supply: 2
Products: 10061
Users: 1204
Facility types: 5
Facilities: 877
Programs: 6
Full-supply: 271
Non-full supply: 1065
Products: 1495
Users: 513
Facility types: 13

N Program Supervisor

(interested in national or regional view)

  • Bandwidth: 3g
  • Browser: Firefox 48+, Chrome 52+
  • Screen Resolution: 2049x1152
  • Facilities: ≈1400
  • Programs: 1
  • Facilities: 900
  • Programs: 2
??
  • Facilities: 6100
  • Programs: 4 (ARV, ILS, LAB, TB)
  • Full-supply: 1020
  • Non-full supply: 240
  • Users:4913 
  • Facility types: 6
  • Facilities: 1,000
  • Programs: 1
  • Full-supply: 200
  • Non-full supply: 2,000
  • Users: 1,000
  • Facility types: 10
  • Facilities: 2,000
  • Programs: 5
  • Full-supply: 1,000
  • Non-full supply: 7,500
  • Users: 5,000
  • Facility types: 10
Facilities: 336
Programs: 1
Full-supply: 24
Non-full supply: 2

District Storeroom Manager

(submits requisitions on behalf of facilities)

  • Bandwidth: 2g (Malawi 3g)
  • Browser: Firefox v48+, Chrome 52+
  • Screen Resolution: 1920x1080
  • Facilities: ≈30
  • Programs: EPI, Pharmaceuticals, ARV's, TB, Malaria
  • Facilities: 50
  • Programs: 6
  • Max FTAP Full-supply: 300
  • Max Non-full: 6,000
  • Facilities: ?
  • Programs: ?
  • Max FTAP Full-supply: ?
  • Max Non-full: ?

All Facilities in the district: An average of : 25


  • Facilities: 30
  • Programs: 5
  • Full-supply: 200
  • Non-full supply: 2,000
  • Users: 100
  • Facility types: 5
  • Facilities: 100
  • Programs: 5
  • Full-supply: 500
  • Non-full supply: 6,000
  • Users: 5,000
  • Facility types: 15
Facilities: 673
Programs: 2
Full-supply: 1027
Non-full supply: 2

Storeroom Manager

(or Store Manager who submits requisitions on behalf of its facility)

  • Bandwidth: 2g
  • Browser: Firefox v48+, Chrome 52+
  • OS: Windows 10+
  • Screen Resolution: 1366x768
  • Facilities: 1
  • Programs: EPI, Pharmaceuticals, ARV's, TB, Malaria
  • Facilities: 1
  • Programs: 6
  • Max FTAP Full-supply: 150
  • Max Non-full: 2,000
  • Facilities: 1
  • Programs: ?
  • Max FTAP Full-supply: ?
  • Max Non-full: ?

4 Programs (ARVs, Lab Products, Essential Medicines, HIV test kits,  

  • Facilities: 1
  • Programs: 5
  • Full-supply: 200
  • Non-full supply: 2,000
  • Users: 1
  • Facility types: 1
  • Facilities: 1
  • Programs: 5
  • Full-supply: 500
  • Non-full supply: 2,000
  • Users: 1
  • Facility types: 1
Facilities: 673
Programs: 2
Full-supply: 1027
Non-full supply: 2

Warehouse clerk<need to define>



  • Facilities:
  • Programs:
  • Full-supply:
  • Non-full supply:
  • Users: 
  • Facility types: 
  • Facilities:
  • Programs:
  • Full-supply:
  • Non-full supply:
  • Users: 
  • Facility types: 
Facilities: 17
Programs: 1
Full-supply: 13
Non-full supply: 0

Notes:

Performance

Application Performance Goals

We use the word 'goal' rather than 'requirement' here to denote that these performance goals, at least at the current time, should be considered aspirational rather than hard requirements. The current system has a long way to go to achieve these goals but we believe that we will reach them (or get closer to reaching them) more quickly by setting more aggressive targets rather than more conservative ones.

Rather than defining the goal for each use case/scenario, we are defining an overall baseline and then only call out the deviations from that baseline. Measuring the Time to First Byte (TTFB) for the server response is a good initial requirement as it limits the possible external factors that could influence the result and tests already exist in the OpenLMIS build pipelines to gather this data. Other metric requirements that could be added later include:

These additional metrics would give a more representative measure of how the system feels for the actual users; it doesn't mean much to users if the TTFB is <200ms if the download and rendering take another 59 seconds. Each of these metrics would provide an indicator for a specific part of the overall performance:

MetricIndicator
Page Upload Time (PUT)

Client-Side Processing Time and Data Volume

Time to First Byte (TTFB)Server-Side Processing Time
Page Download Time (PDT)Page Data Volume and Overall Request Timeline
Page Load Time (PLT)Client-Side Page and Data Processing Time

A common understanding on the context for these goals will also be helpful, especially:

Note that for the purposes of these goals we may want to keep the overall measurement (PLT) broad and not too closely tied to the underlying requests being made while still being easily reproducible.


The server hardware profile is assumed to be in line with the recommendations here.


Use Case/ScenarioProfileRelevant Working DataBaseline 3.3.1Proposed
PUT (sec)TTFB (ms)PDT (sec)PLT (sec)PUT (sec)TTFB (ms)PDT (sec)PLT (sec)
(Default)(Any)(Profile Working Data)




500
5
LoginStoreroom managerN/A


36
(500)
(5)

Initiate Requisition


District Storeroom Manager

(see above)

# Processing Periods: 12

(plus general working data above)


54802232
(500)
(5)
Save (sync) Requisition(same)(same)2.771504.8624
(500)
(5)
Submit Requisition(same)(same)2.717590

2.43

34
(500)
(5)
Authorize Requisition(same)
2.7172702.4322
(500)
(5)
Approve Requisition

N Program Supervisor

How many Requisitions are waiting for approval?

Malawi: average 40 (Per Malawi’s processes, the districts prefer to approve the forms collectively. So in this case, ~40 forms to approve at a time, we do have an outlier, they have 80 forms they would like to approve at one go)

2.62430

2.43

25


(500)
(5)
Batch Requisition ApprovalN Program Supervisor

How many Requisitions?

Malawi: average 40




(3.3.0) 104


1000
30
Convert to Order (one)Warehouse clerk

Max number of approved requisitions waiting for approval

Malawi: average 80


1440
5
(500)
(5)

Convert to Order (multiple)

Warehouse clerk

How many approved requisitions?

Malawi: 30 - 40




(8) 20
(8) 1000
(8) 10
Filter performance on the convert to order page

Max number of approved requisitions waiting for approval

Define the # of variables for the filter









View Requisition

(filter performance)








250
0.5
Fulfill Order









Scalability

Requirement from CdI: The application should support at least 1700 users. The system should support at least 1000 concurrent users. The system should support 1500 health centers, with one user per health center. The system should also support an additional 50 facilities with an average of 3 users each.

This requirement may want to be more detailed as what does it mean to "support" 1700 users? Likewise, does what does the usage of 1000 concurrent users actually look like? How many concurrent requests would that likely entail and what type of concurrent operations are likely be to occurring?

Availability

Network Usage

Client Side:

Server Side:

Browser

This section outlines general performance metrics for the OpenLMIS-UI running in a web browser

DescriptionExpected PerformanceTickets
RAM usageBelow 1gb ram for the browser
Disk space usageWill vary based on profile