spliit

Splitit는 Splitwise의 무료 오픈 소스 대안입니다. Spliit.app의 공식 인스턴스를 사용하거나 자체 인스턴스를 배포할 수 있습니다.

특징

• 그룹을 만들어 친구들과 공유해보세요
• 설명이 포함된 비용 생성
• 그룹 잔액 표시
• 상환 비용 생성
• 프로그레시브 웹 앱
• 비용에 대해 전체/참가자 없음 선택
• 비용을 균등하게 분할(#6)
• 그룹을 즐겨찾기로 표시(#29)
• 그룹을 개설할 때 귀하가 누구인지 애플리케이션에 알려주십시오(#7).
• 비용에 카테고리 지정(#35)
• 그룹 내 비용 검색(#51)
• 비용에 이미지 업로드 및 첨부(#63)
• 영수증을 스캔하여 비용 생성(#23)

가능한 수신 기능

• 반복 비용 생성 기능(#5)
• Splitwise에서 비용 가져오기(#22)

스택

• 웹 애플리케이션용 Next.js
• 스타일링을 위한 TailwindCSS
• UI 구성 요소에 대한 shadcn/UI
• 데이터베이스에 접근하기 위한 Prisma
• 호스팅용 Vercel(애플리케이션 및 데이터베이스)

기여하다

이 프로젝트는 기여에 열려 있습니다. 자유롭게 이슈를 열거나 끌어오기 요청을 해보세요!

재정적으로 기여하고 광고 없이 애플리케이션을 무료로 유지하는 데 도움을 주고 싶다면 다음을 수행할 수도 있습니다.

• ? 저(세바스티앙)를 후원해주세요. 또는
• ? 소액의 일회성 기부를 해보세요.

로컬에서 실행

1. 저장소를 복제하십시오(또는 기여하려는 경우 포크하십시오).
2. PostgreSQL 서버를 시작합니다. 아직 서버가 없으면 ./scripts/start-local-db.sh 실행할 수 있습니다.
3. .env.example 파일을 .env 로 복사합니다.
4. 종속성을 설치하려면 npm install 실행하세요. 이는 데이터베이스 마이그레이션 및 Prisma 클라이언트 업데이트에도 적용됩니다.
5. npm run dev 실행하여 개발 서버를 시작하세요.

컨테이너에서 실행

1. npm run build-image 실행하여 Dockerfile에서 Docker 이미지를 빌드합니다.
2. container.env.example 파일을 container.env 로 복사합니다.
3. npm run start-container 실행하여 postgres 및 spliit2 컨테이너를 시작하세요.
4. http://localhost:3000으로 이동하여 앱에 액세스할 수 있습니다.

옵트인 기능

비용 서류

Spliit는 사용자에게 이미지를 AWS S3 버킷에 업로드하고 비용에 첨부할 수 있는 기능을 제공합니다. 이 기능을 활성화하려면:

• next-s3-upload의 S3 버킷 및 IAM 사용자 섹션의 지침에 따라 이미지가 저장될 S3 버킷을 생성하고 설정합니다.
• 적절한 값으로 환경 변수를 업데이트합니다.

 NEXT_PUBLIC_ENABLE_EXPENSE_DOCUMENTS = true
S3_UPLOAD_KEY = AAAAAAAAAAAAAAAAAAAA
S3_UPLOAD_SECRET = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
S3_UPLOAD_BUCKET = name-of-s3-bucket
S3_UPLOAD_REGION = us-east-1

사용자 지정 엔드포인트를 제공하여 다른 S3 공급자를 사용할 수도 있습니다.

 S3_UPLOAD_ENDPOINT = http://localhost:9000

영수증에서 비용 생성

영수증을 업로드하여 사용자에게 비용을 생성하도록 제안할 수 있습니다. 이 기능은 Vision이 포함된 OpenAI GPT-4와 공용 S3 스토리지 엔드포인트를 사용합니다.

기능을 활성화하려면:

• 비용 문서 기능도 활성화해야 합니다(위 섹션 참조). 나중에 변경될 수도 있지만 지금은 영수증 스캔 작업을 위해 이미지를 저장해야 합니다.
• OpenAI API를 구독하고 Vision을 통해 GPT 4에 액세스하세요(크레딧을 미리 구매해야 할 수도 있음).
• 적절한 값으로 환경 변수를 업데이트합니다.

 NEXT_PUBLIC_ENABLE_RECEIPT_EXTRACT = true
OPENAI_API_KEY = XXXXXXXXXXXXXXXXXXXXXXXXXXXX

제목에서 카테고리 추론

제목에서 비용 범주를 자동으로 추론하도록 사용자에게 제공할 수 있습니다. 이 기능은 OpenAI 구독에 의존하므로 위의 가입 지침에 따라 다음 환경 변수를 구성하세요.

 NEXT_PUBLIC_ENABLE_CATEGORY_EXTRACT = true
OPENAI_API_KEY = XXXXXXXXXXXXXXXXXXXXXXXXXXXX 

특허

MIT, 라이센스를 참조하세요.