@things-factory/accounting 8.0.0-alpha.4 → 8.0.0-alpha.6

package/server/service/financial-institution/financial-institution-mutation.ts

@@ -0,0 +1,198 @@
+import { Resolver, Mutation, Arg, Ctx, Directive } from 'type-graphql'
+import { In } from 'typeorm'
+import { getRepository } from '@things-factory/shell'
+
+import { createAttachment, deleteAttachmentsByRef } from '@things-factory/attachment-base'
+import { FinancialInstitution } from './financial-institution'
+import { NewFinancialInstitution, FinancialInstitutionPatch } from './financial-institution-type'
+
+@Resolver(FinancialInstitution)
+export class FinancialInstitutionMutation {
+  @Directive('@transaction')
+  @Mutation(returns => FinancialInstitution, { description: 'To create new FinancialInstitution' })
+  async createFinancialInstitution(@Arg('financialInstitution') financialInstitution: NewFinancialInstitution, @Ctx() context: ResolverContext): Promise<FinancialInstitution> {
+    const { domain, user, tx } = context.state
+
+    const result = await getRepository(FinancialInstitution, tx).save({
+      ...financialInstitution,
+      domain,
+      creator: user,
+      updater: user
+    })
+
+    if (financialInstitution.thumbnail) {
+      await createAttachment(
+        null,
+        {
+          attachment: {
+            file: financialInstitution.thumbnail,
+            refType: FinancialInstitution.name,
+            refBy: result.id
+          }
+        },
+        context
+      )
+    }
+
+    return result
+  }
+
+  @Directive('@transaction')
+  @Mutation(returns => FinancialInstitution, { description: 'To modify FinancialInstitution information' })
+  async updateFinancialInstitution(
+    @Arg('id') id: string,
+    @Arg('patch') patch: FinancialInstitutionPatch,
+    @Ctx() context: ResolverContext
+  ): Promise<FinancialInstitution> {
+    const { domain, user, tx } = context.state
+
+    const repository = getRepository(FinancialInstitution, tx)
+    const financialInstitution = await repository.findOne({
+      where: { domain: { id: domain.id }, id }
+    })
+
+    const result = await repository.save({
+      ...financialInstitution,
+      ...patch,
+      updater: user
+    })
+
+    if (patch.thumbnail) {
+      await deleteAttachmentsByRef(null, { refBys: [result.id] }, context)
+      await createAttachment(
+        null,
+        {
+          attachment: {
+            file: patch.thumbnail,
+            refType: FinancialInstitution.name,
+            refBy: result.id
+          }
+        },
+        context
+      )
+    }
+
+    return result
+  }
+
+  @Directive('@transaction')
+  @Mutation(returns => [FinancialInstitution], { description: "To modify multiple FinancialInstitutions' information" })
+  async updateMultipleFinancialInstitution(
+    @Arg('patches', type => [FinancialInstitutionPatch]) patches: FinancialInstitutionPatch[],
+    @Ctx() context: ResolverContext
+  ): Promise<FinancialInstitution[]> {
+    const { domain, user, tx } = context.state
+
+    let results = []
+    const _createRecords = patches.filter((patch: any) => patch.cuFlag.toUpperCase() === '+')
+    const _updateRecords = patches.filter((patch: any) => patch.cuFlag.toUpperCase() === 'M')
+    const financialInstitutionRepo = getRepository(FinancialInstitution, tx)
+
+    if (_createRecords.length > 0) {
+      for (let i = 0; i < _createRecords.length; i++) {
+        const newRecord = _createRecords[i]
+
+        const result = await financialInstitutionRepo.save({
+          ...newRecord,
+          domain,
+          creator: user,
+          updater: user
+        })
+
+        if (newRecord.thumbnail) {
+          await createAttachment(
+            null,
+            {
+              attachment: {
+                file: newRecord.thumbnail,
+                refType: FinancialInstitution.name,
+                refBy: result.id
+              }
+            },
+            context
+          )
+        }
+
+        results.push({ ...result, cuFlag: '+' })
+      }
+    }
+
+    if (_updateRecords.length > 0) {
+      for (let i = 0; i < _updateRecords.length; i++) {
+        const updateRecord = _updateRecords[i]
+        const financialInstitution = await financialInstitutionRepo.findOneBy({ id: updateRecord.id })
+
+        const result = await financialInstitutionRepo.save({
+          ...financialInstitution,
+          ...updateRecord,
+          updater: user
+        })
+
+        if (updateRecord.thumbnail) {
+          await deleteAttachmentsByRef(null, { refBys: [result.id] }, context)
+          await createAttachment(
+            null,
+            {
+              attachment: {
+                file: updateRecord.thumbnail,
+                refType: FinancialInstitution.name,
+                refBy: result.id
+              }
+            },
+            context
+          )
+        }
+
+        results.push({ ...result, cuFlag: 'M' })
+      }
+    }
+
+    return results
+  }
+
+  @Directive('@transaction')
+  @Mutation(returns => Boolean, { description: 'To delete FinancialInstitution' })
+  async deleteFinancialInstitution(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {
+    const { domain, tx } = context.state
+
+    await getRepository(FinancialInstitution, tx).delete({ domain: { id: domain.id }, id })
+    await deleteAttachmentsByRef(null, { refBys: [id] }, context)
+
+    return true
+  }
+
+  @Directive('@transaction')
+  @Mutation(returns => Boolean, { description: 'To delete multiple FinancialInstitutions' })
+  async deleteFinancialInstitutions(
+    @Arg('ids', type => [String]) ids: string[],
+    @Ctx() context: ResolverContext
+  ): Promise<boolean> {
+    const { domain, tx } = context.state
+
+    await getRepository(FinancialInstitution, tx).delete({
+      domain: { id: domain.id },
+      id: In(ids)
+    })
+
+    await deleteAttachmentsByRef(null, { refBys: ids }, context)
+
+    return true
+  }
+
+  @Directive('@transaction')
+  @Mutation(returns => Boolean, { description: 'To import multiple FinancialInstitutions' })
+  async importFinancialInstitutions(
+    @Arg('financialInstitutions', type => [FinancialInstitutionPatch]) financialInstitutions: FinancialInstitutionPatch[],
+    @Ctx() context: ResolverContext
+  ): Promise<boolean> {
+    const { domain, tx } = context.state
+
+    await Promise.all(
+      financialInstitutions.map(async (financialInstitution: FinancialInstitutionPatch) => {
+        const createdFinancialInstitution: FinancialInstitution = await getRepository(FinancialInstitution, tx).save({ domain, ...financialInstitution })
+      })
+    )
+
+    return true
+  }
+}

package/server/service/financial-institution/financial-institution-query.ts

@@ -0,0 +1,62 @@
+import { Resolver, Query, FieldResolver, Root, Args, Arg, Ctx, Directive } from 'type-graphql'
+import { Attachment } from '@things-factory/attachment-base'
+import { Domain, getQueryBuilderFromListParams, getRepository, ListParam } from '@things-factory/shell'
+import { User } from '@things-factory/auth-base'
+import { FinancialInstitution } from './financial-institution'
+import { FinancialInstitutionList } from './financial-institution-type'
+
+@Resolver(FinancialInstitution)
+export class FinancialInstitutionQuery {
+  @Query(returns => FinancialInstitution!, { nullable: true, description: 'To fetch a FinancialInstitution' })
+  async financialInstitution(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FinancialInstitution> {
+    const { domain } = context.state
+
+    return await getRepository(FinancialInstitution).findOne({
+      where: { domain: { id: domain.id }, id }
+    })
+  }
+
+  @Query(returns => FinancialInstitutionList, { description: 'To fetch multiple FinancialInstitutions' })
+  async financialInstitutions(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<FinancialInstitutionList> {
+    const { domain } = context.state
+
+    const queryBuilder = getQueryBuilderFromListParams({
+      domain,
+      params,
+      repository: await getRepository(FinancialInstitution),
+      searchables: ['name', 'description']
+    })
+
+    const [items, total] = await queryBuilder.getManyAndCount()
+
+    return { items, total }
+  }
+
+  @FieldResolver(type => String)
+  async thumbnail(@Root() financialInstitution: FinancialInstitution): Promise<string | undefined> {
+    const attachment: Attachment = await getRepository(Attachment).findOne({
+      where: {
+        domain: { id: financialInstitution.domainId },
+        refType: FinancialInstitution.name,
+        refBy: financialInstitution.id
+      }
+    })
+
+    return attachment?.fullpath
+  }
+
+  @FieldResolver(type => Domain)
+  async domain(@Root() financialInstitution: FinancialInstitution): Promise<Domain> {
+    return financialInstitution.domainId && (await getRepository(Domain).findOneBy({ id: financialInstitution.domainId }))
+  }
+
+  @FieldResolver(type => User)
+  async updater(@Root() financialInstitution: FinancialInstitution): Promise<User> {
+    return financialInstitution.updaterId && (await getRepository(User).findOneBy({ id: financialInstitution.updaterId }))
+  }
+
+  @FieldResolver(type => User)
+  async creator(@Root() financialInstitution: FinancialInstitution): Promise<User> {
+    return financialInstitution.creatorId && (await getRepository(User).findOneBy({ id: financialInstitution.creatorId }))
+  }
+}

package/server/service/financial-institution/financial-institution-type.ts

@@ -0,0 +1,91 @@
+import type { FileUpload } from 'graphql-upload/GraphQLUpload.js'
+import GraphQLUpload from 'graphql-upload/GraphQLUpload.js'
+import { ObjectType, Field, InputType, Int, ID, registerEnumType } from 'type-graphql'
+
+import { ObjectRef, ScalarObject } from '@things-factory/shell'
+
+import { FinancialInstitution, FinancialInstitutionType } from './financial-institution'
+
+@InputType()
+export class NewFinancialInstitution {
+  @Field()
+  name: string
+
+  @Field({ nullable: true })
+  description?: string
+
+  @Field(type => FinancialInstitutionType, {
+    description: 'Type of the financial institution (e.g., Bank, Card Company, Insurance Company, etc.)'
+  })
+  type: FinancialInstitutionType
+
+  @Field({ nullable: true, description: 'SWIFT code of the bank (if applicable)' })
+  swiftCode?: string
+
+  @Field({ nullable: true, description: 'Country of the financial institution' })
+  country?: string
+
+  @Field({ nullable: true, description: 'Contact number of the financial institution' })
+  contactNumber?: string
+
+  @Field({ nullable: true, description: 'Website of the financial institution' })
+  website?: string
+
+  @Field({ nullable: true, description: 'Address of the financial institution' })
+  address?: string
+
+  @Field({ nullable: true, description: 'Email of the financial institution' })
+  email?: string
+
+  @Field(type => GraphQLUpload, { nullable: true })
+  thumbnail?: FileUpload
+}
+
+@InputType()
+export class FinancialInstitutionPatch {
+  @Field(type => ID, { nullable: true })
+  id?: string
+
+  @Field({ nullable: true })
+  name?: string
+
+  @Field({ nullable: true })
+  description?: string
+
+  @Field(type => FinancialInstitutionType, {
+    description: 'Type of the financial institution (e.g., Bank, Card Company, Insurance Company, etc.)'
+  })
+  type: FinancialInstitutionType
+
+  @Field({ nullable: true, description: 'SWIFT code of the bank (if applicable)' })
+  swiftCode?: string
+
+  @Field({ nullable: true, description: 'Country of the financial institution' })
+  country?: string
+
+  @Field({ nullable: true, description: 'Contact number of the financial institution' })
+  contactNumber?: string
+
+  @Field({ nullable: true, description: 'Website of the financial institution' })
+  website?: string
+
+  @Field({ nullable: true, description: 'Address of the financial institution' })
+  address?: string
+
+  @Field({ nullable: true, description: 'Email of the financial institution' })
+  email?: string
+  @Field(type => GraphQLUpload, { nullable: true })
+  thumbnail?: FileUpload
+
+  @Field({ nullable: true })
+  cuFlag?: string
+}
+
+@ObjectType()
+export class FinancialInstitutionList {
+  @Field(type => [FinancialInstitution])
+  items: FinancialInstitution[]
+
+  @Field(type => Int)
+  total: number
+}

package/server/service/financial-institution/financial-institution.ts

@@ -0,0 +1,122 @@
+import {
+  CreateDateColumn,
+  UpdateDateColumn,
+  DeleteDateColumn,
+  Entity,
+  Index,
+  Column,
+  RelationId,
+  ManyToOne,
+  PrimaryGeneratedColumn,
+  VersionColumn
+} from 'typeorm'
+import { ObjectType, Field, ID, registerEnumType } from 'type-graphql'
+import { Domain } from '@things-factory/shell'
+import { User } from '@things-factory/auth-base'
+
+export enum FinancialInstitutionType {
+  Bank = 'Bank',
+  CardCompany = 'CardCompany',
+  InsuranceCompany = 'InsuranceCompany',
+  InvestmentCompany = 'InvestmentCompany',
+  SavingsBank = 'SavingsBank',
+  CreditUnion = 'CreditUnion',
+  LoanCompany = 'LoanCompany',
+  SecuritiesFirm = 'SecuritiesFirm'
+}
+
+registerEnumType(FinancialInstitutionType, {
+  name: 'FinancialInstitutionType',
+  description: 'Type of the financial institution (e.g., Bank, Card Company, Insurance Company, etc.)'
+})
+
+@Entity()
+@Index(
+  'ix_financial_institution_0',
+  (financialInstitution: FinancialInstitution) => [financialInstitution.domain, financialInstitution.name],
+  {
+    where: '"deleted_at" IS NULL',
+    unique: true
+  }
+)
+@ObjectType({ description: 'Entity for Financial Institution (e.g., Bank, Card Company, Insurance Company, etc.)' })
+export class FinancialInstitution {
+  @PrimaryGeneratedColumn('uuid')
+  @Field(type => ID)
+  readonly id: string
+
+  @ManyToOne(type => Domain)
+  @Field({ nullable: true })
+  domain?: Domain
+
+  @RelationId((financialInstitution: FinancialInstitution) => financialInstitution.domain)
+  domainId?: string
+
+  @Column()
+  @Field({ nullable: true })
+  name?: string
+
+  @Column({ nullable: true })
+  @Field({ nullable: true })
+  description?: string
+
+  @Column({ type: 'enum', enum: FinancialInstitutionType })
+  @Field(type => FinancialInstitutionType, {
+    description: 'Type of the financial institution (e.g., Bank, Card Company, Insurance Company, etc.)'
+  })
+  type?: FinancialInstitutionType
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'SWIFT code of the bank (if applicable)' })
+  swiftCode?: string
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Country of the financial institution' })
+  country?: string
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Contact number of the financial institution' })
+  contactNumber?: string
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Website of the financial institution' })
+  website?: string
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Address of the financial institution' })
+  address?: string
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Email of the financial institution' })
+  email?: string
+
+  @CreateDateColumn()
+  @Field({ nullable: true })
+  createdAt?: Date
+
+  @UpdateDateColumn()
+  @Field({ nullable: true })
+  updatedAt?: Date
+
+  @DeleteDateColumn()
+  @Field({ nullable: true })
+  deletedAt?: Date
+
+  @ManyToOne(type => User, { nullable: true })
+  @Field(type => User, { nullable: true })
+  creator?: User
+
+  @RelationId((financialInstitution: FinancialInstitution) => financialInstitution.creator)
+  creatorId?: string
+
+  @ManyToOne(type => User, { nullable: true })
+  @Field(type => User, { nullable: true })
+  updater?: User
+
+  @RelationId((financialInstitution: FinancialInstitution) => financialInstitution.updater)
+  updaterId?: string
+
+  @VersionColumn()
+  @Field({ nullable: true })
+  version?: number = 1
+}

package/server/service/financial-institution/index.ts

@@ -0,0 +1,7 @@
+import { FinancialInstitution } from './financial-institution'
+import { FinancialInstitutionQuery } from './financial-institution-query'
+import { FinancialInstitutionMutation } from './financial-institution-mutation'
+
+export const entities = [FinancialInstitution]
+export const resolvers = [FinancialInstitutionQuery, FinancialInstitutionMutation]
+export const subscribers = []

package/server/service/payment/payment-history.ts

@@ -12,7 +12,8 @@ import { config } from '@things-factory/env'
 import { Domain } from '@things-factory/shell'
 
 import { Transaction } from '../transaction/transaction'
-import { Payment, PaymentDirection } from './payment'
+import { Payment, PaymentDirection, PaymentType } from './payment'
+import { BankAccount } from 'service/bank-account/bank-account'
 
 const ORMCONFIG = config.get('ormconfig', {})
 const DATABASE_TYPE = ORMCONFIG.type
@@ -46,39 +47,61 @@ export class PaymentHistory implements HistoryEntityInterface<Payment> {
   domainId?: string
 
   @ManyToOne(type => Transaction, transaction => transaction.payments)
-  @Field(type => Transaction)
-  transaction: Transaction
+  @Field(type => Transaction, { description: 'The transaction associated with this payment' })
+  transaction: Transaction // 결제와 연결된 트랜잭션
 
   @RelationId((payment: Payment) => payment.transaction)
-  transactionId: string
+  transactionId: string // 연결된 트랜잭션의 ID
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'The currency used in the payment' })
+  currency?: string // 결제에 사용된 통화
 
   @Column({ nullable: false })
