moox

โครงการม็อกซ์

ยินดีต้อนรับสู่โครงการ Moox นี่คือ Monorepo และแอป Laravel ที่สามารถติดตั้งได้เพื่อพัฒนา Filament Plugins หรือที่เรียกว่าแพ็คเกจ Laravel เราอยู่ในขั้นเริ่มต้นของการพัฒนา แต่มีปลั๊กอินบางตัวที่คุณอาจพิจารณาว่ามีประโยชน์อยู่แล้ว:

แพ็คเกจ

• Moox Skeleton แพ็คเกจ Skeleton ของเราเพื่อสร้างปลั๊กอิน Filament ใหม่
• Moox Builder แพ็คเกจตัวสร้างของเราเพื่อสร้างทรัพยากรเส้นใย
• Moox Core ซึ่งเป็นที่ต้องการในแพ็คเกจทั้งหมดของเรา จัดส่งสิ่งของทั่วไป
• Moox Jobs จัดการคิวงาน งานที่ล้มเหลว และแบทช์ในเส้นใย

บางส่วนอยู่ในการใช้งานอย่างมีประสิทธิผลแต่ยังไม่ได้จัดทำเป็นเอกสาร:

• Moox Expiry กำหนดและทำให้การหมดอายุของบันทึกของคุณเป็นแบบอัตโนมัติ
• อุปกรณ์ผู้ใช้ Moox จัดการอุปกรณ์ของผู้ใช้ของคุณและตัดสินใจว่าจะจัดการกับสิ่งที่ไม่รู้จักอย่างไร
• เซสชันผู้ใช้ Moox จัดการเซสชันผู้ใช้ของคุณ (รวมถึงในบริบทของอุปกรณ์ด้วย)

แพ็คเกจอื่นๆ ทั้งหมดอยู่ระหว่างการพัฒนาอย่างหนัก:

• Moox Audit การบันทึกและการตรวจสอบ ที่เกี่ยวข้องกับความปลอดภัย และที่เกี่ยวข้องกับโมเดล
• Moox Flags, Flags มีไอคอน Blade สำหรับประเทศ ภาษา และอื่นๆ
• Moox ค้นหา ประเทศ ภาษา สกุลเงิน คำนำหน้าประเทศ เขตเวลา
• ลิงก์เข้าสู่ระบบ Moox ส่งลิงก์เข้าสู่ระบบ (หรือที่เรียกว่าลิงก์วิเศษ) ให้กับผู้ใช้ของคุณ
• Moox Page การจัดการเนื้อหา ปัจจุบันถูกละทิ้ง เนื่องจากเราใช้ Press
• Moox Passkey ให้ผู้ใช้สามารถใช้ Passkeys (Webauthn)
• การอนุญาต Moox จัดการบทบาทและการอนุญาตโดยใช้การอนุญาต Spatie
• Moox Press ใช้ WordPress โดยไม่ต้องใช้ WordPress ใน Filament
• รุ่น Moox Redis ใช้ Redis เป็นตัวทดแทนปลั๊กอินสำหรับรุ่นของคุณ
• Moox Security จัดการความปลอดภัยของรหัสผ่านและคุณสมบัติความปลอดภัยอื่น ๆ
• Moox Sync ซิงค์บันทึกจากเซิร์ฟเวอร์หนึ่งไปยังอีกเซิร์ฟเวอร์ เพิ่มตรรกะและตัวแปลง
• การฝึกอบรม Moox การฝึกอบรมอัตโนมัติ การเชิญ และการตรวจสอบตนเอง
• ผู้ใช้ Moox จัดการผู้ใช้ของคุณใน Filament และให้ผู้ใช้เข้าถึงโปรไฟล์ของพวกเขา

และมีสิ่งอื่น ๆ ที่ไม่อยู่ใน repo นี้:

• Moox DevOps จัดการเซิร์ฟเวอร์ Forge ไซต์ และการปรับใช้ของคุณ
• Moox Backup Server UI, Filament UI สำหรับเซิร์ฟเวอร์สำรองข้อมูล Spatie Laravel
• Moox VS Code Extensions ชุดส่วนขยายโค้ด VS ของเราสำหรับนักพัฒนา Filament

การติดตั้ง

แอพ Laravel dev ในโฟลเดอร์รูทของ Moox Monorepo สร้างขึ้นเพื่อการพัฒนาทันทีด้วย Laravel Herd, Laravel Valet, Laravel Sail หรือ Laragon

 # Create a .env file and adjust to your needs
cp .env.example .env

# Don't forget to create the database according .env

# Install via Composer
composer install

