PHPackages                             empire2/gaze-ticketsystem - 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. empire2/gaze-ticketsystem

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

empire2/gaze-ticketsystem
=========================

Standalone Laravel ticket-system. Livewire-driven kanban/list board, AI analysis, follow-ups, notifications, and an optional ghostwriter integration via source resolvers.

v0.1.2(1mo ago)11↓100%[1 PRs](https://github.com/EmpireTwo/gaze-ticketsystem/pulls)MITPHPPHP ^8.3CI passing

Since May 10Pushed 3w agoCompare

[ Source](https://github.com/EmpireTwo/gaze-ticketsystem)[ Packagist](https://packagist.org/packages/empire2/gaze-ticketsystem)[ Docs](https://github.com/EmpireTwo/gaze-ticketsystem)[ RSS](/packages/empire2-gaze-ticketsystem/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (17)Versions (5)Used By (0)

Gaze Ticketsystem
=================

[](#gaze-ticketsystem)

Standalone Laravel ticket-system. Livewire-driven kanban + list board, AI-assisted ticket analysis, follow-up reminders, notifications, and a soft optional integration with [`empire2/gaze-ghostwriter`](https://github.com/EmpireTwo/gaze-ghostwriter) for turning support drafts into tickets.

[![CI](https://github.com/EmpireTwo/gaze-ticketsystem/actions/workflows/ci.yml/badge.svg)](https://github.com/EmpireTwo/gaze-ticketsystem/actions/workflows/ci.yml)[![Latest Version](https://camo.githubusercontent.com/68522f6878699522d682db784055329f605cf15b1853b700aa3c5f57a3cb86a7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f656d70697265322f67617a652d7469636b657473797374656d2e737667)](https://packagist.org/packages/empire2/gaze-ticketsystem)[![License](https://camo.githubusercontent.com/2d7cb280220b0da8bface61c9e00987889a5b32c92de20174d33dddbba19b913/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f456d7069726554776f2f67617a652d7469636b657473797374656d2e737667)](LICENSE)

The package ships:

- A `tickets` URL prefix with kanban + list + split detail-panel views (Livewire 4).
- `Ticket`, `TicketComment`, `TicketStatus`, `TicketType` Eloquent models with auto-generated `TK-YYYYMM-NNNNN` numbers, Spatie activity log + media library integration.
- A `TicketAiAnalysisService` driven by `laravel/ai` agents, with overridable prompt templates.
- A `gaze-ticketsystem:check-follow-ups` command (alias `ticket:check-follow-ups`) and an opt-in hourly schedule.
- Database notifications for assignments, new comments, and overdue follow-ups.
- A neutral `TicketSourceResolver` contract that lets you plug in arbitrary external sources (e.g. ghostwriter support drafts) without coupling the package to them.

Requirements
------------

[](#requirements)

- PHP `^8.3` (`laravel/ai` requires PHP 8.3+)
- Laravel `^12.0` (`laravel/ai` requires Laravel 12+)
- Livewire `^4.0`
- `empiretwo/gaze-laravel` (auto-installed)
- `spatie/laravel-activitylog` `^4.8`
- `spatie/laravel-medialibrary` `^11.3`
- `laravel/ai` `^0.4.3`

Install
-------

[](#install)

```
composer require empire2/gaze-ticketsystem

php artisan vendor:publish --tag=gaze-ticketsystem-config
php artisan vendor:publish --tag=gaze-ticketsystem-migrations
php artisan migrate
```

Composer will pull `empiretwo/gaze-laravel` automatically; the gaze CLI binary is downloaded into `vendor/bin/gaze` by its bundled installer plugin (Composer asks you to trust the plugin once).

Optional:

```
php artisan vendor:publish --tag=gaze-ticketsystem-views
php artisan vendor:publish --tag=gaze-ticketsystem-seeders
```

Seed the default ticket statuses and types from your `DatabaseSeeder`:

```
$this->call([
    \Empire2\GazeTicketsystem\Database\Seeders\TicketStatusSeeder::class,
    \Empire2\GazeTicketsystem\Database\Seeders\TicketTypeSeeder::class,
]);
```

Configuration
-------------

[](#configuration)

`config/gaze-ticketsystem.php` exposes every host integration point. The most relevant keys:

KeyPurpose`enabled`Master switch; disables routes + Livewire registration when false.`user_model`Authenticatable model used for assignees, creators and comment authors.`customer_model`Optional. When set, the create form shows a customer search box and `Ticket::customer()` returns a real relation; when null, customer search is hidden.`admin_resolver`Optional `callable(): Collection` used to populate "assign to" dropdowns and follow-up notification recipients.`layout`Blade layout used by the package's Livewire components (default `components.layouts.app`).`middleware`Middleware stack for the package routes (default `['web', 'auth']`).`route_prefix`URL prefix (default `tickets`).`schedule_follow_ups`When true the service provider registers `CheckTicketFollowUpsCommand` to run hourly in production.`source_resolvers`Map of `source_type => TicketSourceResolver class-string`. See "Optional Ghostwriter integration" below.`ai.*`AI feature flags + analysis model.`notifications.follow_up_due_after_hours`Threshold used by host applications to trigger follow-up notifications.`media.disk`Disk used for ticket / comment attachments.Host User model integration
---------------------------

[](#host-user-model-integration)

The package never imports your `User` model. Instead, three things must line up:

1. The model class is configured via `gaze-ticketsystem.user_model`.
2. The model is `Authenticatable` (any standard Laravel User works).
3. The "admins" lookup either:
    - is provided as a closure in `gaze-ticketsystem.admin_resolver`, **or**
    - exposes an `admins()` query scope on the user model.

The package ships an `IsTicketAdmin` trait you can drop onto your user model as a starting point:

```
use Empire2\GazeTicketsystem\Concerns\IsTicketAdmin;

class User extends Authenticatable
{
    use IsTicketAdmin;

    public function scopeAdmins($query)
    {
        return $query->whereHas('roles', fn ($q) => $q->whereIn('name', ['admin', 'super-admin']));
    }
}
```

Or wire it via config without touching the model:

```
'admin_resolver' => fn () => \App\Models\User::query()
    ->whereHas('roles', fn ($q) => $q->whereIn('name', ['admin', 'super-admin']))
    ->get(),
```

The contract is: the resolver returns an `Illuminate\Support\Collection`.

Optional Ghostwriter integration
--------------------------------

[](#optional-ghostwriter-integration)

When `empire2/gaze-ghostwriter` is installed alongside this package, support drafts can be turned into tickets via the bundled `GhostwriterSourceResolver` (already mapped under `'support_draft'` in the default config).

The `GhostwriterSourceResolver` feature-detects ghostwriter at runtime — it is safe to ship in stand-alone setups and silently no-ops when the upstream classes are missing.

To wire your own source type, implement the contract:

```
use Empire2\GazeTicketsystem\Contracts\TicketSourceResolver;
use Empire2\GazeTicketsystem\Sources\TicketSourceData;

class CrmInquirySourceResolver implements TicketSourceResolver
{
    public function resolve(string $sourceType, mixed $sourceId): ?TicketSourceData
    {
        if ($sourceType !== 'crm_inquiry') {
            return null;
        }

        $inquiry = \App\Models\CrmInquiry::find($sourceId);

        return $inquiry ? new TicketSourceData(
            title: "Anfrage: {$inquiry->subject}",
            contactName: $inquiry->contact_name,
            contactEmail: $inquiry->contact_email,
            sourceContext: $inquiry->message,
            url: route('crm.inquiries.show', $inquiry),
        ) : null;
    }
}
```

Then map it in `config/gaze-ticketsystem.php`:

```
'source_resolvers' => [
    'support_draft' => \Empire2\GazeTicketsystem\Sources\GhostwriterSourceResolver::class,
    'crm_inquiry'   => \App\Tickets\CrmInquirySourceResolver::class,
],
```

Visiting `/tickets/create?prefill=1&source_type=crm_inquiry&source_id=42` will then prefill the ticket form from your CRM record, and `Ticket::sourceUrl()` will link back to it.

Quick start
-----------

[](#quick-start)

```
use Empire2\GazeTicketsystem\Models\Ticket;
use Empire2\GazeTicketsystem\Enums\Priority;

$ticket = Ticket::create([
    'title'         => 'Login flow broken',
    'body'          => 'User reports a 500 on /login since 9:30',
    'contact_name'  => 'Max Mustermann',
    'contact_email' => 'max@example.com',
    'created_by'    => $authUser->id,
    'status_id'     => $defaultStatus->id,
    'type_id'       => $supportType->id,
    'priority'      => Priority::HIGH,
]);
```

Then visit `/tickets` for the kanban board, `/tickets/{ticket}` for the split view, and `/tickets/settings` to manage statuses + types.

Privacy boundaries
------------------

[](#privacy-boundaries)

This package routes every text prompt and structured LLM response through the [`empiretwo/gaze-laravel`](https://packagist.org/packages/empiretwo/gaze-laravel)boundary. With `gaze_enabled=true` (config key `gaze-ticketsystem.ai.gaze_enabled`, env `GAZE_TICKETSYSTEM_GAZE_ENABLED`), prompts are passed through `gaze clean` before they reach the model, and the `restore` step puts placeholder tokens back into the model output before persistence. With `gaze_enabled=false` (default), the `GuardedAgentRunner` short-circuits with `GazeDisabledException` — there is no bypass branch, all three AI entry points (`analyzeRaw`, `analyze`, `replyToComment`) fail closed.

**Image attachments are NOT redacted.** Gaze is a text-only boundary. Ticket screenshots and other image attachments are sent to the configured AI provider as-is. Each AI call with non-empty attachments emits a `Log::warning('gaze-ticketsystem AI call with un-redactable image attachments', ['ticket_id' => ..., 'count' => N])` so operators can audit out-of-band PII exposure. Treat image upload as out-of-band PII exposure and disable image attachments if your compliance posture forbids it.

**Embeddings:** this package does not generate embeddings — it only sends text prompts (with optional images) to a structured-output agent. If you add embedding paths in a downstream extension, route the input text through `Gaze::clean()` only (no restore) and skip the call when `gaze_enabled=false` (fail-closed).

Console commands
----------------

[](#console-commands)

```
php artisan gaze-ticketsystem:check-follow-ups
# alias:
php artisan ticket:check-follow-ups
```

When `gaze-ticketsystem.schedule_follow_ups` is true (default), the service provider registers the command to run hourly in `production`. Disable it and wire it up yourself in `routes/console.php` if you need different scheduling.

Testing
-------

[](#testing)

```
composer test
composer analyse
composer format
```

The package ships its own Pest test suite. Tests that exercise the full Livewire UI assume a host User model is configured — see `tests/TestCase.php` for the orchestration. The `GhostwriterIntegrationTest` is skipped automatically when `empire2/gaze-ghostwriter` is not installed.

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md).

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance95

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

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 ~0 days

Total

3

Last Release

30d ago

PHP version history (2 changes)v0.1.0PHP ^8.2

v0.1.1PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/7ea97b29c70171e914ebaca119cef17f705745977df0c05ff7b5fe9a90d9bca4?d=identicon)[lord-eagle](/maintainers/lord-eagle)

---

Top Contributors

[![lord-eagle](https://avatars.githubusercontent.com/u/2154876?v=4)](https://github.com/lord-eagle "lord-eagle (2 commits)")

---

Tags

laravelailivewiresupportticketshelpdeskkanbangaze

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/empire2-gaze-ticketsystem/health.svg)

```
[![Health](https://phpackages.com/badges/empire2-gaze-ticketsystem/health.svg)](https://phpackages.com/packages/empire2-gaze-ticketsystem)
```

###  Alternatives

[spatie/laravel-health

Monitor the health of a Laravel application

88011.3M149](/packages/spatie-laravel-health)[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[laravel/ai

The official AI SDK for Laravel.

9782.1M153](/packages/laravel-ai)[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k14.1M120](/packages/laravel-pulse)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9732.3M121](/packages/roots-acorn)[tallstackui/tallstackui

TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications.

719160.4k12](/packages/tallstackui-tallstackui)

PHPackages © 2026

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