[APP] Invoice Ninja

apps/invoice-ninja/config.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "../schema.json",
+  "name": "Invoice Ninja",
+  "port": 8881,
+  "available": true,
+  "exposable": true,
+  "id": "invoice-ninja",
+  "tipi_version": 1,
+  "version": "1.25",
+  "categories": [
+    "finance"
+  ],
+  "description": "Invoice Ninja is an invoicing application which makes sending invoices and receiving payments simple and easy. Our latest version is a clean slate rewrite of our popular invoicing application which builds on the existing feature set and adds a wide range of features and enhancements the community has asked for.",
+  "short_desc": "Invoices, Expenses and Tasks built with Laravel, Flutter and React.",
+  "author": "https://www.invoiceninja.org/",
+  "source": "https://github.com/invoiceninja/invoiceninja",
+  "form_fields": [
+    {
+      "type": "email",
+      "label": "Invoice Ninja User Mail",
+      "required": true,
+      "env_variable": "INVOICE_NINJA_USER_MAIL"
+    },
+    {
+      "type": "password",
+      "label": "Invoice Ninja User Password",
+      "required": true,
+      "env_variable": "INVOICE_NINJA_USER_PASSWORD"
+    },
+    {
+      "type": "random",
+      "label": "MySQL Password",
+      "min": 32,
+      "env_variable": "INVOICE_NINJA_BDD_PASSWORD"
+    },
+    {
+      "type": "text",
+      "label": "Invoice Ninja Application Key (Must be generated with the following command `docker run --rm -it invoiceninja/invoiceninja php artisan key:generate --show`)",
+      "required": true,
+      "env_variable": "INVOICE_NINJA_APP_KEY"
+    }
+  ],
+  "supported_architectures": [
+    "amd64"
+  ]
+}

apps/invoice-ninja/data/init/init.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+mkdir -p /tmp/data/storage /tmp/data/public
+chmod 755 /tmp/data/public
+chown -R 1500:1500 /tmp/data/php /tmp/data/public /tmp/data/storage

apps/invoice-ninja/data/nginx/invoice-ninja.conf

@@ -0,0 +1,36 @@
+server {
+    listen 80 default_server;
+
+    server_tokens off;
+
+    client_max_body_size 100M;
+
+    root /var/www/app/public/;
+    index index.php;
+
+    location / {
+        try_files $uri $uri/ /index.php?$query_string;
+    }
+
+    location /healthcheck {
+        return 200;
+    }
+
+    location = /favicon.ico { access_log off; log_not_found off; }
+    location = /robots.txt  { access_log off; log_not_found off; }
+
+    location ~* /storage/.*\.php$ {
+        return 503;
+    }
+
+    location ~ \.php$ {
+        fastcgi_split_path_info ^(.+\.php)(/.+)$;
+        fastcgi_pass invoice-ninja-server:9000;
+        fastcgi_index index.php;
+        include fastcgi_params;
+        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+        fastcgi_intercept_errors off;
+        fastcgi_buffer_size 16k;
+        fastcgi_buffers 4 16k;
+    }
+}

apps/invoice-ninja/data/php/php-cli.ini

@@ -0,0 +1,18 @@
+session.auto_start = Off
+short_open_tag = Off
+
+error_reporting = E_ALL & ~E_NOTICE & ~E_WARNING & ~E_STRICT & ~E_DEPRECATED
+
+; opcache.enable_cli=1
+; opcache.fast_shutdown=1
+; opcache.memory_consumption=256
+; opcache.interned_strings_buffer=8
+; opcache.max_accelerated_files=4000
+; opcache.revalidate_freq=60
+; # http://symfony.com/doc/current/performance.html
+; realpath_cache_size = 4096K
+; realpath_cache_ttl = 600
+
+memory_limit = 2G
+post_max_size = 60M
+upload_max_filesize = 50M

apps/invoice-ninja/data/php/php.ini

