@rytass/bpm-core-nestjs-module 0.4.0 → 0.5.0

package/src/lib/organization/dto/manager-resolution.input.ts

@@ -0,0 +1,91 @@
+import { Field, ID, InputType, Int } from '@nestjs/graphql';
+import {
+  IsEnum,
+  IsInt,
+  IsOptional,
+  IsString,
+  Matches,
+  Min,
+} from 'class-validator';
+import { ManagerResolutionScopeTypeEnum } from '../organization.enums';
+
+const DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+
+@InputType()
+export class CreateManagerResolutionInput {
+  @Field(() => ManagerResolutionScopeTypeEnum)
+  @IsEnum(ManagerResolutionScopeTypeEnum)
+  scopeType!: ManagerResolutionScopeTypeEnum;
+
+  @Field()
+  @IsString()
+  scopeId!: string;
+
+  @Field()
+  @IsString()
+  managerMemberId!: string;
+
+  @Field(() => Int, { defaultValue: 0 })
+  @IsInt()
+  @Min(0)
+  priority!: number;
+
+  @Field()
+  @IsString()
+  @Matches(DATE_ONLY_PATTERN, {
+    message: 'effectiveFrom must use YYYY-MM-DD format',
+  })
+  effectiveFrom!: string;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  @Matches(DATE_ONLY_PATTERN, {
+    message: 'effectiveTo must use YYYY-MM-DD format',
+  })
+  effectiveTo!: string | null;
+}
+
+@InputType()
+export class UpdateManagerResolutionInput {
+  @Field(() => ID)
+  @IsString()
+  id!: string;
+
+  @Field(() => ManagerResolutionScopeTypeEnum, { nullable: true })
+  @IsOptional()
+  @IsEnum(ManagerResolutionScopeTypeEnum)
+  scopeType!: ManagerResolutionScopeTypeEnum | null;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  scopeId!: string | null;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  managerMemberId!: string | null;
+
+  @Field(() => Int, { nullable: true })
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  priority!: number | null;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  @Matches(DATE_ONLY_PATTERN, {
+    message: 'effectiveFrom must use YYYY-MM-DD format',
+  })
+  effectiveFrom!: string | null;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  @Matches(DATE_ONLY_PATTERN, {
+    message: 'effectiveTo must use YYYY-MM-DD format',
+  })
+  effectiveTo!: string | null;
+}

package/src/lib/organization/dto/membership.input.ts

@@ -0,0 +1,77 @@
+import { Field, ID, InputType } from '@nestjs/graphql';
+import { IsBoolean, IsOptional, IsString, Matches } from 'class-validator';
+
+const DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+
+@InputType()
+export class CreateMembershipInput {
+  @Field()
+  @IsString()
+  memberId!: string;
+
+  @Field(() => ID)
+  @IsString()
+  orgUnitId!: string;
+
+  @Field(() => ID, { nullable: true })
+  @IsOptional()
+  @IsString()
+  positionId!: string | null;
+
+  @Field({ defaultValue: false })
+  @IsBoolean()
+  isPrimary!: boolean;
+
+  @Field()
+  @IsString()
+  @Matches(DATE_ONLY_PATTERN, {
+    message: 'effectiveFrom must use YYYY-MM-DD format',
+  })
+  effectiveFrom!: string;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  @Matches(DATE_ONLY_PATTERN, {
+    message: 'effectiveTo must use YYYY-MM-DD format',
+  })
+  effectiveTo!: string | null;
+}
+
+@InputType()
+export class UpdateMembershipInput {
+  @Field(() => ID)
+  @IsString()
+  id!: string;
+
+  @Field(() => ID, { nullable: true })
+  @IsOptional()
+  @IsString()
+  orgUnitId!: string | null;
+
+  @Field(() => ID, { nullable: true })
+  @IsOptional()
+  @IsString()
+  positionId!: string | null;
+
+  @Field(() => Boolean, { nullable: true })
+  @IsOptional()
+  @IsBoolean()
+  isPrimary!: boolean | null;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  @Matches(DATE_ONLY_PATTERN, {
+    message: 'effectiveFrom must use YYYY-MM-DD format',
+  })
+  effectiveFrom!: string | null;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  @Matches(DATE_ONLY_PATTERN, {
+    message: 'effectiveTo must use YYYY-MM-DD format',
+  })
+  effectiveTo!: string | null;
+}

