[EUSM]: Add a close flags form

[dubdabasoduba]

Issue Context?

• We need to close flags shown on Akuko via the OpenSRP web
• The Close flag process is described in the image below
• OpenSRP web will provide a form that will allow the user to add comments and close the existing flags.
  • It will also generate the required resources and tag them appropriately for the app to download them

Issue Implementation details?

Build a form with the following fields

Field name	Required	Field Type	Field Options	Field Hint
Service Point	:white_check_mark:	Text Field	ReadOnly	N/A
Product	:x:	Text Field	ReadOnly	N/A
Status	:white_check_mark:	Dropdown	Active, Inactive	Select Flag Status
Comments	:white_check_mark:	TextArea		How was the flag resolved?

• Service Point: - This is the Location the Flag is tied to
  • Product Related Flags : - These are flags created for Inventory. To get the location we have to find the inventory through the Flag.subject reference and then find the Location through the List.entry reference.
  • Location Related Flags: - These are flags created for the service point. To get the location we have to find the inventory through the Flag.subject reference
• Product (If Any): - This is the Product the Flag is tied to
  • This will only be needed for Product flags
  • We can find the Inventory through the Flag.subject reference and then fetch the Product through the Group.member reference on the Group resource representing the inventory.

Generate the following resources when a flag is closed.

• https://github.com/onaio/fhir-resources/issues/3231

Issue Acceptance criteria?

• [x] User should be able to close flags and add comments
• [x] Generate and tag the resources appropriately to allow the download by the apps
• [x] The form should not be accessible from other navigation buttons on OpenSRP web

FHIR resources to be used?

No response

Relevant Information

Proposed URL https://{{base_url}}/admin/close-flags/{{uuid}}

[peterMuriuki]

related: https://github.com/onaio/fhir-web/issues/1336 - need to fix this first

[kahummer]

Navigating a URL via a button is possible, but currently, it can't be done through layer events. I would like to understand how the component interactions are expected to work from Akuko's perspective.

[alepietrobon]

The "close flag" will not be a layer event, but a link from either a popup or a table next to the map.

see https://app.akuko.io/post/1ad8e5a3-941b-4b93-ba00-4551ed19bfc6

@kahummer can you confirm what your concern is? Am i missing something?

[kahummer]

It's clear now, I thought this was to be at layer level on the service point. It should be fine

[peterMuriuki]

@dubdabasoduba

o get the location we have to find the inventory through the Flag.subject https://github.com/onaio/fhir-resources/issues/3035 and then find the Location through the List.entry https://github.com/onaio/fhir-resources/issues/3016.

The group inventory does not directly link to the location or the list resource(we could follow list.subject to get location). How exactly we go from flag.subject to get the location is thus not clear

These are flags created for the service point. To get the location we have to find the inventory through the Flag.subject https://github.com/onaio/fhir-resources/issues/3035

Here as well.

Also: What payload resource will be used to capture the comments.

[peterMuriuki]

Get flag

• {{ _.baseUrl }}/fhir/Flag/0e0b553d-d85a-4c16-8f28-e31c41afcc65

Product related flag

TO GET THE PRODUCT

• fetch the group inventory from flag.subject.reference {{ _.baseUrl }}/fhir/Group/eb9ed6a6-56c5-4e1c-a4ed-90990680d5ea

import {FhirServiceClass} from '@opensrp/react-utils';
import {groupResourceType} from '@opensrp/fhir-helpers';

{queryFn: () => {
  return new FhirServiceClass(fhirBaseUrl).read(<flag.subject.reference>)
}}

• fetch the product from Group.member?.[0].entity.reference {{ _.baseUrl }}/fhir/Group/d538bfbd-5f35-47ec-b54f-63bb98cba83e

TO GET THE LOCATION

• fetch the inventory list flag.subject.reference -> Group/e44e26d0-1f7a-41d6-aa57-99c5712ddd66 {{ _.baseUrl }}/fhir/List/_search?item=Group/e44e26d0-1f7a-41d6-aa57-99c5712ddd66&code=|22138876

import {FhirServiceClass} from '@opensrp/react-utils';
import {groupResourceType, servicePointProfileInventoryListCoding} from '@opensrp/fhir-helpers';

{queryFn: () => {
  return new FhirServiceClass(fhirBaseUrl).list({item: <flag.subject.reference>, code: <servicePointProfileInventoryListCoding.system>|<servicePointProfileInventoryListCoding.code>})
}}

• fetch the location list.subject -> Location/20bef46f-b5f2-490f-beca-d9fa6205be06 {{ _.baseUrl }}/fhir/Location/20bef46f-b5f2-490f-beca-d9fa6205be06

Location related flag

TO GET THE LOCATION

• fetch the location flag.subject -> Location/20bef46f-b5f2-490f-beca-d9fa6205be06 {{ _.baseUrl }}/fhir/Location/20bef46f-b5f2-490f-beca-d9fa6205be06

[dubdabasoduba]

https://web.unicef-mg-eusm-preview.smartregister.org/admin/close-flags/ @Mstjamush here is the URL to close flags