
發票忍者第 5 版現已推出!我們採用了版本 4 的最佳部分,並添加了最需要的功能來創建獨一無二的發票應用程式。查看 Invoice Ninja YouTube 頻道以了解最新情況,或立即嘗試示範。
選擇您的設定
託管應用程式的所有專業版和企業版功能都包含在可用原始程式碼中。我們提供每年 30 美元的白標許可證,用於從應用程式面向客戶的部分中刪除 Invoice Ninja 品牌。
注意:自架選項確實支援桌面和行動應用程式。
除了官方 Invoice Ninja - 自架安裝指南外,我們還為您提供了一些命令。
git clone --single-branch --branch v5-stable https://github.com/invoiceninja/invoiceninja.git
cp .env.example .env
composer i -o --no-dev請注意:.env 檔案中的 APP_KEY 用於加密數據,如果遺失,您將無法運行該應用程式。
如果要載入範例數據,請運行,記得配置.env
php artisan migrate:fresh --seed && php artisan db:seed && php artisan ninja:create-test-data運行網路伺服器
php artisan serve 導航至(將 localhost 替換為適當的網域)
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
除了官方的發票忍者 - 開發人員指南外,我們還為您提供了一些見解。
API 和客戶端入口網站是使用 Laravel 開發的,如果您希望為此專案做出貢獻,那麼熟悉 Laravel 至關重要。
檢查 API 的功能時,最好的起點是在 paths/api.php 檔案中,該檔案描述了所有可用的 API 端點。然後控制器方法描述應用程式每個網域的所有入口點,即 InvoiceController / QuoteController
一般的 API 請求都會沿著此路徑進入應用程式。
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 );
}例如,我們正在儲存一張新發票,我們將經過驗證的請求與工廠一起傳遞到發票儲存庫中,並在其中進行處理和保存。
然後,返回的發票通過其服務類別(應用程式/服務/發票),在其中執行各種操作。
然後觸發一個事件,通知應用程式 (app/Providers/EventServiceProvider) 中執行非阻塞子任務的偵聽器
最後,發票被轉換(app/Transformers/)並透過 Fractal 作為回應返回。
使用上述快速託管設置,您可以快速開始建立您的開發環境。而不是使用
composer i -o --no-dev
使用
composer i -o
這提供了開發人員工具,包括允許運行測試套件的 phpunit。
如果您正在考慮向主存儲庫做出貢獻,請添加新功能/修改的任何測試。這將大大增加你的PR被接受的機會
此外,如果您打算為主儲存庫添加任何內容,您可能需要先在 Slack 上與我們討論,我們可以在其中提供任何技術資訊並提供建議。
如果您發現此應用程式有安全問題,請發送電子郵件至 [email protected]。如果您發現問題,請遵循負責任的揭露程序。有關負責任披露的更多信息,請閱讀此處。
Invoice Ninja 是在 Elastic 許可證下發布的。
有關詳細信息,請參閱許可證。