moox

Proyek Moox

Selamat datang di Proyek Moox. Ini adalah Aplikasi Laravel Monorepo dan dapat diinstal untuk mengembangkan Plugin Filament kami alias Paket Laravel. Kami sedang dalam tahap awal pengembangan tetapi sudah ada beberapa plugin yang mungkin Anda anggap berguna:

Paket

• Moox Skeleton, Paket Skeleton kami untuk membuat Plugin Filamen baru
• Moox Builder, Paket Builder kami untuk membuat Sumber Daya Filamen
• Moox Core, yang dibutuhkan oleh semua paket kami, mengirimkan hal-hal umum
• Moox Jobs, kelola Antrean Pekerjaan, Pekerjaan Gagal, dan Batch di Filamen

Beberapa diantaranya sudah digunakan secara produktif namun belum didokumentasikan:

• Moox Expiry, tentukan dan otomatiskan kedaluwarsa catatan Anda
• Perangkat Pengguna Moox, kelola perangkat pengguna Anda dan putuskan cara menangani yang tidak diketahui
• Sesi Pengguna Moox, kelola sesi pengguna Anda (juga dalam konteks perangkat)

Semua paket lainnya sedang dalam pengembangan keras:

• Audit Moox, logging dan audit, terkait keamanan dan terkait model
• Bendera Moox, Bendera berisi Ikon Pisau untuk negara, bahasa, dan lainnya
• Moox Temukan, negara, bahasa, mata uang, awalan negara, zona waktu
• Tautan Masuk Moox, kirimkan Tautan Masuk (alias tautan ajaib) ke pengguna Anda
• Moox Page, manajemen konten, saat ini ditinggalkan karena kami menggunakan Pers
• Moox Passkey, memberi pengguna kemampuan untuk menggunakan Passkeys (Webauthn)
• Izin Moox, kelola peran dan izin menggunakan Izin Spatie
• Moox Press, gunakan WordPress tanpa menggunakan WordPress, di Filament
• Model Moox Redis, gunakan Redis sebagai pengganti plug-in untuk model Anda
• Keamanan Moox, kelola keamanan kata sandi Anda dan fitur keamanan lainnya
• Moox Sync, menyinkronkan catatan dari server ke server, menambahkan logika dan transformator
• Pelatihan Moox, mengotomatiskan pelatihan, undangan, dan validasi diri
• Pengguna Moox, kelola pengguna Anda di Filament dan berikan pengguna akses ke profil mereka

Dan ada beberapa hal lain yang TIDAK ada di repo ini:

• Moox DevOps, Kelola Server Tempa, Situs, dan Penerapan Anda
• UI Server Cadangan Moox, UI Filamen untuk Server Cadangan Spatie Laravel
• Ekstensi Kode VS Moox, paket ekstensi kode VS kami untuk pengembang Filamen

Instalasi

Aplikasi Laravel dev di folder root Moox Monorepo dibuat untuk pengembangan instan dengan Laravel Herd, Laravel Valet, Laravel Sail atau 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

Hal-hal opsional:

 # 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

Admin Moox sekarang tersedia di /moox, misalnya https://moox.test/moox

Pers Moox

Untuk menginstal Moox Press, Anda memerlukan WordPress yang berjalan di /public/wp (atau subdirektori lain, dikonfigurasi di .env).

Instal WordPress baru

Untuk menginstal WordPress baru, kami menyediakan perintah artisan, yang dikirimkan bersama paket Moox Press:

php artisan mooxpress:wpinstall

Perintah ini memerlukan beberapa optimasi dan hanya berjalan "setengah" di Windows.

Paket khusus

Monorepo kami siap menjadi agen ganda:

• Kembangkan proyek swasta atau publik
• sambil berkontribusi pada proyek Moox

Hal ini dilakukan dengan mendukung paket khusus dalam aplikasi pengembangan Monorepo kami. Kedengarannya menarik? Baca di _custom/README.md.

Perkembangan

• Lakukan npm run build sebelum melakukan karena pengujian otomatis di GitHub memerlukan vite-manifest yang berfungsi
• Lakukan php artisan migrate --database=sqlite untuk mencerminkan perubahan pada database pengujian
• Gunakan https://marketplace.visualstudio.com/items?itemName=adrolli.tallui-laravel-livewire-tailwind dengan VS Code
• Gunakan https://github.com/mooxphp/builder untuk membuat paket Anda sendiri
• Silakan lihat KONTRIBUSI untuk rinciannya.

Percabangan

• main adalah versi stabil saat ini, dilindungi cabang, dikomit otomatis ke semua paket, disebarkan ke li
• feature/... harap awali semua cabang fitur, buat permintaan tarik Anda langsung ke main

Gunakan cabang berbasis masalah, awali dengan feature/ (misalnya feature/38-welcome-view) untuk pengujian otomatis dan analisis kode.

Berkomitmen

Pesan komit Anda akan digabungkan ke dalam Changelog.md, artinya pesan tersebut menjadi bagian dari dokumentasi. Tolong pastikan, kamu

• mulailah dengan salah satu dari jenis ini
  • Bump = perubahan versi minor, mayor jika digunakan sebagai Bump!
  • Clean = menghapus barang lama atau kode yang tidak terpakai
  • Deps = mengubah dependensi
  • Devops = GH dan otomatisasi
  • Dokumen = dokumentasi
  • Prestasi = fitur
  • Perbaiki = perbaikan bug
  • Lang = terjemahan
  • Tes = tes menulis
  • Wip = pekerjaan sedang berlangsung
