Adds comprehensive page management and temporary access tokens

Introduces the `PageModule` to provide full CRUD capabilities for pages within spaces.

Key features include:
-   API endpoints for creating, retrieving, updating, and soft-deleting pages.
-   Support for hierarchical page structures with validation to prevent circular references.
-   A mechanism to generate and manage temporary access tokens, allowing controlled public access to specific pages or entire spaces.
-   Integration with database repositories and comprehensive Swagger documentation for all new endpoints and DTOs.
-   Ensures proper authorization and validation for all page and token operations.
This commit is contained in:
dahyeon committed 2025-11-10 15:42:02 +00:00
1 parent ef440a2dbd
commit bb992167d2
10 files changed
+2315 -5

No files matched your search

+249
View File
@@ -0,0 +1,249 @@
import { Injectable, NotFoundException, BadRequestException, ConflictException } from "@nestjs/common";
import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
import { SpaceRepository, PageRepository, UserRepository } from "../global/database/repositories";
export class CreateSpaceDto {
@ApiProperty({
description: '스페이스 키 (고유 식별자, URL에 사용)',
example: 'engineering',
maxLength: 50,
pattern: '^[a-z0-9-]+$'
})
spaceKey: string;
@ApiProperty({
description: '스페이스 이름',
example: 'Engineering Team',
maxLength: 255
})
name: string;
@ApiPropertyOptional({
description: '스페이스 설명',
example: 'Engineering team documentation and knowledge base'
})
description?: string;
@ApiProperty({
description: '현재 사용자 ID (생성자)',
example: '550e8400-e29b-41d4-a716-446655440000',
format: 'uuid'
})
userId: string;
}
export class UpdateSpaceDto {
@ApiPropertyOptional({
description: '스페이스 이름',
example: 'Updated Team Name',
maxLength: 255
})
name?: string;
@ApiPropertyOptional({
description: '스페이스 설명',
example: 'Updated description'
})
description?: string;
}
export class SpaceResponseDto {
@ApiProperty({ description: '스페이스 ID', format: 'uuid' })
spaceId: string;
@ApiProperty({ description: '스페이스 키 (고유 식별자)' })
spaceKey: string;
@ApiProperty({ description: '스페이스 이름' })
name: string;
@ApiProperty({ description: '스페이스 설명', nullable: true })
description: string | null;
@ApiProperty({ description: '생성자 사용자 ID', format: 'uuid' })
createdByUserId: string;
@ApiProperty({ description: '생성 시간', format: 'date-time' })
createdAt: string;
}
export class SpaceWithCreatorDto {
@ApiProperty({ description: '스페이스 정보', type: SpaceResponseDto })
space: SpaceResponseDto;
@ApiProperty({ description: '생성자 정보' })
creator: {
userId: string;
email: string;
displayName: string;
};
}
export class SpaceStatisticsDto {
@ApiProperty({ description: '스페이스 정보', type: SpaceResponseDto })
space: SpaceResponseDto;
@ApiProperty({ description: '통계 정보' })
statistics: {
totalPages: number;
rootPages: number;
};
}
export class DeleteSpaceResponseDto {
@ApiProperty({ description: '응답 메시지' })
message: string;
@ApiProperty({ description: '삭제된 스페이스 ID', format: 'uuid' })
spaceId: string;
}
@Injectable()
export class SpaceService {
constructor(
private readonly spaceRepository: SpaceRepository,
private readonly pageRepository: PageRepository,
private readonly userRepository: UserRepository,
) {}
/**
* 스페이스 생성
*/
async createSpace(dto: CreateSpaceDto) {
// 스페이스 키 중복 확인
const exists = await this.spaceRepository.existsByKey(dto.spaceKey);
if (exists) {
throw new ConflictException(`Space with key '${dto.spaceKey}' already exists`);
}
// 사용자 존재 확인
const user = await this.userRepository.findById(dto.userId);
if (!user) {
throw new NotFoundException(`User with id '${dto.userId}' not found`);
}
// 스페이스 키 형식 검증 (소문자, 숫자, 하이픈만 허용)
const spaceKeyRegex = /^[a-z0-9-]+$/;
if (!spaceKeyRegex.test(dto.spaceKey)) {
throw new BadRequestException('Space key must contain only lowercase letters, numbers, and hyphens');
}
const space = await this.spaceRepository.create({
spaceKey: dto.spaceKey,
name: dto.name,
description: dto.description,
createdByUserId: dto.userId,
});
return space;
}
/**
* 스페이스 ID로 조회
*/
async getSpaceById(spaceId: string) {
const space = await this.spaceRepository.findById(spaceId);
if (!space) {
throw new NotFoundException(`Space with id '${spaceId}' not found`);
}
return space;
}
/**
* 스페이스 키로 조회
*/
async getSpaceByKey(spaceKey: string) {
const space = await this.spaceRepository.findByKey(spaceKey);
if (!space) {
throw new NotFoundException(`Space with key '${spaceKey}' not found`);
}
return space;
}
/**
* 모든 스페이스 조회
*/
async getAllSpaces() {
return await this.spaceRepository.findAll();
}
/**
* 생성자 정보와 함께 스페이스 조회
*/
async getSpaceWithCreator(spaceId: string) {
const result = await this.spaceRepository.findByIdWithCreator(spaceId);
if (!result) {
throw new NotFoundException(`Space with id '${spaceId}' not found`);
}
return result;
}
/**
* 모든 스페이스를 생성자 정보와 함께 조회
*/
async getAllSpacesWithCreator() {
return await this.spaceRepository.findAllWithCreator();
}
/**
* 스페이스 통계 조회
*/
async getSpaceStatistics(spaceId: string) {
const space = await this.spaceRepository.findById(spaceId);
if (!space) {
throw new NotFoundException(`Space with id '${spaceId}' not found`);
}
const allPages = await this.pageRepository.findBySpaceId(spaceId);
const rootPages = await this.pageRepository.findRootPagesBySpaceId(spaceId);
return {
space,
statistics: {
totalPages: allPages.length,
rootPages: rootPages.length,
},
};
}
/**
* 사용자가 생성한 스페이스 조회
*/
async getSpacesByCreator(userId: string) {
const user = await this.userRepository.findById(userId);
if (!user) {
throw new NotFoundException(`User with id '${userId}' not found`);
}
return await this.spaceRepository.findByCreator(userId);
}
/**
* 스페이스 업데이트
*/
async updateSpace(spaceId: string, dto: UpdateSpaceDto) {
const space = await this.spaceRepository.findById(spaceId);
if (!space) {
throw new NotFoundException(`Space with id '${spaceId}' not found`);
}
const updatedSpace = await this.spaceRepository.update(spaceId, dto);
return updatedSpace;
}
/**
* 스페이스 삭제 (cascade로 페이지도 함께 삭제됨)
*/
async deleteSpace(spaceId: string) {
const space = await this.spaceRepository.findById(spaceId);
if (!space) {
throw new NotFoundException(`Space with id '${spaceId}' not found`);
}
await this.spaceRepository.delete(spaceId);
return {
message: 'Space deleted successfully',
spaceId
};
}
}