@things-factory/accounting 7.0.2 → 7.1.2

package/server/service/fiscal-quarter/fiscal-quarter.ts

@@ -0,0 +1,80 @@
+import {
+  CreateDateColumn,
+  DeleteDateColumn,
+  UpdateDateColumn,
+  Entity,
+  Index,
+  Column,
+  ManyToOne,
+  RelationId,
+  PrimaryGeneratedColumn
+} from 'typeorm'
+import { ObjectType, Field, Int, ID } from 'type-graphql'
+import { Domain } from '@things-factory/shell'
+import { User } from '@things-factory/auth-base'
+import { FiscalStatus } from '../common-type'
+
+@ObjectType({ description: 'Entity representing a fiscal quarter' })
+@Entity()
+export class FiscalQuarter {
+  @PrimaryGeneratedColumn('uuid')
+  @Field(type => ID)
+  readonly id: string
+
+  @ManyToOne(type => Domain)
+  @Field({ nullable: true })
+  domain?: Domain
+
+  @RelationId((fiscalQuarter: FiscalQuarter) => fiscalQuarter.domain)
+  domainId?: string
+
+  @Column()
+  @Field(type => Int, { description: 'The fiscal year (e.g., 2023)' })
+  year: number // 회계연도 (예: 2023)
+
+  @Column()
+  @Field(type => Int, { description: 'The quarter number (1, 2, 3, or 4)' })
+  quarter: number // 1, 2, 3, 4 분기
+
+  @Column()
+  @Field(type => String, { description: 'The start date of the fiscal quarter in YYYY-MM-DD format' })
+  startDate: string // 분기 시작일
+
+  @Column()
+  @Field(type => String, { description: 'The end date of the fiscal quarter in YYYY-MM-DD format' })
+  endDate: string // 분기 종료일
+
+  @Column({ default: FiscalStatus.OPEN })
+  @Field(type => FiscalStatus, { description: 'The status of the fiscal quarter (OPEN, CLOSED, FINALIZED)' })
+  status: FiscalStatus // 분기의 상태 (OPEN, CLOSED, FINALIZED)
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Notes or comments about the fiscal quarter' })
+  notes?: 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((fiscalQuarter: FiscalQuarter) => fiscalQuarter.creator)
+  creatorId?: string
+
+  @ManyToOne(type => User, { nullable: true })
+  @Field(type => User, { nullable: true })
+  updater?: User
+
+  @RelationId((fiscalQuarter: FiscalQuarter) => fiscalQuarter.updater)
+  updaterId?: string
+}

package/server/service/fiscal-quarter/index.ts

@@ -0,0 +1,7 @@
+import { FiscalQuarter } from './fiscal-quarter'
+import { FiscalQuarterQuery } from './fiscal-quarter-query'
+import { FiscalQuarterMutation } from './fiscal-quarter-mutation'
+
+export const entities = [FiscalQuarter]
+export const resolvers = [FiscalQuarterQuery, FiscalQuarterMutation]
+export const subscribers = []

package/server/service/fiscal-year/fiscal-year-mutation.ts

