spliit

Splitwise เป็นทางเลือกโอเพ่นซอร์สฟรีสำหรับ Splitwise คุณสามารถใช้อินสแตนซ์อย่างเป็นทางการได้ที่ Spliit.app หรือปรับใช้อินสแตนซ์ของคุณเอง:

คุณสมบัติ

• สร้างกลุ่มและแบ่งปันกับเพื่อน ๆ
• สร้างรายจ่ายพร้อมคำอธิบาย
• แสดงยอดคงเหลือของกลุ่ม
• สร้างค่าใช้จ่ายในการชดใช้คืน
• โปรเกรสซีฟเว็บแอป
• เลือกทั้งหมด/ไม่มีผู้เข้าร่วมสำหรับค่าใช้จ่าย
• แบ่งค่าใช้จ่ายไม่เท่ากัน (#6)
• ทำเครื่องหมายกลุ่มว่าเป็นรายการโปรด (#29)
• บอกใบสมัครว่าคุณเป็นใครเมื่อเปิดกลุ่ม (#7)
• กำหนดหมวดหมู่ให้กับค่าใช้จ่าย (#35)
• ค้นหาค่าใช้จ่ายในกลุ่ม (#51)
• อัพโหลดและแนบภาพค่าใช้จ่าย (#63)
• สร้างรายจ่ายโดยการสแกนใบเสร็จรับเงิน (#23)

คุณสมบัติขาเข้าที่เป็นไปได้

• ความสามารถในการสร้างค่าใช้จ่ายที่เกิดขึ้นประจำ (#5)
• ค่าใช้จ่ายในการนำเข้าจาก Splitwise (#22)

สแต็ค

• Next.js สำหรับเว็บแอปพลิเคชัน
• TailwindCSS สำหรับจัดแต่งทรงผม
• shadcn/UI สำหรับส่วนประกอบ UI
• Prisma เพื่อเข้าถึงฐานข้อมูล
• Vercel สำหรับการโฮสต์ (แอปพลิเคชันและฐานข้อมูล)

มีส่วนช่วย

โครงการนี้เปิดให้มีส่วนร่วม อย่าลังเลที่จะเปิดประเด็นหรือแม้แต่คำขอดึง!

หากคุณต้องการบริจาคเงินและช่วยเราทำให้แอปพลิเคชันนี้ฟรีและไม่มีโฆษณา คุณยังสามารถ:

• - สนับสนุนฉัน (เซบาสเตียน) หรือ
• - บริจาคเล็กๆ น้อยๆ เพียงครั้งเดียว

ดำเนินการในพื้นที่

1. โคลนพื้นที่เก็บข้อมูล (หรือแยกมันหากคุณตั้งใจจะมีส่วนร่วม)
2. เริ่มเซิร์ฟเวอร์ PostgreSQL คุณสามารถเรียกใช้ ./scripts/start-local-db.sh ได้ หากคุณยังไม่มีเซิร์ฟเวอร์
3. คัดลอกไฟล์ .env.example เป็น .env
4. รัน npm install เพื่อติดตั้งการพึ่งพา นอกจากนี้ยังจะใช้การย้ายฐานข้อมูลและอัปเดต Prisma Client
5. รัน npm run dev เพื่อเริ่มเซิร์ฟเวอร์การพัฒนา

วิ่งในภาชนะ

1. รัน npm run build-image เพื่อสร้างอิมเมจนักเทียบท่าจาก Dockerfile
2. คัดลอกไฟล์ container.env.example เป็น container.env
3. รัน npm run start-container เพื่อเริ่ม postgres และคอนเทนเนอร์ spliit2
4. คุณสามารถเข้าถึงแอปได้โดยไปที่ http://localhost:3000

คุณสมบัติการเลือกใช้

เอกสารค่าใช้จ่าย

Spliit เสนอให้ผู้ใช้อัปโหลดภาพ (ไปยังบัคเก็ต AWS S3) และแนบไปกับค่าใช้จ่าย หากต้องการเปิดใช้งานคุณสมบัตินี้:

• ปฏิบัติตามคำแนะนำในส่วน บัคเก็ต S3 และ ผู้ใช้ IAM ของ next-s3-upload เพื่อสร้างและตั้งค่าบัคเก็ต 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

สร้างรายจ่ายจากการรับ

คุณสามารถเสนอให้ผู้ใช้สร้างค่าใช้จ่ายได้โดยการอัพโหลดใบเสร็จรับเงิน คุณสมบัตินี้อาศัย OpenAI GPT-4 พร้อมด้วย Vision และอุปกรณ์ปลายทางพื้นที่เก็บข้อมูล S3 สาธารณะ

หากต้องการเปิดใช้งานคุณลักษณะนี้:

• คุณต้องเปิดใช้งานคุณลักษณะเอกสารค่าใช้จ่ายด้วย (ดูหัวข้อด้านบน) ซึ่งอาจมีการเปลี่ยนแปลงได้ในอนาคต แต่ตอนนี้เราจำเป็นต้องจัดเก็บภาพเพื่อให้สแกนใบเสร็จได้
• สมัครสมาชิก OpenAI API และเข้าถึง GPT 4 ด้วย Vision (คุณอาจต้องซื้อเครดิตล่วงหน้า)
• อัปเดตตัวแปรสภาพแวดล้อมของคุณด้วยค่าที่เหมาะสม:

 NEXT_PUBLIC_ENABLE_RECEIPT_EXTRACT = true
OPENAI_API_KEY = XXXXXXXXXXXXXXXXXXXXXXXXXXXX

อนุมานหมวดหมู่จากชื่อเรื่อง

คุณสามารถเสนอให้ผู้ใช้อนุมานประเภทค่าใช้จ่ายจากชื่อโดยอัตโนมัติได้ เนื่องจากฟีเจอร์นี้ต้องอาศัยการสมัครสมาชิก OpenAI ให้ทำตามคำแนะนำในการสมัครด้านบนและกำหนดค่าตัวแปรสภาพแวดล้อมต่อไปนี้:

 NEXT_PUBLIC_ENABLE_CATEGORY_EXTRACT = true
OPENAI_API_KEY = XXXXXXXXXXXXXXXXXXXXXXXXXXXX 

ใบอนุญาต

MIT ดูใบอนุญาต