invoiceninja

Faktur Ninja 5

Faktur Ninja Versi 5 telah hadir! Kami telah mengambil bagian terbaik dari versi 4 dan menambahkan fitur yang paling banyak diminta untuk membuat aplikasi faktur yang tiada duanya. Periksa Saluran YouTube Invoice Ninja untuk mendapatkan informasi terbaru, atau coba Demo sekarang.

Pilih pengaturan Anda

• Dihosting: Versi host kami adalah solusi Perangkat Lunak sebagai Layanan (SaaS). Anda siap menjalankannya dalam waktu kurang dari 5 menit, tanpa perlu khawatir tentang hosting atau infrastruktur server.
• Self-Hosted: Bagi mereka yang lebih suka mengelola hosting dan infrastruktur servernya sendiri. Versi ini memberi Anda kendali penuh dan fleksibilitas.

Semua fitur Pro dan Perusahaan dari aplikasi yang dihosting disertakan dalam kode sumber yang tersedia. Kami menawarkan lisensi label putih senilai $30 per tahun untuk menghapus merek Invoice Ninja dari bagian aplikasi yang berhubungan dengan klien.

Bersosialisasilah dengan kami

• Forum Dukungan
• Kendur
• Perselisihan
• Instagram

Dokumentasi

• Ninja Faktur - API
• Ninja Faktur - Panduan Pengembang
• Ninja Faktur - Panduan Pengguna
• Invoice Ninja - Panduan Instalasi yang Dihosting Sendiri

Opsi Instalasi dan Klien

Aplikasi Seluler

• iPhone
• Android
• F-Droid

Aplikasi Desktop

• macOS
• jendela
• Linux - Jepret
• Linux - Pak datar

Instalasi Server yang Dihosting Sendiri

Catatan: Opsi yang dihosting sendiri mendukung aplikasi desktop dan seluler.

• Server atau VM
• File buruh pelabuhan
• Cloudron
• Lembut
• Elestio
• YunoHost

Penyedia yang Direkomendasikan

• Garis
• Cap pos

[Lanjutan] Pengaturan Hosting Cepat

Selain Invoice Ninja - Panduan Instalasi yang Dihosting Sendiri, kami memiliki beberapa perintah untuk Anda.

git clone --single-branch --branch v5-stable https://github.com/invoiceninja/invoiceninja.git
cp .env.example .env
composer i -o --no-dev

Harap Dicatat: APP_KEY Anda di file .env digunakan untuk mengenkripsi data, jika Anda kehilangannya, Anda tidak akan dapat menjalankan aplikasi.

Jalankan jika Anda ingin memuat data sampel, ingatlah untuk mengkonfigurasi .env

php artisan migrate:fresh --seed && php artisan db:seed && php artisan ninja:create-test-data

Untuk menjalankan server web

php artisan serve 

Arahkan ke (ganti localhost dengan domain yang sesuai)

 http://localhost:8000/setup - To setup your configuration if you did not load sample data.
http://localhost:8000/ - For Administrator Logon

user: [email protected]
pass: password

http://localhost:8000/client/login - For Client Portal

user: [email protected]
pass: password

Panduan Pengembang

Selain Invoice Ninja - Panduan Pengembang resmi, kami siap membantu Anda dengan beberapa wawasan.

Desain Aplikasi

API dan portal klien telah dikembangkan menggunakan Laravel. Jika Anda ingin berkontribusi pada proyek ini, keakraban dengan Laravel sangatlah penting.

Saat memeriksa fungsionalitas API, tempat terbaik untuk memulai adalah di file rute/api.php yang menjelaskan semua titik akhir API yang tersedia. Metode pengontrol kemudian menjelaskan semua titik masuk ke setiap domain aplikasi, yaitu InvoiceController / QuoteController

Permintaan API rata-rata mengikuti jalur ini ke dalam aplikasi.

• Middleware memproses permintaan pada awalnya dengan memeriksa domain yang diminta + menyediakan lapisan otentikasi.
• Permintaan tersebut kemudian masuk ke Formulir Permintaan (Jenis yang ditunjukkan dalam metode pengontrol) yang digunakan untuk memberikan otorisasi dan juga validasi permintaan. Jika berhasil, permintaan tersebut kemudian diteruskan ke metode pengontrol tempat ia dicerna, berikut contohnya:

 public function store ( StoreInvoiceRequest $ request )
{

    $ invoice = $ this -> invoice_repo -> save ( $ request -> all (), InvoiceFactory:: create ( auth ()-> user ()-> company ()-> id , auth ()-> user ()-> id ));

    $ invoice = $ invoice -> service ()
                        -> fillDefaults ()
                        -> triggeredActions ( $ request )
                        -> adjustInventory ()
                        -> save ();

    event ( new InvoiceWasCreated ( $ invoice , $ invoice -> company , Ninja:: eventVars ( auth ()-> user () ? auth ()-> user ()-> id : null )));

    return $ this -> itemResponse ( $ invoice );

}

Di sini misalnya kami menyimpan faktur baru, kami meneruskan permintaan yang divalidasi bersama dengan pabrik ke dalam penyimpanan faktur tempat permintaan tersebut diproses dan disimpan.

Faktur yang dikembalikan kemudian melewati kelas layanannya (aplikasi/Layanan/Faktur) tempat berbagai tindakan dilakukan.

Sebuah peristiwa kemudian diaktifkan yang memberi tahu pendengar dalam aplikasi (aplikasi/Penyedia/EventServiceProvider) yang melakukan sub tugas non-pemblokiran

Akhirnya faktur diubah (aplikasi/Transformers/) dan dikembalikan sebagai respons melalui Fraktal.

Lingkungan pengembang

Dengan menggunakan Quick Hosting Setup yang dijelaskan di atas, Anda dapat dengan cepat mulai membangun lingkungan pengembangan Anda. Daripada menggunakan

 composer i -o --no-dev

menggunakan

 composer i -o

Ini menyediakan alat pengembang termasuk phpunit yang memungkinkan rangkaian pengujian dijalankan.

Jika Anda mempertimbangkan untuk berkontribusi kembali ke repositori utama, silakan tambahkan pengujian apa pun untuk fungsionalitas/modifikasi baru. Ini akan sangat meningkatkan peluang PR Anda diterima

Selain itu, jika Anda merencanakan penambahan apa pun untuk repositori utama, Anda mungkin ingin mendiskusikan hal ini dengan kami terlebih dahulu di Slack di mana kami dapat membantu dengan informasi teknis dan memberikan saran.

Kredit

• Hillel Coren
• David Bomba
• Benjamin Beganović
• Semua Kontributor

Keamanan

Jika Anda menemukan masalah keamanan pada aplikasi ini, silakan kirim email ke [email protected]. Harap ikuti prosedur pengungkapan yang bertanggung jawab jika Anda mendeteksi suatu masalah. Untuk informasi lebih lanjut mengenai pengungkapan yang bertanggung jawab, silakan baca di sini.

Lisensi

Invoice Ninja dirilis di bawah Lisensi Elastis.
Lihat LISENSI untuk detailnya.