@things-factory/accounting 8.0.0-beta.9 → 8.0.0

package/server/service/income-statement/income-statement.ts

@@ -0,0 +1,120 @@
+import {
+  CreateDateColumn,
+  UpdateDateColumn,
+  DeleteDateColumn,
+  Entity,
+  Index,
+  Column,
+  RelationId,
+  ManyToOne,
+  OneToMany,
+  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'
+
+import { IncomeStatementLineItem } from './income-statement-line-item'
+
+export enum IncomeStatementStatus {
+  STATUS_A = 'STATUS_A',
+  STATUS_B = 'STATUS_B'
+}
+
+registerEnumType(IncomeStatementStatus, {
+  name: 'IncomeStatementStatus',
+  description: 'State enumeration of an income statement' // 손익계산서의 상태 열거형
+})
+
+// 손익계산서 (Income Statement)
+@Entity()
+@Index(
+  'ix_income_statement_0',
+  (incomeStatement: IncomeStatement) => [
+    incomeStatement.domain,
+    incomeStatement.year,
+    incomeStatement.quarter,
+    incomeStatement.month
+  ],
+  {
+    unique: true,
+    where: '"deleted_at" IS NULL' // 삭제되지 않은 경우에만 유니크
+  }
+)
+@ObjectType({ description: 'Entity for IncomeStatement, representing the profit and loss report' }) // 손익계산서 엔티티
+export class IncomeStatement {
+  @PrimaryGeneratedColumn('uuid')
+  @Field(type => ID, { description: 'Unique identifier for the income statement' })
+  readonly id: string // 고유 식별자 (UUID)
+
+  @VersionColumn()
+  @Field({ nullable: true, description: 'Version number for optimistic locking' })
+  version?: number = 1 // 낙관적 잠금을 위한 버전 관리 필드
+
+  @ManyToOne(type => Domain)
+  @Field({ nullable: true, description: 'The domain to which this income statement belongs' })
+  domain?: Domain // 이 손익계산서가 속한 도메인
+
+  @RelationId((incomeStatement: IncomeStatement) => incomeStatement.domain)
+  domainId?: string // 도메인의 ID
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Fiscal year of the income statement' })
+  year?: number // 회계 연도
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Fiscal quarter of the income statement' })
+  quarter?: number // 회계 분기
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Fiscal month of the income statement' })
+  month?: number // 회계 월
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Total revenue recorded in the income statement' })
+  revenue?: number // 손익계산서에 기록된 총수익
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Total expenses recorded in the income statement' })
+  expense?: number // 손익계산서에 기록된 총비용
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Net income calculated as revenue minus expenses' })
+  netIncome?: number // 총수익에서 총비용을 뺀 순이익
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Indicates whether this income statement is active' })
+  active?: boolean // 이 손익계산서가 활성 상태인지 여부
+
+  @OneToMany(type => IncomeStatementLineItem, lineItem => lineItem.statement)
+  @Field(type => [IncomeStatementLineItem], { nullable: true })
+  lineItems?: IncomeStatementLineItem[] // 계정별 브레이크다운
+
+  @CreateDateColumn()
+  @Field({ nullable: true, description: 'The date and time when the income statement was created' })
+  createdAt?: Date // 손익계산서가 생성된 날짜 및 시간
+
+  @UpdateDateColumn()
+  @Field({ nullable: true, description: 'The date and time when the income statement was last updated' })
+  updatedAt?: Date // 손익계산서가 마지막으로 업데이트된 날짜 및 시간
+
+  @DeleteDateColumn()
+  @Field({ nullable: true, description: 'The date and time when the income statement was deleted' })
+  deletedAt?: Date // 손익계산서가 삭제된 날짜 및 시간
+
+  @ManyToOne(type => User, { nullable: true })
+  @Field(type => User, { nullable: true, description: 'The user who created the income statement' })
+  creator?: User // 손익계산서를 생성한 사용자
+
+  @RelationId((incomeStatement: IncomeStatement) => incomeStatement.creator)
+  creatorId?: string // 손익계산서를 생성한 사용자의 ID
+
+  @ManyToOne(type => User, { nullable: true })
+  @Field(type => User, { nullable: true, description: 'The user who last updated the income statement' })
+  updater?: User // 손익계산서를 마지막으로 업데이트한 사용자
+
+  @RelationId((incomeStatement: IncomeStatement) => incomeStatement.updater)
+  updaterId?: string // 손익계산서를 업데이트한 사용자의 ID
+}

package/server/service/income-statement/index.ts

@@ -0,0 +1,10 @@
+import { IncomeStatement } from './income-statement'
+import { IncomeStatementLineItem } from './income-statement-line-item'
+import { IncomeStatementHistory } from './income-statement-history'
+import { IncomeStatementQuery } from './income-statement-query'
+import { IncomeStatementMutation } from './income-statement-mutation'
+import { IncomeStatementHistoryEntitySubscriber } from './event-subscriber'
+
+export const entities = [IncomeStatement, IncomeStatementLineItem, IncomeStatementHistory]
+export const resolvers = [IncomeStatementQuery, IncomeStatementMutation]
+export const subscribers = [IncomeStatementHistoryEntitySubscriber]

package/server/service/index.ts

@@ -0,0 +1,108 @@
+/* EXPORT ENTITY TYPES */
+export * from './income-statement/income-statement'
+export * from './financial-statement/financial-statement'
+export * from './accounting-category/accounting-category'
+export * from './transaction/transaction'
+export * from './payment/payment'
+export * from './account/account'
+export * from './accounting-document/accounting-document'
+export * from './fiscal-month/fiscal-month'
+export * from './fiscal-quarter/fiscal-quarter'
+export * from './fiscal-year/fiscal-year'
+
+/* IMPORT ENTITIES AND RESOLVERS */
+import {
+  entities as IncomeStatementEntities,
+  resolvers as IncomeStatementResolvers,
+  subscribers as IncomeStatementSubscribers
+} from './income-statement'
+import {
+  entities as FinancialStatementEntities,
+  resolvers as FinancialStatementResolvers,
+  subscribers as FinancialStatementSubscribers
+} from './financial-statement'
+import {
+  entities as AccountingCategoryEntities,
+  resolvers as AccountingCategoryResolvers,
+  subscribers as AccountingCategorySubscribers
+} from './accounting-category'
+import {
+  entities as TransactionEntities,
+  resolvers as TransactionResolvers,
+  subscribers as TransactionSubscribers
+} from './transaction'
+import {
+  entities as PaymentEntities,
+  resolvers as PaymentResolvers,
+  subscribers as PaymentSubscribers
+} from './payment'
+import {
+  entities as AccountEntities,
+  resolvers as AccountResolvers,
+  subscribers as AccountSubscribers
+} from './account'
+import {
+  entities as AccountingDocumentEntities,
+  resolvers as AccountingDocumentResolvers,
+  subscribers as AccountingDocumentSubscribers
+} from './accounting-document'
+import {
+  entities as FiscalMonthEntities,
+  resolvers as FiscalMonthResolvers,
+  subscribers as FiscalMonthSubscribers
+} from './fiscal-month'
+import {
+  entities as FiscalQuarterEntities,
+  resolvers as FiscalQuarterResolvers,
+  subscribers as FiscalQuarterSubscribers
+} from './fiscal-quarter'
+import {
+  entities as FiscalYearEntities,
+  resolvers as FiscalYearResolvers,
+  subscribers as FiscalYearSubscribers
+} from './fiscal-year'
+
+export const entities = [
+  /* ENTITIES */
+  ...IncomeStatementEntities,
+  ...FinancialStatementEntities,
+  ...AccountingCategoryEntities,
+  ...TransactionEntities,
+  ...AccountEntities,
+  ...AccountingDocumentEntities,
+  ...PaymentEntities,
+  ...FiscalMonthEntities,
+  ...FiscalQuarterEntities,
+  ...FiscalYearEntities
+]
+
+export const subscribers = [
+  /* SUBSCRIBERS */
+  ...IncomeStatementSubscribers,
+  ...FinancialStatementSubscribers,
+  ...AccountingCategorySubscribers,
+  ...TransactionSubscribers,
+  ...PaymentSubscribers,
+  ...AccountSubscribers,
+  ...AccountingDocumentSubscribers,
+  ...FiscalYearSubscribers,
+  ...FiscalMonthSubscribers,
+  ...FiscalQuarterSubscribers,
+  ...FiscalYearSubscribers
+]
+
+export const schema = {
+  resolverClasses: [
+    /* RESOLVER CLASSES */
+    ...IncomeStatementResolvers,
+    ...FinancialStatementResolvers,
+    ...AccountingCategoryResolvers,
+    ...TransactionResolvers,
+    ...PaymentResolvers,
+    ...AccountResolvers,
+    ...AccountingDocumentResolvers,
+    ...FiscalMonthResolvers,
+    ...FiscalQuarterResolvers,
+    ...FiscalYearResolvers
+  ]
+}

package/server/service/payment/event-subscriber.ts

@@ -0,0 +1,17 @@
+import { EventSubscriber } from 'typeorm'
+
+import { HistoryEntitySubscriber } from '@operato/typeorm-history'
+
+import { Payment } from './payment'
+import { PaymentHistory } from './payment-history'
+
+@EventSubscriber()
+export class PaymentHistoryEntitySubscriber extends HistoryEntitySubscriber<Payment, PaymentHistory> {
+  public get entity() {
+    return Payment
+  }
+
+  public get historyEntity() {
+    return PaymentHistory
+  }
+}

package/server/service/payment/index.ts

@@ -0,0 +1,9 @@
+import { Payment } from './payment'
+import { PaymentHistory } from './payment-history'
+import { PaymentHistoryEntitySubscriber } from './event-subscriber'
+import { PaymentQuery } from './payment-query'
+import { PaymentMutation } from './payment-mutation'
+
+export const entities = [Payment, PaymentHistory]
+export const resolvers = [PaymentQuery, PaymentMutation]
+export const subscribers = [PaymentHistoryEntitySubscriber]

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

@@ -0,0 +1,132 @@
+import { Field, ID, ObjectType } from 'type-graphql'
+import { Column, Entity, Index, ManyToOne, PrimaryGeneratedColumn, RelationId } from 'typeorm'
+
+import {
+  HistoryActionColumn,
+  HistoryActionType,
+  HistoryEntityInterface,
+  HistoryOriginalIdColumn
+} from '@operato/typeorm-history'
+import { Role, User } from '@things-factory/auth-base'
+import { config } from '@things-factory/env'
+import { Domain } from '@things-factory/shell'
+
+import { Transaction } from '../transaction/transaction'
+import { Payment, PaymentDirection } from './payment'
+
+const ORMCONFIG = config.get('ormconfig', {})
+const DATABASE_TYPE = ORMCONFIG.type
+
+@Entity()
+@Index(
+  'ix_payment_history_0',
+  (paymentHistory: PaymentHistory) => [paymentHistory.originalId, paymentHistory.version],
+  { unique: true }
+)
+@Index(
+  'ix_payment_history_1',
+  (paymentHistory: PaymentHistory) => [paymentHistory.domain, paymentHistory.originalId, paymentHistory.version],
+  { unique: true }
+)
+@ObjectType({ description: 'History Entity of Payment' })
+export class PaymentHistory implements HistoryEntityInterface<Payment> {
+  @PrimaryGeneratedColumn('uuid')
+  @Field(type => ID)
+  readonly id: string
+
+  @Column({ nullable: true, default: 1 })
+  @Field({ nullable: true })
+  version?: number = 1
+
+  @ManyToOne(type => Domain)
+  @Field({ nullable: true })
+  domain?: Domain
+
+  @RelationId((payment: Payment) => payment.domain)
+  domainId?: string
+
+  @ManyToOne(type => Transaction, transaction => transaction.payments)
+  @Field(type => Transaction)
+  transaction: Transaction
+
+  @RelationId((payment: Payment) => payment.transaction)
+  transactionId: string
+
+  @Column({ nullable: false })
+  @Field({ nullable: false })
+  amount: number
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'fiscal year' })
+  year?: number
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'fiscal quarter' })
+  quarter?: number
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'fiscal month' })
+  month?: number
+
+  @Column({ nullable: false })
+  @Field({ nullable: false })
+  paidAt: Date
+
+  @Column({ nullable: false })
+  @Field(type => PaymentDirection)
+  direction: PaymentDirection
+
+  @Column({ nullable: true })
+  @Field({ nullable: true })
+  note?: string
+
+  @Column({ nullable: true })
+  @Field({ nullable: true })
+  createdAt?: Date
+
+  @Column({ nullable: true })
+  @Field({ nullable: true })
+  updatedAt?: Date
+
+  @Column({ nullable: true })
+  @Field({ nullable: true })
+  deletedAt?: Date
+
+  @ManyToOne(type => User, { nullable: true })
+  @Field(type => User, { nullable: true })
+  creator?: User
+
+  @RelationId((payment: Payment) => payment.creator)
+  creatorId?: string
+
+  @ManyToOne(type => User, { nullable: true })
+  @Field(type => User, { nullable: true })
+  updater?: User
+
+  @RelationId((payment: Payment) => payment.updater)
+  updaterId?: string
+
+  @Field(type => String, { nullable: true })
+  thumbnail?: string
+
+  @HistoryOriginalIdColumn()
+  public originalId!: string
+
+  @HistoryActionColumn({
+    nullable: false,
+    type:
+      DATABASE_TYPE == 'postgres' || DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'
+        ? 'enum'
+        : DATABASE_TYPE == 'oracle'
+          ? 'varchar2'
+          : DATABASE_TYPE == 'mssql'
+            ? 'nvarchar'
+            : 'varchar',
+    enum:
+      DATABASE_TYPE == 'postgres' || DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'
+        ? HistoryActionType
+        : undefined,
+    length: DATABASE_TYPE == 'postgres' || DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb' ? undefined : 10
+  })
+  public action!: HistoryActionType
+}

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

