Configures Drizzle ORM with full schema and adds repositories
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.
This commit is contained in:
1 parent
dff10ff604
commit
ef440a2dbd
9 files changed
+1385
-34
No files matched your search
@@ -0,0 +1,219 @@
|
||||
# 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 {}
|
||||
```
|
||||
Reference in new issue
Block a user