package/src/lib/organization/dto/org-unit.input.ts

@@ -0,0 +1,96 @@
+import { Field, ID, InputType } from '@nestjs/graphql';
+import {
+  IsArray,
+  IsEnum,
+  IsOptional,
+  IsString,
+  Matches,
+  ValidateNested,
+} from 'class-validator';
+import { OrgUnitTypeEnum } from '../organization.enums';
+
+const ISO_DATE_TIME_WITH_TIME_ZONE_PATTERN =
+  /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{3})?)?(?:Z|[+-]\d{2}:\d{2})$/;
+
+@InputType()
+export class CreateOrgUnitInput {
+  @Field(() => ID, { nullable: true })
+  @IsOptional()
+  @IsString()
+  parentId!: string | null;
+
+  @Field()
+  @IsString()
+  code!: string;
+
+  @Field()
+  @IsString()
+  name!: string;
+
+  @Field(() => OrgUnitTypeEnum)
+  @IsEnum(OrgUnitTypeEnum)
+  type!: OrgUnitTypeEnum;
+
+  @Field({ defaultValue: '{}' })
+  @IsString()
+  metadataJson!: string;
+}
+
+@InputType()
+export class UpdateOrgUnitInput {
+  @Field(() => ID)
+  @IsString()
+  id!: string;
+
+  @Field(() => ID, { nullable: true })
+  @IsOptional()
+  @IsString()
+  parentId!: string | null;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  code!: string | null;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  name!: string | null;
+
+  @Field(() => OrgUnitTypeEnum, { nullable: true })
+  @IsOptional()
+  @IsEnum(OrgUnitTypeEnum)
+  type!: OrgUnitTypeEnum | null;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  metadataJson!: string | null;
+}
+
+@InputType()
+export class CommitOrgUnitTreeDraftMoveInput {
+  @Field(() => ID)
+  @IsString()
+  id!: string;
+
+  @Field(() => ID, { nullable: true })
+  @IsOptional()
+  @IsString()
+  parentId!: string | null;
+
+  @Field()
+  @IsString()
+  @Matches(ISO_DATE_TIME_WITH_TIME_ZONE_PATTERN, {
+    message: 'baseUpdatedAt must be ISO 8601 datetime with timezone',
+  })
+  baseUpdatedAt!: string;
+}
+
+@InputType()
+export class CommitOrgUnitTreeDraftInput {
+  @Field(() => [CommitOrgUnitTreeDraftMoveInput])
+  @IsArray()
+  @ValidateNested({ each: true })
+  moves!: readonly CommitOrgUnitTreeDraftMoveInput[];
+}

package/src/lib/organization/dto/position.input.ts

@@ -0,0 +1,50 @@
+import { Field, ID, InputType, Int } from '@nestjs/graphql';
+import { IsInt, IsOptional, IsString, Min } from 'class-validator';
+
+@InputType()
+export class CreatePositionInput {
+  @Field()
+  @IsString()
+  code!: string;
+
+  @Field()
+  @IsString()
+  name!: string;
+
+  @Field(() => Int)
+  @IsInt()
+  @Min(0)
+  level!: number;
+
+  @Field({ defaultValue: '{}' })
+  @IsString()
+  metadataJson!: string;
+}
+
+@InputType()
+export class UpdatePositionInput {
+  @Field(() => ID)
+  @IsString()
+  id!: string;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  code!: string | null;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  name!: string | null;
+
+  @Field(() => Int, { nullable: true })
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  level!: number | null;
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  metadataJson!: string | null;
+}

package/src/lib/organization/json-metadata.ts

