Dev to Stage

db-management/migrations/20250818105519-dataset-viewer-pg-changes.js

@@ -0,0 +1,53 @@
+'use strict';
+
+var dbm;
+var type;
+var seed;
+var fs = require('fs');
+var path = require('path');
+var Promise;
+
+/**
+  * We receive the dbmigrate dependency from dbmigrate initially.
+  * This enables us to not have to rely on NODE_PATH.
+  */
+exports.setup = function(options, seedLink) {
+  dbm = options.dbmigrate;
+  type = dbm.dataType;
+  seed = seedLink;
+  Promise = options.Promise;
+};
+
+exports.up = function(db) {
+  var filePath = path.join(__dirname, 'sqls', '20250818105519-dataset-viewer-pg-changes-up.sql');
+  return new Promise( function( resolve, reject ) {
+    fs.readFile(filePath, {encoding: 'utf-8'}, function(err,data){
+      if (err) return reject(err);
+      console.log('received data: ' + data);
+
+      resolve(data);
+    });
+  })
+  .then(function(data) {
+    return db.runSql(data);
+  });
+};
+
+exports.down = function(db) {
+  var filePath = path.join(__dirname, 'sqls', '20250818105519-dataset-viewer-pg-changes-down.sql');
+  return new Promise( function( resolve, reject ) {
+    fs.readFile(filePath, {encoding: 'utf-8'}, function(err,data){
+      if (err) return reject(err);
+      console.log('received data: ' + data);
+
+      resolve(data);
+    });
+  })
+  .then(function(data) {
+    return db.runSql(data);
+  });
+};
+
+exports._meta = {
+  "version": 1
+};

db-management/migrations/sqls/20250818105519-dataset-viewer-pg-changes-down.sql

@@ -0,0 +1 @@
+DROP COLUMN IF EXISTS data_viewer_config;

db-management/migrations/sqls/20250818105519-dataset-viewer-pg-changes-up.sql

@@ -0,0 +1,2 @@
+ALTER TABLE public.project_group
+ADD COLUMN IF NOT EXISTS  data_viewer_config JSON DEFAULT '{}'::JSON;    

src/assets/user-management-spec.json

@@ -773,6 +773,15 @@
                             }
                         }
                     },
+                    {
+                        "name": "data_viewer_allowed",
+                        "in": "query",
+                        "description": "<strong>Data viewer allowed:</strong> Filters project groups based on whether data viewer access is allowed. Uses a boolean value.",
+                        "required": false,
+                        "schema": {
+                            "type": "boolean"
+                        }
+                    },
                     {
                         "name": "page_no",
                         "in": "query",
@@ -1058,6 +1067,51 @@
                 }
             }
         },
+        "/api/v1/project-group/{projectGroupId}/dataset-viewer": {
+            "post": {
+                "tags": [
+                    "ProjectGroup"
+                ],
+                "summary": "Updates the project group data viewer preferences",
+                "description": "Updates the project group data viewer preferences.",
+                "operationId": "updateDataViewer",
+                "parameters": [
+                    {
+                        "name": "projectGroupId",
+                        "in": "path",
+                        "description": "The ID of the project group to update.",
+                        "required": true,
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ],
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "schema": {
+                                "$ref": "#/components/schemas/data_viewer"
+                            }
+                        }
+                    },
+                    "required": true
+                },
+                "responses": {
+                    "200": {
+                        "description": "Project group data viewer preferences updated successfully."
+                    },
+                    "401": {
+                        "description": "Unauthenticated request"
+                    },
+                    "403": {
+                        "description": "Unauthorized request"
+                    },
+                    "500": {
+                        "description": "An server error occurred."
+                    }
+                }
+            }
+        },
         "/api/v1/reset-credentials": {
             "post": {
                 "tags": [
@@ -1188,6 +1242,10 @@
                             "type": "string",
                             "description": "Role associated with project group."
                         }
+                    },
+                    "data_viewer_config": {
+                        "$ref": "#/components/schemas/data_viewer",
+                        "description": "Configuration settings for the dataset viewer."
                     }
                 },
                 "description": "User associated project groups and roles."
