I think it would be helpful to add a human readable identifier to the yaml mapping file, of the mapping itself, not just the archetype. The identifier should also be versioned.
If this spec will (potentially) be part of the openEHR specification, I suggest adopting the openEHR resource model https://specifications.openehr.org/releases/BASE/latest/resource.html#_authored_resource_class.
Alternatively you could adopt the FHIR canonical resource, which will be more familiar to people familiar with fhir. https://build.fhir.org/canonicalresource.html#CanonicalResource
I think it would be helpful to add a human readable identifier to the yaml mapping file, of the mapping itself, not just the archetype. The identifier should also be versioned.
If this spec will (potentially) be part of the openEHR specification, I suggest adopting the openEHR resource model https://specifications.openehr.org/releases/BASE/latest/resource.html#_authored_resource_class.
Alternatively you could adopt the FHIR canonical resource, which will be more familiar to people familiar with fhir. https://build.fhir.org/canonicalresource.html#CanonicalResource