@@ -0,0 +1,15 @@
+export function parseMetadataJson(
+  value: string | null | undefined,
+): Readonly<Record<string, unknown>> {
+  if (!value) {
+    return {};
+  }
+
+  const parsed: unknown = JSON.parse(value);
+
+  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+    throw new Error('metadataJson must be a JSON object');
+  }
+
+  return parsed as Readonly<Record<string, unknown>>;
+}

package/src/lib/organization/manager-resolution.entity.ts

@@ -0,0 +1,44 @@
+import { Field, ID, Int, ObjectType } from '@nestjs/graphql';
+import {
+  Column,
+  CreateDateColumn,
+  Entity,
+  PrimaryGeneratedColumn,
+} from 'typeorm';
+import { ManagerResolutionScopeTypeEnum } from './organization.enums';
+
+@Entity('manager_resolutions')
+@ObjectType('ManagerResolution')
+export class ManagerResolutionEntity {
+  @PrimaryGeneratedColumn('uuid')
+  @Field(() => ID)
+  id!: string;
+
+  @Column('text', { name: 'scope_type' })
+  @Field(() => ManagerResolutionScopeTypeEnum)
+  scopeType!: ManagerResolutionScopeTypeEnum;
+
+  @Column('text', { name: 'scope_id' })
+  @Field()
+  scopeId!: string;
+
+  @Column('text', { name: 'manager_member_id' })
+  @Field()
+  managerMemberId!: string;
+
+  @Column('int')
+  @Field(() => Int)
+  priority!: number;
+
+  @Column('date', { name: 'effective_from' })
+  @Field()
+  effectiveFrom!: string;
+
+  @Column('date', { name: 'effective_to', nullable: true })
+  @Field(() => String, { nullable: true })
+  effectiveTo!: string | null;
+
+  @CreateDateColumn({ name: 'created_at', type: 'timestamptz' })
+  @Field()
+  createdAt!: Date;
+}

package/src/lib/organization/membership.entity.ts

@@ -0,0 +1,50 @@
+import { Field, ID, ObjectType } from '@nestjs/graphql';
+import {
+  Column,
+  CreateDateColumn,
+  Entity,
+  PrimaryGeneratedColumn,
+  Unique,
+  UpdateDateColumn,
+} from 'typeorm';
+
+@Entity('memberships')
+@Unique(['memberId', 'orgUnitId', 'positionId', 'effectiveFrom'])
+@ObjectType('Membership')
+export class MembershipEntity {
+  @PrimaryGeneratedColumn('uuid')
+  @Field(() => ID)
+  id!: string;
+
+  @Column('text', { name: 'member_id' })
+  @Field()
+  memberId!: string;
+
+  @Column('uuid', { name: 'org_unit_id' })
+  @Field(() => ID)
+  orgUnitId!: string;
+
+  @Column('uuid', { name: 'position_id', nullable: true })
+  @Field(() => ID, { nullable: true })
+  positionId!: string | null;
+
+  @Column('boolean', { default: false, name: 'is_primary' })
+  @Field()
+  isPrimary!: boolean;
+
+  @Column('date', { name: 'effective_from' })
+  @Field()
+  effectiveFrom!: string;
+
+  @Column('date', { name: 'effective_to', nullable: true })
+  @Field(() => String, { nullable: true })
+  effectiveTo!: string | null;
+
+  @CreateDateColumn({ name: 'created_at', type: 'timestamptz' })
+  @Field()
+  createdAt!: Date;
+
+  @UpdateDateColumn({ name: 'updated_at', type: 'timestamptz' })
+  @Field()
+  updatedAt!: Date;
+}

package/src/lib/organization/org-unit-tree-commit-result.object.ts

@@ -0,0 +1,8 @@
+import { Field, ObjectType } from '@nestjs/graphql';
+import { OrgUnitEntity } from './org-unit.entity';
+
+@ObjectType('OrgUnitTreeCommitResult')
+export class OrgUnitTreeCommitResultObject {
+  @Field(() => [OrgUnitEntity])
+  orgUnits!: readonly OrgUnitEntity[];
+}

package/src/lib/organization/org-unit.entity.ts