@@ -1441,6 +1499,40 @@
                 },
                 "description": "Describes an Project Group."
             },
+            "data_viewer": {
+                "type": "object",
+                "properties": {
+                    "dataset_viewer_allowed": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "Flag to indicate to allow all datasets within the project group to be viewed on the dataset viewer."
+                    },
+                    "feedback_turnaround_time": {
+                        "required": [
+                            "number",
+                            "units"
+                        ],
+                        "type": "object",
+                        "description": "Feedback turnaround time for the project group.",
+                        "properties": {
+                            "number": {
+                                "type": "integer",
+                                "description": "Number of days for feedback turnaround time."
+                            },
+                            "units": {
+                                "type": "string",
+                                "enum": [
+                                    "days",
+                                    "months",
+                                    "years"
+                                ],
+                                "description": "Unit of time for feedback turnaround time."
+                            }
+                        }
+                    }
+                },
+                "description": "Describes an Project group."
+            },
             "ProjectGroupList": {
                 "type": "object",
                 "properties": {
@@ -1475,9 +1567,12 @@
                             "$ref": "#/components/schemas/POC",
                             "description": "POC details"
                         }
+                    },
+                    "data_viewer": {
+                        "$ref": "#/components/schemas/data_viewer",
+                        "description": "Describes an Project group."
                     }