@@ -0,0 +1,139 @@
+import { Resolver, Mutation, Arg, Ctx, Directive } from 'type-graphql'
+import { In } from 'typeorm'
+import { getRepository } from '@things-factory/shell'
+
+import { Payment } from './payment'
+import { NewPayment, PaymentPatch } from './payment-type'
+
+@Resolver(Payment)
+export class PaymentMutation {
+  @Directive('@transaction')
+  @Directive('@privilege(category: "accounting", privilege: "mutation")')
+  @Mutation(returns => Payment, { description: 'To create new Payment' })
+  async createPayment(@Arg('payment') payment: NewPayment, @Ctx() context: ResolverContext): Promise<Payment> {
+    const { domain, user, tx } = context.state
+
+    const result = await getRepository(Payment, tx).save({
+      ...payment,
+      domain,
+      creator: user,
+      updater: user
+    })
+
+    return result
+  }
+
+  @Directive('@transaction')
+  @Directive('@privilege(category: "accounting", privilege: "mutation")')
+  @Mutation(returns => Payment, { description: 'To modify Payment information' })
+  async updatePayment(
+    @Arg('id') id: string,
+    @Arg('patch') patch: PaymentPatch,
+    @Ctx() context: ResolverContext
+  ): Promise<Payment> {
+    const { domain, user, tx } = context.state
+
+    const repository = getRepository(Payment, tx)
+    const payment = await repository.findOne({
+      where: { domain: { id: domain.id }, id }
+    })
+
+    const result = await repository.save({
+      ...payment,
+      ...patch,
+      updater: user
+    })
+
+    return result
+  }
+
+  @Directive('@transaction')
+  @Directive('@privilege(category: "accounting", privilege: "mutation")')
+  @Mutation(returns => [Payment], { description: "To modify multiple Payments' information" })
+  async updateMultiplePayment(
+    @Arg('patches', type => [PaymentPatch]) patches: PaymentPatch[],
+    @Ctx() context: ResolverContext
+  ): Promise<Payment[]> {
+    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 paymentRepo = getRepository(Payment, tx)
+
+    if (_createRecords.length > 0) {
+      for (let i = 0; i < _createRecords.length; i++) {
+        const newRecord = _createRecords[i]
+
+        const result = await paymentRepo.save({
+          ...newRecord,
+          domain,
+          creator: user,
+          updater: user
+        })
+
+        results.push({ ...result, cuFlag: '+' })
+      }
+    }
+
+    if (_updateRecords.length > 0) {
+      for (let i = 0; i < _updateRecords.length; i++) {
+        const updateRecord = _updateRecords[i]
+        const payment = await paymentRepo.findOneBy({ id: updateRecord.id })
+
+        const result = await paymentRepo.save({
+          ...payment,
+          ...updateRecord,
+          updater: user
+        })
+
+        results.push({ ...result, cuFlag: 'M' })
+      }
+    }
+
+    return results
+  }
+
+  @Directive('@transaction')
+  @Directive('@privilege(category: "accounting", privilege: "mutation")')
+  @Mutation(returns => Boolean, { description: 'To delete Payment' })
+  async deletePayment(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {
+    const { domain, tx } = context.state
+
+    await getRepository(Payment, tx).delete({ domain: { id: domain.id }, id })
+
+    return true
+  }
+
+  @Directive('@transaction')
+  @Directive('@privilege(category: "accounting", privilege: "mutation")')
+  @Mutation(returns => Boolean, { description: 'To delete multiple Payments' })
+  async deletePayments(@Arg('ids', type => [String]) ids: string[], @Ctx() context: ResolverContext): Promise<boolean> {
+    const { domain, tx } = context.state
+
+    await getRepository(Payment, tx).delete({
+      domain: { id: domain.id },
+      id: In(ids)
+    })
+
+    return true
+  }
+
+  @Directive('@transaction')
+  @Directive('@privilege(category: "accounting", privilege: "mutation")')
+  @Mutation(returns => Boolean, { description: 'To import multiple Payments' })
+  async importPayments(
+    @Arg('payments', type => [PaymentPatch]) payments: PaymentPatch[],
+    @Ctx() context: ResolverContext
+  ): Promise<boolean> {
+    const { domain, tx } = context.state
+
+    await Promise.all(
+      payments.map(async (payment: PaymentPatch) => {
+        const createdPayment: Payment = await getRepository(Payment, tx).save({ domain, ...payment })
+      })
+    )
+
+    return true
+  }
+}

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

@@ -0,0 +1,50 @@
+import { Resolver, Query, FieldResolver, Root, Args, Arg, Ctx, Directive } from 'type-graphql'
+import { Domain, getQueryBuilderFromListParams, getRepository, ListParam } from '@things-factory/shell'
+import { User } from '@things-factory/auth-base'
+import { Payment } from './payment'
+import { PaymentList } from './payment-type'
+
+@Resolver(Payment)
+export class PaymentQuery {
+  @Directive('@privilege(category: "accounting", privilege: "query")')
+  @Query(returns => Payment!, { nullable: true, description: 'To fetch a Payment' })
+  async payment(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<Payment> {
+    const { domain } = context.state
+
+    return await getRepository(Payment).findOne({
+      where: { domain: { id: domain.id }, id }
+    })
+  }
+
+  @Directive('@privilege(category: "accounting", privilege: "query")')
+  @Query(returns => PaymentList, { description: 'To fetch multiple Payments' })
+  async payments(@Args(type => ListParam) params: ListParam, @Ctx() context: ResolverContext): Promise<PaymentList> {
+    const { domain } = context.state
+
+    const queryBuilder = getQueryBuilderFromListParams({
+      domain,
+      params,
+      repository: await getRepository(Payment),
+      searchables: []
+    })
+
+    const [items, total] = await queryBuilder.getManyAndCount()
+
+    return { items, total }
+  }
+
+  @FieldResolver(type => Domain)
+  async domain(@Root() payment: Payment): Promise<Domain> {
+    return payment.domainId && (await getRepository(Domain).findOneBy({ id: payment.domainId }))
+  }
+
+  @FieldResolver(type => User)
+  async updater(@Root() payment: Payment): Promise<User> {
+    return payment.updaterId && (await getRepository(User).findOneBy({ id: payment.updaterId }))
+  }
+
+  @FieldResolver(type => User)
+  async creator(@Root() payment: Payment): Promise<User> {
+    return payment.creatorId && (await getRepository(User).findOneBy({ id: payment.creatorId }))
+  }
+}

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

@@ -0,0 +1,64 @@
+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 { Payment, PaymentDirection } from './payment'
+
+@InputType()
+export class NewPayment {
+  @Field(type => ObjectRef)
+  transaction: ObjectRef
+
+  @Field({ nullable: true })
+  currency?: string
+
+  @Field({ nullable: false })
+  amount: number
+
+  @Field({ nullable: false })
+  paidAt: Date
+
+  @Field(type => PaymentDirection)
+  direction: PaymentDirection
+
+  @Field({ nullable: true })
+  note?: string
+}
+
+@InputType()
+export class PaymentPatch {
+  @Field(type => ID, { nullable: true })
+  id?: string
+
+  @Field(type => ObjectRef)
+  transaction: ObjectRef
+
+  @Field({ nullable: true })
+  currency?: string
+
+  @Field({ nullable: false })
+  amount: number
+
+  @Field({ nullable: false })
+  paidAt: Date
+
+  @Field(type => PaymentDirection)
+  direction: PaymentDirection
+
+  @Field({ nullable: true })
+  note?: string
+
+  @Field({ nullable: true })
+  cuFlag?: string
+}
+
+@ObjectType()
+export class PaymentList {
+  @Field(type => [Payment])
+  items: Payment[]
+
+  @Field(type => Int)
+  total: number
+}