SYSTEM BLUEPRINT

건축 3D 결과물
검수와 공유 화면 설계

OBJ·DAE 결과물을 발견부터 공유 완료까지 이어 보는 사용자·운영자 설계도입니다.

스토리보드란?

스토리보드는 3D 결과물의 로드·검수·공유가 실제 화면에서 어떤 순서로 이어지는지 보여주는 실행 설계도입니다.

  1. 건축주가 링크를 열고 3D 결과물을 이해하는 흐름
  2. 운영 담당자가 모델 버전과 공유 상태를 관리하는 흐름

마지막까지 보시면 3D 결과물을 전달하는 MVP의 기준 화면이 그려집니다.

건축주 시나리오

건축주 3D 검수 여정

설치 없이 공유 링크를 열어 결과물을 이해하고 검수 의견을 남기는 흐름.

1. 모델 링크 열기

공유 링크에서 결과물을 즉시 로드

2. 모델 상태 확인

버전·업로드 시각·상태를 확인

3. 3D 검수 조작

회전·확대와 선택·숨김으로 검수

4. 의견·상태 확인

검수 메모와 처리 상태를 확인

5. 공유 완료

확인 가능한 링크로 다음 사람에게 전달

건축주 | 화면 01

공유 링크에서 3D 결과물 확인

https://viewer.local/viewer
viewer.local/공유-뷰어
3D REVIEW / R1

HOUSE-204 / v03

3D
X  Y  Z
OBJ + DAE업데이트 10:42

[화면 개요 및 목적]

건축주가 링크를 열자 모델이 먼저 보이고, 파일명·버전·최근 업데이트가 함께 표시된다.

[핵심 기능 로직]

Three.js 로더와 카메라 초기화를 먼저 완료하고, 모델 메타데이터는 뷰어 상태와 분리한다.

  • 확장 가능한 구조
    Three.js + TypeScript
건축주 | 화면 02

검수 조작과 상태 확인

https://viewer.local/review
viewer.local/검수-모드
3D REVIEW / R2

검수 도구

선택이동숨김초기화
선택됨 · WALL-02
검수 중

[화면 개요 및 목적]

건축주가 회전·확대하고 요소를 선택해 숨김 처리하며 검수 상태를 확인한다.

[핵심 기능 로직]

뷰어 입력은 카메라 조작과 검수 편집 명령으로 분리하고, 현재 상태는 저장 가능한 이벤트로 만든다.

  • 확장 가능한 구조
    Viewer Command API
건축주 | 화면 03

공유 완료와 다음 행동

https://viewer.local/share
viewer.local/공유-완료
3D REVIEW / R3

검수 링크 준비됨

이 링크는 현재 모델 버전을 가리킵니다.

[화면 개요 및 목적]

검수 상태와 모델 버전을 확인한 뒤 링크를 복사해 건축주·설계 담당자에게 전달한다.

[핵심 기능 로직]

공유 토큰은 모델 버전과 분리해 만료·권한 정책과 로그인 기능을 후속으로 추가한다.

  • 확장 가능한 구조
    Share Token API
운영 담당자 시나리오

모델 업로드·공유 여정

생성된 OBJ·DAE 결과물을 버전으로 관리하고 공유 링크를 발행하는 흐름.

1. 모델 링크 열기

공유 링크에서 결과물을 즉시 로드

2. 모델 상태 확인

버전·업로드 시각·상태를 확인

3. 3D 검수 조작

회전·확대와 선택·숨김으로 검수

4. 의견·상태 확인

검수 메모와 처리 상태를 확인

5. 공유 완료

확인 가능한 링크로 다음 사람에게 전달

운영 담당자 | 화면 01

모델 버전 목록

https://viewer.local/versions
viewer.local/버전-목록
3D REVIEW / R1

프로젝트 모델

HOUSE-204 / v03최신OBJ·DAE · 10:42
HOUSE-204 / v02보관OBJ · 어제
HOUSE-204 / v01보관OBJ · 2일 전

[화면 개요 및 목적]