@@ -0,0 +1,53 @@
+import { Field, ID, ObjectType } from '@nestjs/graphql';
+import {
+  Column,
+  CreateDateColumn,
+  DeleteDateColumn,
+  Entity,
+  PrimaryGeneratedColumn,
+  UpdateDateColumn,
+} from 'typeorm';
+import { OrgUnitTypeEnum } from './organization.enums';
+
+@Entity('org_units')
+@ObjectType('OrgUnit')
+export class OrgUnitEntity {
+  @PrimaryGeneratedColumn('uuid')
+  @Field(() => ID)
+  id!: string;
+
+  @Column('uuid', { name: 'parent_id', nullable: true })
+  @Field(() => ID, { nullable: true })
+  parentId!: string | null;
+
+  @Column('text', { unique: true })
+  @Field()
+  code!: string;
+
+  @Column('text')
+  @Field()
+  name!: string;
+
+  @Column('text')
+  @Field(() => OrgUnitTypeEnum)
+  type!: OrgUnitTypeEnum;
+
+  @Column('ltree')
+  @Field()
+  path!: string;
+
+  @Column('jsonb', { default: {} })
+  metadata!: Readonly<Record<string, unknown>>;
+
+  @DeleteDateColumn({ name: 'deleted_at', type: 'timestamptz' })
+  @Field(() => Date, { nullable: true })
+  deletedAt!: Date | null;
+
+  @CreateDateColumn({ name: 'created_at', type: 'timestamptz' })
+  @Field()
+  createdAt!: Date;
+
+  @UpdateDateColumn({ name: 'updated_at', type: 'timestamptz' })
+  @Field()
+  updatedAt!: Date;
+}

package/src/lib/organization/organization-summary.object.ts

@@ -0,0 +1,16 @@
+import { Field, Int, ObjectType } from '@nestjs/graphql';
+
+@ObjectType('OrganizationSummary')
+export class OrganizationSummaryObject {
+  @Field(() => Int)
+  orgUnitCount!: number;
+
+  @Field(() => Int)
+  positionCount!: number;
+
+  @Field(() => Int)
+  membershipCount!: number;
+
+  @Field(() => Int)
+  managerResolutionCount!: number;
+}

package/src/lib/organization/organization.enums.ts

@@ -0,0 +1,19 @@
+import { registerEnumType } from '@nestjs/graphql';
+
+export enum OrgUnitTypeEnum {
+  COMPANY = 'company',
+  DIVISION = 'division',
+  DEPARTMENT = 'department',
+  TEAM = 'team',
+}
+
+export enum ManagerResolutionScopeTypeEnum {
+  MEMBER = 'MEMBER',
+  ORG_UNIT = 'ORG_UNIT',
+  POSITION = 'POSITION',
+}
+
+registerEnumType(OrgUnitTypeEnum, { name: 'OrgUnitType' });
+registerEnumType(ManagerResolutionScopeTypeEnum, {
+  name: 'ManagerResolutionScopeType',
+});

package/src/lib/organization/organization.module.ts

@@ -0,0 +1,27 @@
+import { Module } from '@nestjs/common';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { ManagerResolutionEntity } from './manager-resolution.entity';
+import { MembershipEntity } from './membership.entity';
+import { OrgUnitEntity } from './org-unit.entity';
+import { OrganizationMutations } from './organization.mutations';
+import { OrganizationQueries } from './organization.queries';
+import { OrganizationService } from './organization.service';
+import { PositionEntity } from './position.entity';
+
+@Module({
+  imports: [
+    TypeOrmModule.forFeature([
+      ManagerResolutionEntity,
+      MembershipEntity,
+      OrgUnitEntity,
+      PositionEntity,
+    ]),
+  ],
+  providers: [
+    OrganizationMutations,
+    OrganizationQueries,
+    OrganizationService,
+  ],
+  exports: [OrganizationService],
+})
+export class OrganizationModule {}

package/src/lib/organization/organization.mutations.ts

