ดาวน์โหลด grocy - ดาวน์โหลดซอร์สโค้ด grocy

ERP ที่เหนือกว่าตู้เย็นของคุณ

Grocy เป็นโซลูชันการจัดการครัวเรือนและร้านขายของชำที่โฮสต์บนเว็บสำหรับบ้านของคุณ

นี่เป็นโครงการงานอดิเรกของ Bernd Bestel

ลองดูสิ

การสาธิตสาธารณะของเวอร์ชันเสถียรล่าสุด (สาขา release ) → https://demo.grocy.info
การสาธิตสาธารณะของเวอร์ชันการพัฒนาปัจจุบัน (สาขา master ) → https://demo-prerelease.grocy.info

คุณสมบัติ

ดูเว็บไซต์ → https://grocy.info

คำถาม / ช่วยเหลือ / รายงานข้อผิดพลาด / คำขอคุณสมบัติ

คำถามช่วยเหลือและการใช้งานทั่วไป → r/grocy subreddit
รายงานข้อผิดพลาดและการร้องขอคุณสมบัติ → ตัวติดตามปัญหา

โปรดอย่าส่งข้อความส่วนตัวถึงฉันหรือโทรหาฉันเกี่ยวกับเรื่อง Grocy ฉันตรวจสอบตัวติดตามปัญหาและ subreddit เกือบทุกวัน แต่ไม่ได้ให้การสนับสนุนใดๆ นอกเหนือจากนั้น

การมีส่วนร่วมของชุมชน

ดูเว็บไซต์สำหรับรายการส่วนเสริม / เครื่องมือที่ชุมชนสนับสนุน → https://grocy.info/addons

วิธีการติดตั้ง

ชำระเงิน Grocy Desktop หากคุณต้องการเรียกใช้ Grocy โดยไม่ต้องจัดการเว็บเซิร์ฟเวอร์เหมือนกับแอปพลิเคชันเดสก์ท็อปทั่วไป (Windows)
ดาวน์โหลดรุ่นล่าสุดโดยตรง - การติดตั้งไม่มีอะไรมากไปกว่าการคลิก "ถัดไป" 2 ครั้ง

Grocy เป็นแอปพลิเคชั่น PHP ที่ค่อนข้างเรียบง่ายในทางเทคนิค ดังนั้นหมายเหตุพื้นฐานในการใช้งานมีดังนี้:

แกะรุ่นล่าสุด
คัดลอก config-dist.php ไปยัง data/config.php + แก้ไขตามความต้องการของคุณ
ตรวจสอบให้แน่ใจว่าไดเร็กทอรี data สามารถเขียนได้
รูทของเว็บเซิร์ฟเวอร์ควรชี้ไปที่ไดเร็กทอรี public
รวม try_files $uri /index.php$is_args$query_string; ในบล็อกตำแหน่งของคุณหากคุณใช้ nginx
หรือปิดการใช้งานการเขียน URL ใหม่ (ดูตัวเลือก DISABLE_URL_REWRITING ใน data/config.php )
→ การเข้าสู่ระบบเริ่มต้นคือ admin ผู้ใช้ด้วยรหัสผ่าน admin กรุณาเปลี่ยนรหัสผ่านทันที (เมนูผู้ใช้ที่มุมขวาบน)

หรือโคลนที่เก็บนี้ (สาขา release จะอ้างอิงถึงเวอร์ชันที่ออกล่าสุดเสมอ) และติดตั้งการพึ่งพา Composer และ Yarn ด้วยตนเอง

ดูเว็บไซต์สำหรับคำแนะนำในการติดตั้งเพิ่มเติมและความช่วยเหลือในการแก้ไขปัญหา → https://grocy.info/links

การสนับสนุนแพลตฟอร์ม

PHP 8.2 หรือ 8.3 (พร้อม SQLite 3.34.0+)
ส่วนขยาย PHP ที่จำเป็น: fileinfo , pdo_sqlite , gd , ctype , intl , zlib , mbstring
คำแนะนำ: การทดสอบเกณฑ์มาตรฐานแสดงให้เห็นว่า เช่น การจัดการการแปลงหน่วยเร็วขึ้นถึง 5 เท่า เมื่อใช้ SQLite เวอร์ชันล่าสุด (3.39.4+)
Firefox, Chrome หรือ Edge ล่าสุด