운영 담당자가 업로드된 모델과 버전을 비교하고 최신 결과물을 선택한다.

[핵심 기능 로직]

모델 파일과 프로젝트·버전 메타데이터를 분리 저장하여 후속 로그인과 구독을 수용한다.

  • 확장 가능한 구조
    Three.js + TypeScript
운영 담당자 | 화면 02

공유 상태 관리

https://viewer.local/sharing
viewer.local/링크-관리
3D REVIEW / R3

공유 링크

새 버전으로 링크 갱신  →

[화면 개요 및 목적]

운영 담당자가 공유 링크의 상태와 버전을 확인하고 다시 발행한다.

[핵심 기능 로직]

공유 토큰을 별도 리소스로 두고 만료·비공개 전환을 API 경계에서 처리한다.

  • 확장 가능한 구조
    Share Token API
운영 담당자 | 화면 03

검수 상태 대시보드

https://viewer.local/dashboard
viewer.local/운영-대시보드
3D REVIEW / R2

검수 현황

03전체 모델
02검수 중
01공유 활성

최근 업데이트 · HOUSE-204 v03

[화면 개요 및 목적]

운영 담당자가 모델별 검수 상태와 최근 활동을 한 화면에서 확인한다.

[핵심 기능 로직]

상태·이벤트·모델 버전을 조회 API로 분리하여 운영 화면과 향후 계정 권한을 연결한다.

  • 확장 가능한 구조
    Viewer Command API
확장 구조 시나리오

향후 로그인·구독 확장 여정

현재 MVP의 익명 링크 경계를 향후 계정·권한·유료 구독으로 확장하는 흐름.

1. 모델 링크 열기

공유 링크에서 결과물을 즉시 로드

2. 모델 상태 확인

버전·업로드 시각·상태를 확인

3. 3D 검수 조작

회전·확대와 선택·숨김으로 검수

4. 의견·상태 확인

검수 메모와 처리 상태를 확인

5. 공유 완료

확인 가능한 링크로 다음 사람에게 전달

확장 구조 | 화면 01

향후 계정·권한 경계

https://viewer.local/account
viewer.local/확장-경계
3D REVIEW / R4

다음 단계

현재
공유 링크
다음
계정 권한
후속
구독 플랜
핵심 모델 리소스는 그대로 재사용합니다.

[화면 개요 및 목적]

로그인과 유료 구독을 붙일 때 프로젝트·모델·공유 권한이 자연스럽게 확장된다.

[핵심 기능 로직]

익명 공유 토큰과 사용자 계정의 권한 모델을 분리해 현재 MVP를 흔들지 않는다.

  • 확장 가능한 구조
    Resource Boundary
확장 구조 | 화면 02

문·창문 편집 확장 포인트

https://viewer.local/future-edit
viewer.local/확장-도구
3D REVIEW / R4

편집 도구 확장

선택이동숨김문 추가창 추가
현재 범위는 검수 도구까지입니다.

[화면 개요 및 목적]

자유 모델링은 제외하되 향후 문·창문 편집 명령을 추가할 수 있는 구조를 보여준다.

[핵심 기능 로직]

검수 편집 명령을 command 형태로 두어 후속 도구를 추가해도 뷰어 입력이 충돌하지 않게 한다.

  • 확장 가능한 구조
    Resource Boundary
확장 구조 | 화면 03

인수인계와 운영 기준

https://viewer.local/handoff
viewer.local/인수인계
3D REVIEW / R5

MVP 범위 기준

✓ OBJ·DAE 웹 로드✓ 카메라·검수 조작✓ 공유 링크— CAD 분석·자동 생성 제외— 자유 모델링 제외

[화면 개요 및 목적]

범위 제외 항목과 확장 지점을 문서화하여 이후 계약 범위를 오해 없이 이어 간다.

[핵심 기능 로직]

생성 엔진과 웹 뷰어를 분리하고 샘플 파일·실행법·API 경계를 인수인계 문서로 남긴다.

  • 확장 가능한 구조
    Resource Boundary