# Migrate and seed
php artisan migrate:fresh --seed

# Use Vite (for Laravel Sail on Windows: do it in Ubuntu, not inside the Sail container)
npm install
npm run dev

สิ่งที่ไม่จำเป็น:

 # You can create a user then
php artisan make:filament-user

# You can use the custom composer.json
cp _custom/composer.json-example _custom/composer.json

# Run Sail (alternatively start Herd,Laragon or Valet)
./vendor/bin/sail up

# Rebuild the sail config if needed
./vendor/bin/sail down --rmi all -v
php artisan sail:install

# Remove broken symlinks if needed
# switching from Laragon to Sail for example
rm -Rf vendor/mooxphp

ขณะนี้ Moox Admin มีให้บริการที่ /moox เช่น https://moox.test/moox

สำนักพิมพ์ม็อกซ์

หากต้องการติดตั้ง Moox Press คุณต้องมี WordPress ที่ทำงานอยู่ใน /public/wp (หรือไดเร็กทอรีย่อยอื่นที่กำหนดค่าเป็น .env)

ติดตั้ง WordPress ใหม่

ในการติดตั้ง WordPress ใหม่ เรามีคำสั่งช่างฝีมือซึ่งมาพร้อมกับแพ็คเกจ Moox Press:

php artisan mooxpress:wpinstall

คำสั่งต้องการการปรับให้เหมาะสมและรันเพียง "ครึ่ง" บน Windows

แพ็คเกจแบบกำหนดเอง

Monorepo ของเราเตรียมพร้อมที่จะเป็นตัวแทนคู่:

• พัฒนาโครงการส่วนตัวหรือสาธารณะ
• ในขณะที่มีส่วนร่วมในโครงการ Moox

ทำได้โดยการรองรับแพ็คเกจแบบกำหนดเองในแอปการพัฒนาของ Monorepo ของเรา ฟังดูน่าสนใจใช่ไหม? อ่านบน _custom/README.md

การพัฒนา

• อย่า npm run build ก่อนที่จะคอมมิต เนื่องจากการทดสอบอัตโนมัติบน GitHub จำเป็นต้องมี vite-manifest ที่ใช้งานได้
• ทำ php artisan migrate --database=sqlite เพื่อสะท้อนการเปลี่ยนแปลงในฐานข้อมูลทดสอบ
• ใช้ https://marketplace.visualstudio.com/items?itemName=adrolli.tallui-laravel-livewire-tailwind กับโค้ด VS
• ใช้ https://github.com/mooxphp/builder เพื่อสร้างแพ็คเกจของคุณเอง
• โปรดดูการมีส่วนร่วมเพื่อดูรายละเอียด

การแตกแขนง

• main เป็นเวอร์ชันเสถียรปัจจุบัน มีการป้องกันสาขา คอมมิตกับแพ็คเกจทั้งหมดโดยอัตโนมัติ และปรับใช้กับ li
• feature/... โปรดนำหน้าสาขาคุณลักษณะทั้งหมด สร้างคำขอดึงของคุณไปที่หลักโดยตรง

ใช้สาขาที่อิงตามปัญหา นำหน้าด้วย Feature/ (เช่น Feature/38-welcome-view) สำหรับการทดสอบอัตโนมัติและการวิเคราะห์โค้ด

มุ่งมั่น

ข้อความยืนยันของคุณจะถูกรวมเข้ากับ Changelog.md ซึ่งหมายความว่าข้อความเหล่านั้นจะกลายเป็นส่วนหนึ่งของเอกสารประกอบ โปรดแน่ใจนะคุณ

• เริ่มต้นด้วยประเภทใดประเภทหนึ่งเหล่านี้
  • Bump = การเปลี่ยนแปลงเวอร์ชันรอง, สำคัญหากใช้เป็น Bump!
  • Clean = ลบของเก่าหรือโค้ดที่ไม่ได้ใช้
  • Deps = การเปลี่ยนแปลงการพึ่งพา
  • Devops = GH และระบบอัตโนมัติ
  • เอกสาร = เอกสาร
  • ความสำเร็จ = คุณลักษณะ
  • แก้ไข = แก้ไขข้อบกพร่อง
  • หลาง = การแปล
  • การทดสอบ = การทดสอบการเขียน
  • Wip = งานอยู่ระหว่างดำเนินการ
• สำหรับการทำลายการเปลี่ยนแปลงให้เพิ่ม "!" ทุกประเภทเพื่อสร้างการเปิดตัวครั้งสำคัญ
• ตามด้วยชื่อย่อของแพ็คเกจใน []
  • ทั้งหมด - หลายแพ็คเกจหรือทั้งหมด
  • Repo - สิ่ง Monorepo
  • แกนกลาง
  • ช่างก่อสร้าง
  • งาน
  • -
