PHPackages jeffersongoncalves/laravel-erp-maintenance - 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. jeffersongoncalves/laravel-erp-maintenance ActiveLibrary[Utility & Helpers](/categories/utility) jeffersongoncalves/laravel-erp-maintenance ========================================== ERP maintenance — maintenance schedules and visits for the Laravel ERP ecosystem 1.1.0(1mo ago)12592MITPHPPHP ^8.2 Since Jun 29Pushed 1mo agoCompare [ Source](https://github.com/jeffersongoncalves/laravel-erp-maintenance)[ Packagist](https://packagist.org/packages/jeffersongoncalves/laravel-erp-maintenance)[ Docs](https://github.com/jeffersongoncalves/laravel-erp)[ RSS](/packages/jeffersongoncalves-laravel-erp-maintenance/feed)WikiDiscussions main Synced 2w ago READMEChangelogDependencies (7)Versions (4)Used By (2) [![Laravel ERP Maintenance](https://raw.githubusercontent.com/jeffersongoncalves/laravel-erp-maintenance/main/art/jeffersongoncalves-laravel-erp-maintenance.png)](https://raw.githubusercontent.com/jeffersongoncalves/laravel-erp-maintenance/main/art/jeffersongoncalves-laravel-erp-maintenance.png) Laravel ERP Maintenance ======================= [](#laravel-erp-maintenance) ERP maintenance — maintenance schedules and visits for the Laravel ERP ecosystem. This package is the maintenance module of the Laravel ERP ecosystem. It owns the maintenance documents: maintenance schedules (with their planned items and the generated dated visit rows) and maintenance visits (with their per-line service purposes). The customer, the serviced item and its serial number are referenced as dynamic links (`party_type`/`party_id`, `item_code`, `serial_no`), so the package depends only on [`jeffersongoncalves/laravel-erp-core`](https://github.com/jeffersongoncalves/laravel-erp-core) — there is no hard dependency on the selling, stock or CRM modules. Features -------- [](#features) - **Maintenance schedules** — A submittable document that plans recurring maintenance for a customer. Each schedule item declares an item, a start date, a periodicity (`Weekly`, `Monthly`, `Quarterly`, `Yearly`) and a number of visits; submitting the schedule expands those into concrete dated visit rows. - **Maintenance visits** — A submittable record of a service call with a type (`Scheduled`, `Unscheduled`, `Breakdown`) and a completion status (`Pending`, `Partially Completed`, `Fully Completed`). Each visit line (purpose) records the item, serial number, the work done and the service person; the overall completion status is recomputed from those lines. - **Submittable documents** — Schedules and visits use the core `IsSubmittable` lifecycle (draft → submitted → cancelled) with naming series and company scoping. - **Customizable Models** — Override any model via config (ModelResolver pattern). - **Translations** — English and Brazilian Portuguese. Compatibility ------------- [](#compatibility) PackagePHPLaravel`^1.0``^8.2``^11.0 | ^12.0 | ^13.0`Installation ------------ [](#installation) ``` composer require jeffersongoncalves/laravel-erp-maintenance ``` Publish and run the migrations (the core package migrations must be published too): ``` php artisan vendor:publish --tag="erp-core-migrations" php artisan vendor:publish --tag="erp-maintenance-migrations" php artisan migrate ``` Publish the config (optional): ``` php artisan vendor:publish --tag="erp-maintenance-config" ``` Generating Visits ----------------- [](#generating-visits) A maintenance schedule plans recurring work through its items. Submitting the schedule (or calling `MaintenanceScheduleService::generateSchedule()` directly) expands each item into `no_of_visits` dated rows in `maintenance_schedule_details`, stepping from the item's `start_date` by its periodicity (`Weekly` = +1 week, `Monthly` = +1 month, `Quarterly` = +3 months, `Yearly` = +1 year). Dynamic Links ------------- [](#dynamic-links) Maintenance documents reference the customer through `party_type` + `party_id` and the serviced item through a plain `item_code` (and optional `serial_no`) string. This keeps the maintenance module decoupled from the selling, stock and CRM packages while still allowing those records to be resolved at the application layer. Database Tables --------------- [](#database-tables) All tables use the configured prefix shared across the ERP ecosystem (default: `erp_`): `maintenance_schedules`, `maintenance_schedule_items`, `maintenance_schedule_details`, `maintenance_visits`, `maintenance_visit_purposes`. Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](.github/SECURITY.md) on how to report security vulnerabilities. Credits ------- [](#credits) - [Jefferson Simão Gonçalves](https://github.com/jeffersongoncalves) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 44 — FairBetter than 90% of packages Maintenance91 Actively maintained with recent releases Popularity18 Limited adoption so far Community10 Small or concentrated contributor base Maturity48 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 Every ~1 days Total 3 Last Release 42d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/411493?v=4)[Jefferson Gonçalves](/maintainers/jeffersongoncalves)[@jeffersongoncalves](https://github.com/jeffersongoncalves) --- Top Contributors [![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (1 commits)") --- Tags laravelmaintenanceERPmaintenance-schedulemaintenance-visit ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/jeffersongoncalves-laravel-erp-maintenance/health.svg) ``` [![Health](https://phpackages.com/badges/jeffersongoncalves-laravel-erp-maintenance/health.svg)](https://phpackages.com/packages/jeffersongoncalves-laravel-erp-maintenance) ``` ### Alternatives [misterphilip/maintenance-mode An enhanced drop-in replacement for Laravel's maintenance mode 120178.4k](/packages/misterphilip-maintenance-mode) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)