-  @Field({ nullable: false })
-  amount: number
+  @Field({ nullable: false, description: 'The amount of money involved in the payment' })
+  amount: number // 결제된 금액
+
+  @Column({ type: 'enum', enum: PaymentType, nullable: false })
+  @Field(type => PaymentType, { description: 'Type of the payment' })
+  paymentType: PaymentType // 결제 유형
+
+  @ManyToOne(type => BankAccount, { nullable: true })
+  @Field(type => BankAccount, { nullable: true, description: 'Source bank account for the payment' })
+  sourceBankAccount?: BankAccount
+
+  @RelationId((payment: Payment) => payment.sourceBankAccount)
+  sourceBankAccountId?: string
+
+  @ManyToOne(type => BankAccount, { nullable: true })
+  @Field(type => BankAccount, { nullable: true, description: 'Destination bank account for the payment' })
+  destinationBankAccount?: BankAccount
+
+  @RelationId((payment: Payment) => payment.destinationBankAccount)
+  destinationBankAccountId?: string
 
   @Column({ nullable: true })
-  @Field({ nullable: true, description: 'fiscal year' })
-  year?: number
+  @Field({ nullable: true, description: 'Fiscal year in which the payment was made' })
+  year?: number // 결제가 발생한 회계 연도
 
   @Column({ nullable: true })