@@ -0,0 +1,115 @@
+import { Args, Mutation, Resolver } from '@nestjs/graphql';
+import { BPMAdminOnly } from '../bpm-auth';
+import { ManagerResolutionEntity } from './manager-resolution.entity';
+import { MembershipEntity } from './membership.entity';
+import { OrgUnitEntity } from './org-unit.entity';
+import { OrganizationService } from './organization.service';
+import { PositionEntity } from './position.entity';
+import {
+  CreateManagerResolutionInput,
+  UpdateManagerResolutionInput,
+} from './dto/manager-resolution.input';
+import {
+  CreateMembershipInput,
+  UpdateMembershipInput,
+} from './dto/membership.input';
+import {
+  CommitOrgUnitTreeDraftInput,
+  CreateOrgUnitInput,
+  UpdateOrgUnitInput,
+} from './dto/org-unit.input';
+import { OrgUnitTreeCommitResultObject } from './org-unit-tree-commit-result.object';
+import {
+  CreatePositionInput,
+  UpdatePositionInput,
+} from './dto/position.input';
+
+@Resolver()
+@BPMAdminOnly()
+export class OrganizationMutations {
+  constructor(private readonly organizationService: OrganizationService) {}
+
+  @Mutation(() => OrgUnitEntity)
+  async createOrgUnit(
+    @Args('input') input: CreateOrgUnitInput,
+  ): Promise<OrgUnitEntity> {
+    return this.organizationService.createOrgUnit(input);
+  }
+
+  @Mutation(() => OrgUnitEntity)
+  async updateOrgUnit(
+    @Args('input') input: UpdateOrgUnitInput,
+  ): Promise<OrgUnitEntity> {
+    return this.organizationService.updateOrgUnit(input);
+  }
+
+  @Mutation(() => OrgUnitTreeCommitResultObject)
+  async commitOrgUnitTreeDraft(
+    @Args('input') input: CommitOrgUnitTreeDraftInput,
+  ): Promise<OrgUnitTreeCommitResultObject> {
+    return this.organizationService.commitOrgUnitTreeDraft(input);
+  }
+
+  @Mutation(() => Boolean)
+  async deleteOrgUnit(
+    @Args('id', { type: () => String }) id: string,
+  ): Promise<boolean> {
+    return this.organizationService.deleteOrgUnit(id);
+  }
+
+  @Mutation(() => PositionEntity)
+  async createPosition(
+    @Args('input') input: CreatePositionInput,
+  ): Promise<PositionEntity> {
+    return this.organizationService.createPosition(input);
+  }
+
+  @Mutation(() => PositionEntity)
+  async updatePosition(
+    @Args('input') input: UpdatePositionInput,
+  ): Promise<PositionEntity> {
+    return this.organizationService.updatePosition(input);
+  }
+
+  @Mutation(() => Boolean)
+  async deleteMembership(
+    @Args('id', { type: () => String }) id: string,
+  ): Promise<boolean> {
+    return this.organizationService.deleteMembership(id);
+  }
+
+  @Mutation(() => MembershipEntity)
+  async createMembership(
+    @Args('input') input: CreateMembershipInput,
+  ): Promise<MembershipEntity> {
+    return this.organizationService.createMembership(input);
+  }
+
+  @Mutation(() => MembershipEntity)
+  async updateMembership(
+    @Args('input') input: UpdateMembershipInput,
+  ): Promise<MembershipEntity> {
+    return this.organizationService.updateMembership(input);
+  }
+
+  @Mutation(() => ManagerResolutionEntity)
+  async createManagerResolution(
+    @Args('input') input: CreateManagerResolutionInput,
+  ): Promise<ManagerResolutionEntity> {
+    return this.organizationService.createManagerResolution(input);
+  }
+
+  @Mutation(() => ManagerResolutionEntity)
+  async updateManagerResolution(
+    @Args('input') input: UpdateManagerResolutionInput,
+  ): Promise<ManagerResolutionEntity> {
+    return this.organizationService.updateManagerResolution(input);
+  }
+
+  @Mutation(() => Boolean)
+  async deleteManagerResolution(
+    @Args('id', { type: () => String }) id: string,
+  ): Promise<boolean> {
+    return this.organizationService.deleteManagerResolution(id);
+  }
+}