วิธีรันโดยใช้ Docker

ดูคำแนะนำที่ grocy/grocy-docker หรือ linuxserver/docker-grocy

วิธีการอัพเดต

เขียนทับทุกสิ่งด้วยรีลีสล่าสุดโดยยังคงรักษาไดเร็กทอรี data ไว้
ตรวจสอบ config-dist.php เพื่อดูตัวเลือกการกำหนดค่าใหม่ และเพิ่มลงใน data/config.php ของคุณตามความเหมาะสม (ค่าเริ่มต้นจาก config-dist.php จะถูกนำมาใช้ในกรณีที่ไม่อยู่ในการตั้งค่าที่กำหนดของ data/config.php )
ล้างไดเร็กทอรี data/viewcache
เยี่ยมชมเส้นทางหลักหนึ่งครั้งเพื่อใช้การย้ายฐานข้อมูล (ดูด้านล่าง)

หากคุณเรียกใช้ Grocy บน Linux ก็จะมี update.sh ด้วย (อย่าลืมทำให้สคริปต์ทำงานได้ ( chmod +x update.sh ) และให้แน่ใจว่าคุณได้แตก unzip ไว้แล้ว) ซึ่งทำสิ่งนี้และสร้างการสำรองข้อมูลเพิ่มเติม ( ไฟล์เก็บถาวร .tgz ) ของการติดตั้งปัจจุบันใน data/backups (การสำรองข้อมูลที่เก่ากว่า 60 วันจะถูกลบออกในระหว่างการอัพเดต)

รองรับหลายภาษา

Grocy สามารถแปลเป็นภาษาท้องถิ่นได้อย่างสมบูรณ์ - ภาษาเริ่มต้นคือภาษาอังกฤษ (รวมเข้ากับรหัส) ฉันดูแลการแปลภาษาเยอรมันอยู่เสมอ

คุณสามารถช่วยแปล Grocy บน Transifex ได้อย่างง่ายดายหากภาษาของคุณไม่สมบูรณ์หรือยังไม่มีให้บริการ

ภาษาเริ่มต้นสามารถตั้งค่าได้ใน data/config.php เช่น Setting('DEFAULT_LOCALE', 'it'); และยังมีการตั้งค่าผู้ใช้ (ดูหน้าการตั้งค่าผู้ใช้) เพื่อตั้งค่าภาษาที่แตกต่างกันต่อผู้ใช้

การสาธิตก่อนเผยแพร่พร้อมใช้งานสำหรับการแปลใดๆ ที่เสร็จสมบูรณ์อย่างน้อย 70 % และจะดึงการแปลจาก Transifex ผ่านไป 10 นาทีทุกชั่วโมง ดังนั้นคุณจึงสามารถดูตัวอย่างการแปลที่คุณมีส่วนร่วมได้ทันที ขอบคุณ!

นอกจากนี้ การแปลใดๆ ที่เคยถึงระดับความสมบูรณ์ 70 % (ทรัพยากร strings ) จะถูกรวมไว้ในรุ่นต่างๆ

ขออภัย ยังไม่รองรับภาษา RTL

แรงจูงใจ