• อ้างอิงถึงปัญหา เชื่อมโยงกันด้วยหมายเลขประเด็น เช่น #138
• เตรียมการปิดปัญหาอัตโนมัติโดยใช้ "ปิด #138"

ตัวอย่างที่ถูกต้อง

• Wip[Core]: Feature register assets wip #123
• Fix[All]: Update all packages Close #321
• Feat[Monorepo]: Update dev app Close #22
• Bump![ChartComponents]: Major Updates
• Feat![PackageBuilder]: This will become a major release #23

อ่านเพิ่มเติมเกี่ยวกับการคอมมิตแบบเดิมๆ

ดึงคำขอ

สร้าง PR เพื่อ main . ใช้คอมมิตแบบเดิมๆ ตามที่อธิบายไว้ข้างต้น

เซมเวอร์

เราใช้การกำหนดเวอร์ชันเชิงความหมาย ซึ่งเขียนเหมือน 1.2.3 สำหรับ

1. การเปิดตัวที่สำคัญ
2. การเปิดตัวเล็กน้อย
3. เผยแพร่การแก้ไขข้อผิดพลาด

เยี่ยมชม Semver.org สำหรับข้อมูลเพิ่มเติม

ข่าวประชาสัมพันธ์

ขณะนี้ดำเนินการด้วยตนเอง คุณลักษณะการเผยแพร่อัตโนมัติกำลังดำเนินการอยู่

การทดสอบ

เราทดสอบ Moox โดยใช้:

• โมโนเรโป
  • ลาราสถาน, PHPStan ระดับ 5
  • Laravel Pint ผู้ให้บริการ PHP CS
  • สภาพภูมิอากาศของ Codacy และ Code
• แพ็คเกจ
  • ลาราสถาน, PHPStan ระดับ 5
  • Laravel Pint ผู้ให้บริการ PHP CS
  • ศัตรูพืช

โปรดตรวจสอบให้แน่ใจว่าคุณใช้เครื่องมือเดียวกันใน VS Code (ชุดส่วนขยายรหัส VS ของเราครอบคลุมเรื่องนี้) หรือทำการตรวจสอบด้วยตนเองก่อนดำเนินการกับสาขา dev:

• PHPStan: composer analyse หรือ ./vendor/bin/phpstan analyse สำหรับแพ็คเกจ ../../vendor/bin/phpstan analyse
• ศัตรูพืช: composer test หรือ ./vendor/bin/pest pest สำหรับแพ็คเกจ ../../vendor/bin/pest
• ความครอบคลุม: composer test-coverage หรือ ./vendor/bin/pest --coverage สำหรับแพ็คเกจ ../../vendor/bin/pest --coverage
• Pint: composer format หรือ ./vendor/bin/pint pint สำหรับแพ็คเกจ ../../vendor/bin/pint

การนำทางของผู้ดูแลระบบ

ชื่อและการเรียงลำดับใน AdminPanel สามารถปรับได้ในการกำหนดค่าแพ็คเกจ แต่นี่คือการเรียงลำดับเริ่มต้นที่จะเก็บทุกอย่างไว้:

 - Dashboard
- Main - 1000
    - Expiry - 1100
    - Notifications - 1800
- Content - 2000
    - Posts - 2100
    - Pages - 2200
    - Media - 2300
    - Categories - 2400
    - Tags - 2500
    - Comments - 2600
- Custom - 3000
    - ...
- Meta - 4000
    - Wp Meta...
- Custom - 5000
    - ...
- Users - 6000
    - App users - 6010 (Moox Users, Moox Press Users 6015)
    - Site users - 6020
    - Customers - 6030
    - Registrations - 6100
    - Roles - 6200
    - Permissions - 6201
    - Devices - 6300
    - Sessions - 6400
    - Login-Links - 6500
    - Password-Tokens - 6600
    - Passkeys - 6700
- System - 7000
    - Audit - 7500
    - Options (Press) - 7900
- Jobs - 8000
    - Job manager - 8001
    - ...
- Tools - 9000
    - Sync - 9500
    - Backup - 9800
    - Builder - 9990

ผู้ร่วมให้ข้อมูล

Moox สร้างโดยคนดีๆ เหล่านี้ และบอท ...

