Skip to content

Commit

Permalink
Merge pull request #96 from gsainfoteam/siwonpada/issue95
Browse files Browse the repository at this point in the history
[Documentation] lib documentation
  • Loading branch information
siwonpada authored Dec 23, 2024
2 parents 5b995e8 + cbe131e commit 15d1f0d
Show file tree
Hide file tree
Showing 8 changed files with 108 additions and 0 deletions.
30 changes: 30 additions & 0 deletions libs/infoteam-idp/src/infoteam-idp.module.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Infoteam idp Module

인포팀의 idp를 더 쉽게 사용하기 위한 module입니다.

## Environment

사용되는 package들은 다음과 같습니다.

- @nestjs/common
- @nestjs/config
- @nestjs/axios
- rxjs
- axios

이용하기 위해서 필요한 설정 변수는 다음과 같습니다.

``` env
IDP_URL=https://api.idp.gistory.me
IDP_CLIENT_ID=yourclientid
IDP_CLIENT_SECRET=yourclientsecret
```

위의 설정변수를 보면 알 수 있겠지만, 해당 모듈을 사용하기 위해서는 먼저 infoteam idp에서 client등록을 해야지 사용할 수 있습니다.

## Function

기능은 다음과 같습니다.

- authorization_code를 이용해서 AccessToken으로 돌려받음.
- AccessToken을 이용해서, 해당 유저의 정보들을 돌려받음.
2 changes: 2 additions & 0 deletions libs/logger/src/index.ts
Original file line number Diff line number Diff line change
@@ -1 +1,3 @@
export * from './logger.module';
export * from './logger.decorator.register';
export * from './decorator/loggable';
3 changes: 3 additions & 0 deletions libs/logger/src/logger.decorator.register.ts
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,9 @@ export class LoggerDecoratorRegister implements OnModuleInit {
private readonly metadataScanner: MetadataScanner,
) {}

/**
* if the decorator, loggable, is founded, it will log before and after the method
*/
onModuleInit() {
return this.discoveryService
.getProviders()
Expand Down
14 changes: 14 additions & 0 deletions libs/logger/src/logger.module.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# Logger Module

logging을 더 편하게 하기 위한 module입니다.

## Environment

사용되는 package들은 다음과 같습니다.

- @nestjs/core
- @nestjs/common

## Function

loggable이라는 데코레이터가 붙어있는 class의 함수가 실행시키기 이전, 이후의 함수의 로그를 찍는다.
1 change: 1 addition & 0 deletions libs/logger/src/logger.module.ts
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,6 @@ import { LoggerDecoratorRegister } from './logger.decorator.register';
@Module({
imports: [DiscoveryModule],
providers: [LoggerDecoratorRegister],
exports: [LoggerDecoratorRegister],
})
export class LoggerModule {}
27 changes: 27 additions & 0 deletions libs/object/src/object.module.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# Object Module

AWS의 S3를 더 쉽게 조작하기 위해서 사용되는 module입니다.

## Environment

사용되는 package들은 다음과 같습니다.

- @nestjs/common
- @nestjs/config
- @aws-sdk/client-s3

이용하기 위해서 필요한 설정 변수는 다음과 같습니다.

``` env
AWS_S3_REGION=yourbucketregion
AWS_S3_BUCKET=yourbucket
AWS_ACCESS_KEY_ID=xxxxxxxxxx
AWS_SECRET_ACCESS_KEY=xxxxxxx
```

## Function

기능은 다음과 같습니다.

- AWS S3에 object를 업로드합니다.
- AWS S3에 object를 삭제합니다.
28 changes: 28 additions & 0 deletions libs/prisma/src/prisma.module.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# Prisma Module

데이터베이스를 조작하기 위한 ORM, prisma를 nestjs의 module화 시킨 module입니다.

## Environment

사용되는 package들은 다음과 같습니다.

- @nestjs/common
- @nestjs/config
- @prisma/client

dev-package들은 다음과 같습니다.

- prisma

이용하기 위해서 필요한 설정 변수는 다음과 같습니다.

``` env
DATABASE_URL=postgresql://janedoe:mypassword@localhost:5432/mydb
```

## Function

기능은 다음과 같습니다.

- 모듈이 켜질때, 데이터베이스에 연결함.
- 모듈이 꺼질떄, 데이터베이스에 연결을 해제함.
3 changes: 3 additions & 0 deletions libs/prisma/src/prisma.service.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@ import { Injectable, OnModuleDestroy, OnModuleInit } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';
import { PrismaClient } from '@prisma/client';

/**
* Service for using Prisma.
*/
@Injectable()
export class PrismaService
extends PrismaClient
Expand Down

0 comments on commit 15d1f0d

Please sign in to comment.