-  @Field({ nullable: true, description: 'fiscal quarter' })
-  quarter?: number
+  @Field({ nullable: true, description: 'Fiscal quarter in which the payment was made' })
+  quarter?: number // 결제가 발생한 회계 분기
 
   @Column({ nullable: true })
-  @Field({ nullable: true, description: 'fiscal month' })
-  month?: number
+  @Field({ nullable: true, description: 'Fiscal month in which the payment was made' })
+  month?: number // 결제가 발생한 회계 월
 
   @Column({ nullable: false })
-  @Field({ nullable: false })
-  paidAt: Date
+  @Field({ nullable: false, description: 'The date and time when the payment was made' })
+  paidAt: Date // 결제가 이루어진 날짜 및 시간
 
   @Column({ nullable: false })
-  @Field(type => PaymentDirection)
-  direction: PaymentDirection
+  @Field(type => PaymentDirection, { description: 'Direction of the payment (Incoming or Outgoing)' })
+  direction: PaymentDirection // 결제 방향 (수금 또는 지출)
 
   @Column({ nullable: true })
-  @Field({ nullable: true })
-  note?: string
+  @Field({ nullable: true, description: 'Additional notes or comments about the payment' })
+  note?: string // 결제에 대한 추가 설명 또는 메모
 
   @Column({ nullable: true })
   @Field({ nullable: true })

