9. 첨부파일

PropSheet의 attachment 타입 필드를 사용하면 레코드에 다양한 파일을 첨부할 수 있습니다. 이미지, 문서, 스프레드시트 등 14종의 파일 형식을 지원하며, 이미지 파일은 셀에서 바로 썸네일로 확인할 수 있습니다.

9.1 첨부파일 필드

첨부파일 기능을 사용하려면 데이터베이스에 attachment 타입 필드가 있어야 합니다. attachment 타입 필드는 파일을 업로드하고 관리하기 위한 전용 필드입니다.

attachment 필드 생성

필드 추가 버튼 클릭
스프레드시트 화면에서 컬럼 헤더 우측 끝에 있는 + 버튼을 클릭합니다.
필드 이름 입력
필드 이름을 입력합니다. 예: "계약서", "현장사진", "대표사진" 등 용도에 맞는 이름을 지정합니다.
필드 타입으로 "attachment" 선택
필드 타입 드롭다운에서 attachment를 선택합니다.
필드 생성 완료
"추가" 버튼을 클릭하면 새로운 첨부파일 필드가 생성됩니다. 해당 컬럼의 셀에는 파일 업로드 영역이 표시됩니다.

📸

at-01

attachment 필드 생성

필드 추가 팝업에서 필드 타입을 "attachment"로 선택한 상태. 필드 이름 입력란과 타입 드롭다운이 보이는 화면.

필드 타입 변경 불가
이미 데이터가 입력된 필드는 타입을 변경할 수 없습니다. attachment 필드를 다른 타입으로 변경하거나, 다른 타입의 필드를 attachment로 변경하는 것은 지원되지 않습니다. 필요한 경우 새 필드를 생성하세요.

9.2 파일 업로드

attachment 타입 필드의 셀을 클릭하면 파일을 업로드할 수 있습니다. 한 셀에 여러 파일을 첨부할 수 있으며, 허용된 확장자의 파일만 업로드 가능합니다.

업로드 방법

셀 클릭
attachment 타입 필드의 셀을 클릭합니다. 파일 업로드 영역이 활성화됩니다.
파일 선택
"파일 선택" 버튼을 클릭하거나, 파일을 드래그 앤 드롭하여 업로드합니다. 파일 탐색기에서 원하는 파일을 선택합니다.
업로드 완료 확인
파일이 업로드되면 셀에 파일명이 표시됩니다. 이미지 파일의 경우 썸네일이 함께 표시됩니다.

📸

at-02

파일 업로드 과정

attachment 셀을 클릭하여 파일 업로드 영역이 활성화된 상태. "파일 선택" 버튼과 드래그 앤 드롭 안내 문구가 보이는 화면.

허용 파일 확장자

PropSheet은 보안과 호환성을 위해 다음 14종의 파일 확장자만 업로드를 허용합니다.

분류	확장자	설명
이미지	`.jpg`	JPEG 이미지 (가장 많이 사용되는 사진 형식)
	`.jpeg`	JPEG 이미지 (jpg와 동일한 형식)
	`.png`	PNG 이미지 (투명 배경 지원)
	`.gif`	GIF 이미지 (애니메이션 지원)
	`.webp`	WebP 이미지 (고압축 웹 이미지 형식)
문서	`.pdf`	PDF 문서 (계약서, 도면 등)
	`.doc`	Microsoft Word 문서 (구 버전)
	`.docx`	Microsoft Word 문서 (최신 버전)
	`.hwp`	한글(HWP) 문서
스프레드시트	`.xls`	Microsoft Excel 스프레드시트 (구 버전)
스프레드시트	`.xlsx`	Microsoft Excel 스프레드시트 (최신 버전)
텍스트/데이터	`.txt`	일반 텍스트 파일
	`.csv`	CSV 데이터 파일 (콤마 구분)

허용되지 않는 파일
위 14종 이외의 확장자(예: .zip, .exe, .mp4 등)는 업로드할 수 없습니다. 허용되지 않는 파일을 업로드하려고 하면 오류 메시지가 표시됩니다. 파일 확장자를 임의로 변경하여 업로드하는 것은 권장하지 않습니다.

부동산 업무에서 자주 사용하는 파일
매물 현장 사진(.jpg, .png), 계약서(.pdf, .hwp), 등기부등본(.pdf), 건축물대장(.pdf), 매물 목록(.xlsx, .csv) 등이 대표적입니다. 현장 사진은 .jpg로, 공문서는 .pdf로 업로드하는 것을 권장합니다.

9.3 파일 관리

업로드된 파일은 셀 내에서 목록 형태로 관리됩니다. 각 파일의 이름을 확인하고, 필요에 따라 개별적으로 삭제할 수 있습니다.

업로드된 파일 목록 확인

셀 클릭
파일이 첨부된 attachment 셀을 클릭합니다.
파일 목록 확인
셀이 확장되어 업로드된 파일 목록이 표시됩니다. 각 파일의 이름과 함께 삭제 버튼(X)이 표시됩니다. 이미지 파일은 썸네일도 함께 나타납니다.