@@ -0,0 +1,21 @@
+session.auto_start = Off
+short_open_tag = Off
+
+error_reporting = E_ALL & ~E_NOTICE & ~E_WARNING & ~E_STRICT & ~E_DEPRECATED
+
+; opcache.enable=1
+; opcache.preload=/srv/www/invoiceninja/current/preload.php
+; opcache.preload_user=www-data
+
+; ; The OPcache shared memory storage size.
+; opcache.max_accelerated_files=300000
+; opcache.validate_timestamps=1
+; opcache.revalidate_freq=30
+; opcache.jit_buffer_size=256M
+; opcache.jit=1205
+; opcache.memory_consumption=1024M
+
+
+post_max_size = 60M
+upload_max_filesize = 50M
+memory_limit=512M

apps/invoice-ninja/docker-compose.yml

@@ -0,0 +1,102 @@
+version: "3.9"
+
+services:
+  invoice-ninja:
+    image: nginx:1.25
+    container_name: invoice-ninja
+    restart: unless-stopped
+    volumes:
+      - ${APP_DATA_DIR}/data/nginx/invoice-ninja.conf:/etc/nginx/conf.d/default.conf:ro
+      - ${APP_DATA_DIR}/data/public:/var/www/app/public:ro
+    depends_on:
+      invoice-ninja-server:
+        condition: service_started
+    ports:
+      - ${APP_PORT}:80
+    networks:
+      - tipi_main_network
+    labels:
+      # Main
+      traefik.enable: true
+      traefik.http.middlewares.invoice-ninja-web-redirect.redirectscheme.scheme: https
+      traefik.http.services.invoice-ninja.loadbalancer.server.port: 80
+      # Web
+      traefik.http.routers.invoice-ninja-insecure.rule: Host(`${APP_DOMAIN}`)
+      traefik.http.routers.invoice-ninja-insecure.entrypoints: web
+      traefik.http.routers.invoice-ninja-insecure.service: invoice-ninja
+      traefik.http.routers.invoice-ninja-insecure.middlewares: invoice-ninja-web-redirect
+      # Websecure
+      traefik.http.routers.invoice-ninja.rule: Host(`${APP_DOMAIN}`)
+      traefik.http.routers.invoice-ninja.entrypoints: websecure
+      traefik.http.routers.invoice-ninja.service: invoice-ninja
+      traefik.http.routers.invoice-ninja.tls.certresolver: myresolver
+      # Local domain
+      traefik.http.routers.invoice-ninja-local-insecure.rule: Host(`invoice-ninja.${LOCAL_DOMAIN}`)
+      traefik.http.routers.invoice-ninja-local-insecure.entrypoints: web
+      traefik.http.routers.invoice-ninja-local-insecure.service: invoice-ninja
+      traefik.http.routers.invoice-ninja-local-insecure.middlewares: invoice-ninja-web-redirect
+      # Local domain secure
+      traefik.http.routers.invoice-ninja-local.rule: Host(`invoice-ninja.${LOCAL_DOMAIN}`)
+      traefik.http.routers.invoice-ninja-local.entrypoints: websecure
+      traefik.http.routers.invoice-ninja-local.service: invoice-ninja
+      traefik.http.routers.invoice-ninja-local.tls: true
+
+  invoice-ninja-server:
+    image: invoiceninja/invoiceninja:5.8.2
+    container_name: invoice-ninja-server
+    restart: unless-stopped
+    user: 1500:1500
+    environment:
+      - IN_USER_EMAIL=${INVOICE_NINJA_USER_MAIL}
+      - IN_PASSWORD=${INVOICE_NINJA_USER_PASSWORD}
+      - APP_URL=http://invoice-ninja
+      - APP_KEY=${INVOICE_NINJA_APP_KEY}
+      - APP_CIPHER=AES-256-CBC
+      - DB_HOST=invoice-ninja-db
+      - DB_PORT=3306
+      - DB_DATABASE=ninja
+      - DB_USERNAME=ninja
+      - DB_PASSWORD=ninja
+      - REQUIRE_HTTPS=false
+      - QUEUE_CONNECTION=database
+      - IS_DOCKER=TRUE
+    volumes:
+      - ${APP_DATA_DIR}/data/public:/var/www/app/public:rw,delegated
+      - ${APP_DATA_DIR}/data/storage:/var/www/app/storage:rw,delegated
+      - ${APP_DATA_DIR}/data/php/php.ini:/usr/local/etc/php/php.ini:ro
+      - ${APP_DATA_DIR}/data/php/php-cli.ini:/usr/local/etc/php/php-cli.ini:ro
+    depends_on:
+      invoice-ninja-db:
+        condition: service_healthy
+    networks:
+      - tipi_main_network
+
+  invoice-ninja-db:
+    image: mariadb:10.4
+    container_name: invoice-ninja-db
+    restart: unless-stopped
+    environment:
+      - MARIADB_ROOT_PASSWORD=${INVOICE_NINJA_BDD_PASSWORD}
+      - MARIADB_USER=ninja
+      - MARIADB_PASSWORD=ninja
+      - MARIADB_DATABASE=ninja
+    volumes:
+      - ${APP_DATA_DIR}/data/mysql:/var/lib/mysql:rw,delegated
+    networks:
+      - tipi_main_network
+    depends_on:
+      invoice-ninja-init:
+        condition: service_completed_successfully
+    healthcheck:
+      test: [ "CMD", "healthcheck.sh", "--su-mysql", "--connect", "--innodb_initialized" ]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+
+  invoice-ninja-init:
+    image: bash:5.2.21
+    container_name: invoice-ninja-init
+    volumes:
+      - ${APP_DATA_DIR}/data:/tmp/data
+    command: bash -c "chmod +x /tmp/data/init/init.sh && /tmp/data/init/init.sh "

