Improve specs about INSTRUCTION states



Improve the specification of how initial states for INSTRUCTIONS/ACTIVITIES are assigned, adding some examples.

1. From the specs, definition of state "INITIAL: initial state, prior to planning activity (default starting state for computable representation of state machine)."

In some contexts, creating the INSTRUCTION is actually planning, but from the specs it is not clear how to get from INITIAL to PLANNED when the INSTRUCTION is created (Heath mentioned that an ACTION instance should be included in the committed COMPOSITION, I added this might be a placeholder ACTION just to change the state from INITIAL to PLANNED, SCHEDULED or ACTIVE, but this ACTION is not a real data container).

Considering this, if no ACTION is yet created for an existing INSTRUCTION/ACTIVITY, then those are on the INITIAL state.


2. All examples are focused on medication

We should add examples for other types of INSTRUCTIONS like non-drug treatments and procedures. We should ask the community for clinically valid flows or maybe propose a couple and let the community review them, add the mapping of the flow to the ISM states and provide full examples of how states change in function of ACTIONs committed. Full step-by-step examples are better for developers.




Pablo Pazos


Affects versions