@dssp/dkpi 1.0.0-alpha.35 → 1.0.0-alpha.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dssp/dkpi",
-  "version": "1.0.0-alpha.35",
+  "version": "1.0.0-alpha.37",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -39,7 +39,7 @@
     "docker:push": "docker image push hatiolab/dkpi:latest && docker image push hatiolab/dkpi:$npm_package_version"
   },
   "dependencies": {
-    "@dssp/project": "^1.0.0-alpha.35",
+    "@dssp/project": "^1.0.0-alpha.37",
     "@material/web": "^2.1.0",
     "@operato/chart": "^9.0.0",
     "@operato/gantt": "^9.0.0",
@@ -93,5 +93,5 @@
   "devDependencies": {
     "@things-factory/builder": "^9.0.0"
   },
-  "gitHead": "ed297576d670b3551aa9ba781f95ff36b0ba31e4"
+  "gitHead": "f06dfcc285fb02dfe4f175269c54c91ac264ae34"
 }

package/schema.graphql

@@ -1506,6 +1506,53 @@ type BuildingInspection {
   status: String
   updatedAt: DateTimeISO
   updater: User
+  worklog: BuildingInspectionDailyWorklog
+}
+
+"""Entity for BuildingInspectionDailyWorklog"""
+type BuildingInspectionDailyWorklog {
+  buildingInspections: [BuildingInspection!]
+  createdAt: DateTimeISO
+  creator: User
+  date: String
+  deletedAt: DateTimeISO
+  directiveMemo: String
+  documentNo: String
+  domain: Domain
+  id: ID
+  memo: String
+
+  """총괄 감리 책임자"""
+  overallSupervisory: User
+  overallSupervisorySignature: String
+  projectId: String!
+
+  """건축사보 (공종별 감리 관리자)"""
+  taskSupervisory: User
+  taskSupervisorySignature: String
+  updatedAt: DateTimeISO
+  updater: User
+  worklogs: Object
+}
+
+input BuildingInspectionDailyWorklogNew {
+  buildingInspectionIds: [String!]
+  date: String!
+  directiveMemo: String
+  memo: String
+  overallSupervisoryId: String
+  overallSupervisorySignature: String
+  projectId: String!
+  taskSupervisoryId: String
+  taskSupervisorySignature: String
+  worklogs: Object
+}
+
+input BuildingInspectionDailyWorklogPatch {
+  directiveMemo: String
+  id: ID!
+  memo: String
+  worklogs: Object
 }
 
 type BuildingInspectionList {
@@ -1546,7 +1593,9 @@ type BuildingInspectionSummaryOfLevel {
 
 input BuildingInspectionsOfBuildingLevel {
   buildingLevelId: String!
+  endDate: String
   limit: Float
+  startDate: String
 }
 
 input BuildingInspectionsOfProject {
@@ -1621,8 +1670,17 @@ type Checklist {
   id: ID!
   inspectionDrawingType: String
   inspectionParts: [String!]
+  inspectionRequestDocumentNo: String
+  inspectionRequestMemo: String
+  inspectionRequestUpdatedAt: DateTimeISO
+  inspectionResultDocumentNo: String
+  inspectionResultMemo: String
+  inspectionResultStatus: String
+  inspectionResultType: String
+  inspectionResultUpdatedAt: DateTimeISO
   location: String
   name: String
+  nameListAttachment: Attachment
 
   """총괄 시공 책임자"""
   overallConstructor: User
@@ -1716,6 +1774,10 @@ type ChecklistList {
 
 input ChecklistSubmitInputType {
   id: String!
+  inspectionRequestMemo: String
+  inspectionResultMemo: String
+  inspectionResultStatus: String
+  inspectionResultType: String
   overallConstructorSignature: String
   overallSupervisorySignature: String
   taskConstructorSignature: String
@@ -4637,6 +4699,102 @@ enum KpiPeriodType {
   YEAR
 }
 
+"""
+Defines the meaning and metadata for each scope level (scope01~05) in KpiOrgScope
+"""
+type KpiScope {
+  """Whether this scope definition is active and should be used"""
+  active: Boolean!
+  createdAt: DateTimeISO
+  creator: User
+
+  """Detailed description of what this scope dimension represents"""
+  description: String
+
+  """Order/priority for display and processing"""
+  displayOrder: Int!
+
+  """Domain this scope definition belongs to"""
+  domain: Domain
+  id: ID!
+
+  """Whether this scope should be included in statistical calculations"""
+  includeInStatistics: Boolean!
+
+  """Scope level (1-5) corresponding to scope01-scope05 in KpiOrgScope"""
+  level: Int!
+
+  """Additional metadata for this scope dimension (colors, icons, etc.)"""
+  metadata: Object
+
+  """Display name for this scope dimension (e.g., "지역", "회사", "프로젝트규모")"""
+  name: String!
+
+  """Parent scope level if this forms a hierarchy"""
+  parentLevel: Int
+
+  """Type category of this scope dimension"""
+  scopeType: ScopeType!
+
+  """Whether this scope should be displayed in dashboard visualizations"""
+  showInDashboard: Boolean!
+  updatedAt: DateTimeISO
+  updater: User
+
+  """
+  List of valid values for this scope (e.g., ["서울", "부산", "대구"] for regions)
+  """
+  validValues: Object
+
+  """Regex pattern for validating values in this scope dimension"""
+  validationPattern: String
+}
+
+type KpiScopeList {
+  items: [KpiScope!]!
+  total: Float!
+}
+
+input KpiScopePatch {
+  """Whether this scope definition is active and should be used"""
+  active: Boolean! = true
+  cuFlag: String
+
+  """Detailed description of what this scope dimension represents"""
+  description: String
+
+  """Order/priority for display and processing"""
+  displayOrder: Int! = 1
+  id: ID
+
+  """Whether this scope should be included in statistical calculations"""
+  includeInStatistics: Boolean! = true
+
+  """Scope level (1-5) corresponding to scope01-scope05 in KpiOrgScope"""
+  level: Int!
+
+  """Additional metadata for this scope dimension"""
+  metadata: Object
+
+  """Display name for this scope dimension (e.g., "지역", "회사", "프로젝트규모")"""
+  name: String!
+
+  """Parent scope level if this forms a hierarchy"""
+  parentLevel: Int
+
+  """Type category of this scope dimension"""
+  scopeType: ScopeType!
+
+  """Whether this scope should be displayed in dashboard visualizations"""
+  showInDashboard: Boolean! = false
+
+  """List of valid values for this scope"""
+  validValues: [String!]
+
+  """Regex pattern for validating values in this scope dimension"""
+  validationPattern: String
+}
+
 """
 KPI Statistics Entity - Stores comprehensive statistical information for KPIs and Categories including central tendency measures (mean, median), dispersion metrics (standard deviation, variance), range indicators (min, max), and percentile distributions (25th, 75th percentiles, IQR). Supports both KPI and Category targets with flexible period-based aggregation (daily, weekly, monthly, yearly). Includes extensible JSON fields for additional metrics and metadata for calculation tracking.
 """
@@ -4663,6 +4821,9 @@ type KpiStatistic {
   """Reference to the KPI definition for which this value is calculated."""
   kpi: Kpi
 
+  """Organization scope for scoped statistics. Null for overall statistics."""
+  kpiOrgScope: KpiOrgScope
+
   """Lower fence for outlier detection (Q1 - 1.5 * IQR)"""
   lowerFence: Float
 
@@ -4696,7 +4857,7 @@ type KpiStatistic {
   range: Float
 
   """
-  Statistical scope - null for overall statistics, category value for scoped statistics (e.g., "서울", "부장", "대규모")
+  Legacy scope field - use kpiOrgScope instead. Statistical scope - null for overall statistics, category value for scoped statistics (e.g., "서울", "부장", "대규모")
   """
   scope: String
 
@@ -4781,6 +4942,9 @@ type KpiValue {
   """ID of the domain (tenant) for this KPI value."""
   domainId: String
 
+  """Group key for this value (organization, line, user, project, etc.)"""
+  group: String
+
   """Unique identifier for this KPI value record."""
   id: ID!
 
@@ -5438,8 +5602,21 @@ type Mutation {
     orgScopes: [NewKpiOrgScope!]!
   ): [KpiOrgScope!]!
 
+  """
+  Calculate statistics for all KPIs in a specific period from KpiValue data
+  """
+  calculateAllKpiStatistics(periodType: KpiPeriodType!, valueDate: String!): [KpiStatistic!]!
+
+  """Calculate statistics for a specific KPI and period from KpiValue data"""
+  calculateKpiStatistics(kpiId: String!, periodType: KpiPeriodType!, valueDate: String!): [KpiStatistic!]!
+
   """KPI 기준으로 formula 계산 및 KPI Value upsert"""
   calculateKpiValue(kpiId: String!, org: String, valueDate: String): KpiValue!
+
+  """
+  Recalculate statistics for dashboard regions (scope02-based statistics)
+  """
+  calculateRegionalStatistics(periodType: KpiPeriodType! = MONTH, valueDate: String!): [KpiStatistic!]!
   cancelInvitation(email: EmailAddress!, reference: String!, type: String!): Boolean!
 
   """To clear translations cache"""
@@ -5504,6 +5681,9 @@ type Mutation {
   """To create Building Inspection information"""
   createBuildingInspection(patch: NewBuildingInspection!): BuildingInspection!
 
+  """Create Daily Worklog by projectId+date"""
+  createBuildingInspectionDailyWorklog(patch: BuildingInspectionDailyWorklogNew!): BuildingInspectionDailyWorklog!
+
   """To create new ChecklistItemComment"""
   createChecklistItemComment(checklistItemComment: NewChecklistItemComment!): ChecklistItemComment!
 
@@ -5613,6 +5793,9 @@ type Mutation {
     kpiOrgScope: NewKpiOrgScope!
   ): KpiOrgScope!
 
+  """Create a new scope dimension definition"""
+  createKpiScope(kpiScope: NewKpiScope!): KpiScope!
+
   """To create new KpiStatistic"""
   createKpiStatistic(kpiStatistic: NewKpiStatistic!): KpiStatistic!
 
@@ -6012,6 +6195,12 @@ type Mutation {
     ids: [String!]!
   ): Boolean!
 
+  """Delete a scope dimension definition"""
+  deleteKpiScope(id: String!): Boolean!
+
+  """Delete multiple scope dimension definitions"""
+  deleteKpiScopes(ids: [String!]!): Boolean!
+
   """To delete KpiStatistic"""
   deleteKpiStatistic(id: String!): Boolean!
 
@@ -6652,6 +6841,9 @@ type Mutation {
   """To create Building Inspection And Checklist information"""
   updateBuildingInspectionChecklist(buildingInspection: UpdateBuildingInspectionSubmitType!): Boolean!
 
+  """Update Daily Worklog"""
+  updateBuildingInspectionDailyWorklog(patch: BuildingInspectionDailyWorklogPatch!): BuildingInspectionDailyWorklog!
+
   """To modify ChecklistItemComment information"""
   updateChecklistItemComment(id: String!, patch: ChecklistItemCommentPatch!): ChecklistItemComment!
 
@@ -6736,6 +6928,9 @@ type Mutation {
   """To modify KpiMetricValue information"""
   updateKpiMetricValue(id: String!, patch: KpiMetricValuePatch!): KpiMetricValue!
 
+  """Update a scope dimension definition"""
+  updateKpiScope(id: String!, patch: KpiScopePatch!): KpiScope!
+
   """To modify KpiStatistic information"""
   updateKpiStatistic(id: String!, patch: KpiStatisticPatch!): KpiStatistic!
 
@@ -6878,6 +7073,9 @@ type Mutation {
     patches: [KpiOrgScopePatch!]!
   ): [KpiOrgScope!]!
 
+  """Update multiple scope dimension definitions"""
+  updateMultipleKpiScope(patches: [KpiScopePatch!]!): [KpiScope!]!
+
   """To modify multiple KpiStatistics' information"""
   updateMultipleKpiStatistic(patches: [KpiStatisticPatch!]!): [KpiStatistic!]!
 
@@ -7827,6 +8025,44 @@ input NewKpiOrgScope {
   scope05: String
 }
 
+input NewKpiScope {
+  """Whether this scope definition is active and should be used"""
+  active: Boolean! = true
+
+  """Detailed description of what this scope dimension represents"""
+  description: String
+
+  """Order/priority for display and processing"""
+  displayOrder: Int! = 1
+
+  """Whether this scope should be included in statistical calculations"""
+  includeInStatistics: Boolean! = true
+
+  """Scope level (1-5) corresponding to scope01-scope05 in KpiOrgScope"""
+  level: Int!
+
+  """Additional metadata for this scope dimension"""
+  metadata: Object
+
+  """Display name for this scope dimension (e.g., "지역", "회사", "프로젝트규모")"""
+  name: String!
+
+  """Parent scope level if this forms a hierarchy"""
+  parentLevel: Int
+
+  """Type category of this scope dimension"""
+  scopeType: ScopeType!
+
+  """Whether this scope should be displayed in dashboard visualizations"""
+  showInDashboard: Boolean! = false
+
+  """List of valid values for this scope"""
+  validValues: [String!]
+
+  """Regex pattern for validating values in this scope dimension"""
+  validationPattern: String
+}
+
 input NewKpiStatistic {
   additionalStatistics: Object
   count: Float
@@ -8698,6 +8934,7 @@ type PDFDrawing {
 type PDFDrawingLink {
   box: String
   data: PDFDrawingLinkData
+  dwgId: String
   id: String
   story: String
   symbol: String
@@ -9107,14 +9344,18 @@ type Project {
   createdAt: DateTimeISO
   creator: User
   deletedAt: DateTimeISO
+  documentNaming: String
   domain: Domain
   endDate: String
+  geoGroup: String
   id: ID!
+  inputType: String
   inspPassRate: Float
   kpi: Float
   mainPhoto: Attachment
   name: String!
-  projectType: String!
+  postalCode: String
+  projectType: String
   robotCount: Float
   robotProgressRate: Float
   rootTasks: [Task!]
@@ -9150,6 +9391,9 @@ input ProjectPatch {
   """연관된 건물 복합체 정보 (선택 사항)"""
   buildingComplex: BuildingComplexPatch
 
+  """프로젝트 문서 네이밍"""
+  documentNaming: String
+
   """프로젝트 준공일정"""
   endDate: String
 
@@ -9697,6 +9941,7 @@ type Query {
 
   """To fetch a BuildingInspection"""
   buildingInspection(id: String!): BuildingInspection
+  buildingInspectionDailyWorklogByProjectIdAndDate(date: String!, projectId: String!): BuildingInspectionDailyWorklog
 
   """To fetch a BuildingInspection Summary"""
   buildingInspectionDateSummaryOfLevelAndPeriod(buildingLevelId: String!, endDate: String!, startDate: String!): [BuildingInspectionSummary!]
@@ -9974,6 +10219,10 @@ type Query {
     sortings: [Sorting!]
   ): ContactList!
   customers: [Domain!]!
+  dailyWorklogDatesOfProject(endDate: String!, projectId: String!, startDate: String!): [BuildingInspectionDailyWorklog!]!
+
+  """Get aggregated statistics by scope02 (regional level) for dashboard"""
+  dashboardRegionalStatistics(periodType: KpiPeriodType! = MONTH, valueDate: String!): [KpiStatistic!]!
 
   """
   Retrieves a single data archive by its unique identifier. This query fetches detailed information about a data archive request including its status, download URL, and associated dataset information for data export purposes.
@@ -10792,6 +11041,24 @@ type Query {
     searchTerm: String
   ): [String!]!
 
+  """Fetch a scope dimension definition by ID"""
+  kpiScope(id: String!): KpiScope
+
+  """Fetch multiple scope dimension definitions"""
+  kpiScopes(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """Pagination options for the list query."""
+    pagination: Pagination
+
+    """Sorting options for the list query."""
+    sortings: [Sorting!]
+  ): KpiScopeList!
+
   """To fetch a KpiStatistic"""
   kpiStatistic(id: String!): KpiStatistic
 
@@ -11346,6 +11613,9 @@ type Query {
   """To query data in S3 using Amazon Athena SDK"""
   queryFromAthena(queryData: Object!): Any!
 
+  """Get regional statistics for dashboard map visualization"""
+  regionalKpiStatistics(periodType: KpiPeriodType! = MONTH, regions: [String!], valueDate: String!): [KpiStatistic!]!
+
   """To fetch a Resource"""
   resource(id: String!): Resource
 
@@ -12125,6 +12395,16 @@ type ScenarioQueueState {
   queue: [PendingObject!]!
 }
 
+"""Types of organizational scope dimensions"""
+enum ScopeType {
+  BUSINESS
+  CUSTOM
+  GEOGRAPHIC
+  ORGANIZATIONAL
+  TECHNICAL
+  TEMPORAL
+}
+
 """Entity for Setting"""
 type Setting {
   category: String!