package/server/service/payment/payment-type.ts

@@ -4,7 +4,7 @@ import { ObjectType, Field, InputType, Int, ID, registerEnumType } from 'type-gr
 
 import { ObjectRef, ScalarObject } from '@things-factory/shell'
 
-import { Payment, PaymentDirection } from './payment'
+import { Payment, PaymentDirection, PaymentType } from './payment'
 
 @InputType()
 export class NewPayment {
@@ -23,6 +23,15 @@ export class NewPayment {
   @Field(type => PaymentDirection)
   direction: PaymentDirection
 
+  @Field(type => PaymentType, { description: 'Type of the payment' })
+  paymentType: PaymentType // 결제 유형
+
+  @Field(type => ObjectRef, { nullable: true, description: 'Source bank account for the payment' })
+  sourceBankAccount?: ObjectRef
+
+  @Field(type => ObjectRef, { nullable: true, description: 'Destination bank account for the payment' })
+  destinationBankAccount?: ObjectRef
+
   @Field({ nullable: true })
   note?: string
 }
@@ -47,6 +56,15 @@ export class PaymentPatch {
   @Field(type => PaymentDirection)
   direction: PaymentDirection
 
+  @Field(type => PaymentType, { description: 'Type of the payment' })
+  paymentType: PaymentType // 결제 유형
+
+  @Field(type => ObjectRef, { nullable: true, description: 'Source bank account for the payment' })
+  sourceBankAccount?: ObjectRef
+
+  @Field(type => ObjectRef, { nullable: true, description: 'Destination bank account for the payment' })
+  destinationBankAccount?: ObjectRef
+
   @Field({ nullable: true })
   note?: string
 

package/server/service/payment/payment.ts

@@ -15,6 +15,7 @@ import { ObjectType, Field, ID, registerEnumType } from 'type-graphql'
 import { Domain } from '@things-factory/shell'
 import { User } from '@things-factory/auth-base'
 import { Transaction } from '../transaction/transaction'
+import { BankAccount } from 'service/bank-account/bank-account'
 
 export enum PaymentDirection {
   Incoming = 'Incoming', // 수금
@@ -26,6 +27,18 @@ registerEnumType(PaymentDirection, {
   description: 'Indicates whether the payment is incoming (received) or outgoing (paid)' // 결제 방향을 나타냅니다 (수금 또는 지출)
 })
 
+export enum PaymentType {
+  Transfer = 'Transfer', // 계좌 이체
+  Cash = 'Cash', // 현금
+  CreditCard = 'CreditCard', // 신용카드
+  DebitCard = 'DebitCard' // 직불카드
+}
+
+registerEnumType(PaymentType, {
+  name: 'PaymentType',
+  description: 'Type of the payment (e.g., Transfer, Cash, CreditCard, DebitCard)' // 결제 유형을 나타냅니다
+})
+
 @Entity()
 @Index('ix_payment_0', (payment: Payment) => [payment.domain, payment.transaction, payment.paidAt], {
   where: '"deleted_at" IS NULL',
@@ -71,6 +84,24 @@ export class Payment {
   @Field({ nullable: false, description: 'The amount of money involved in the payment' })
   amount: number // 결제된 금액
 
+  @Column({ type: 'enum', enum: PaymentType, nullable: false })
+  @Field(type => PaymentType, { description: 'Type of the payment' })
+  paymentType: PaymentType // 결제 유형
+
+  @ManyToOne(type => BankAccount, { nullable: true })
+  @Field(type => BankAccount, { nullable: true, description: 'Source bank account for the payment' })
+  sourceBankAccount?: BankAccount
+
+  @RelationId((payment: Payment) => payment.sourceBankAccount)
+  sourceBankAccountId?: string
+
+  @ManyToOne(type => BankAccount, { nullable: true })
+  @Field(type => BankAccount, { nullable: true, description: 'Destination bank account for the payment' })
+  destinationBankAccount?: BankAccount
+
+  @RelationId((payment: Payment) => payment.destinationBankAccount)
+  destinationBankAccountId?: string
+
   @Column({ nullable: true })
   @Field({ nullable: true, description: 'Fiscal year in which the payment was made' })
   year?: number // 결제가 발생한 회계 연도