Integrates the Drizzle ORM schema into the database service, enabling type-safe queries across all entities. Establishes the foundation for a repository pattern by providing and exporting specialized repository classes within the database module. This separates concerns, moving specific entity operations out of the core database service. Removes example Drizzle usage from the database service, focusing its responsibility on connection management and providing the configured Drizzle client.
7.4 KiB
7.4 KiB
Database Layer
이 디렉토리는 wiki-server의 데이터베이스 레이어를 구성합니다.
구조
database/
├── schema.ts # Drizzle ORM 스키마 정의
├── database.service.ts # 데이터베이스 연결 관리
├── database.facade.ts # 고수준 비즈니스 로직 파사드
├── database.module.ts # NestJS 모듈 정의
└── repositories/ # 도메인별 Repository 패턴
├── user.repository.ts
├── space.repository.ts
├── page.repository.ts
├── token.repository.ts
└── index.ts
사용 방법
1. Repository 직접 사용 (단순 CRUD)
import { UserRepository } from '@/modules/global/database/repositories';
@Injectable()
export class AccountService {
constructor(private readonly userRepository: UserRepository) {}
async getUser(userId: string) {
return await this.userRepository.findById(userId);
}
async createUser(data: CreateUserDto) {
return await this.userRepository.create(data);
}
}
2. DatabaseFacade 사용 (복잡한 비즈니스 로직)
import { DatabaseFacade } from '@/modules/global/database/database.facade';
@Injectable()
export class PageService {
constructor(private readonly dbFacade: DatabaseFacade) {}
async createPage(data: CreatePageDto) {
// 부모 페이지 검증 포함
return await this.dbFacade.createPageWithValidation(data);
}
async getPageTree(pageId: string) {
// 재귀적으로 자식 페이지 포함
return await this.dbFacade.getPageTree(pageId);
}
}
Repositories
UserRepository
사용자 관리 관련 기능:
create(data)- 사용자 생성findById(userId)- ID로 조회findByEntraObjectId(entraObjectId)- Entra Object ID로 조회findByEmail(email)- 이메일로 조회findAllActive()- 모든 활성 사용자 조회findAllSystemAdmins()- 시스템 관리자 조회update(userId, data)- 사용자 정보 업데이트updateLastLogin(userId)- 마지막 로그인 시간 업데이트activate(userId)/deactivate(userId)- 활성화/비활성화findOrCreate(data)- 찾거나 생성
SpaceRepository
스페이스 관리 관련 기능:
create(data)- 스페이스 생성findById(spaceId)- ID로 조회findByKey(spaceKey)- Key로 조회findAll()- 모든 스페이스 조회findByCreator(userId)- 생성자별 조회findByIdWithCreator(spaceId)- 생성자 정보 포함 조회findAllWithCreator()- 모든 스페이스를 생성자 정보와 함께 조회update(spaceId, data)- 스페이스 업데이트delete(spaceId)- 스페이스 삭제existsByKey(spaceKey)- Key 존재 여부 확인
PageRepository
페이지 관리 관련 기능:
create(data)- 페이지 생성findById(pageId)- ID로 조회findBySpaceId(spaceId)- 스페이스의 모든 페이지 조회findRootPagesBySpaceId(spaceId)- 루트 페이지들 조회findChildPages(parentPageId)- 자식 페이지들 조회findByIdWithUsers(pageId)- 생성자/수정자 정보 포함 조회update(pageId, data)- 페이지 업데이트softDelete(pageId, userId)- 소프트 삭제restore(pageId, userId)- 복구hardDelete(pageId)- 하드 삭제findRecentlyUpdatedBySpaceId(spaceId, limit)- 최근 업데이트된 페이지findByCreator(userId)- 생성자별 조회updateSortOrder(pageId, sortOrder)- 정렬 순서 업데이트movePage(pageId, newParentPageId, userId)- 페이지 이동
TokenRepository
액세스 토큰 및 권한 관리:
createToken(data)- 토큰 생성findTokenById(tokenId)- ID로 조회findTokenByValue(tokenValue)- 값으로 조회findTokensByCreator(userId)- 생성자별 조회findActiveTokens()- 활성 토큰 조회findExpiredTokens()- 만료된 토큰 조회deleteToken(tokenId)- 토큰 삭제isTokenValid(tokenValue)- 토큰 유효성 확인createPermission(data)- 권한 생성findPermissionsByTokenId(tokenId)- 토큰의 모든 권한 조회findSpacePermissionsByTokenId(tokenId)- 스페이스 권한 조회findPagePermissionsByTokenId(tokenId)- 페이지 권한 조회hasSpacePermission(tokenId, spaceId)- 스페이스 접근 권한 확인hasPagePermission(tokenId, pageId)- 페이지 접근 권한 확인deletePermission(permissionId)- 권한 삭제findTokenWithPermissions(tokenValue)- 토큰 및 권한 전체 조회
DatabaseFacade
고수준 비즈니스 로직을 제공하는 파사드:
User Operations
handleUserLogin(userData)- 로그인 처리 (찾거나 생성 + 마지막 로그인 업데이트)
Space Operations
createSpaceWithValidation(data)- 중복 키 검증 포함 생성getSpaceWithPages(spaceId)- 스페이스와 모든 페이지 조회deleteSpaceWithPages(spaceId)- 스페이스 및 페이지 삭제getSpaceStatistics(spaceId)- 스페이스 통계 조회
Page Operations
createPageWithValidation(data)- 부모 페이지 검증 포함 생성getPageTree(pageId)- 재귀적 페이지 트리 조회getSpacePageTree(spaceId)- 스페이스 전체 페이지 트리movePageWithValidation(pageId, newParentPageId, userId)- 순환 참조 검증 포함 이동
Token Operations
createTokenWithPermissions(tokenData, permissions)- 토큰 및 권한 생성authenticateToken(tokenValue)- 토큰 인증canAccessResource(tokenValue, resourceType, resourceId)- 리소스 접근 권한 확인cleanupExpiredTokens()- 만료된 토큰 정리
Combined Operations
getUserActivity(userId)- 사용자의 모든 활동 조회
데이터베이스 스키마
users
userId(PK) - UUIDentraObjectId(Unique) - Microsoft Entra Object IDentraTenantId- Microsoft Entra Tenant IDemail- 이메일displayName- 표시 이름isSystemAdmin- 시스템 관리자 여부isActive- 활성 상태createdAt,updatedAt,lastLoginAt- 타임스탬프
spaces
spaceId(PK) - UUIDspaceKey(Unique) - 스페이스 키name- 이름description- 설명createdByUserId(FK) - 생성자createdAt- 생성 시간
pages
pageId(PK) - UUIDspaceId(FK) - 스페이스parentPageId(FK, nullable) - 부모 페이지sortOrder- 정렬 순서title- 제목content- 내용createdByUserId(FK) - 생성자updatedByUserId(FK) - 수정자createdAt,updatedAt- 타임스탬프isDeleted- 삭제 여부 (소프트 삭제)
accesstokens
tokenId(PK) - UUIDtokenValue(Unique) - 토큰 값description- 설명expiresAt(nullable) - 만료 시간createdByUserId(FK) - 생성자createdAt- 생성 시간
tokenpermissions
permissionId(PK) - UUIDtokenId(FK) - 토큰spaceId(FK, nullable) - 스페이스 (spaceId 또는 pageId 중 하나만 설정)pageId(FK, nullable) - 페이지 (spaceId 또는 pageId 중 하나만 설정)- Constraint: spaceId와 pageId 중 정확히 하나만 NULL이 아니어야 함
모듈 임포트
다른 모듈에서 사용하려면:
import { Module } from '@nestjs/common';
import { DatabaseModule } from '@/modules/global/database/database.module';
@Module({
imports: [DatabaseModule],
// ...
})
export class YourModule {}