@@ -0,0 +1,145 @@
+import { Resolver, Mutation, Arg, Ctx, Directive } from 'type-graphql'
+import { In } from 'typeorm'
+import { getRepository } from '@things-factory/shell'
+
+import { FiscalYear } from './fiscal-year'
+import { NewFiscalYear, FiscalYearPatch } from './fiscal-year-type'
+
+@Resolver(FiscalYear)
+export class FiscalYearMutation {
+  @Directive('@transaction')
+  @Directive('@privilege(category: "accounting", privilege: "mutation")')
+  @Mutation(returns => FiscalYear, { description: 'To create new FiscalYear' })
+  async createFiscalYear(
+    @Arg('fiscalYear') fiscalYear: NewFiscalYear,
+    @Ctx() context: ResolverContext
+  ): Promise<FiscalYear> {
+    const { domain, user, tx } = context.state
+
+    const result = await getRepository(FiscalYear, tx).save({
+      ...fiscalYear,
+      domain,
+      creator: user,
+      updater: user
+    })
+
+    return result
+  }
+
+  @Directive('@transaction')
+  @Directive('@privilege(category: "accounting", privilege: "mutation")')
+  @Mutation(returns => FiscalYear, { description: 'To modify FiscalYear information' })
+  async updateFiscalYear(
+    @Arg('id') id: string,
+    @Arg('patch') patch: FiscalYearPatch,
+    @Ctx() context: ResolverContext
+  ): Promise<FiscalYear> {
+    const { domain, user, tx } = context.state
+
+    const repository = getRepository(FiscalYear, tx)
+    const fiscalYear = await repository.findOne({
+      where: { domain: { id: domain.id }, id }
+    })
+
+    const result = await repository.save({
+      ...fiscalYear,
+      ...patch,
+      updater: user
+    })
+
+    return result
+  }
+
+  @Directive('@transaction')
+  @Directive('@privilege(category: "accounting", privilege: "mutation")')
+  @Mutation(returns => [FiscalYear], { description: "To modify multiple FiscalYears' information" })
+  async updateMultipleFiscalYear(
+    @Arg('patches', type => [FiscalYearPatch]) patches: FiscalYearPatch[],
+    @Ctx() context: ResolverContext
+  ): Promise<FiscalYear[]> {
+    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 fiscalYearRepo = getRepository(FiscalYear, tx)
+
+    if (_createRecords.length > 0) {
+      for (let i = 0; i < _createRecords.length; i++) {
+        const newRecord = _createRecords[i]
+
+        const result = await fiscalYearRepo.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 fiscalYear = await fiscalYearRepo.findOneBy({ id: updateRecord.id })
+
+        const result = await fiscalYearRepo.save({
+          ...fiscalYear,
+          ...updateRecord,
+          updater: user
+        })
+
+        results.push({ ...result, cuFlag: 'M' })
+      }
+    }
+
+    return results
+  }
+
+  @Directive('@transaction')
+  @Directive('@privilege(category: "accounting", privilege: "mutation")')
+  @Mutation(returns => Boolean, { description: 'To delete FiscalYear' })
+  async deleteFiscalYear(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {
+    const { domain, tx } = context.state
+
+    await getRepository(FiscalYear, tx).delete({ domain: { id: domain.id }, id })
+
+    return true
+  }
+
+  @Directive('@transaction')
+  @Directive('@privilege(category: "accounting", privilege: "mutation")')
+  @Mutation(returns => Boolean, { description: 'To delete multiple FiscalYears' })
+  async deleteFiscalYears(
+    @Arg('ids', type => [String]) ids: string[],
+    @Ctx() context: ResolverContext
+  ): Promise<boolean> {
+    const { domain, tx } = context.state
+
+    await getRepository(FiscalYear, 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 FiscalYears' })
+  async importFiscalYears(
+    @Arg('fiscalYears', type => [FiscalYearPatch]) fiscalYears: FiscalYearPatch[],
+    @Ctx() context: ResolverContext
+  ): Promise<boolean> {
+    const { domain, tx } = context.state
+
+    await Promise.all(
+      fiscalYears.map(async (fiscalYear: FiscalYearPatch) => {
+        const createdFiscalYear: FiscalYear = await getRepository(FiscalYear, tx).save({ domain, ...fiscalYear })
+      })
+    )
+
+    return true
+  }
+}

package/server/service/fiscal-year/fiscal-year-query.ts

@@ -0,0 +1,53 @@
+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 { FiscalYear } from './fiscal-year'
+import { FiscalYearList } from './fiscal-year-type'
+
+@Resolver(FiscalYear)
+export class FiscalYearQuery {
+  @Directive('@privilege(category: "accounting", privilege: "query")')
+  @Query(returns => FiscalYear!, { nullable: true, description: 'To fetch a FiscalYear by year' })
+  async fiscalYear(@Arg('year') year: number, @Ctx() context: ResolverContext): Promise<FiscalYear | undefined> {
+    const { domain } = context.state
+
+    return await getRepository(FiscalYear).findOne({
+      where: { domain: { id: domain.id }, year }
+    })
+  }
+
+  @Directive('@privilege(category: "accounting", privilege: "query")')
+  @Query(returns => FiscalYearList, { description: 'To fetch multiple FiscalYears' })
+  async fiscalYears(
+    @Args(type => ListParam) params: ListParam,
+    @Ctx() context: ResolverContext
+  ): Promise<FiscalYearList> {
+    const { domain } = context.state
+
+    const queryBuilder = getQueryBuilderFromListParams({
+      domain,
+      params,
+      repository: await getRepository(FiscalYear),
+      searchables: []
+    })
+
+    const [items, total] = await queryBuilder.getManyAndCount()
+
+    return { items, total }
+  }
+
+  @FieldResolver(type => Domain)
+  async domain(@Root() fiscalYear: FiscalYear): Promise<Domain> {
+    return fiscalYear.domainId && (await getRepository(Domain).findOneBy({ id: fiscalYear.domainId }))
+  }
+
+  @FieldResolver(type => User)
+  async updater(@Root() fiscalYear: FiscalYear): Promise<User> {
+    return fiscalYear.updaterId && (await getRepository(User).findOneBy({ id: fiscalYear.updaterId }))
+  }
+
+  @FieldResolver(type => User)
+  async creator(@Root() fiscalYear: FiscalYear): Promise<User> {
+    return fiscalYear.creatorId && (await getRepository(User).findOneBy({ id: fiscalYear.creatorId }))
+  }
+}

package/server/service/fiscal-year/fiscal-year-type.ts

@@ -0,0 +1,54 @@
+import { InputType, ObjectType, Field, ID, Int } from 'type-graphql'
+import { FiscalYear } from './fiscal-year'
+import { FiscalStatus } from '../common-type'
+
+@InputType()
+export class NewFiscalYear {
+  @Field(type => Int)
+  year: number // 회계연도 (예: 2023)
+
+  @Field(type => String, { description: 'The start date of the fiscal month in YYYY-MM-DD format' })
+  startDate: string // 월의 시작일
+
+  @Field(type => String, { description: 'The end date of the fiscal month in YYYY-MM-DD format' })
+  endDate: string // 월의 종료일
+
+  @Field(type => FiscalStatus, { nullable: true })
+  status?: FiscalStatus // 회계연도의 상태 (OPEN, CLOSED, FINALIZED)
+
+  @Field({ nullable: true })
+  notes?: string // 회계연도에 대한 설명이나 주석
+}
+
+@InputType()
+export class FiscalYearPatch {
+  @Field(type => ID, { nullable: true })
+  id?: string
+
+  @Field(type => Int, { nullable: true })
+  year?: number // 회계연도 (예: 2023)
+
+  @Field(type => String, { description: 'The start date of the fiscal month in YYYY-MM-DD format' })
+  startDate: string // 월의 시작일
+
+  @Field(type => String, { description: 'The end date of the fiscal month in YYYY-MM-DD format' })
+  endDate: string // 월의 종료일
+
+  @Field(type => FiscalStatus, { nullable: true })
+  status?: FiscalStatus // 회계연도의 상태 (OPEN, CLOSED, FINALIZED)
+
+  @Field({ nullable: true })
+  notes?: string // 회계연도에 대한 설명이나 주석
+
+  @Field({ nullable: true })
+  cuFlag?: string // Create/Update Flag
+}
+
+@ObjectType()
+export class FiscalYearList {
+  @Field(type => [FiscalYear])
+  items: FiscalYear[]
+
+  @Field(type => Int)
+  total: number
+}

package/server/service/fiscal-year/fiscal-year.ts

@@ -0,0 +1,76 @@
+import {
+  CreateDateColumn,
+  DeleteDateColumn,
+  UpdateDateColumn,
+  Entity,
+  Index,
+  Column,
+  ManyToOne,
+  RelationId,
+  PrimaryGeneratedColumn
+} from 'typeorm'
+import { ObjectType, Field, Int, ID } from 'type-graphql'
+import { Domain } from '@things-factory/shell'
+import { User } from '@things-factory/auth-base'
+import { FiscalStatus } from '../common-type'
+
+@ObjectType({ description: 'Entity representing a fiscal year' })
+@Entity()
+export class FiscalYear {
+  @PrimaryGeneratedColumn('uuid')
+  @Field(type => ID)
+  readonly id: string
+
+  @ManyToOne(type => Domain)
+  @Field({ nullable: true })
+  domain?: Domain
+
+  @RelationId((fiscalYear: FiscalYear) => fiscalYear.domain)
+  domainId?: string
+
+  @Column()
+  @Field(type => Int, { description: 'The fiscal year (e.g., 2023)' })
+  year: number // 회계연도 (예: 2023)
+
+  @Column()
+  @Field(type => String, { description: 'The start date of the fiscal year in YYYY-MM-DD format' })
+  startDate: string // 회계연도 시작일
+
+  @Column()
+  @Field(type => String, { description: 'The end date of the fiscal year in YYYY-MM-DD format' })
+  endDate: string // 회계연도 종료일
+
+  @Column({ default: FiscalStatus.OPEN })
+  @Field(type => FiscalStatus, { description: 'The status of the fiscal year (OPEN, CLOSED, FINALIZED)' })
+  status: FiscalStatus // 회계연도의 상태 (OPEN, CLOSED, FINALIZED)
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Notes or comments about the fiscal year' })
+  notes?: 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((fiscalYear: FiscalYear) => fiscalYear.creator)
+  creatorId?: string
+
+  @ManyToOne(type => User, { nullable: true })
+  @Field(type => User, { nullable: true })
+  updater?: User
+
+  @RelationId((fiscalYear: FiscalYear) => fiscalYear.updater)
+  updaterId?: string
+}

package/server/service/fiscal-year/index.ts

@@ -0,0 +1,7 @@
+import { FiscalYear } from './fiscal-year'
+import { FiscalYearQuery } from './fiscal-year-query'
+import { FiscalYearMutation } from './fiscal-year-mutation'
+
+export const entities = [FiscalYear]
+export const resolvers = [FiscalYearQuery, FiscalYearMutation]
+export const subscribers = []

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

@@ -1,5 +1,5 @@
 import { Field, ID, ObjectType } from 'type-graphql'
-import { Column, Entity, Index, ManyToOne, PrimaryGeneratedColumn, RelationId } from 'typeorm'
+import { Column, Entity, Index, ManyToOne, OneToMany, PrimaryGeneratedColumn, RelationId } from 'typeorm'
 
 import {
   HistoryActionColumn,
@@ -12,6 +12,7 @@ import { config } from '@things-factory/env'
 import { Domain } from '@things-factory/shell'
 
 import { IncomeStatement, IncomeStatementStatus } from './income-statement'
+import { IncomeStatementLineItem } from './income-statement-line-item'
 
 const ORMCONFIG = config.get('ormconfig', {})
 const DATABASE_TYPE = ORMCONFIG.type
@@ -45,31 +46,43 @@ export class IncomeStatementHistory implements HistoryEntityInterface<IncomeStat
   version?: number = 1
 
   @ManyToOne(type => Domain)
-  @Field(type => Domain)
+  @Field({ nullable: true })
   domain?: Domain
 
-  @RelationId((incomeStatement: IncomeStatement) => incomeStatement.domain)
+  @RelationId((incomeStatementHistory: IncomeStatementHistory) => incomeStatementHistory.domain)
   domainId?: string
 
-  @Column()
-  @Field()
-  name: string
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Fiscal year of the income statement' })
+  year?: number // 회계 연도
 
   @Column({ nullable: true })
-  @Field({ nullable: true })
-  description?: string
+  @Field({ nullable: true, description: 'Fiscal quarter of the income statement' })
+  quarter?: number // 회계 분기
 
   @Column({ nullable: true })
-  @Field({ nullable: true })
-  active?: boolean
+  @Field({ nullable: true, description: 'Fiscal month of the income statement' })
+  month?: number // 회계 월
 
   @Column({ nullable: true })
-  @Field({ nullable: true })
-  state?: IncomeStatementStatus
+  @Field({ nullable: true, description: 'Total revenue recorded in the income statement' })
+  revenue?: number // 손익계산서에 기록된 총수익
 
   @Column({ nullable: true })
-  @Field({ nullable: true })
-  params?: string
+  @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[] // 계정별 브레이크다운
 
   @Column({ nullable: true })
   @Field({ nullable: true })
@@ -84,17 +97,17 @@ export class IncomeStatementHistory implements HistoryEntityInterface<IncomeStat
   deletedAt?: Date
 
   @ManyToOne(type => User, { nullable: true })
-  @Field(type => User, { nullable: true })
+  @Field({ nullable: true })
   creator?: User
 
-  @RelationId((incomeStatement: IncomeStatement) => incomeStatement.creator)
+  @RelationId((incomeStatementHistory: IncomeStatementHistory) => incomeStatementHistory.creator)
   creatorId?: string
 
   @ManyToOne(type => User, { nullable: true })
-  @Field(type => User, { nullable: true })
+  @Field({ nullable: true })
   updater?: User
 
-  @RelationId((incomeStatement: IncomeStatement) => incomeStatement.updater)
+  @RelationId((incomeStatementHistory: IncomeStatementHistory) => incomeStatementHistory.updater)
   updaterId?: string
 
   @HistoryOriginalIdColumn()

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

@@ -0,0 +1,84 @@
+import {
+  CreateDateColumn,
+  UpdateDateColumn,
+  DeleteDateColumn,
+  Entity,
+  Index,
+  Column,
+  RelationId,
+  ManyToOne,
+  PrimaryGeneratedColumn,
+  VersionColumn
+} from 'typeorm'
+import { ObjectType, Field, ID } from 'type-graphql'
+
+import { Domain } from '@things-factory/shell'
+import { User } from '@things-factory/auth-base'
+import { Account } from '../account/account'
+import { IncomeStatement } from './income-statement'
+
+@ObjectType({
+  description: 'Line item for an income statement, representing a detailed breakdown of financial accounts'
+})
+@Entity()
+@Index(
+  'ix_income_statement_line_item_0',
+  (lineItem: IncomeStatementLineItem) => [lineItem.statement, lineItem.account],
+  {
+    unique: false,
+    where: '"deleted_at" IS NULL'
+  }
+)
+export class IncomeStatementLineItem {
+  @PrimaryGeneratedColumn('uuid')
+  @Field(type => ID)
+  readonly id: string
+
+  @ManyToOne(type => IncomeStatement, statement => statement.lineItems)
+  @Field(type => IncomeStatement, { description: 'The income statement this line item belongs to' })
+  statement: IncomeStatement // 해당 라인 아이템이 속한 손익계산서
+
+  @RelationId((lineItem: IncomeStatementLineItem) => lineItem.statement)
+  statementId: string // 손익계산서의 ID
+
+  @ManyToOne(type => Account)
+  @Field(type => Account, { description: 'The financial account associated with this line item' })
+  account: Account // 라인 아이템에 연결된 계정
+
+  @RelationId((lineItem: IncomeStatementLineItem) => lineItem.account)
+  accountId: string // 계정의 ID
+
+  @Column({ nullable: false })
+  @Field({ nullable: false, description: 'The monetary amount associated with this account for the income statement' })
+  amount: number // 계정과 관련된 금액
+
+  @Column({ nullable: true })
+  @Field({ nullable: true, description: 'Optional description or notes about this line item' })
+  description?: string // 라인 아이템에 대한 선택적 설명 또는 메모
+
+  @CreateDateColumn()
+  @Field({ nullable: true, description: 'The date and time when this line item was created' })
+  createdAt?: Date // 라인 아이템이 생성된 날짜 및 시간
+
+  @UpdateDateColumn()
+  @Field({ nullable: true, description: 'The date and time when this line item was last updated' })
+  updatedAt?: Date // 라인 아이템이 마지막으로 업데이트된 날짜 및 시간
+
+  @DeleteDateColumn()
+  @Field({ nullable: true, description: 'The date and time when this line item was deleted' })
+  deletedAt?: Date // 라인 아이템이 삭제된 날짜 및 시간
+
+  @ManyToOne(type => User, { nullable: true })
+  @Field(type => User, { nullable: true, description: 'The user who created this line item' })
+  creator?: User // 라인 아이템을 생성한 사용자
+
+  @RelationId((lineItem: IncomeStatementLineItem) => lineItem.creator)
+  creatorId?: string // 생성자의 ID
+
+  @ManyToOne(type => User, { nullable: true })
+  @Field(type => User, { nullable: true, description: 'The user who last updated this line item' })
+  updater?: User // 라인 아이템을 마지막으로 업데이트한 사용자
+
+  @RelationId((lineItem: IncomeStatementLineItem) => lineItem.updater)
+  updaterId?: string // 업데이트한 사용자의 ID
+}