Just develop to master

.env.example

@@ -2,8 +2,9 @@ APP_NAME="InvoicePlane v2"
 APP_ENV=local
 APP_KEY=
 APP_DEBUG=true
+APP_EXTREME_LOGGING=false
 DEBUGBAR_ENABLED=false
-APP_URL=http://localhost.test
+APP_URL=http://ivplv2.test
 
 APP_LOCALE=en
 APP_FALLBACK_LOCALE=en
@@ -24,25 +25,25 @@ LOG_LEVEL=debug
 DB_CONNECTION=mariadb
 DB_HOST=127.0.0.1
 DB_PORT=3306
-DB_DATABASE=localhost
+DB_DATABASE=ivplv2
 DB_USERNAME=root
-DB_PASSWORD=root
+DB_PASSWORD=
 
-SESSION_DRIVER=redis
+SESSION_DRIVER=database
 SESSION_LIFETIME=120
 SESSION_ENCRYPT=false
 SESSION_PATH=/
 SESSION_DOMAIN=null
 
 BROADCAST_CONNECTION=log
 FILESYSTEM_DISK=local
-QUEUE_CONNECTION=beanstalkd
+QUEUE_CONNECTION=database
 
-CACHE_STORE=redis
-CACHE_PREFIX=localhost
+CACHE_STORE=database
+# CACHE_PREFIX=ivplv2
 
 REDIS_CLIENT=phpredis
-REDIS_HOST=redis
+REDIS_HOST=127.0.0.1
 REDIS_PASSWORD=null
 REDIS_PORT=6379
 

.env.testing.example

@@ -0,0 +1,59 @@
+APP_NAME="InvoicePlane v2"
+APP_ENV=testing
+APP_KEY=
+APP_DEBUG=false
+APP_EXTREME_LOGGING=false
+DEBUGBAR_ENABLED=false
+APP_URL=http://localhost
+
+APP_LOCALE=en
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+
+PHP_CLI_SERVER_WORKERS=4
+
+BCRYPT_ROUNDS=4
+
+LOG_CHANNEL=stack
+LOG_DAILY_DAYS=7
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+DB_CONNECTION=sqlite
+DB_DATABASE=:memory:
+
+SESSION_DRIVER=array
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=sync
+
+CACHE_STORE=array
+
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+MAIL_MAILER=array
+MAIL_SCHEME=null
+MAIL_HOST=127.0.0.1
+MAIL_PORT=2525
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_FROM_ADDRESS="[email protected]"
+MAIL_FROM_NAME="${APP_NAME}"
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+VITE_APP_NAME="${APP_NAME}"

.github/CHECKLIST.md

@@ -0,0 +1,64 @@
+# InvoicePlane V2 – Feature Test Checklist
+
+I've written some tests. Indexes first. After indexes, the statuses, etc. After that the special cases, exceptions, etc., then the Create, Update, Delete actions within the different *modules*.
+Some *modules* had a *sub page*. For example: Invoices have invoice_groups as a *sub page*.
+Maybe I'll do the *settings* per module as a separate row in this checklist.
+
+## Notes (Invoices)
+- Tests for overdue invoices are missing:
+ - If status NOT IN (1,4) and DATEDIFF((NOW), invoice_date_due) > 0 then `is_overdue` is true
+- Make special scope for overdue invoices
+- Test for that scope
+
+## Notes (Quotes)
+- The notes in the index, I've not ported them over from CodeIgniter.
+- For now, it's silly to put notes in an index. It's easily added though.
+
+---
+
+## Test Coverage
+
+| Module | Submodule | Index (happy) | Specials (happy) | Create (happy) | Update (happy) | Delete (happy) | Translations |
+|-----------|------------------|:-------------:|:----------------:|:--------------:|:--------------:|:--------------:|:------------:|
+| clients | | | | | | | |
+| | user_clients | | | | | | |
+| core | | | | | | | |
+| | custom_fields | | | | | | |
+| | custom_values | | | | | | |
+| | dashboard | | | | | | |
+| | email_templates | | | | | | |
+| | filter | | | | | | |
+| | guest | (view missing)| | | | | |
+| | import | | | | | | |
+| | layout | | | | | | |
+| | mailer | | | | | | |
+| | sessions | | | | | | |
+| | settings | | | | | | |
+| | upload | | | | | | |
+| | welcome | | | | | | |
+| invoices | | | | | | | |
+| | invoice_groups | | | | | | |
+| | tax_rates | | | | | | |
+| | peppol | | | | | | |
+| payments | | | | | | | |
+| | payment_methods | | | | | | |
+| products | | | | | | | |
+| | families | | | | | | |
+| | units | | | | | | |
+| projects | | | | | | | |
+| | tasks | | | | | | |
+| quotes | | | | | | | |
+| reports | | | | | | | |
+| users | | | | | | | |
+| setup | | | | | | | |
+
+---
+
+## Notes (Peppol E-Invoicing)
+
+The Peppol integration includes comprehensive test coverage:
+- **Enum Tests:** All Peppol enums (TransmissionStatus, ErrorType, ValidationStatus, etc.) have complete test coverage
+- **Service Tests:** PeppolService with HTTP fakes for transmission, status checking, and cancellation
+- **Provider Tests:** Factory pattern and provider-specific client tests
+- **Format Handler Tests:** UBL, FatturaPA, ZUGFeRD format validation and transformation
+- **Integration Tests:** End-to-end integration lifecycle (create, test, validate, send)