• untuk perubahan yang dapat menyebabkan gangguan, tambahkan "!" ke jenis apa pun untuk membuat rilis besar
• diikuti dengan nama pendek paket, di []
  • Semua - beberapa atau semua paket
  • Repo - Hal monorepo
  • Inti
  • Pembangun
  • Pekerjaan
  • ...
• mereferensikan suatu terbitan, ditautkan berdasarkan nomor terbitan, misalnya #138
• siapkan penutupan otomatis masalah dengan menggunakan "Tutup #138"

Contoh yang valid

• 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

Baca selengkapnya tentang komitmen konvensional.

Tarik permintaan

Buat PR ke main . Gunakan komitmen konvensional seperti dijelaskan di atas.

Semver

Kami menggunakan versi semantik, ditulis seperti 1.2.3 untuk

1. Rilisan besar
2. Rilisan kecil
3. Rilis perbaikan bug

Kunjungi Semver.org untuk informasi lebih lanjut.

Rilis

Saat ini dilakukan secara manual, fitur rilis otomatis sedang dalam proses.

Pengujian

Kami menguji Moox menggunakan:

• Monorepo
  • Larastan, PHPStan Tingkat 5
  • Laravel Pint, Pemecah Masalah PHP CS
  • Iklim kodasi dan kode
• Paket
  • Larastan, PHPStan Tingkat 5
  • Laravel Pint, Pemecah Masalah PHP CS
  • Hama

Harap pastikan Anda menggunakan alat yang sama di VS Code (Paket Ekstensi VS Code kami mencakup hal ini) atau lakukan pemeriksaan secara manual sebelum melakukan ke cabang pengembang:

• PHPStan: composer analyse atau ./vendor/bin/phpstan analyse , untuk paket ../../vendor/bin/phpstan analyse
• Hama: composer test atau ./vendor/bin/pest , untuk paket ../../vendor/bin/pest
• Cakupan: composer test-coverage atau ./vendor/bin/pest --coverage , untuk paket ../../vendor/bin/pest --coverage
• Pint: composer format atau ./vendor/bin/pint , untuk paket ../../vendor/bin/pint

Navigasi Admin

Judul dan pengurutan di AdminPanel dapat disesuaikan dalam konfigurasi paket, tetapi ini adalah pengurutan default yang menjaga semuanya tetap pada tempatnya:

 - 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

Kontributor

Moox dibuat oleh orang-orang baik ini, dan bot ...

Alf Pengeboran ? ? ?️	Aziz Gasim ?️	KimSpeer ?️	Weblate (bot) ?	Bot Moox ?	Pegang kembali Jesse	FMorlock ? ?
Sam Bola ?	Kim Speer ?️ ️	Pergeseran Laravel ?	mikagrich	somogyi.zoltan	Igor Klaus	Greg RG
Allan Nordhoy ?	Jan Brot	Milo Ivir ?	Mika	Semua Kontributor ?	Freek Van der Herten ?	merenovasi[bot] ?
tindakan github[bot] ?	ketergantunganbot[bot] ?	Mikachu	simmon	Kalpesh Mahida	baris	Mark van den Broek
Sebastian De Deyne	Peter Forret	Ettore Atalan ?	p-paul	Salh

Tabel ini dibuat oleh Bot Semua Kontributor. Untuk menambahkan kontributor gunakan perintah berikut di setiap komentar terbitan atau PR:

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

Kami biasanya menggunakan "kode" dan "terjemahan", tetapi ada kemungkinan jenis lain yang tercantum di AllContributers.org. Harap lakukan hanya satu permintaan dalam satu waktu, karena kami akan mengalami konflik penggabungan jika Anda mencoba menambahkan beberapa kontributor tanpa menggabungkan PR di antaranya.

Menyumbang

Kami menyambut setiap kontribusi! Akan luar biasa jika Anda:

• Buat Masalah di Repo yang paling sesuai dan tambahkan informasi tentang masalah atau ide tersebut. Kami akan membalasnya dalam beberapa hari.
• Buat Pull Request di Monorepo ini. Harap jangan melakukan PR pada repo read-only kami, repo tersebut tidak siap untuk perubahan kode. Hanya monorepo yang memiliki gerbang kualitas dan pengujian otomatis.
• Terjemahkan Moox menggunakan Weblate.
• Beritahu orang lain tentang Moox atau tautkan ke kami.
• Pertimbangkan sumbangan atau sponsor.

Terjemahan

Moox diterjemahkan dengan Weblate. Tentu saja Anda juga dapat langsung mengedit file terjemahan dalam paket, tetapi menggunakan platform terjemahan berfitur lengkap seperti Weblate mungkin lebih nyaman.

Lisensi

Moox adalah perangkat lunak Open-Source gratis yang dilisensikan di bawah Lisensi MIT.

Beberapa proyek yang kami andalkan dirilis di bawah lisensi berbeda. Kami melakukan yang terbaik untuk memastikan bahwa lisensi ini mengizinkan penggunaan pribadi dan komersial dan tidak menerapkan batasan apa pun.

Jika Anda melihat ada masalah dengan lisensi Moox atau ketergantungan apa pun, silakan kirim email kepada kami di [email protected].

Keamanan

Seperti disebutkan di atas, kami menggunakan pemeriksaan kode otomatis dan audit keamanan untuk memastikan bahwa kode kami bebas dari kerentanan keamanan.

Baca Kebijakan Keamanan kami untuk mempelajari lebih lanjut tentang keamanan atau melaporkan potensi kerentanan. Harap JANGAN gunakan pelacak masalah untuk melaporkan masalah terkait keamanan.