파일 개별 삭제

삭제할 파일의 X 버튼 클릭
삭제하려는 파일 옆의 X 버튼을 클릭합니다.
삭제 확인
삭제 확인 메시지가 표시됩니다. "삭제"를 클릭하면 해당 파일이 서버에서 완전히 삭제됩니다.
삭제 완료
파일이 삭제되면 목록에서 해당 파일이 사라집니다. 셀에 남은 파일이 없으면 빈 상태로 돌아갑니다.

📸

at-03

파일 목록 및 삭제

attachment 셀을 클릭하여 확장된 상태. 업로드된 파일 3개의 목록과 각 파일 옆 X(삭제) 버튼이 보이는 화면.

삭제는 되돌릴 수 없습니다
파일을 삭제하면 서버에서 물리적으로 완전히 제거됩니다. 삭제된 파일은 복구할 수 없으므로 신중하게 삭제하세요. 중요한 파일은 삭제 전에 반드시 로컬에 백업하시기 바랍니다.

9.4 이미지 미리보기

이미지 파일(.jpg, .jpeg, .png, .gif, .webp)은 다른 파일과 달리 셀 안에서 바로 썸네일로 표시됩니다. 이를 통해 파일을 다운로드하지 않고도 어떤 이미지인지 빠르게 확인할 수 있습니다.

썸네일 표시

이미지가 업로드되면 셀에 작은 썸네일이 자동으로 생성되어 표시됩니다. 여러 이미지가 첨부된 경우 첫 번째 이미지의 썸네일이 대표로 표시되며, 나머지 이미지 수가 숫자로 함께 표기됩니다.

📸

at-04

셀 내 이미지 썸네일

attachment 컬럼에 이미지가 업로드된 여러 레코드. 각 셀에 작은 썸네일 이미지가 표시된 상태. 일부 셀에는 "+3" 같은 추가 이미지 수 표기가 보이는 화면.

원본 이미지 미리보기

썸네일 클릭
셀에 표시된 이미지 썸네일을 클릭합니다.
원본 크기 미리보기
화면 중앙에 원본 크기의 이미지가 오버레이 형태로 표시됩니다. 이미지를 확대하여 세부 사항을 확인할 수 있습니다.
미리보기 닫기
오버레이 외부를 클릭하거나 ESC 키를 누르면 미리보기가 닫힙니다.

📸

at-05

이미지 원본 미리보기

썸네일 클릭 후 원본 이미지가 오버레이로 표시된 상태. 배경이 어둡게 처리되고 중앙에 큰 이미지가 보이는 화면.

대표사진 필드 활용
부동산 매물 관리에서는 "대표사진" 필드를 attachment 타입으로 만들어 사용하면 편리합니다. 매물 목록에서 각 매물의 대표 사진을 썸네일로 빠르게 확인할 수 있어 시각적으로 매물을 구분하기 좋습니다.

9.5 스토리지

PropSheet은 데이터베이스별로 파일 저장 용량을 관리합니다. 각 데이터베이스에는 1GB의 스토리지 용량이 할당되며, 업로드된 모든 파일의 합계가 이 한도를 초과할 수 없습니다.

스토리지 사용량 확인

데이터베이스 설정 열기
스프레드시트 화면 상단의 데이터베이스 이름 옆 설정(톱니바퀴) 아이콘을 클릭합니다.
스토리지 정보 확인
설정 패널에서 현재 사용 중인 스토리지 용량과 전체 한도(1GB)를 확인할 수 있습니다. 사용량은 바(bar) 그래프와 숫자로 표시됩니다.

📸

at-06

스토리지 사용량 확인

데이터베이스 설정 패널에서 스토리지 사용량이 표시된 상태. "사용: 245MB / 1GB" 형태의 바 그래프와 숫자가 보이는 화면.

용량 관리 팁

방법	설명
불필요한 파일 삭제	더 이상 필요 없는 첨부파일을 주기적으로 삭제하여 용량을 확보합니다.
이미지 압축 후 업로드	고해상도 사진은 웹용으로 리사이즈(1920px 이하)하거나 압축한 후 업로드하면 용량을 절약할 수 있습니다.
WebP 형식 활용	JPEG/PNG 대신 WebP 형식을 사용하면 동일 화질 대비 파일 크기가 25~35% 작습니다.
중복 파일 정리	같은 파일이 여러 레코드에 중복 업로드되어 있다면 정리하여 용량을 확보합니다.

용량 초과 시
스토리지 사용량이 1GB에 도달하면 더 이상 파일을 업로드할 수 없습니다. 기존 파일을 삭제하여 용량을 확보한 후에 새 파일을 업로드하세요. 텍스트 데이터(레코드의 일반 필드 값)는 스토리지 한도에 포함되지 않으며, 오직 첨부파일만 계산됩니다.

파일 저장 경로
업로드된 파일은 서버의 /uploads/propsheet/{데이터베이스ID}/{레코드ID}/ 경로에 저장됩니다. 파일명은 안전한 형태로 자동 변환되며, 메타데이터는 file_attachments 테이블에서 관리됩니다.