An example application of CareKit's OCKSample synchronizing iOS

by iOS Example

CareKitSample+ParseCareKit

An example application of CareKit's OCKSample synchronizing CareKit data to the Cloud via ParseCareKit.

ParseCareKit synchs the following entities to Parse tables/classes:

  • [x] OCKTask <-> Task
  • [x] OCKOutcome <-> Outcome
  • [x] OCKOutcomeValue <-> OutcomeValue
  • [x] OCKNote <-> Note
  • [x] OCKRevisionRecord.KnowledgeVector <-> Clock
  • [x] OCKPatient <-> Patient
  • [x] OCKCarePlan <-> CarePlan
  • [x] OCKContact <-> Contact

Use at your own risk. There is no promise that this is HIPAA compliant and we are not responsible for any mishandling of your data

Setup Your Parse Server

You can setup your parse-server locally to test using parse-hipaa. Simply type the following to get your parse-server running with postgres locally:

  1. Fork parse-hipaa
  2. cd parse-hipaa
  3. docker-compose up - this will take a couple of minutes to setup as it needs to initialize postgres, but as soon as you see parse-server running on port 1337., it's ready to go. See here for details
  4. If you would like to use mongo instead of postgres, in step 3, type docker-compose -f docker-compose.mongo.yml up instead of docker-compose up

Fork this repo to get the modified OCKSample app.

  1. Fork CareKitSample-ParseCareKit
  2. Open OCKSample.xcodeproj in Xcode
  3. You may need to configure your "Team" and "Bundle Identifier" in "Signing and Capabilities"
  4. Run the app and data will synchronize with parse-hipaa via http://localhost:1337/parse automatically
  5. You can edit Parse server setup in the ParseCareKit.plist file under "Supporting Filles" in the Xcode browser

View your data in Parse Dashboard

Parse Dashboard is the easiest way to view your data in the Cloud (or local machine in this example) and comes with parse-hipaa. To access:

  1. Open your browser and go to http://localhost:4040/dashboard
  2. Username: parse
  3. Password: 1234
  4. Be sure to refresh your browser to see new changes synched from your CareKitSample app

Note that CareKit data is extremely sensitive and you are responsible for ensuring your parse-server meets HIPAA compliance.

Transitioning the sample app to a production app

If you plan on using this app as a starting point for your produciton app. Once you have your parse-hipaa server in the Cloud behind ssl, you should open ParseCareKit.plist in Xcode and change the value for Server to point to your server(s) in the Cloud. You should also open Info.plist in Xcode and remove App Transport Security Settings and any key/value pairs under it as this was only in place to allow you to test the sample app to connect to a server setup on your local machine. iOS apps don't allow non-ssl connections in production, and even if you find a way to connect to non-ssl servers, it wouldn't be HIPAA compliant.

GitHub