@things-factory/kpi 9.0.23 → 9.0.24

package/server/service/kpi-category-value/kpi-category-value-type.ts

@@ -0,0 +1,48 @@
+import { InputType, Field, Float, ObjectType } from 'type-graphql'
+import { KpiPeriodType } from '../kpi/kpi'
+import { KpiCategoryValue } from './kpi-category-value'
+
+@InputType()
+export class NewKpiCategoryValue {
+  @Field()
+  domainId: string
+
+  @Field()
+  categoryId: string
+
+  @Field({ nullable: true })
+  group?: string
+
+  @Field(type => Float, { nullable: true, description: 'Performance score for this category (0-1 range)' })
+  score?: number
+
+  @Field()
+  valueDate: string
+}
+
+@InputType()
+export class KpiCategoryValuePatch {
+  @Field({ nullable: true })
+  domainId?: string
+
+  @Field({ nullable: true })
+  categoryId?: string
+
+  @Field({ nullable: true })
+  group?: string
+
+  @Field(type => Float, { nullable: true, description: 'Performance score for this category (0-1 range)' })
+  score?: number
+
+  @Field({ nullable: true })
+  valueDate?: string
+}
+
+@ObjectType()
+export class KpiCategoryValueList {
+  @Field(type => [KpiCategoryValue])
+  items: KpiCategoryValue[]
+
+  @Field()
+  total: number
+}

package/server/service/kpi-category-value/kpi-category-value.ts

@@ -0,0 +1,79 @@
+import {
+  Entity,
+  PrimaryGeneratedColumn,
+  Column,
+  Index,
+  ManyToOne,
+  CreateDateColumn,
+  UpdateDateColumn,
+  RelationId
+} from 'typeorm'
+import { Field, ObjectType, ID, Float } from 'type-graphql'
+import { Domain } from '@things-factory/shell'
+import { KpiCategory } from '../kpi-category/kpi-category'
+import { User } from '@things-factory/auth-base'
+
+@Entity()
+@Index('ix_kpi_category_value_latest', ['domain', 'group', 'category', 'valueDate'], { unique: true })
+@ObjectType({ description: 'Entity for KpiCategoryValue' })
+export class KpiCategoryValue {
+  @PrimaryGeneratedColumn('uuid')
+  @Field(type => ID, { description: 'Unique identifier for this KPI category value record.' })
+  readonly id: string
+
+  @ManyToOne(() => Domain, { onDelete: 'CASCADE' })
+  @Field(type => Domain, { nullable: true, description: 'Domain (tenant) to which this KPI category value belongs.' })
+  domain: Domain
+
+  @RelationId((kpiCategoryValue: KpiCategoryValue) => kpiCategoryValue.domain)
+  @Field({ nullable: true, description: 'Domain (tenant) to which this KPI category value belongs.' })
+  domainId: string
+
+  @Column({ default: '' })
+  @Field({ nullable: true, description: 'Group key for this value (organization, line, user, etc.)' })
+  group?: string
+
+  @Field(type => Float, { nullable: true, description: 'Performance score for this category (0-1 range).' })
+  @Column('float', { nullable: true })
+  score?: number
+
+  @Field({
+    nullable: true,
+    description:
+      'Date or period for which this KPI category value is recorded (e.g., day: YYYY-MM-DD, month: YYYY-MM, quarter: YYYY-Qn, range: YYYY-MM-DD~YYYY-MM-DD).'
+  })
+  @Column()
+  valueDate: string
+
+  @ManyToOne(() => KpiCategory, { onDelete: 'CASCADE' })
+  @Field(type => KpiCategory, { nullable: true, description: 'KPI category to which this value belongs.' })
+  category: KpiCategory
+
+  @RelationId((kpiCategoryValue: KpiCategoryValue) => kpiCategoryValue.category)
+  @Field({ nullable: true, description: 'ID of the domain (tenant) for this KPI category value.' })
+  categoryId: string
+
+  @Field({ nullable: true, description: 'Timestamp when this KPI category value record was created.' })
+  @CreateDateColumn()
+  createdAt: Date
+
+  @Field({ nullable: true, description: 'Timestamp when this KPI category value record was last updated.' })
+  @UpdateDateColumn()
+  updatedAt: Date
+
+  @ManyToOne(() => User, { nullable: true, onDelete: 'SET NULL' })
+  @Field(type => User, { nullable: true, description: 'User who created this KPI category value record.' })
+  creator?: User
+
+  @RelationId((kpiCategoryValue: KpiCategoryValue) => kpiCategoryValue.creator)
+  @Field({ nullable: true, description: 'ID of the user who created this KPI category value record.' })
+  creatorId?: string
+
+  @ManyToOne(() => User, { nullable: true, onDelete: 'SET NULL' })
+  @Field(type => User, { nullable: true, description: 'User who last updated this KPI category value record.' })
+  updater?: User
+
+  @RelationId((kpiCategoryValue: KpiCategoryValue) => kpiCategoryValue.updater)
+  @Field({ nullable: true, description: 'ID of the user who last updated this KPI category value record.' })
+  updaterId?: string
+}