apps/invoice-ninja/metadata/description.md

@@ -0,0 +1,160 @@
+<p align="center">
+    <img src="https://raw.githubusercontent.com/hillelcoren/invoice-ninja/master/public/images/round_logo.png" alt="Sublime's custom image"/>
+</p>
+
+![v5-develop phpunit](https://github.com/invoiceninja/invoiceninja/workflows/phpunit/badge.svg?branch=v5-develop)
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/d16c78aad8574466bf83232b513ef4fb)](https://www.codacy.com/gh/turbo124/invoiceninja/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=turbo124/invoiceninja&amp;utm_campaign=Badge_Grade)
+<a href="https://cla-assistant.io/invoiceninja/invoiceninja"><img src="https://cla-assistant.io/readme/badge/invoiceninja/invoiceninja" alt="CLA assistant" /></a>
+
+# Invoice Ninja 5
+
+## [Hosted](https://www.invoiceninja.com) | [Self-Hosted](https://www.invoiceninja.org)
+
+Join us on [Slack](http://slack.invoiceninja.com), [Discord](https://discord.gg/ZwEdtfCwXA), [Support Forum](https://forum.invoiceninja.com)
+
+## Introduction
+
+Version 5 of Invoice Ninja is here!
+We took the best parts of version 4 and add the most requested features
+to produce a invoicing application like no other.
+
+All Pro and Enterprise features from the hosted app are included in the open code.
+We offer a $30 per year white-label license to remove the Invoice Ninja branding from client facing parts of the app.
+
+* [Videos](https://www.youtube.com/@appinvoiceninja)
+* [API Documentation](https://api-docs.invoicing.co/)
+* [APP Documentation](https://invoiceninja.github.io/)
+* [Support Forum](https://forum.invoiceninja.com)
+
+## Setup
+
+### Mobile Apps
+* [iPhone](https://apps.apple.com/app/id1503970375?platform=iphone)
+* [Android](https://play.google.com/store/apps/details?id=com.invoiceninja.app)
+* [F-Droid](https://f-droid.org/en/packages/com.invoiceninja.app)
+
+### Desktop Apps
+* [macOS](https://apps.apple.com/app/id1503970375?platform=mac)
+* [Windows](https://microsoft.com/en-us/p/invoice-ninja/9n3f2bbcfdr6)
+* [Linux](https://snapcraft.io/invoiceninja)
+
+### Installation Options
+* [Docker File](https://hub.docker.com/r/invoiceninja/invoiceninja/)
+* [Cloudron](https://cloudron.io/store/com.invoiceninja.cloudronapp.html)
+* [Softaculous](https://www.softaculous.com/apps/ecommerce/Invoice_Ninja)
+
+### Recommended Providers
+* [Stripe](https://stripe.com/)
+* [Postmark](https://postmarkapp.com/)
+
+## Quick Hosting Setup
+
+```sh
+git clone --single-branch --branch v5-stable https://github.com/invoiceninja/invoiceninja.git
+cp .env.example .env
+composer i -o --no-dev
+php artisan key:generate
+```
+
+Please Note:
+Your APP_KEY in the .env file is used to encrypt data, if you lose this you will not be able to run the application.
+
+Run if you want to load sample data, remember to configure .env
+```sh
+php artisan migrate:fresh --seed && php artisan db:seed && php artisan ninja:create-test-data
+```
+
+To run the web server
+```sh
+php artisan serve 
+```
+
+Navigate to (replace localhost with the appropriate domain)
+```
+http://localhost:8000/setup - To setup your configuration if you did not load sample data.
+http://localhost:8000/ - For Administrator Logon
+
+user: small@example.com
+pass: password
+
+http://localhost:8000/client/login - For Client Portal
+
+user: user@example.com
+pass: password
+```
+## Developers Guide
+
+
+### App Design
+
+The API and client portal have been developed using [Laravel](https://laravel.com) if you wish to contribute to this project familiarity with Laravel is essential.
+
+When inspecting functionality of the API, the best place to start would be in the routes/api.php file which describes all of the availabe API endpoints. The controller methods then describe all the entry points into each domain of the application, ie InvoiceController / QuoteController
+
+The average API request follows this path into the application.
+
+* Middleware processes the request initially inspecting the domain being requested + provides the authentication layer.
+* The request then passes into a Form Request (Type hinted in the controller methods) which is used to provide authorization and also validation of the request. If successful, the request is then passed into the controller method where it is digested, here is an example:
+
+```php
+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);
+
+}
+```
+
+Here for example we are storing a new invoice, we pass the validated request along with a factory into the invoice repository where it is processed and saved.
+
+The returned invoice then passes through its service class (app/Services/Invoice) where various actions are performed.
+
+A event is then fired which notifies listeners in the application (app/Providers/EventServiceProvider) which perform non blocking sub tasks
+
+Finally the invoice is transformed (app/Transformers/) and returned as a response via Fractal.
+
+### Developer environment
+
+Using the Quick Hosting Setup describe above you can quickly get started building out your development environment. Instead of using
+
+```
+composer i -o --no-dev
+``` 
+
+use
+
+```
+composer i -o
+```
+
+This provides the developer tools including phpunit which allows the test suite to be run.
+
+If you are considering contributing back to the main repository, please add in any tests for new functionality / modifications. This will greatly increase the chances of your PR being accepted
+
+Also, if you plan any additions for the main repository, you may want to discuss this with us first on Slack where we can assist with any technical information and provide advice.
+
+## Credits
+* [Hillel Coren](https://hillelcoren.com/)
+* [David Bomba](https://github.com/turbo124)
+* [Benjamin Beganović](https://github.com/beganovich)
+* [All Contributors](https://github.com/invoiceninja/invoiceninja/graphs/contributors)
+
+## Security
+
+If you find a security issue with this application, please send an email to contact@invoiceninja.com.
+Please follow responsible disclosure procedures if you detect an issue.
+For further information on responsible disclosure please read [here](https://cheatsheetseries.owasp.org/cheatsheets/Vulnerability_Disclosure_Cheat_Sheet.html).
+
+## License
+Invoice Ninja is released under the Elastic License.  
+See [LICENSE](LICENSE) for details.