spliit

Splitwise adalah alternatif sumber terbuka dan gratis untuk Splitwise. Anda dapat menggunakan instance resmi di Spliit.app, atau menerapkan instance Anda sendiri:

Fitur

• Buat grup dan bagikan dengan teman-teman
• Buat pengeluaran dengan deskripsi
• Tampilkan saldo grup
• Buat biaya penggantian
• Aplikasi Web Progresif
• Pilih semua/tidak ada peserta untuk pengeluaran
• Membagi pengeluaran secara tidak merata (#6)
• Tandai grup sebagai favorit (#29)
• Beritahu aplikasi siapa Anda saat membuka grup (#7)
• Tetapkan kategori untuk pengeluaran (#35)
• Cari pengeluaran dalam grup (#51)
• Unggah dan lampirkan gambar ke pengeluaran (#63)
• Buat pengeluaran dengan memindai tanda terima (#23)

Kemungkinan fitur masuk

• Kemampuan untuk menciptakan pengeluaran berulang (#5)
• Biaya impor dari Splitwise (#22)

Tumpukan

• Next.js untuk aplikasi web
• TailwindCSS untuk penataan gaya
• shadcn/UI untuk komponen UI
• Prisma untuk mengakses database
• Vercel untuk hosting (aplikasi dan database)

Menyumbang

Proyek ini terbuka untuk kontribusi. Jangan ragu untuk membuka terbitan atau bahkan permintaan tarik!

Jika Anda ingin berkontribusi secara finansial dan membantu kami menjaga aplikasi ini tetap gratis dan tanpa iklan, Anda juga dapat:

• ? Sponsori saya (Sebastien), atau
• ? Berikan sumbangan kecil satu kali.

Jalankan secara lokal

1. Kloning repositori (atau fork jika Anda ingin berkontribusi)
2. Mulai server PostgreSQL. Anda dapat menjalankan ./scripts/start-local-db.sh jika Anda belum memiliki server.
3. Salin file .env.example sebagai .env
4. Jalankan npm install untuk menginstal dependensi. Ini juga akan menerapkan migrasi database dan memperbarui Klien Prisma.
5. Jalankan npm run dev untuk memulai server pengembangan

Jalankan dalam sebuah wadah

1. Jalankan npm run build-image untuk membuat image buruh pelabuhan dari Dockerfile
2. Salin file container.env.example sebagai container.env
3. Jalankan npm run start-container untuk memulai postgres dan container spliit2
4. Anda dapat mengakses aplikasi dengan menjelajah ke http://localhost:3000

Fitur keikutsertaan

Dokumen pengeluaran

Spliit menawarkan pengguna untuk mengunggah gambar (ke bucket AWS S3) dan melampirkannya ke pengeluaran. Untuk mengaktifkan fitur ini:

• Ikuti petunjuk di bagian bucket S3 dan pengguna IAM pada unggahan s3 berikutnya untuk membuat dan menyiapkan bucket S3 tempat gambar akan disimpan.
• Perbarui variabel lingkungan Anda dengan nilai yang sesuai:

 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

Anda juga dapat menggunakan penyedia S3 lainnya dengan menyediakan titik akhir khusus:

 S3_UPLOAD_ENDPOINT = http://localhost:9000

Buat pengeluaran dari tanda terima

Anda dapat menawarkan pengguna untuk membuat pengeluaran dengan mengunggah tanda terima. Fitur ini mengandalkan OpenAI GPT-4 dengan Vision dan titik akhir penyimpanan S3 publik.

Untuk mengaktifkan fitur ini:

• Anda juga harus mengaktifkan fitur dokumen pengeluaran (lihat bagian di atas). Hal ini mungkin akan berubah di masa mendatang, namun untuk saat ini kami perlu menyimpan gambar agar pemindaian tanda terima dapat berfungsi.
• Berlangganan OpenAI API dan dapatkan akses ke GPT 4 dengan Vision (Anda mungkin perlu membeli kredit terlebih dahulu).
• Perbarui variabel lingkungan Anda dengan nilai yang sesuai:

 NEXT_PUBLIC_ENABLE_RECEIPT_EXTRACT = true
OPENAI_API_KEY = XXXXXXXXXXXXXXXXXXXXXXXXXXXX

Simpulkan kategori dari judul

Anda dapat menawarkan pengguna untuk secara otomatis menyimpulkan kategori pengeluaran dari judul. Karena fitur ini bergantung pada langganan OpenAI, ikuti petunjuk pendaftaran di atas dan konfigurasikan variabel lingkungan berikut:

 NEXT_PUBLIC_ENABLE_CATEGORY_EXTRACT = true
OPENAI_API_KEY = XXXXXXXXXXXXXXXXXXXXXXXXXXXX 

Lisensi

MIT, lihat LISENSI.