fix: the instance store path is not relative

- Original, store the path contains root path
- For flexible path, use the relative path
- Add `SaveDicomFileResult` type def

api/dicom-web/controller/STOW-RS/storeInstance.js

@@ -311,6 +311,7 @@ async function getDICOMJson(filename) {
  * @param {import('formidable').File} file
  * @param {JSON} dicomJson
  * @param {import('../../../../utils/typeDef/dicom').UIDObject} uidObj
+ * @return {import("../../../../utils/typeDef/STOW-RS/STOW-RS.def").SaveDicomFileResult}
  */
 async function saveDICOMFile(file, dicomJson, uidObj) {
     try {
@@ -574,7 +575,7 @@ async function storeDICOMJsonToDB(uidObj, saveDICOMFileResult) {
         _.merge(dicomJson, {
             studyPath: saveDICOMFileResult.studyPath,
             seriesPath: saveDICOMFileResult.seriesPath,
-            instancePath: saveDICOMFileResult.instancePath
+            instancePath: saveDICOMFileResult.relativePath
         });
         let query = {
             $and: [

utils/typeDef/STOW-RS/STOW-RS.def.js

@@ -8,6 +8,16 @@
  *
  */
 
+/**
+ * @typedef {object} SaveDicomFileResult
+ * @property {string} fullPath The path of saved file's directory
+ * @property {string} relativePath The relative path of saved DICOM instance file. e.g. /files/123.dcm
+ * @property {string} instancePath The full path of saved DICOM instance file. e.g. /home/app/files/123.dcm
+ * @property {string} seriesPath The relative path of series level directory
+ * @property {string} studyPath The relative path of study level directory
+ * @property {Object} dicomJson 
+ */
+
 const STOW_RS = true;
 
 module.exports.unUse = {};