aboleon/metaframework-accounts

Accounts and invoices domain package for Laravel applications.

0.3.6 2026-02-24 21:52 UTC

Requires

• php: ^8.3
• aboleon/metaframework: dev-mfw-2026||^1.0
• aboleon/metaframework-google-places: ^1.2
• aboleon/metaframework-mailer: 0.*
• aboleon/metaframework-mediaclass: 0.*
• barryvdh/laravel-dompdf: ^3.1
• maatwebsite/excel: ^3.1

Requires (Dev)

• laravel/pint: ^1.27
• orchestra/testbench: ^10.0
• phpunit/phpunit: ^11.0

MIT

README

Accounts and invoices package for MetaFramework-based Laravel applications.

This package relies on the MetaFramework package stack (notably aboleon/metaframework and companion MetaFramework packages). It is not intended to be used as a standalone package without MetaFramework.

What this package provides

• Accounts / clients management with multi-address support and Google Places integration
• Invoices management with line items, PDF generation, email dispatch, and Excel export
• Expense tracking linked to invoices with net gain computation
• Payment methods, bank accounts, and cashflow ledger
• Currency and VAT management
• Company information management (translatable)
• Admin dashboard with multi-currency financial reporting
• Optional customer-facing login portal (front account skeleton)

Quick Start

composer require aboleon/metaframework-accounts
php artisan migrate

Composer installs the required MetaFramework packages automatically because they are declared as package dependencies.

Laravel package discovery registers MetaFramework\Accounts\Providers\AccountsServiceProvider automatically.

Table of Contents

Topic	Description
Installation	Requirements, Composer install, running migrations, dependency list
Configuration	Publishing the config file and available options
Publishing	All publish tags: config, assets, views, translations, front account skeleton
Accounts	Account model, addresses, business data, controller actions, account search component
Invoices	Invoice model, line items, document types, CRUD, PDF, email, Excel export
Expenses	Expense associations, net gain computation, editability rules, Blade components
Payments	Payment methods, channels, bank accounts, cashflow ledger
Currencies & VAT	Currency model, reporting conversion, VAT rates and defaults
Company	Company legal info, translatable data, bank account details
Dashboard	Turnover metrics, client stats, year filter, multi-currency handling
Front Account	Customer portal installation, published files, auth guard, routes
Routes	Full route table with methods, URIs, names, and controllers
Database	Full table reference grouped by domain, column types, foreign keys
Translations	Supported locales, file structure, publishing, and usage

Notes for integration

• Table names use the mfw_accounts_* prefix.
• Asset URLs are expected under public/vendor/mfw-accounts.
• Route prefix is configurable via config('mfw-accounts.route_prefix'); route names are stable (mfw-accounts.*).
• The front account skeleton (mfw-accounts-front tag or php artisan mfw-accounts:front) is optional and must be explicitly installed.
• User type segregation config (config/mfw-user-types.php) is owned/published by this package via the mfw-user-types tag.
• Backward-compatibility alias: the tag mfw-account (without trailing s) maps to the same skeleton.
• Legacy host table renames/migrations must be handled in the host application; do not modify package migrations.