PHPackages                             ilbullo/artisan-ledger - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. ilbullo/artisan-ledger

ActiveLibrary[Utility & Helpers](/categories/utility)

ilbullo/artisan-ledger
======================

Modulo agnostico per la gestione dei corrispettivi giornalieri

v1.0.0(5mo ago)00MITBladePHP ^8.2

Since Jan 19Pushed 5mo agoCompare

[ Source](https://github.com/ilbullo/artisan-ledger)[ Packagist](https://packagist.org/packages/ilbullo/artisan-ledger)[ RSS](/packages/ilbullo-artisan-ledger/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (3)Versions (2)Used By (0)

🚚 Laravel Artisan Ledger
========================

[](#-laravel-artisan-ledger)

> **La soluzione definitiva per la gestione dei corrispettivi giornalieri in Laravel.**

**Artisan Ledger** nasce dall'esigenza di semplificare la contabilità quotidiana per artigiani, trasportatori e piccole imprese. Spesso i gestionali standard sono troppo complessi; questo pacchetto offre un'interfaccia pulita, reattiva e focalizzata solo su ciò che conta: **quanto hai incassato e come.**

---

✨ Perché scegliere Artisan Ledger?
----------------------------------

[](#-perché-scegliere-artisan-ledger)

Monitorare gli incassi non dovrebbe essere un lavoro a tempo pieno. Con questo pacchetto integrato nella tua applicazione Laravel, ottieni:

- **⚡ Interfaccia Real-time**: Grazie a Livewire, i dati vengono salvati e aggiornati istantaneamente in tutti i report senza mai ricaricare la pagina.
- **📊 Analisi Multicanale**: Non limitarti a un totale. Suddividi i tuoi incassi tra Contanti, POS, Bonifici o qualsiasi altro metodo configurabile.
- **🔍 Controllo Totale**: La "Griglia di Controllo" ti permette di individuare in un secondo i giorni dimenticati o i buchi nella registrazione.
- **🏦 Architettura Professionale**: Utilizza relazioni polimorfiche, il che significa che puoi collegare un registro a un Utente, a un'intera Ditta o a una specifica Filiale senza cambiare una riga di codice.

---

🛠 Funzionalità Incluse
----------------------

[](#-funzionalità-incluse)

### 📝 Editor Giornaliero Smart

[](#-editor-giornaliero-smart)

Un componente minimalista per inserire le cifre di fine giornata. Include un campo note per segnare anomalie, turni o promemoria importanti.

### 📅 Dettaglio Mensile (Matrix View)

[](#-dettaglio-mensile-matrix-view)

Una tabella avanzata che mostra i giorni del mese sulle righe e i tuoi canali di incasso sulle colonne. Include i totali di riga (giornalieri) e i totali di colonna (mensili per canale).

### 📈 Riepilogo Annuale

[](#-riepilogo-annuale)

Una visione ad alto livello che raggruppa gli incassi mese per mese, ideale per il confronto delle performance stagionali e per la preparazione dei dati per il commercialista.

### 🏁 Griglia di Verifica

[](#-griglia-di-verifica)

Una visualizzazione compatta 1-31 per tutti i 12 mesi dell'anno. Ogni cella indica se il dato è presente, rendendo il "check" di fine mese estremamente rapido.

---

🎨 Design Moderno
----------------

[](#-design-moderno)

Il pacchetto è costruito con **Tailwind CSS**, offrendo un look pulito e professionale che si adatta perfettamente alla dashboard di Laravel Breeze o Jetstream. È completamente responsive: controlla i tuoi incassi anche da smartphone mentre sei in viaggio.

---

📦 Installazione
---------------

[](#-installazione)

Segui questi passaggi per integrare **Artisan Ledger** nel tuo progetto Laravel.

### 1. Requisiti

[](#1-requisiti)

Assicurati che il tuo progetto utilizzi:

- PHP 8.2 o superiore
- Laravel 10.x o 11.x
- Livewire 3.x

### 2. Installazione tramite Composer

[](#2-installazione-tramite-composer)

Esegui il comando dalla root del tuo progetto:

```
composer require ilbullo/artisan-ledger
```

### 3. Configurazione del Modello

[](#3-configurazione-del-modello)

Il pacchetto utilizza una relazione polimorfica per associare i dati del registro. Aggiungi il trait `HasLedger` al modello che gestirà i corrispettivi (solitamente `User.php`):

PHP

```
namespace App\Models;

use Ilbullo\ArtisanLedger\Traits\HasLedger;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use HasLedger;

    // ... il resto del tuo modello
}

```

### 4. Database e Migrazioni

[](#4-database-e-migrazioni)

Crea le tabelle necessarie (`ledger_days` e `ledger_entries`) eseguendo le migrazioni:

Bash

```
php artisan migrate

```

### 5. Pubblicazione Asset

[](#5-pubblicazione-asset)

Per personalizzare i canali di incasso o lo stile dei componenti, pubblica i file del pacchetto:

**Configurazione (Consigliato)** Serve per definire i tuoi canali (Contanti, POS, ecc.):

Bash

```
php artisan vendor:publish --tag="artisan-ledger-config"

```

**Viste Blade (Opzionale)** Se desideri modificare il design dei componenti (Tailwind CSS):

Bash

```
php artisan vendor:publish --tag="artisan-ledger-views"

```

🛠 Setup Post-Installazione
--------------------------

[](#-setup-post-installazione)

### Configura i tuoi canali

[](#configura-i-tuoi-canali)

Apri il file `config/artisan-ledger.php` e adatta l'array `channels` alle tue esigenze lavorative:

PHP

```
'channels' => [
    'cash' => [
        'label' => 'Contanti',
        'icon'  => 'banknotes',
    ],
    'pos' => [
        'label' => 'POS / Carte',
        'icon'  => 'credit-card',
    ],
    // Aggiungi qui altri canali come 'bonifico', 'assegno', ecc.
],

```

🎨 Personalizzazione dei Template (Viste)
----------------------------------------

[](#-personalizzazione-dei-template-viste)

Se desideri modificare il design dei componenti per adattarlo perfettamente al tuo tema, puoi pubblicare i file Blade nella cartella delle risorse del tuo progetto.

### 1. Pubblicare le viste

[](#1-pubblicare-le-viste)

Esegui questo comando nel terminale:

```
php artisan vendor:publish --tag="artisan-ledger-views"
```

### 2. Dove trovare i file

[](#2-dove-trovare-i-file)

Dopo l'esecuzione, troverai tutti i template del pacchetto in: `resources/views/vendor/artisan-ledger/`

Qui potrai modificare liberamente:

- `livewire/ledger-editor.blade.php`: Il form di inserimento.
- `livewire/ledger-monthly-detail.blade.php`: La tabella dei corrispettivi.
- ...e tutti gli altri componenti.

### 3. Note sul Design

[](#3-note-sul-design)

I componenti sono costruiti utilizzando **Tailwind CSS**.

- Se modifichi le classi Tailwind nelle viste pubblicate, assicurati che il tuo file `tailwind.config.js` includa il percorso delle viste vendor per compilare correttamente i nuovi stili:

JavaScript

```
content: [
    // ... altri percorsi
    "./resources/views/vendor/artisan-ledger/**/*.blade.php",
],

```

> **Nota:** Una volta pubblicate, Laravel darà la precedenza ai file in `resources/views/vendor/artisan-ledger/` rispetto a quelli originali contenuti nel pacchetto.

🏷️ Tag dei Componenti
---------------------

[](#️-tag-dei-componenti)

Puoi inserire questi tag in qualsiasi file Blade (es. `resources/views/dashboard.blade.php`). Assicurati che l'utente sia autenticato, poiché il registro è collegato al profilo dell'utente loggato.

### 1. Editor di Inserimento (Giornaliero)

[](#1-editor-di-inserimento-giornaliero)

Utilizzato per caricare i dati della giornata selezionata.

```

```

### 2. Tabella Mensile Dettagliata

[](#2-tabella-mensile-dettagliata)

Mostra la griglia completa del mese corrente con i totali per ogni canale.

HTML

```

```

### 3. Riepilogo Totali Annuali

[](#3-riepilogo-totali-annuali)

Mostra una tabella sintetica con i totali incassati mese per mese.

HTML

```

```

### 4. Griglia di Controllo (Checklist)

[](#4-griglia-di-controllo-checklist)

Una matrice compatta (mesi/giorni) per individuare rapidamente i giorni senza registrazioni.

HTML

```

```

---

### Esempio di implementazione rapida

[](#esempio-di-implementazione-rapida)

Ecco come potresti organizzare la tua dashboard in Laravel Breeze:

HTML

```

```

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance70

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

167d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d1f92a7449f5c67538551ce77a35f7c7ff2dc059574879ed8ff566f72e24c47a?d=identicon)[ilbullo](/maintainers/ilbullo)

---

Top Contributors

[![ilbullo](https://avatars.githubusercontent.com/u/1204664?v=4)](https://github.com/ilbullo "ilbullo (4 commits)")

### Embed Badge

![Health badge](/badges/ilbullo-artisan-ledger/health.svg)

```
[![Health](https://phpackages.com/badges/ilbullo-artisan-ledger/health.svg)](https://phpackages.com/packages/ilbullo-artisan-ledger)
```

###  Alternatives

[nasirkhan/laravel-starter

A CMS like modular Laravel starter project.

1.4k2.7k](/packages/nasirkhan-laravel-starter)[team-nifty-gmbh/tall-datatables

Server-side rendered datatables for Laravel and Livewire

1320.9k4](/packages/team-nifty-gmbh-tall-datatables)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.4k](/packages/tomshaw-electricgrid)[ramonrietdijk/livewire-tables

Dynamic tables for models with Laravel Livewire

21259.6k](/packages/ramonrietdijk-livewire-tables)[noerd/noerd

101.4k7](/packages/noerd-noerd)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)