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. jeffersongoncalves/laravel-erp-maintenance

Active

jeffersongoncalves/laravel-erp-maintenance
==========================================

10PHP

Pushed todayCompare

[ Source](https://github.com/jeffersongoncalves/laravel-erp-maintenance)[ Packagist](https://packagist.org/packages/jeffersongoncalves/laravel-erp-maintenance)[ RSS](/packages/jeffersongoncalves-laravel-erp-maintenance/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersionsUsed By (0)

Laravel ERP Maintenance
=======================

[](#laravel-erp-maintenance)

ERP maintenance — maintenance schedules and visits for the Laravel ERP ecosystem.

This package is the maintenance module of an ERPNext-native rebuild. 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
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance65

Regular maintenance activity

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity8

Early-stage or recently created project

 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.

### 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)")

### 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)
```

PHPackages © 2026

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