2020 Notes & Recordings
- 1 2020-12-17: Updates on current Forms Plan, whitelabelling, Registration page, and general 2021 direction
- 2 2020-12-10: Squad call, GitHub Actions update/demo, LHC forms demo
- 3 2020-11-26: Grid layout & Grid view widgets,
- 4 2020-11-19: Squad Updates: Forms2, Registration designs, Clinical Views designs
- 5 2020-11-16: Sprint planning
- 6 2020-11-12: Sprint Demo: Carbonizing Registration page, widgets, and changing language; Design Updates for Test Results, and Developer Guide to Developing a MF Distro
- 7 2020-11-09 - Live demo of the Gopher Teaching EMR chart search
- 8 2020-11-05 - Demos & Updates
- 9 2020-01-02 - Product Design Session
- 10 2020-10-29 - Demos & Updates
- 11 2020-10-19 - Design Call: Med Order Workflow Updates, Identifying Features Ready for Development
- 12 2020-10-15 - Order Entry Update, How to Release, and Design Updates
- 13 2020-10-08 - Check-in Call
- 14 2020-09-28 - Design Call - Medication Order Designs Update
- 15 2020-09-24
- 16 2020-09-17 - Demo ongoing work - order entry designs, carbon styling
- 17 2020-09-15 - Virtual HIV visit workflow using POC
- 18 2020-09-14 - User testing process - Order entry
- 19 2020-09-14 - Sprint 5 planning
- 20 2020-09-10 - Squad Check-in and Sprint Demo
- 21 2020-09-08 - Design Session
- 22 2020-08-31
- 23 2020-08-27: Demos of ongoing work: identifier generation, extensions
- 24 2020-08-20: Sprint review & extensions discussion
- 25 2020-08-10: Design Call
- 26 2020-08-07: Insights from Ajay Brar re. Style Guides vs Design Systems
- 27 2020-8-03 Design Call
- 28 2020-07-27 Condition Widget - Modelling Design Call
- 29 2020-07-23
2020-12-17: Updates on current Forms Plan, whitelabelling, Registration page, and general 2021 direction
Recording: https://iu.mediaspace.kaltura.com/media/1_i9hugzif
Attending: Nikita, Grace, Eric, Dimitri, Brandon, Eudson, Jonathan Teich, Burke, Larry, Donald, Daniel, Romain, Tendo
Whitelabelling plan for January
Simple. Focus is showing in January what it would look like to change just a few things. (One day might be nice to have a module that could add some pre-config'd style sheets.)
Goal: easy for non-tech person to configure in Implementer Tools.
Registration Page Work
Reg Page Configuration needs to be sorted out asap so we can complete this page
Brandon and Larry working on this; has been complex; trying to support the many ways that Implementers may need to customize it
Forms Plan at the Moment
Focus now will be on integration of HFE for backwards compatibility; Nikita focusing on supporting that. Quickly demonstrate we can run HFE forms somewhere in our framework.
LHC forms: Off the table for now. Requirements not clear enough. Might be possible if there's a useable layer under the Angular code driving the frontend. Concerning that the FHIR model seems unstable. Follow up planned between Burke, JJ, and Clem (head of LHC forms).
Bahmni Forms2: Also off the table for now. There's core Bahmni tech debt to address and not enough collaborative resources to do so. Would require dismantling Bahmni core, extracting into separate module, and then there would still be FHIR things to do.
Ampath forms: not off the table.
Plan: Make it work with the quick solution first. Then, lean towards something better integrated.
Test Results viewer
This is the next big deliverable we should be seeing in the new year. Nikita likely will work on it.
Frontend Architecture
Brakes on changing Architecture! 2021 is about delivering, building on what we've done
Attachment Module
Plan: Extension via attachment-esm; Samuel will be working on this
2020-12-10: Squad call, GitHub Actions update/demo, LHC forms demo
Recording: https://iu.mediaspace.kaltura.com/media/1_mddh30rz
Attendees: Burke, Grace, Paul Lynch, JJ, Nikita, Ajay Kanduru, Brandon, Ciaran, Daniel, Dennis, Dimitri, Donald, Eudson Bambo, Florian, Ian, Jonathan T, Samuel, Romain
GitHub Actions Update/Demo
See example: https://github.com/openmrs/openmrs-esm-patient-chart/pull/198/files Note that linting issue is immediately visible in PR thread
LHC Forms Demo/Discussion
Special Guests: Paul Lynch, Ajay Kanduru, Eudson Bambo, Ye Wang
Go to lhcforms.nlm.nih.gov (note that LHC-Forms Widget isn't FHIR based - no pre-pop; just core-rendering, b/c created before FHIR)
We're missing/craving the FHIR-based approach to forms. Good to produce the FHIR Qnr.
What's the underlying schema to represent the form? Core representation is FHIR.
Form Builder Implemented in AngularJS? Yes.
Clinical Table Search Service
Useage in production systems: Used at Regenstrief & a Chronic Disease project at ___. May be in production systems they don't know about b/c it's open source.
The way FHIR envisions this working is that the questionnaire corresponds to a questionnaire response, which is just values linked against the questions defined in the questionnaire, but that the backend can do additional processing from the questionnaire response to generate the linked resources. Basically, forms are a two step process: the data collection and processing that data collection. Only the first seems really defined by LHC Forms. So there's a large degree of mapping the data meaningfully that we'd still need to handle, but with some additions to the FHIR2 module we should be able to make that roughly as easy to do as it is in any of our form building tools
2020-11-26: Grid layout & Grid view widgets,
Recording: https://iu.mediaspace.kaltura.com/media/1_ug1o4e5k
Updates:
Donald - Vitals and Biometrics widget grid view:
Dennis - Grid layout
Florian
Big live development session!
tl;dr - Showed the tech Framework in great detail
User Testing the Test Results wireframes - to Start Wednesday next week
2020-11-19: Squad Updates: Forms2, Registration designs, Clinical Views designs
Recording: https://iu.mediaspace.kaltura.com/media/1_ghm1g6p8
Forms2: Nikita and Florian have begun work on Bahmni Forms 2; call tomorrow with Angshu to go over approach and agree on architecture. (Goal is to have mf-ized Forms2 by the end of the year so that Forms can be created in Forms 2 and then displayed, used, and submitted in our 3.0 Frontend beta; may not be robust by end of year.)
Want no forking; goal is collaboration & shared goal/resource.
Demos: JJ leading demo with UCSF next week.
Eric away Nov 23-Dec 8
Registration designs discussed
Clinical views designs discussed
2020-11-16: Sprint planning
Attendees: Burke, Brandon, Daniel, Dennis, Dimitri, Donald, Eric, Florian, Grace, JJ, Larry, Nikita
Overall Sprint Plan: Complete implementation of the new designs so that our prototype has an end to end patient visit workflow.
Prioritize: Registration, Vitals, generic Form, and Summary page.
Wireframes here: https://app.zeplin.io/project/5f7223cfda10f94d67cec6d0
Encouragement that Devs in EAT contact Florian, Nikita throughout the week - don't wait for Thursday calls. They are especially available in the morning.
TODO: Florian and Nikita to f/u w Ciaran: We need more flexible guidance so it's not so explicit pixel sizes. And, it needs to specify what components of Carbon are being used, so the dev can use as much as possible directly from Carbon (not custom CSS instructions).
Defer to Carbon first to set the terms
Is Carbon integrated into Zeplin, or Sketch? (E.g. in AdobeXD their designers could say "I want this button from this UI framework to be placed here" so in styleguides/css guidance it clarified "button type: primary")
E.g. what Carbon tool is this:
Is the info being lost in Zeplin transition?
2020-11-12: Sprint Demo: Carbonizing Registration page, widgets, and changing language; Design Updates for Test Results, and Developer Guide to Developing a MF Distro
Attendees: Dennis, Donald, Grace, JJ, Ciaran, Daniel, Dimitri, Eric, Ian, Larry, Jonathan Teich, Nikita, Samuel, Brandon
Recording: https://iu.mediaspace.kaltura.com/media/1_1a8ut7b9
Announcements/Updates:
Welcome Nikita from Smapiot (Florian and Nikita are taking over Manuel's work)
Monday: Sprint Planning - focus on converting
Meeting w/ Bahmni technical team Tuesday next week to talk about collaborating on microfrontendizing work moving forward (namely on Appointments and Forms2)
Demos
Implementing Carbon in Relationships Search - Larry
Checked relationships via API query:
Carbon was straightforward: npm install the library, then import the components like you would import other components like React. Documentation wasn't so clear, even misleading: e.g. auto-suggest component, but reading more, it was just a pattern sharing how people usually use the search box; they didn't actually ahve this implemented; this took time
Next: Carbonizing the whole registration page ongoing.
Implementing Carbon in Registration Page - Donald
Carbonizing widgets - Dennis
Empty state and Error state designs implemented
MF373
Carbon: Finding he can move faster now, and faster than with previous style guide; but some edge cases: e.g. compiling
Translations - Dennis
Defining language by lng= parameter
Switch to spanish with lng=es
Would
Strings are pulled from Transifex https://www.transifex.com/openmrs/OpenMRS/dashboard/
Config Tool updates - hover state to show Name - Donald
Tooltip showing extension slot name - would be nice to see value too
Extensions Slot: Florian
Don't need to use attach function anymore
Next: bringing extensions to the global state container. Can connect the tools directly to that container.
Forms 2 - no work yet; frontend logic split between two repos and intermangled with each other. Need to find solution to restructure that code so it can be frontend facing the way they need it, but so on the other hand, we can cherry-pick from the visual components.
Design Updates: Results Page
Results Page, and side navigation and filtering workflows. Full video here: https://www.loom.com/share/a24ec114e2784053ae8bc4af7945eb7f
Documentation Update: Developer Guide for MicroFrontends
Goal: Help people get started using MFs, and get them set up to contribute if they want to. Documentation has been spread across many repos; trying to put it in one clear place we can direct people to.
https://docs.google.com/document/d/1Ihr26LXhyr3qQM4RV8ltZC-333Ga9a5eaWJyzCTkw90/edit?ts=5fab2e71
TODO: Florian to add some screenshots
TODO: JJ to Move to GitHub as an RFC next week
2020-11-09 - Live demo of the Gopher Teaching EMR chart search
Recording: https://iu.mediaspace.kaltura.com/media/1_bi91ne13
2020-11-05 - Demos & Updates
Recording: https://iu.mediaspace.kaltura.com/media/1_2xsl04e0
Plan for UI improvements to the implementer tools?
Attendees: Burke, Dennis, Nikita, Ciaran, Daniel, Donald, Dimitri, Eric, Florian, Ian, Larry, JJ, Jon Teich, Kim Oxlund, Mike, Romain, Grace, Samuel, Sharif
Welcome Nikita developer, will be working closely w/ Florian also on Forms 2 engine
Demo of updates to Dev tools config - Florian - can turn on/off settings
Demo of Drug Ordering progress - Florian
Update of Carbon Design System integration into Patient Summary - Dennis
Using Carbon was smooth; Tutorials on Carbon's website were really helpful
Seeing error because Immunizations not yet fully supported by FHIR2
UX Update
All user feedback details now really small
Still working on workflow for jumping between tasks, like between Visit Note vs Order Basket
Need support for backend auto-saving
Nikita and Florian to start implementing
Before & After video to share with OMRS Community the design progress: "The MFE squad has been working hard to create a frontend that's extensible; this is what we're now working with. We think this has great potential and want to share how things are looking. We want to know we're meeting key needs - Join us..." Most recent video is in slack. Video Script - Grace & Ciaran to follow up.
2020-01-02 - Product Design Session
2020-10-29 - Demos & Updates
Time Zone changes coming this weekend to EDT → EST, and PDT → PST. Proposal: shift forward 1 hr UTC due to other calls as well.
Manuel - presentation of latest Order Entry dev work
Manuel - presentation of early tech to enable building microfrontends without dependencies
Ciaran - summary of feedback from User Testing
3 user tests this week of patient visit workflow
Difference between data you record once, vs things that change more frequently
Being able to see relationships and their HIV status - if known to the system, could you jump into their pt chart if they present as a family unit at the clinic
Wanted to see if pt has any Mental Illnesses
Recommended Actions were great but wanted to see them at the end of the visit as a double check before ending the visit
Order Entry - wanted to see who wrote certain notes
Appointment Scheduling - visualizing what it looks like when a user misses an appointment
Grace - Pitch to pilot using GitHub issues: https://docs.google.com/presentation/d/1HL0vh_edTrwGLbbLEo6jjFcackquwREsoC9gREIXqps/edit#slide=id.g8bb4aa155a_0_10
2020-10-19 - Design Call: Med Order Workflow Updates, Identifying Features Ready for Development
Attendees: Burke, Ciaran, Grace, JJ, David, Eric, Ian, Romain, Sharif
Recording: https://iu.mediaspace.kaltura.com/media/1_emn474p8
Med Order Workflow Updates
Tablet or Strength based order flow? We think we need both.
Need to set up next set of user tests to start next week.
Identifying Features Ready for Development
Vitals entry
Focus on widget/tile/form-level features
Action Items
* Grace & JJ - get example medication orders for Ciaran that will act as test cases for whether order entry design captures needs
2020-10-15 - Order Entry Update, How to Release, and Design Updates
Recording: https://iu.mediaspace.kaltura.com/media/1_tq1z6c3r
Attendees: Burke, Brandon, Daniel, Donald, Eric, Florian, Grace, Ian, JJ, Manuel, Mike, Sharif
Global State demo - Florian
Order Entry Update
Manuel - Order Entry - improved search experience, pagination, free text dosage, can now edit dose, Fixed duration and Rx refills so can't be negative value
Next - implementing changes in designs, connect floating order basket with reality
Can even search by dose and frequency
Drug info being pulled from REST API (not FHIR - dosing format, pill sizes, durations, doesn't have support in FHIR yet)
Concern: Using JSON as drug search endpoint. This was made to help make UI faster to prefill based on common order patterns, but search should probably hit the endpoint on OpenMRS.
Process for adding code.
PR
Discuss it
Merge
Make a new release
Brandon: I encourage the use of https://github.com/github-changelog-generator/github-changelog-generator for generating release notes. It'll create a CHANGELOG.md. You can just copy-paste the section corresponding to the latest tag.
https://github.com/openmrs/openmrs-rfc-frontend/blob/master/text/0022-versions.md - see recommendations related to toggl
Maybe control esm-core releases tightly? Plan: do a release at the end of each sprint (at end of demo call, publicly viewable so people can see and learn).
UX Update
See Ciaran's latest walk-through video: https://www.loom.com/share/7a62e7b187444644bae7c0e2562f55cd
Invitation to add feedback about workflows and navigation via the #ux-design-advisory slack group
2020-10-08 - Check-in Call
Recording: https://iu.mediaspace.kaltura.com/media/1_8ko04td3
Attendees: Burke, Manuel, JJ, Florian, Dennis, Ashutosh, Brandon, Ciaran, Daniel, Dimitri, Ian, Bett, Samuel, Mona, Mpho, Nicky K, Romain, Tendo, Thomas Mwogi, Vlad Shioshvili
Agenda:
Demos
Manuel - Order Entry
Florian - access app shell and customize package via command line tool
Dennis & JJ - Configuration tools. Lookups with
10 mins - Ciaran Demo
Review work to be done for Registration Epic
Guidance re. using custom CSS vs using Design System. Almost everything in Carbon Design should be there; sometimes it's not named what you'd expect. Should avoid inventing new stuff - avoid custom CSS. Question whether writing custom CSS is really needed or whether it's buried somewhere in Carbon Design
How to use esm-style guide now
Test Results Viewer
Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.Update on appointments (low priority but promised update to Bahmni about) - adding in a few slots for appointments
2020-09-28 - Design Call - Medication Order Designs Update
Attendees: Burke, Grace, Daniel, Florian, Eric, Romain, Ciaran, David
HIV Clinic Workflow shadowing: Eric and Ciaran to set up virtual workflow tour for Ciaran in HIV clinic (with no patients around and fake data) so Ciaran can experiense end-to-end clinic workflow in patient's shoes with sample/fake data entered for him as a patient by each user role type.
Check with community (big implementers) how did they handle Drug Orders - pick only, or create custom? Request goes to add to formulary / drug table, or do you allow custom entry?
Awareness that MVP scope does not include integration of orders with pharmacy system. Without integration this may become an issue with go-lives (re. clinicians having to duplicate digital and paper orders). At PIH, digital orders right now are "not real orders" because you manually write the Rx for the patient to take to the pharmacy. Dispensing workflow not connected to any workflows. Printing the Rx - not realistic for pilot site locations. (JJ note after: Ampath planning to push orders into pharmacy system in near future.)
Decisions:
We'll be using a formulary-style workflow in Drug ordering (i.e. as a clinician, I don't just say "I'm ordering Aspirin"; I have to specifically pick out "Aspirin 81mg" or "Aspiring 325mg".)
Custom Drug creation is not in-scope for MVP. Sites will be encouraged to keep the Drug Table up to date.
2020-09-24
Attendees: Florian, Donald, Dennis, Burke, Brandon, Ciaran, Daniel, David, Grace, JJ, Samuel, Mike, Mona Fenzl, Romain, Brandon, Eric
Demo:
Donald demoed progress carbonizing header nav
Florian demoed the carbon designs that he has adopted for the medication orders. Working medication orders with data flows working. Working on enabling widgets as extensions and host the medications/drugorder widget via this mechanism (pull #179) Planning to introduce widgets as extensions soon. Currently supporting both old and new approach to extensions.
Brandon demoed on making extensions configurable. He made the reports button an extension.
Dennis demoed on on the chart summary translations.
Dennis demoed ongoing work to show a UI Editor that enables editing the config and extensions, and highlights the section the user is editing.
Ciaran gave an update - He has been doing user testing with the designs and some of the suggestions were: include some vitals and allergies to be easily viewed on the order entry page. He also demoed the designs he has for the visit workflow. He also will find a way of how the vitals for today's visit will be displayed (make it collapsible)
Ciaran will share links in slack to the sketches where people can add comments and suggestions.
2020-09-17 - Demo ongoing work - order entry designs, carbon styling
Attendees: Larry, Brandon, Burke, Mike, Daniel, Donald, Florian, Ian, JJ, Samuel, Manuel, Romain, David, Dennis, Mona, Grace, Eric
Demo:
Ciaran shared some of the designs he has been working on and they are ready for user testing.
Brandon updates – Working on extensions and configurations. Currently working to make extensions configurable.
Donald did carbon styling implementation demo on the allergies widget. He will create a PR for the patient chart widgets carbon styling.
Manuel – Did a demo for drug orders and he has introduced carbon styling. He will continue implementing in drug orders. while awaiting for wireframes that Ciaran is working on.
Samuel – Did a demo for editing patient demographics data.
Larry - Did a demo of adding configurable support for additional patient attributes.
To Do
Florian to create tickets in JIRA for domain decomposition.
2020-09-15 - Virtual HIV visit workflow using POC
Attendees: JJ, Ciaran, ERic
JJ aasumed the role of Clinician and took Ciaran through the HIV workflow in AMPATH POC. Important was to capture the medication order concept.
Eric also took Ciaran through the process of patient registration and program enrollments in AMPATH POC.
2020-09-14 - User testing process - Order entry
Attendees: JJ, Burke, Eric, Ciaran, Mike, David, Daniel, Ian, Jen, Samuel, Dmitri
Notes:
User test workflow
Ciaran will spend 90minutes with a user with three different workflows, i.e:
Speak to the users at the beginning of the conversation and ask them some questions.
Present the designs and walk through with the user
Towards the end of the conversation, allow user to ask questions. (3 major workflows)
Reviewed the latest designs for order entry that Ciaran has made
Ciaran is 75% done with the order entry clickable designs and should be done soon - in the course of the week - for user testing to begin.
To Do's
Eric to organize for a call with Ciaran and one of the clinicians at AMPATH to go through the AMPATH workflow of order entry.
Ciaran to come up with a plan for the user testing.
2020-09-14 - Sprint 5 planning
Notes:
JJ clarified that the patient chart and patient chart widgets tickets for carbon integration styling will have to wait for Ciarans prototypes in order to proceed. The tickets will however go into sprint 5 once the designs are ready.
2020-09-10 - Squad Check-in and Sprint Demo
Attendees: Burke, Donald, Manuel, Ajay, Brandon, Ciaran, Daniel, Dennis, Dimitri, Eric, Florian, Larry, JJ, Romain, Samuel, Tendo, Grace
Recording: ___
Notes:
Sprint Demo
Medication Order entry widget demo, using extensions system, demo'd by Florian and Manuel
Progress Carbon integration into styleguide, demo'd by Donald - started w/ fonts and warning messages
Progress making buttons extension-slot-based, demo'd by Dennis
Extension slot demo/explanation by Brandon
Link gets placed into an extension slot. So expect to be using/seeing divs a lot
Test Results Update
Basic table display being built
Test data from PIH/Ellen going to be incorporated into designs and what they're building
Brandon to help unblock them with screen not displaying
General Design Updates
Designs for order entry: _______
Product Management Updates
HIV Outpatient Clinic Workflow goal; documentation progress here: HIV Clinic Workflows to Support: Ampath, PIH Mexico, UgandaEMR
Jira: Using Epics to capture and delineate widgets work, still have one place of working together while different global teams pick up different work
See backlog view: https://issues.openmrs.org/secure/RapidBoard.jspa?rapidView=231&projectKey=MF&view=planning&issueLimit=100
Special mention:
- Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.
- Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.
- Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.
Question: Is an extension same as what we've been calling a widget? Let's pick a name and be consistent.
Bahmni Forms Epic?
Grace & Eric: Raise question about tickets, i.d. Eric as person who will be following up with Squad Devs - we want to know how to help, and this helps us understand what's going on
Eric to lead Cycle Planning call on Monday Using Board view & Sprint view in Jira
Goals for Next Sprint - sounds right?
Extension (needs breaking down)
Carbon integration into styleguide
Need to get 1 & 2 sorted to move forward with the others
Roadmap for how to transition our existing features to the visuals in latest designs using Carbon
Domain decomposition(needs breaking down)
Designs ready and tested for Global Navigation (ideally start work on it this sprint)
User testing: need a way for clients to look at mockups and provide feedback. Talk about process on Monday in Design Forum at 4pm UTC.
Appointment Scheduling or Forms?
2020-09-08 - Design Session
Test Results Updates
Ellen and Ajay had a call about Reference Ranges. Ranges just per-lab-result. Absolute High, Critical High, Normal High already built-in, per test.
David to share PIH EMR end-to-end HIV Clinic workflow with Ciaran/Grace/Eric/Daniel on Thursday.
Reviewed latest wireframes from Ciaran
2020-08-31
Lab Results updates
Dev work beginning this week at ThoughtWorks, led by Nori Krishna
User testing plan included
Nori to check that Carbon Design is used
TODO: Grace - Access for Nori to JIRA - epics proposal; People to add
PIH
PIH Planning technical roadmap; deciding how to use MFE work moving forwards. Has anyone recently done inventory of what we have, the functionality that's already in SPA?
Whether we're iterating on it
TODO: JJ/Grace/Eric: Documentation of what's been done/in progress in SPA/patient chart/etc, the status and completeness, design status, etc; follow-up with Dave about this
Ciaran's work
User Interviews: Looking for clinician users on front lines who can share their screens to support research
TODO: List of people Ciaran can reach out to - ideally users with a few different contexts
"We would like 1-2 clinical providers who are regular users of your OpenMRS implementation(s) in delivering patient care to help work with a UX designer to help inform our frontend framework design. They will need to be able to join up to X Zoom calls lasting about Y minutes."
User(s) designated by:
Uganda EMR (@Stephen Senkomago Musoke )
PIH (@David DeSimone)
AMPATH (@Eric Achillah) - Grace f/u
Bahmni () - Grace f/u