-                },
-                "description": "Describes an Project group."
+                }
             },
             "POC": {
                 "type": "object",

src/controller/project-group-controller.ts

@@ -11,6 +11,7 @@ import { ProjectGroupUserQueryParams } from "../model/params/project-group-user-
 import { Utility } from "../utility/utility";
 import queryValidationMiddleware from "../middleware/query-params-validation-middleware";
 import { listRequestValidation } from "../middleware/list-request-validation-middleware";
+import { DatasetViewerDto, FeedbackTurnaroundTime } from "../model/dto/dataset-viewer-dto";
 
 class ProjectGroupController implements IController {
     public path = '';
@@ -26,6 +27,28 @@ class ProjectGroupController implements IController {
         this.router.get(`${this.path}/api/v1/project-group`, listRequestValidation, authorizationMiddleware([]), queryValidationMiddleware(ProjectGroupQueryParams), this.getProjectGroup);
         this.router.get(`${this.path}/api/v1/project-group/:projectGroupId/users`, authorizationMiddleware([Role.TDEI_ADMIN, Role.POC], true), this.getProjectGroupUsers);
         this.router.put(`${this.path}/api/v1/project-group/:projectGroupId/active/:status`, authorizationMiddleware([Role.TDEI_ADMIN]), this.deleteProjectGroup);
+        this.router.post(`${this.path}/api/v1/project-group/:projectGroupId/dataset-viewer`, authorizationMiddleware([Role.TDEI_ADMIN, Role.POC], true), this.putDatasetViewer);
+    }
+
+    /**
+     * Gets the dataset viewer configuration for a project group
+     * @param req - The request object
+     * @param res - The response object
+     * @param next - The next middleware function
+     */
+    async putDatasetViewer(req: Request, res: express.Response, next: NextFunction) {
+        try {
+            let projectGroupId = req.params.projectGroupId;
+            let datasetViewerConfig = DatasetViewerDto.from(req.body);
+            datasetViewerConfig.feedback_turnaround_time = FeedbackTurnaroundTime.from(datasetViewerConfig.feedback_turnaround_time);
+
+            await datasetViewerConfig.validateRequestInput();
+            const result = await projectGroupService.updateDatasetViewerConfig(projectGroupId, datasetViewerConfig);
+            Ok(res, result);
+        } catch (error) {
+            let errorMessage = "Error updating the dataset viewer config.";
+            Utility.handleError(res, next, error, errorMessage);
+        }
     }
 
     public deleteProjectGroup = async (request: Request, response: express.Response, next: NextFunction) => {

src/model/dto/dataset-viewer-dto.ts

@@ -0,0 +1,81 @@
+import { IsBoolean, IsEnum, IsNotEmpty, IsNumber, validate, ValidateNested, ValidationError } from "class-validator";
+import { BaseDto } from "./base-dto";
+import { Prop } from "nodets-ms-core/lib/models";
+import { QueryConfig } from "pg";
+import { InputException } from "../../exceptions/http/http-exceptions";
+import { plainToInstance, Type } from "class-transformer";
+
+export enum TimeUnit {
+    DAYS = "days",
+    MONTHS = "months",
+    YEARS = "years"
+}
+
+export class FeedbackTurnaroundTime extends BaseDto {
+    @Prop()
+    @IsNotEmpty()
+    @IsNumber()
+    number!: number;
+
+    @Prop()
+    @IsNotEmpty()
+    @IsEnum(TimeUnit)
+    units!: TimeUnit;
+}
+
+export class DatasetViewerDto extends BaseDto {
+    @Prop()
+    @IsNotEmpty()
+    @IsBoolean()
+    dataset_viewer_allowed!: boolean;
+
+    @Prop()
+    @IsNotEmpty()
+    @ValidateNested()
+    @Type(() => FeedbackTurnaroundTime)
+    feedback_turnaround_time!: FeedbackTurnaroundTime;
+
+    constructor(init?: Partial<DatasetViewerDto>) {
+        super();
+        Object.assign(this, init);
+    }
+
+    async validateRequestInput() {
+        // Ensure nested object exists
+        // if (!this.feedback_turnaround_time) {
+        //     this.feedback_turnaround_time = new FeedbackTurnaroundTime();
+        // }
+        // const dto = plainToInstance(this.constructor as new () => DatasetViewerDto, this);
+        let errors = await validate(this);
+        if (errors.length > 0) {
+            console.log('Input validation failed');
+            let message = errors
+                .map((error: ValidationError) => {
+                    if (error.constraints) {
+                        return Object.values(error.constraints);
+                    }
+                    if (error.children && error.children.length > 0) {
+                        // Nested validation messages
+                        return error.children.map(c => Object.values(c.constraints || {})).join(', ');
+                    }
+                    return '';
+                })
+                .join(', ');
+
+            throw new InputException(`Required fields are missing or invalid: ${message}`);
+        }
+        return true;
+    }
+
+    /**
+    * Builds the update dataset viewer QueryConfig object
+    * @returns QueryConfig object
+    */
+    getUpdateDatasetViewerQuery(tdei_project_group_id: string): QueryConfig {
+        const queryObject = {
+            text: `UPDATE project_group SET data_viewer_config = $1 WHERE project_group_id = $2`,
+            values: [JSON.stringify(this), tdei_project_group_id]
+        }
+        return queryObject;
+    }
+}

src/model/dto/project-group-dto.ts

@@ -4,6 +4,7 @@ import { BaseDto } from "./base-dto";
 import { Prop } from "nodets-ms-core/lib/models";
 import { QueryConfig } from "pg";
 import { FeatureCollection } from "geojson";
+import { DatasetViewerDto } from "./dataset-viewer-dto";
 
 export class ProjectGroupDto extends BaseDto {
     @Prop()
@@ -32,6 +33,9 @@ export class ProjectGroupDto extends BaseDto {
     @IsValidPolygon()
     @Prop()
     polygon!: FeatureCollection;
+    @IsOptional()
+    @Prop()
+    data_viewer_config!: DatasetViewerDto;
 
     constructor(init?: Partial<ProjectGroupDto>) {
         super();

src/model/dto/project-group-role-dto.ts

@@ -1,8 +1,10 @@
+import { DatasetViewerDto } from "./dataset-viewer-dto";
+
 export class ProjectGroupRoleDto {
     tdei_project_group_id!: string;
     project_group_name!: string;
     roles!: string[];
-
+    data_viewer_config!: DatasetViewerDto;
     constructor(init?: Partial<ProjectGroupRoleDto>) {
         Object.assign(this, init);
     }