อัลฟ์ ดรอลลิงเจอร์ - - ?	อาซิซ กาซิม ?	คิมสเปียร์ ?	เว็บเลท (บอท) -	ม็อกซ์บอท -	ไรน์โฮลด์ เจสซี่	เอฟมอร์ล็อค - -
แซม โบลา -	คิม สเปียร์ ?	ลาร์ราเวลชิฟต์ -	มิคากริช	somogyi.zoltan	อิกอร์ คลอส	เกร็ก อาร์จี
อัลลัน นอร์ดเฮย -	จานา บรอท	มิโล อิเวียร์ -	มิก้า	ผู้ร่วมให้ข้อมูลทั้งหมด -	ฟรีค ฟาน เดอร์ แฮร์เทน -	ปรับปรุงใหม่[บอท] -
GitHub การกระทำ [บอท] -	ขึ้นอยู่กับบอท[บอท] -	มิคาชู	ซิมมอน	กัลเปช มหิดา	โรว์ลิน	มาร์ก ฟาน เดน บรุค
เซบาสเตียน เดอ ไดน์	ปีเตอร์ ฟอร์เร็ต	เอตโตเร่ อตาลัน -	พี-พอล	ซาลห์

ตารางนี้สร้างโดย Bot ผู้ร่วมให้ข้อมูลทั้งหมด หากต้องการเพิ่มผู้มีส่วนร่วม ให้ใช้คำสั่งต่อไปนี้ในความคิดเห็นของปัญหาหรือการประชาสัมพันธ์:

@all-contributors please add @github-user for code

โดยทั่วไปเราใช้ "โค้ด" และ "การแปล" แต่มีประเภทที่เป็นไปได้อื่นๆ ที่แสดงอยู่ใน AllContributers.org โปรดดำเนินการคำขอครั้งละ 1 รายการเท่านั้น เนื่องจากเราจะพบข้อขัดแย้งในการรวมหากคุณพยายามเพิ่มผู้ร่วมให้ข้อมูลหลายรายโดยไม่รวม PR เข้าด้วยกัน

มีส่วนช่วย

เรายินดีรับทุกการมีส่วนร่วม! มันจะยอดเยี่ยมมากหากคุณ:

• สร้างปัญหาใน Repo ที่เหมาะสมที่สุดและเพิ่มข้อมูลเกี่ยวกับปัญหาหรือแนวคิด เราจะตอบกลับภายในสองสามวัน
• สร้างคำขอดึงใน Monorepo นี้ โปรดอย่าประชาสัมพันธ์ repos แบบอ่านอย่างเดียวของเรา เนื่องจากไม่ได้เตรียมไว้สำหรับการเปลี่ยนแปลงโค้ด มีเพียง monorepo เท่านั้นที่มีประตูคุณภาพและการทดสอบอัตโนมัติ
• แปล Moox โดยใช้ Weblate
• บอกคนอื่นเกี่ยวกับ Moox หรือลิงก์มาหาเรา
• พิจารณาการบริจาคหรือการสนับสนุน

การแปล

Moox แปลด้วย Weblate แน่นอนว่าคุณสามารถแก้ไขไฟล์การแปลในแพ็คเกจได้โดยตรง แต่การใช้แพลตฟอร์มการแปลที่มีคุณสมบัติครบถ้วนเช่น Weblate อาจสะดวกกว่า

ใบอนุญาต

Moox เป็นซอฟต์แวร์โอเพ่นซอร์สฟรีที่ได้รับอนุญาตภายใต้ใบอนุญาต MIT

บางโครงการที่เราพึ่งพานั้นได้รับการเผยแพร่ภายใต้ใบอนุญาตที่แตกต่างกัน เราพยายามอย่างเต็มที่เพื่อให้แน่ใจว่าใบอนุญาตเหล่านี้อนุญาตให้ใช้ทั้งแบบส่วนตัวและเชิงพาณิชย์ และไม่มีการกำหนดข้อจำกัดใดๆ

หากคุณสังเกตเห็นปัญหาใดๆ เกี่ยวกับสิทธิ์การใช้งาน Moox หรือการพึ่งพาใดๆ โปรดส่งอีเมลถึงเราที่ [email protected]

ความปลอดภัย

ตามที่กล่าวไว้ข้างต้น เราใช้การตรวจสอบโค้ดอัตโนมัติและการตรวจสอบความปลอดภัยเพื่อให้แน่ใจว่าโค้ดของเราไม่มีช่องโหว่ด้านความปลอดภัย

อ่านนโยบายความปลอดภัยของเราเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับการรักษาความปลอดภัยหรือรายงานช่องโหว่ที่อาจเกิดขึ้น กรุณาอย่าใช้เครื่องมือติดตามปัญหาในการรายงานปัญหาที่เกี่ยวข้องกับความปลอดภัย