ครัวเรือนจะต้องมีการจัดการ ก่อนที่ Grocy ฉันทำสิ่งนี้ (เกือบ 10 ปี) โดยใช้ซอฟต์แวร์ที่เขียนเองตัวแรก (แอปพลิเคชันแบบฟอร์ม C# Windows) และแผ่นงาน Excel จำนวนมาก ซอฟต์แวร์นี้ใช้งานได้ยากในตอนท้ายและ Excel ก็คือ Excel ดังนั้นฉันจึงค้นหาและลองสิ่งต่างๆ เป็นเวลานาน (มาก) โดยไม่มีอะไรพอดี 100 % ดังนั้นนี่คือเป้าหมายของฉันสำหรับ "การจัดการครัวเรือนที่สมบูรณ์" ERP ตู้เย็นของคุณ!

เรื่องน่ารู้

ส่วนที่เหลือ API

ดูอินสแตนซ์ Swagger UI ที่ผสานรวมบน /api

ส่วนหน้าของเว็บใช้ API นี้กับทุกสิ่ง ดังนั้นทุกสิ่งที่คุณทำได้ก็สามารถทำได้ผ่าน API เช่นกัน

เครื่องอ่านบาร์โค้ดและการสแกนกล้อง

บางฟิลด์ (ที่มีไอคอนบาร์โค้ดด้านบน) ยังอนุญาตให้เลือกค่าโดยการสแกนบาร์โค้ดได้ จะทำงานได้ดีที่สุดเมื่อเครื่องอ่านบาร์โค้ดของคุณนำหน้าบาร์โค้ดทุกตัวด้วยตัวอักษรซึ่งปกติไม่ได้เป็นส่วนหนึ่งของชื่อรายการ (ฉันใช้ $ ) และส่ง TAB หลังจากการสแกน

นอกจากนี้คุณยังสามารถใช้กล้องของอุปกรณ์เพื่อสแกนบาร์โค้ดได้โดยใช้ปุ่มกล้องทางด้านขวาของฟิลด์ที่เกี่ยวข้อง (ขับเคลื่อนโดย Quagga2 ซึ่งเป็นการประมวลผลสตรีมกล้องฝั่งไคลเอ็นต์แบบออฟไลน์ทั้งหมด โปรดทราบเนื่องจากข้อจำกัดด้านความปลอดภัยของเบราว์เซอร์ สิ่งนี้ ใช้งานได้เฉพาะเมื่อให้บริการ Grocy ผ่านการเชื่อมต่อที่ปลอดภัย ( https:// )) วิดีโอสาธิตด่วน: https://www.youtube.com/watch?v=Y5YH6IJFnfc

คำแนะนำส่วนตัวของฉัน: ใช้เครื่องสแกนบาร์โค้ดเลเซอร์ USB มีราคาถูกและทำงานได้ดีขึ้น เร็วขึ้น 1,000 % ภายใต้ทุกสภาพแสงและจากทุกมุม

ป้อนชวเลขสำหรับช่องวันที่

ด้วยเหตุผล (ประสิทธิภาพการทำงาน) ช่องวันที่ (และเวลา) อินพุต (และการแสดงผล) ทั้งหมดใช้รูปแบบ ISO-8601 โดยไม่คำนึงถึงการแปล มีชวเลขดังต่อไปนี้:

MMDD จะถูกขยายเป็นวันที่กำหนดในปีปัจจุบัน ถ้า > วันนี้ หรือวันที่กำหนดในปีหน้า ถ้า < วันนี้ ในรูปแบบที่ถูกต้อง
ตัวอย่าง: 0517 จะถูกแปลงเป็น 2024-05-17
YYYYMMDD ได้รับการขยายเป็นสัญกรณ์ ISO-8601 ที่เหมาะสม
ตัวอย่าง: 20240417 จะถูกแปลงเป็น 2024-04-17
YYYYMMe หรือ YYYYMM+ ได้รับการขยายไปจนถึงสิ้นเดือนที่กำหนดในปีที่กำหนดในรูปแบบที่เหมาะสม
ตัวอย่าง: 202407e จะถูกแปลงเป็น 2024-07-31
[+/-]n[d/m/y] ได้รับการขยายเป็นวันที่สัมพันธ์กับวันนี้ ในขณะที่เพิ่ม ( + ) หรือลบ ( - ) จำนวน ของวัน ays/ m ใน วัน / y หูในรูปแบบที่ถูกต้อง
ตัวอย่าง: +1m จะถูกแปลงเป็นวันเดียวกันในเดือนหน้า
x ได้รับการขยายเป็น 2999-12-31 (ซึ่งเป็นนามแฝงของ "ไม่ค้างชำระ")
ปุ่มลูกศรลง/ขึ้นจะเพิ่ม/ลดวันที่ 1 วัน
ปุ่มลูกศรขวา/ซ้ายจะเพิ่ม/ลดวันที่ 1 สัปดาห์
Shift + ปุ่มลูกศรลง/ขึ้น จะเพิ่ม/ลดวันที่ 1 เดือน
Shift + ปุ่มลูกศรขวา/ซ้าย จะเพิ่ม/ลดวันที่ 1 ปี

แป้นพิมพ์ลัดสำหรับปุ่มต่างๆ

เมื่อใดก็ตามที่ปุ่มมีตัวอักษรที่เน้นด้วยตัวหนา นี่คือคีย์ลัด ตัวอย่าง: สามารถ "กด" ปุ่ม " P เพิ่มเป็นผลิตภัณฑ์ใหม่" ได้โดยใช้ปุ่ม P บนแป้นพิมพ์

การค้นหาบาร์โค้ดผ่านบริการภายนอก

สามารถเพิ่มผลิตภัณฑ์ลงในฐานข้อมูลได้โดยตรงโดยการค้นหาเทียบกับบริการภายนอกด้วยบาร์โค้ด

ซึ่งสามารถทำได้แบบแทนที่โดยใช้เวิร์กโฟลว์ตัวเลือกผลิตภัณฑ์ "การค้นหาบาร์โค้ดภายนอก (ผ่านปลั๊กอิน)" (กล่องโต้ตอบเวิร์กโฟลว์จะปรากฏขึ้นเมื่อป้อนสิ่งที่ไม่รู้จักในช่องป้อนข้อมูลผลิตภัณฑ์ใดๆ)

ไม่มีปลั๊กอินสำหรับบริการใดๆ โปรดดูการใช้งานอ้างอิงใน data/plugins/DemoBarcodeLookupPlugin.php

การย้ายฐานข้อมูล

การย้ายสคีมาฐานข้อมูลจะดำเนินการโดยอัตโนมัติเมื่อไปที่เส้นทางรูท ( / ) (คลิกที่โลโก้ที่ขอบด้านบนซ้าย)

โปรดทราบ: การย้ายฐานข้อมูลควรจะทำงานระหว่างรีลีส ไม่ใช่ระหว่างคอมมิตทุกครั้ง หากคุณต้องการรันสาขา master ปัจจุบัน (ซึ่งเป็นเวอร์ชันการพัฒนา) คุณต้องจัดการเรื่องนั้น (และอื่นๆ อีกมากมาย) ด้วยตัวเอง

ปิดการใช้งานคุณสมบัติบางอย่าง

หากคุณไม่ได้ใช้ชุดคุณสมบัติบางอย่างของ Grocy (เช่น หากคุณไม่ต้องการ "งานบ้าน") ก็จะมีการตั้งค่าสถานะคุณสมบัติตามคุณสมบัติหลักที่ตั้งค่าให้ซ่อน/ปิดการใช้งานองค์ประกอบ UI ที่เกี่ยวข้อง (ดู config-dist.php )

เพิ่ม CSS หรือ JS ของคุณเองโดยไม่ต้องแก้ไขแอปพลิเคชันเอง

เมื่อมีไฟล์ data/custom_js.html เนื้อหาของไฟล์จะถูกเพิ่มก่อน </body> (ส่วนท้ายของเนื้อหา) ในทุกหน้า
เมื่อมีไฟล์ data/custom_css.html อยู่แล้ว เนื้อหาของไฟล์จะถูกเพิ่มก่อน </head> (ส่วนท้ายของส่วนหัว) ในทุกหน้า

โหมดสาธิต

เมื่อตั้งค่า MODE เป็น dev , demo หรือ prerelease แอปพลิเคชันจะทำงานในโหมดสาธิต ซึ่งหมายความว่าการรับรองความถูกต้องถูกปิดใช้งาน และข้อมูลสาธิตบางส่วนจะถูกสร้างขึ้นในระหว่างการโยกย้ายสคีมาฐานข้อมูล (ส่งผ่านพารามิเตอร์แบบสอบถาม nodemodata เช่น https://grocy.example.com/?nodemodata เพื่อข้ามไป)

โหมดฝังตัว

เมื่อไฟล์ embedded.txt มีอยู่ ไฟล์นั้นจะต้องมีเส้นทางที่ถูกต้องและเขียนได้ ซึ่งจะใช้เป็นไดเร็กทอรีข้อมูลแทน data และการตรวจสอบสิทธิ์จะถูกปิดใช้งาน (ใช้ใน Grocy Desktop)

ในโหมดฝังตัว การตั้งค่าสามารถแทนที่ได้ด้วยไฟล์ข้อความใน data/settingoverrides ชื่อไฟล์จะต้องเป็น <SettingName>.txt (เช่น BASE_URL.txt ) และเนื้อหาจะต้องเป็นค่าการตั้งค่า (โดยปกติจะเป็นบรรทัดเดียว)