Versions Compared

Old Version 8

changes.mady.by.user Mary Jo Kochendorfer

Saved on

compared with

New Version 9

changes.mady.by.user Craig Appl

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Adding a technical component and questions for this featureset

...

In addition there is an email and SMS feature which is in development in eLMIS but not yet  completed or in use.  This comprises a link from the “reporting rate” report which leads to an interface where the user can manually push reminders to late reporters.

Assumptions

  • For SMS communications, implementations have budget to support SMS features (which charges per message)

User Stories


#TitleUser StoryLabelImportanceNotes
1SMS and email functionalityAs a facility I want for a range of user-controlled SMS and email communications to be handled and tracked within OpenLMIS so that functionality can be automated and tracked in the same system.



eLMIS TanzaniaMust have
2Automatic R&R rejection notice via email and SMS

As a facility (or districts who submit R&Rs on behalf of facilities reporting on paper) I want to receive automated SMS and email notification when an R&R I submitted has been rejected so that I can address the issue sooner.

eLMIS TanzaniaMust Have
3Supervisor Reports and Push Notification InterfaceAs a supervisor, I want to have an interface where I can perform functions so that I can perform regular tasks and push reminders to late reporters.

eLMIS Tanzania

Must Have

  • see lists of facilities which have not reported yet for the current period, together with the facility’s contact details.  The interface should allow showing of late-reporters across all programs or a selected program.

  • select one or multiple facilities and click on a button leading to an option to send an SMS and/or an  email to the facility(ies) based on a pre-filled template (but editable before sending)

  • in cases where the user is a higher level supervisor (eg zonal), click on a button to notify lower level supervisor (eg district), leading to an option to send an SMS and/or an email to the lower level supervisor based on a pre-filled template (but editable before sending)

    The templates should contain customisable general text as well as placeholders/”form fields” for the facility’s name and the period of the report, which are pre-filled by the system.

4Log of SMS and emails sentAs a supervisor or administrator I need the system to log SMSes and emails sent so that I have a historical record of the communications sent.eLMIS TanzaniaMust Have

Technical Scope

Each of the numbered items below relate to the user stories above.

  1. SMS and email functionality
    1. This functionality assumes that the user wants to be able to track all email and SMS transactions in a single OpenLMIS system. We need to discuss this as something that's architecturally appropriate. There are many third party tools that do this as their core activity and an integration with these tools may be best.
  2. Automatic R&R rejection notice via email and SMS
    1. Rejection emails are not currently in OpenLMIS (Josh Zamor please verify). We can add this to the requisition service as a core feature
    2. SMS would require a different interface and featureset that's independent because it's not currently supported.
  3. Supervisor Reports and Push Notification Interface
    1. This has multiple components:
      1. They would like to see a list of late reporters for the current reporting period. This should be done as a built in report or custom user interface
      2. They want to add a checkbox widget to this report that will allow the user to submit a form that sends an email or SMS notification to the facility manager
        1. This report will somehow need to know if the user has a validated phone number or email address by which they can send a notification
          1. If not, there should be a way for the supervisor to add that to the user account if they have it
        2. Before the message is sent, the user would like to customize the message that's sent
      3. There should be some type of feedback loop that shows how many messages were sent and when
  4. Log of SMS and emails sent
    1. SMS and emails should be logged differently
      1. SMS could be linked to a bill at some point in the future
    2. This should be a report in the system that's available for system administrators.

Diagrams


Dependencies

DescriptionLink

...

#QuestionOutcomeStatus
1For Tanzania user stories: review the users, "so thats" added, review the label, and review the priority level.
2Josh Zamor Do we currently expose the content of email messages that were sent? The Notification service doesn't seem to have a database element

3Currently the emails are sent to an email server that performs the actual sending of messages. The email server should keep a unified view of all messages that were sent and OpenLMIS does not track these. Logically, it seems that notifications should be managed in third party tools with a link to the third party tool exposed in OpenLMIS such as an email server or SMS Gateway like RapidPro or frontlineSMS. Should this be considered an integration instead of a feature that should be built into OpenLMIS?

4Instead of SMS, could we use a chat system like Telegram or Facebook messenger? These systems don't charge per message and could be cheaper than SMS.

5Does the user need to be actively connected to the OpenLMIS server to send messages? What features should be available when offline?

6What should we do when the SMS gateway has run out of money and needs to be recharged?

7The current system posts emails in realtime. Do we need to somehow queue messages? What about automated retries?

8Do we need to keep a log of the message content, or just a list of which messages were sent?

9How long should we keep this log? Does it need to be in a database, or will a text file with logrotate be fine? Database entries could get big quickly.

Out of Scope