...
Responsible Person: | |||||||||||
Other parties to review/input: | |||||||||||
FYI: | |||||||||||
Targeted release date: |
| ||||||||||
Jira Status: |
|
*Note opensrp code for opensrp generic peer-to-peer sync: https://github.com/OpenSRP/android-p2p-sync
*For Reveal we have to build the ability to sync structures and task and filter by plans
Process
- Prepare rough business analysis/reqs doc (Derek Pollard: IN PROGRESS)Complete) Pierre Dane, please review before requesting CHAI team to review.
- Get CHAI review
- Get Akros Review
- Get Ona feedback
- One iteration
- Ona sign off
- Ona tech spec scoping
- Ona LOE
- Ona scheduling
Assumptions
Each user would have to pre-download the plan, maps etc for each area as those cannot be synced.
- Query running sync will first look at which plans are shared by the two users trying to sync.
- Two tablets sync to each other at a time.
- A sync from one sender device to another receiver device will send all data to the receiver that does not already exist on the receiving tablet.
- All synced data should have a sync id.
Definitions
- Peer-to-peer sync in the process by which, two or more tablets sync data across themselves without a "master tablet" syncs one by one to each of the other tablets of interest without syncing to the server first. This would be done through some local network mechanism (bluetooth, hotpsot) from the devices. The outcome will be to provide offline coverage indicators for the "master tablet."
Requirements
Sync data within a specific operational area between tablets that collected data in that operational area.
Ensure data is not sent back to a tablet that it was already synced from (sync unique ids)
Get confirmation of what data was synced between tablets to ensure all data was sent and received.
Display coverage indicators for that operational area that reflect all synced data and filters out any duplicates to show one spray status per structure. See workflow below for indicators suggested and reason.
Views
- Select icon from hamburger menu to view on app indicators.
- Select progress dashboard icon
- Note that it would be good to show the total number of structures within this operational area and the completeness status based on coverage. Complete = 90% and over. Nearly there = 60 to 90%. Far out = 10 to 60%. Not visited yet = less than 10%.
- Note the ‘Sync’ at the top has changed to ‘Server Sync’
- OR select icon from map view to bring up on app indicators
- Brings up a page of key indicators. Select MAP to go back to the map or select PEER SYNC to start peer to peer sync with other data collectors devices.
- Note the order of indicators is to try simulate the decision process whether using structures or rooms as your spray coverage per operational area.
- Have I reached my target > No. How many structures are there still to possibly spray (Not visited plus not sprayed) to help inform how many teams I should send back > 63. Of those how many do I need to spray to reach my 90% minimum target coverage > 34. Is spray success rate below 90% and therefore will require revisiting some structures already visited but not sprayed > No. If yes, to determine if it’s worthwhile trying to convert not sprayed to sprayed, then how many of those were because of refused > 3. How many structures are available that weren’t refused >60. Is this above my minimum target of 34 structures and therefore likely for my teams to be able to reach the 90% target if they continue to spray > Yes. If no, then likely need to bring someone in to convince people to accept IRS or decide to get coverage as high as possible and then leave it at that.
- Get peers you need to sync with to also select ‘PEER SYNC’ and wait for them to connect and become available. ‘RUN SYNC’ is not selectable until at least 1 user is selected.
- Select peers to sync with and then select ‘RUN SYNC’ to start syncing between devices.
- Once SYNC is complete go back to indicators by selecting the ‘progress dashboard icon’ – not visible here but should be below MAP in the grey.
Notes
Overview of sync and offline indicators from mSpray:
...
- Spray coverage
- Room coverage
- Number of structures required to get to 95%
- Number of rooms required to get to 95%
- * Accuracy of the calculation is key
- Show how many records have been sent.
- Deal with multiple data collected from the same structure
- Is all data synced
Requirements
Sync data within a specific operational area between tablets, including those tablets that collected data in that area.
Get confirmation of what data was synced between two tablets to ensure all data was sent and received.
Display coverage indicators for that operational area that reflect all synced data and filters out any duplicates to show one spray status per structure.
...
Justification
Dependencies
...