원장 공유 및 임베드하기

Beancount.io는 재무 데이터를 공유할 수 있는 유연한 옵션을 제공합니다. 웹사이트에 원장을 임베드하여 공개적으로 보여주거나, 협업자를 초대하여 계정 편집 및 관리를 함께 할 수 있습니다.

원장 임베드하기

임베드 기능을 사용하면 웹사이트, 포트폴리오 또는 문서에 원장을 공개적으로 표시할 수 있습니다. 이는 투명성 보고서, 오픈 소스 프로젝트 예산 또는 교육용 시연에 적합합니다.

사전 요구 사항: 원장을 공개로 설정하기

중요: 원장을 임베드하기 전에 먼저 공개 가시성으로 설정해야 합니다.

1. 원장의 설정 페이지로 이동합니다: https://beancount.io/ledger/{username}/{repo}/settings
2. 가시성 설정을 "Private(비공개)"에서 "Public(공개)"으로 변경합니다.
3. 변경 사항을 저장합니다.

보안 참고 사항

모든 재무 데이터를 다른 사람과 공유하는 것이 괜찮은 경우에만 원장을 공개로 설정하십시오. 공개 원장은 인터넷상의 누구나 볼 수 있습니다. 원장에 민감한 개인 또는 비즈니스 재무 정보가 포함되어 있다면 비공개로 유지하고 대신 협업 기능을 사용하십시오.

iframe으로 임베드하기

원장이 공개로 설정되면 HTML iframe을 사용하여 모든 웹사이트에 임베드할 수 있습니다. 다음은 개요(overview) 페이지를 임베드하는 예시입니다:

iframe 코드 예시

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin-bottom: 2rem;">
  <iframe
    style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
    src="https://beancount.io/ledger/puncsky/example/overview"
    title="Beancount 원장 개요"
    frameBorder="0"
    allow="clipboard-write"
    loading="lazy">
  </iframe>
</div>

임베드 뷰 사용자 정의하기

URL 경로를 변경하여 원장의 다른 페이지를 임베드할 수 있습니다:

• 개요(Overview): /ledger/{username}/{repo}/overview
• 대차대조표(Balance Sheet): /ledger/{username}/{repo}/balance-sheet
• 손익계산서(Income Statement): /ledger/{username}/{repo}/income-statement
• 분개장(Journal): /ledger/{username}/{repo}/journal
• 통계(Statistics): /ledger/{username}/{repo}/statistics

{username}을 본인의 사용자 이름으로, {repo}를 원장 저장소 이름으로 바꾸기만 하면 됩니다.

편집을 위해 원장 공유하기

회계사, 비즈니스 파트너 또는 팀원 등 다른 사람이 원장 편집을 돕길 원한다면 협업자로 초대할 수 있습니다. 협업자는 원장에 대한 모든 읽기 및 쓰기 권한을 가지며 Git 기반 워크플로우를 통해 커밋을 생성할 수 있습니다.

단계별 안내: 협업자 초대하기

1. 협업자에게 가입 요청하기 협업자는 먼저 https://beancount.io에서 무료 계정을 생성해야 합니다.

2. 협업자 페이지로 이동하기 https://beancount.io/ledger/{username}/{repo}/collaborators로 이동합니다 ({username}과 {repo}를 본인의 원장 정보로 변경).

3. 협업자 초대하기 "Invite Collaborator" 버튼을 클릭하고 협업자의 사용자 이름 또는 이메일 주소를 입력합니다.

협업자가 할 수 있는 일

초대를 수락한 협업자는 다음과 같은 작업을 수행할 수 있습니다:

• 모든 거래 및 재무 데이터 조회
• 웹 인터페이스를 통해 직접 원장 파일 편집
• Git 커밋 생성 및 커밋 내역 확인
• 문서 및 영수증 업로드
• 쿼리 실행 및 보고서 생성
• Git 명령어를 사용하여 변경 사항 푸시 및 풀 (로컬에서 작업하는 경우)

협업 모범 사례

• 역할을 명확히 정의: 누가 어떤 계정이나 기간을 담당할지 논의하십시오.
• 의미 있는 커밋 메시지 사용: 누가 어떤 변경을 왜 했는지 추적하는 데 도움이 됩니다.
• 정기적인 소통: 충돌을 피하기 위해 주요 변경 사항에 대해 조율하십시오.
• 변경 사항 함께 검토: Git 내역을 사용하여 서로의 작업을 검토하십시오.
• 정기적인 백업: Git이 버전 관리를 제공하지만, 별도의 백업을 유지하십시오.

Git 기반 워크플로우

Beancount.io는 버전 관리를 위해 Git을 사용합니다. Git 지식이 있는 협업자는 저장소를 로컬로 복제(clone)하고, 선호하는 텍스트 편집기로 변경한 뒤, 업데이트 내용을 서버로 푸시(push)할 수 있습니다. 이는 재무 데이터를 관리하기 위한 강력한 버전 관리 기능을 제공합니다.

개인정보 보호 고려사항

공개 vs. 비공개 원장

• 공개 원장 (Public Ledgers):

  • 외부 웹사이트에 임베드 가능
  • URL이 있는 누구나 볼 수 있음
  • 설정에 따라 검색 엔진에 의해 인덱싱될 수 있음
  • 투명성 및 교육 목적에 적합

• 비공개 원장 (Private Ledgers - 기본값):

  • 본인과 초대된 협업자만 액세스 가능
  • 외부 임베드 불가
  • 개인 및 비즈니스 재무 관리에 권장됨

각 옵션의 사용 시기

• 공개 사용: 오픈 소스 프로젝트 예산, 교육용 예시, 투명성 보고서, 포트폴리오 시연
• 비공개 사용: 개인 재무, 비즈니스 회계, 고객 작업, 민감한 재무 데이터

원장의 설정 페이지에서 언제든지 가시성 설정을 변경할 수 있습니다.