@things-factory/kpi 9.0.27 → 9.0.29

package/helps/kpi/kpi-statistic.md

@@ -0,0 +1,160 @@
+# KpiStatistic
+
+Paragraphs are separated by a blank line.
+
+2nd paragraph. _Italic_, **bold**, and `monospace`. Itemized lists
+look like:
+
+- this one
+- that one
+- the other one
+
+Note that --- not considering the asterisk --- the actual text
+content starts at 4-columns in.
+
+> Block quotes are
+> written like so.
+>
+> They can span multiple paragraphs,
+> if you like.
+
+Use 3 dashes for an em-dash. Use 2 dashes for ranges (ex., "it's all
+in chapters 12--14"). Three dots ... will be converted to an ellipsis.
+Unicode is supported. ☺
+
+## An h2 header
+
+Here's a numbered list:
+
+1. first item
+2. second item
+3. third item
+
+Note again how the actual text starts at 4 columns in (4 characters
+from the left side). Here's a code sample:
+
+# Let me re-iterate ...
+
+for i in 1 .. 10 { do-something(i) }
+
+As you probably guessed, indented 4 spaces. By the way, instead of
+indenting the block, you can use delimited blocks, if you like:
+
+```
+define foobar() {
+print "Welcome to flavor country!";
+}
+```
+
+(which makes copying & pasting easier). You can optionally mark the
+delimited block for Pandoc to syntax highlight it:
+
+```python
+import time
+# Quick, count to ten!
+for i in range(10):
+# (but not *too* quick)
+time.sleep(0.5)
+print(i)
+```
+
+### An h3 header
+
+Now a nested list:
+
+1. First, get these ingredients:
+
+- carrots
+- celery
+- lentils
+
+2. Boil some water.
+
+3. Dump everything in the pot and follow
+   this algorithm:
+
+find wooden spoon
+uncover pot
+stir
+cover pot
+balance wooden spoon precariously on pot handle
+wait 10 minutes
+goto first step (or shut off burner when done)
+
+Do not bump wooden spoon or it will fall.
+
+Notice again how text always lines up on 4-space indents (including
+that last line which continues item 3 above).
+
+Here's a link to [a website](http://foo.bar), to a [local
+doc](local-doc.html), and to a [section heading in the current
+doc](#an-h2-header). Here's a footnote [^1].
+
+[^1]: Some footnote text.
+
+Tables can look like this:
+
+Name Size Material Color
+
+---
+
+All Business 9 leather brown
+Roundabout 10 hemp canvas natural
+Cinderella 11 glass transparent
+
+Table: Shoes sizes, materials, and colors.
+
+(The above is the caption for the table.) Pandoc also supports
+multi-line tables:
+
+---
+
+Keyword Text
+
+---
+
+red Sunsets, apples, and
+other red or reddish
+things.
+
+green Leaves, grass, frogs
+and other things it's
+not easy being.
+
+---
+
+A horizontal rule follows.
+
+---
+
+Here's a definition list:
+
+apples
+: Good for making applesauce.
+
+oranges
+: Citrus!
+
+tomatoes
+: There's no "e" in tomatoe.
+
+Again, text is indented 4 spaces. (Put a blank line between each
+term and its definition to spread things out more.)
+
+Here's a "line block" (note how whitespace is honored):
+
+| Line one
+| Line too
+| Line tree
+
+and images can be specified like so:
+
+![example image](example-image.jpg 'An exemplary image')
+
+Inline math equation: $\omega = d\phi / dt$. Display
+math should get its own line like so:
+
+$$I = \int \rho R^{2} dV$$
+
+And note that you can backslash-escape any punctuation characters
+which you wish to be displayed literally, ex.: \`foo\`, \*bar\*, etc.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/kpi",
-  "version": "9.0.27",
+  "version": "9.0.29",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -41,8 +41,8 @@
     "@operato/styles": "^9.0.0",
     "@operato/utils": "^9.0.0",
     "@things-factory/auth-base": "^9.0.25",
-    "@things-factory/dataset": "^9.0.27",
+    "@things-factory/dataset": "^9.0.28",
     "@things-factory/shell": "^9.0.25"
   },
-  "gitHead": "7dbcca8920f72218807a5583c510df97fe2102ba"
+  "gitHead": "7e3b1a58f5c971d960bb7ca88ccc3fca4c4bd08d"
 }

package/server/service/index.ts

@@ -1,4 +1,5 @@
 /* EXPORT ENTITY TYPES */
+export * from './kpi-statistic/kpi-statistic'
 export * from './kpi/kpi'
 export * from './kpi/kpi-type'
 export * from './kpi-category/kpi-category'
@@ -14,6 +15,11 @@ export * from './kpi-metric-value/kpi-metric-value-type'
 export * from './kpi-alert'
 
 /* IMPORT ENTITIES AND RESOLVERS */
+import {
+  entities as KpiStatisticEntities,
+  resolvers as KpiStatisticResolvers,
+  subscribers as KpiStatisticSubscribers
+} from './kpi-statistic'
 import { entities as KpiEntities, resolvers as KpiResolvers } from './kpi'
 import { entities as KpiCategoryEntities, resolvers as KpiCategoryResolvers } from './kpi-category'
 import { entities as KpiCategoryValueEntities, resolvers as KpiCategoryValueResolvers } from './kpi-category-value'
@@ -24,6 +30,7 @@ import { resolvers as KpiAlertResolvers } from './kpi-alert'
 
 export const entities = [
   /* ENTITIES */
+  ...KpiStatisticEntities,
   ...KpiEntities,
   ...KpiCategoryEntities,
   ...KpiCategoryValueEntities,
@@ -35,6 +42,7 @@ export const entities = [
 export const schema = {
   resolverClasses: [
     /* RESOLVER CLASSES */
+    ...KpiStatisticResolvers,
     ...KpiResolvers,
     ...KpiCategoryResolvers,
     ...KpiCategoryValueResolvers,

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

@@ -21,6 +21,7 @@ import { KpiMetricValueProvider } from '../../controllers/kpi-metric-value-provi
 @Resolver(Kpi)
 export class KpiMutation {
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Kpi, { description: 'Create a new KPI with the provided details.' })
   async createKpi(
     @Arg('kpi', { description: 'Input object containing details for the new KPI.' }) kpi: NewKpi,
@@ -103,6 +104,7 @@ export class KpiMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Kpi, { description: 'To modify Kpi information' })
   async updateKpi(@Arg('id') id: string, @Arg('patch') patch: KpiPatch, @Ctx() context: ResolverContext): Promise<Kpi> {
     const { domain, user, tx } = context.state
@@ -197,6 +199,7 @@ export class KpiMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => [Kpi], { description: "To modify multiple Kpis' information" })
   async updateMultipleKpi(
     @Arg('patches', type => [KpiPatch]) patches: KpiPatch[],
@@ -272,6 +275,7 @@ export class KpiMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Boolean, { description: 'To delete Kpi' })
   async deleteKpi(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {
     const { domain, tx } = context.state
@@ -288,6 +292,7 @@ export class KpiMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Boolean, { description: 'To delete multiple Kpis' })
   async deleteKpis(@Arg('ids', type => [String]) ids: string[], @Ctx() context: ResolverContext): Promise<boolean> {
     const { domain, tx } = context.state
@@ -303,6 +308,7 @@ export class KpiMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Boolean, { description: 'To import multiple Kpis' })
   async importKpis(
     @Arg('kpis', type => [KpiPatch]) kpis: KpiPatch[],
@@ -320,6 +326,7 @@ export class KpiMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Kpi, { description: 'Release a KPI and create a version history.' })
   async releaseKpi(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<Kpi> {
     const { domain, user, tx } = context.state
@@ -350,6 +357,7 @@ export class KpiMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Kpi, { description: 'Revert a KPI to a specific historical version.' })
   async revertKpiVersion(
     @Arg('id') id: string,
@@ -387,6 +395,7 @@ export class KpiMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => KpiValue, { description: 'KPI 기준으로 formula 계산 및 KPI Value upsert' })
   async calculateKpiValue(
     @Arg('kpiId') kpiId: string,

package/server/service/kpi/kpi-query.ts

@@ -11,6 +11,7 @@ import { KpiCategory } from '../kpi-category/kpi-category'
 
 @Resolver(Kpi)
 export class KpiQuery {
+  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
   @Query(returns => Kpi!, { nullable: true, description: 'Fetch a single KPI by its unique identifier.' })
   async kpi(
     @Arg('id', { description: 'Unique identifier of the KPI to fetch.' }) id: string,
@@ -23,6 +24,7 @@ export class KpiQuery {
     })
   }
 
+  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
   @Query(returns => KpiList, { description: 'To fetch multiple Kpis' })
   async kpis(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<KpiList> {
     const { domain } = context.state

package/server/service/kpi-alert/kpi-alert-query.ts

@@ -1,4 +1,4 @@
-import { Resolver, Query, Ctx } from 'type-graphql'
+import { Directive, Resolver, Query, Ctx } from 'type-graphql'
 import { getRepository } from '@things-factory/shell'
 import { Kpi } from '../kpi/kpi'
 import { KpiValue } from '../kpi-value/kpi-value'
@@ -6,6 +6,7 @@ import { KpiAlert } from './kpi-alert-type'
 
 @Resolver()
 export class KpiAlertQuery {
+  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
   @Query(returns => [KpiAlert], { description: 'KPI 실적/등급/목표 미달 등 경고/알림 리스트 반환' })
   async kpiAlerts(@Ctx() context): Promise<KpiAlert[]> {
     const { domain } = context.state

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

@@ -15,6 +15,7 @@ import { KpiCategoryValue } from '../kpi-category-value/kpi-category-value'
 @Resolver(KpiCategory)
 export class KpiCategoryMutation {
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => KpiCategory, { description: 'Create a new KPI category.' })
   async createKpiCategory(
     @Arg('kpiCategory') kpiCategory: NewKpiCategory,
@@ -33,6 +34,7 @@ export class KpiCategoryMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => KpiCategory, { description: 'Update an existing KPI category.' })
   async updateKpiCategory(
     @Arg('id') id: string,
@@ -57,6 +59,7 @@ export class KpiCategoryMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Boolean, { description: 'Delete a KPI category.' })
   async deleteKpiCategory(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {
     const { domain, tx } = context.state
@@ -73,6 +76,7 @@ export class KpiCategoryMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => KpiCategoryValueResult, { description: 'Calculate KPI category value and score.' })
   async calculateKpiValue(
     @Arg('categoryId') categoryId: string,

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

@@ -27,6 +27,7 @@ export class KpiCategoryValueResult {
 
 @Resolver(KpiCategory)
 export class KpiCategoryQuery {
+  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
   @Query(returns => KpiCategory!, {
     nullable: true,
     description: 'Fetch a single KPI category by its unique identifier.'
@@ -42,6 +43,7 @@ export class KpiCategoryQuery {
     })
   }
 
+  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
   @Query(returns => KpiCategoryList, { description: 'To fetch multiple KpiCategories' })
   async kpiCategories(
     @Args(type => ListParam) params: ListParam,

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

@@ -12,6 +12,7 @@ import { registerSchedule, unregisterSchedule, CallbackBase, Application } from
 @Resolver(KpiMetric)
 export class KpiMetricMutation {
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => KpiMetric, { description: 'Create a new KPI metric with the provided details.' })
   async createKpiMetric(
     @Arg('kpiMetric', { description: 'Input object containing details for the new KPI metric.' })
@@ -90,6 +91,7 @@ export class KpiMetricMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => KpiMetric, { description: 'To modify KpiMetric information' })
   async updateKpiMetric(
     @Arg('id') id: string,
@@ -177,6 +179,7 @@ export class KpiMetricMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => [KpiMetric], { description: "To modify multiple KpiMetrics' information" })
   async updateMultipleKpiMetric(
     @Arg('patches', type => [KpiMetricPatch]) patches: KpiMetricPatch[],
@@ -252,6 +255,7 @@ export class KpiMetricMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Boolean, { description: 'To delete KpiMetric' })
   async deleteKpiMetric(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {
     const { domain, tx } = context.state
@@ -267,6 +271,7 @@ export class KpiMetricMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Boolean, { description: 'To delete multiple KpiMetrics' })
   async deleteKpiMetrics(
     @Arg('ids', type => [String]) ids: string[],
@@ -285,6 +290,7 @@ export class KpiMetricMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Boolean, { description: 'To import multiple KpiMetrics' })
   async importKpiMetrics(
     @Arg('kpiMetrics', type => [KpiMetricPatch]) kpiMetrics: KpiMetricPatch[],

package/server/service/kpi-metric/kpi-metric-query.ts

@@ -7,6 +7,7 @@ import { KpiMetricList } from './kpi-metric-type'
 
 @Resolver(KpiMetric)
 export class KpiMetricQuery {
+  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
   @Query(returns => KpiMetric!, { nullable: true, description: 'Fetch a single KPI metric by its unique identifier.' })
   async kpiMetric(
     @Arg('id', { description: 'Unique identifier of the KPI metric to fetch.' }) id: string,
@@ -19,6 +20,7 @@ export class KpiMetricQuery {
     })
   }
 
+  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
   @Query(returns => KpiMetricList, { description: 'To fetch multiple KpiMetrics' })
   async kpiMetrics(
     @Args(type => ListParam) params: ListParam,

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

@@ -13,6 +13,7 @@ import { getDefaultValueDate } from '../utils/value-date-util'
 @Resolver(KpiMetricValue)
 export class KpiMetricValueMutation {
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => KpiMetricValue, { description: 'Create a new metric value with the provided details.' })
   async createKpiMetricValue(
     @Arg('metricValue', { description: 'Input object containing details for the new metric value.' })
@@ -58,6 +59,7 @@ export class KpiMetricValueMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => KpiMetricValue, { description: 'Record a metric value by metric name, value, meta, and group.' })
   async recordKpiMetricValue(
     @Arg('metricName', { description: 'Metric code/name.' }) metricName: string,
@@ -108,6 +110,7 @@ export class KpiMetricValueMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => KpiMetricValue, { description: 'To modify KpiMetricValue information' })
   async updateKpiMetricValue(
     @Arg('id') id: string,
@@ -136,6 +139,7 @@ export class KpiMetricValueMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => [KpiMetricValue], { description: "To modify multiple KpiMetricValues' information" })
   async updateMultipleKpiMetricValue(
     @Arg('patches', type => [KpiMetricValuePatch]) patches: KpiMetricValuePatch[],
@@ -206,6 +210,7 @@ export class KpiMetricValueMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Boolean, { description: 'To delete KpiMetricValue' })
   async deleteKpiMetricValue(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {
     const { domain, tx } = context.state
@@ -214,6 +219,7 @@ export class KpiMetricValueMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Boolean, { description: 'To delete multiple KpiMetricValues' })
   async deleteKpiMetricValues(
     @Arg('ids', type => [String]) ids: string[],
@@ -228,6 +234,7 @@ export class KpiMetricValueMutation {
   }
 
   @Directive('@transaction')
+  @Directive('@privilege(category: "kpi", privilege: "mutation", domainOwnerGranted: true, superUserGranted: true)')
   @Mutation(returns => Boolean, { description: 'To import multiple KpiMetricValues' })
   async importKpiMetricValues(
     @Arg('metricValues', type => [KpiMetricValuePatch]) metricValues: KpiMetricValuePatch[],

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

@@ -1,4 +1,4 @@
-import { Resolver, Query, Args, Arg, Ctx, FieldResolver, Root } from 'type-graphql'
+import { Directive, Resolver, Query, Args, Arg, Ctx, FieldResolver, Root } from 'type-graphql'
 import { Domain, getQueryBuilderFromListParams, getRepository, ListParam } from '@things-factory/shell'
 import { User } from '@things-factory/auth-base'
 import { KpiMetricValue } from './kpi-metric-value'
@@ -7,6 +7,7 @@ import { KpiMetric } from '../kpi-metric/kpi-metric'
 
 @Resolver(KpiMetricValue)
 export class KpiMetricValueQuery {
+  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
   @Query(returns => KpiMetricValueList, { description: 'To fetch multiple KpiMetricValues' })
   async kpiMetricValues(
     @Args(type => ListParam) params: ListParam,
@@ -23,6 +24,7 @@ export class KpiMetricValueQuery {
     return { items, total }
   }
 
+  @Directive('@privilege(category: "kpi", privilege: "query", domainOwnerGranted: true, superUserGranted: true)')
   @Query(returns => KpiMetricValue, {
     nullable: true,
     description: 'Fetch a single metric value by its unique identifier.'

package/server/service/kpi-statistic/index.ts

@@ -0,0 +1,7 @@
+import { KpiStatistic } from './kpi-statistic.js'
+import { KpiStatisticQuery } from './kpi-statistic-query.js'
+import { KpiStatisticMutation } from './kpi-statistic-mutation.js'
+
+export const entities = [KpiStatistic]
+export const resolvers = [KpiStatisticQuery, KpiStatisticMutation]
+export const subscribers = []