# 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) ```typescript 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 사용 (복잡한 비즈니스 로직) ```typescript 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) - UUID - `entraObjectId` (Unique) - Microsoft Entra Object ID - `entraTenantId` - Microsoft Entra Tenant ID - `email` - 이메일 - `displayName` - 표시 이름 - `isSystemAdmin` - 시스템 관리자 여부 - `isActive` - 활성 상태 - `createdAt`, `updatedAt`, `lastLoginAt` - 타임스탬프 ### spaces - `spaceId` (PK) - UUID - `spaceKey` (Unique) - 스페이스 키 - `name` - 이름 - `description` - 설명 - `createdByUserId` (FK) - 생성자 - `createdAt` - 생성 시간 ### pages - `pageId` (PK) - UUID - `spaceId` (FK) - 스페이스 - `parentPageId` (FK, nullable) - 부모 페이지 - `sortOrder` - 정렬 순서 - `title` - 제목 - `content` - 내용 - `createdByUserId` (FK) - 생성자 - `updatedByUserId` (FK) - 수정자 - `createdAt`, `updatedAt` - 타임스탬프 - `isDeleted` - 삭제 여부 (소프트 삭제) ### accesstokens - `tokenId` (PK) - UUID - `tokenValue` (Unique) - 토큰 값 - `description` - 설명 - `expiresAt` (nullable) - 만료 시간 - `createdByUserId` (FK) - 생성자 - `createdAt` - 생성 시간 ### tokenpermissions - `permissionId` (PK) - UUID - `tokenId` (FK) - 토큰 - `spaceId` (FK, nullable) - 스페이스 (spaceId 또는 pageId 중 하나만 설정) - `pageId` (FK, nullable) - 페이지 (spaceId 또는 pageId 중 하나만 설정) - Constraint: spaceId와 pageId 중 정확히 하나만 NULL이 아니어야 함 ## 모듈 임포트 다른 모듈에서 사용하려면: ```typescript import { Module } from '@nestjs/common'; import { DatabaseModule } from '@/modules/global/database/database.module'; @Module({ imports: [DatabaseModule], // ... }) export class YourModule {} ```