.github/CONTRIBUTING.md

@@ -0,0 +1,89 @@
+Contributing to InvoicePlane V2
+
+Thank you for considering contributing to **InvoicePlane V2** — a Laravel + Filament modular rewrite of the original InvoicePlane. This guide outlines our project rules and contribution standards.
+
+---
+
+## Structure & Standards
+
+- **Laravel 11+**, **PHP 8.2+**
+- **Filament** used for all UI
+- **Livewire** used for reactive components
+- **Modular** folder structure only:
+ - `Modules/{Module}/Filament/Admin/Resources/`
+ - `Modules/{Module}/Services/`
+ - `Modules/{Module}/Tests/Feature/`
+- Use:
+ - `BelongsToCompany` trait for multi-tenancy
+ - `DTOs` + `Transformers` for all data
+ - `Services` for all business logic
+
+---
+
+## Code Formatting
+
+```bash
+vendor/bin/pint
+php artisan test
+```
+
+- Follow PSR-12
+- No logic in Filament or Livewire pages
+- No inline DTO construction
+- No tight coupling — use DI and clear return types
+
+---
+
+Test Requirements
+
+All tests go in: Modules/{Module}/Tests/Feature/
+
+Extend: AbstractAdminPanelTestCase OR AbstractCompanyPanelTestCase OR AbstractTestCase (for Unit tests)
+
+Use: #[Test] and #[Group('crud')] or #[Group('smoke')]
+
+All tests should have:
+
+- @payload block (if input-based)
+- it_ prefix in the method
+
+```
+#[Test]
+#[Group('crud')]
+/**
+ * @payload missing: invoice_number
+ * {
+ * "customer_id": 1,
+ * "due_date": "2025-06-01"
+ * }
+ */
+public function it_fails_to_create_invoice_without_required_invoice_number(): void
+```
+
+---
+
+Pull Requests
+
+- One PR per feature or fix
+- Reference rows in CHECKLIST.md
+- Translate if needed
+- Add tests where you can
+
+---
+
+Translation
+
+All strings use trans('...')
+
+Translations managed via Crowdin:
+https://translations.invoiceplane.com
+
+---
+
+Community
+
+Discord: https://discord.gg/PPzD2hTrXt
+
+Community Forums: https://community.invoiceplane.com
+
+GitHub Issues: https://github.com/InvoicePlane/InvoicePlane-v2/issues

.github/DOCKER.md

@@ -0,0 +1,81 @@
+DOCKER.md
+
+# Docker Setup for InvoicePlane V2
+
+This guide explains how to run InvoicePlane V2 using Docker.
+
+---
+
+## Prerequisites
+
+- Docker installed (https://www.docker.com/)
+- Docker Compose v2+
+
+---
+
+## Quick Start
+
+```bash
+git clone https://github.com/InvoicePlane/InvoicePlane.git
+cd InvoicePlane
+
+cp .env.example .env
+composer install
+php artisan key:generate
+php artisan migrate --seed
+
+docker compose up -d
+
+Visit: http://localhost/ivpl
+
+---
+
+Useful Commands
+
+Action	Command
+
+Start services	docker compose up -d
+Stop services	docker compose down
+View logs	docker compose logs -f
+Run artisan	docker compose exec app php artisan
+Rebuild containers	docker compose build --no-cache
+
+---
+
+Services
+
+App container: Laravel application
+
+Database: MariaDB (latest)
+
+Mail: MailCatcher (port 1080)
+
+Queue: Redis (optional)
+
+---
+
+Customize Docker
+
+Change database port in docker-compose.yml
+
+Override PHP version via Dockerfile
+
+Add volumes for local persistence if needed
+
+---
+
+Troubleshooting
+
+Port already in use: Adjust ports in docker-compose.yml
+
+Permission issues: Ensure Docker has access to your project folder
+
+Missing .env config: Re-run cp .env.example .env and adjust
+
+---
+
+---
+
+What's Next?
+
+Visit CHECKLIST.md if contributing