package/server/service/kpi-metric-value/kpi-metric-value-mutation.ts

@@ -151,8 +151,22 @@ export class KpiMetricValueMutation {
     if (_createRecords.length > 0) {
       for (let i = 0; i < _createRecords.length; i++) {
         const newRecord = _createRecords[i]
+
+        if (!newRecord.metricId) {
+          throw new Error('metricId is required for creating new metric value')
+        }
+
+        const metric = await getRepository(KpiMetric).findOne({
+          where: { domain: { id: domain.id }, id: newRecord.metricId }
+        })
+
+        if (!metric) {
+          throw new Error(`Metric not found: ${newRecord.metricId}`)
+        }
+
         const result = await metricValueRepo.save({
           ...newRecord,
+          metric,
           domain,
           creator: user,
           updater: user
@@ -165,9 +179,23 @@ export class KpiMetricValueMutation {
       for (let i = 0; i < _updateRecords.length; i++) {
         const updateRecord = _updateRecords[i]
         const metricValue = await metricValueRepo.findOneBy({ id: updateRecord.id })
+
+        if (!updateRecord.metricId) {
+          throw new Error('metricId is required for updating value')
+        }
+
+        const metric = await getRepository(KpiMetric).findOne({
+          where: { domain: { id: domain.id }, id: updateRecord.metricId }
+        })
+
+        if (!metric) {
+          throw new Error(`Metric not found: ${updateRecord.metricId}`)
+        }
+
         const result = await metricValueRepo.save({
           ...metricValue,
           ...updateRecord,
+          metric,
           updater: user
         } as any)
         results.push({ ...result, cuFlag: 'M' })

package/server/service/kpi-value/kpi-value-mutation.ts

@@ -54,6 +54,60 @@ export class KpiValueMutation {
     return await getRepository(KpiValue, tx).save(entity)
   }
 
+  @Directive('@transaction')
+  @Mutation(returns => [KpiValue], { description: 'Create multiple KPI values with the provided details.' })
+  async createMultipleKpiValue(
+    @Arg('values', type => [NewKpiValue], {
+      description: 'Array of input objects containing details for the new KPI values.'
+    })
+    values: NewKpiValue[],
+    @Ctx() context: ResolverContext
+  ): Promise<KpiValue[]> {
+    const { domain, user, tx } = context.state
+    const repository = getRepository(KpiValue, tx)
+    const scoreService = new KpiValueScoreService()
+
+    const entities: KpiValue[] = []
+
+    for (const kpiValue of values) {
+      let kpi = kpiValue.kpiId ? await getRepository(Kpi).findOne({ where: { id: kpiValue.kpiId } }) : undefined
+
+      let inputType: KpiValueInputType | undefined = undefined
+      if (kpiValue.inputType) {
+        if (typeof kpiValue.inputType === 'string') {
+          inputType = KpiValueInputType[kpiValue.inputType as keyof typeof KpiValueInputType]
+        } else {
+          inputType = kpiValue.inputType
+        }
+      }
+
+      const entity: Partial<KpiValue> = {
+        kpi,
+        kpiId: kpiValue.kpiId,
+        version: kpiValue.version || 1,
+        valueDate: kpiValue.valueDate,
+        value: kpiValue.value,
+        group: kpiValue.group || '',
+        source: kpiValue.source || 'MANUAL',
+        domain: domain,
+        creator: user,
+        updater: user
+      }
+      if (inputType) entity.inputType = inputType
+
+      const savedEntity = await repository.save(entity)
+
+      // 성과 점수 자동 계산 및 저장
+      if (kpi) {
+        await scoreService.calculateAndSaveScore(savedEntity, kpi)
+      }
+
+      entities.push(savedEntity)
+    }
+
+    return entities
+  }
+
   @Directive('@transaction')
   @Mutation(returns => KpiValue, { description: 'To modify KpiValue information' })
   async updateKpiValue(
@@ -109,8 +163,14 @@ export class KpiValueMutation {
       for (let i = 0; i < _createRecords.length; i++) {
         const newRecord = _createRecords[i]
 
+        const kpi = await getRepository(Kpi, tx).findOne({
+          where: { domain: { id: domain.id }, id: newRecord.kpiId }
+        })
+
         const result = await kpiValueRepo.save({
           ...newRecord,
+          kpi,
+          version: newRecord.version || kpi.version,
           domain,
           creator: user,
           updater: user
@@ -125,9 +185,15 @@ export class KpiValueMutation {
         const updateRecord = _updateRecords[i]
         const kpiValue = await kpiValueRepo.findOneBy({ id: updateRecord.id })
 
+        const kpi = await getRepository(Kpi, tx).findOne({
+          where: { domain: { id: domain.id }, id: updateRecord.kpiId }
+        })
+
         const result = await kpiValueRepo.save({
           ...kpiValue,
           ...updateRecord,
+          kpi,
+          version: updateRecord.version || kpi.version,
           updater: user
         } as any)
 

package/things-factory.config.js

@@ -8,9 +8,12 @@ export default {
     { tagname: 'kpi-dashboard', page: 'kpi-dashboard' },
     { tagname: 'kpi-list-page', page: 'kpi-list' },
     { tagname: 'kpi-category-list-page', page: 'kpi-category-list' },
+    { tagname: 'kpi-category-value-list-page', page: 'kpi-category-value-list' },
     { tagname: 'kpi-metric-list-page', page: 'kpi-metric-list' },
     { tagname: 'kpi-value-list-page', page: 'kpi-value-list' },
+    { tagname: 'kpi-value-editor-page', page: 'kpi-value-editor' },
     { tagname: 'kpi-metric-value-list-page', page: 'kpi-metric-value-list' },
+    { tagname: 'kpi-metric-value-editor-page', page: 'kpi-metric-value-editor' },
     { tagname: 'kpi-value-manual-entry-page', page: 'kpi-value-manual-entry' },
     { tagname: 'kpi-metric-value-manual-entry-page', page: 'kpi-metric-value-manual-entry' },
     { tagname: 'kpi-history-list-page', page: 'kpi-history-list' }

package/translations/en.json

@@ -5,10 +5,13 @@
   "label.functions": "functions",
   "title.kpi list": "KPI List",
   "title.kpi category list": "KPI Catogory List",
+  "title.kpi category value list": "KPI Category Value List",
+  "title.kpi value editor": "KPI Value Editor",
   "title.kpi grade list": "KPI Grade List",
   "title.kpi metric list": "KPI Metric List",
   "title.kpi value list": "KPI Value List",
   "title.kpi metric value list": "KPI Metric Value List",
+  "title.kpi metric value editor": "KPI Metric Value Editor",
   "title.kpi performance board": "KPI Performance Board",
   "title.kpi management center": "KPI Management Center",
   "title.kpi overview": "KPI Overview",

package/translations/ja.json

@@ -5,10 +5,13 @@
   "label.functions": "함수",
   "title.kpi list": "KPI リスト",
   "title.kpi category list": "KPI カテゴリ リスト",
+  "title.kpi category value list": "KPI カテゴリ 値 リスト",
+  "title.kpi value editor": "KPI 値 エディター",
   "title.kpi grade list": "KPI グレード リスト",
   "title.kpi metric list": "KPI メトリック リスト",
   "title.kpi value list": "KPI 値 リスト",
   "title.kpi metric value list": "KPI メトリック 値 リスト",
+  "title.kpi metric value editor": "KPI メトリック 値 エディター",
   "title.kpi performance board": "KPI パフォーマンス ボード",
   "title.kpi management center": "KPI 管理 センター",
   "title.kpi overview": "KPI 概要",

package/translations/ko.json

@@ -5,10 +5,13 @@
   "label.functions": "함수",
   "title.kpi list": "KPI 목록",
   "title.kpi category list": "KPI 카테고리 목록",
+  "title.kpi category value list": "KPI 카테고리 값 목록",
+  "title.kpi value editor": "KPI 값 편집기",
   "title.kpi grade list": "KPI 등급 목록",
   "title.kpi metric list": "KPI 메트릭 목록",
   "title.kpi value list": "KPI 값 목록",
   "title.kpi metric value list": "KPI 메트릭 값 목록",
+  "title.kpi metric value editor": "KPI 메트릭 값 편집기",
   "title.kpi performance board": "KPI 성과 보드",
   "title.kpi management center": "KPI 관리 센터",
   "title.kpi overview": "KPI 개요",

package/translations/ms.json

@@ -5,10 +5,13 @@
   "label.functions": "functions",
   "title.kpi list": "Senarai KPI",
   "title.kpi category list": "Senarai Kategori KPI",
+  "title.kpi category value list": "Senarai Nilai Kategori KPI",
+  "title.kpi value editor": "KPI Nilai Editor",
   "title.kpi grade list": "Senarai Gred KPI",
   "title.kpi metric list": "Senarai Metrik KPI",
   "title.kpi value list": "Senarai Nilai KPI",
   "title.kpi metric value list": "Senarai Metrik KPI",
+  "title.kpi metric value editor": "KPI Metrik Editor",
   "title.kpi performance board": "Papan KPI",
   "title.kpi management center": "Pusat Pengurusan KPI",
   "title.kpi overview": "Pengenalan KPI",

package/translations/zh.json

@@ -5,10 +5,13 @@
   "label.functions": "函数",
   "title.kpi list": "KPI 列表",
   "title.kpi category list": "KPI 分类列表",
+  "title.kpi category value list": "KPI 分类值列表",
+  "title.kpi value editor": "KPI 值编辑器",
   "title.kpi grade list": "KPI 等级列表",
   "title.kpi metric list": "KPI 指标列表",
   "title.kpi value list": "KPI 值列表",
   "title.kpi metric value list": "KPI 指标值列表",
+  "title.kpi metric value editor": "KPI 指标值编辑器",
   "title.kpi performance board": "KPI 绩效看板",
   "title.kpi management center": "KPI 管理中心",
   "title.kpi overview": "KPI 概述",